• Zuletzt bearbeitet am: 24 April 2023

Adress-API (/addresses)

Verwenden Sie die Adress-API zum Abfragen, Erstellen oder Aktualisieren von persönlichen oder Lieferanten-Adressinformationen.

Verwenden Sie die Adress-API zum Abfragen, Erstellen oder Aktualisieren von persönlichen oder Lieferanten-Adressinformationen.

Die URL für Zugriffsadressen lautet: https://<instance>/api/addresses

  • Verwenden Sie diese URL, um persönliche Adressinformationen abzufragen: https://<instance url>/api/users/<user ID>/addresses
  • Verwenden Sie diese URL, um Informationen zum Lieferantenauftrag an die Adresse abzufragen: https:/<instance url>//api/suppliers/<user ID>/addresses

Weitere Informationen finden Sie unter Integrations-Best Practices.

Aktionen

Mit der Adressen-API können Sie:

Verb Pfad Aktion Beschreibung
BEITRAG /api/addresses erstellen Adresse erstellen
ABFRAGEN /api/addresses index Adressen abfragen
ABFRAGEN /api/addresses/:id anzeigen Adresse anzeigen
PUT /api/addresses/:id aktualisierung Adresse aktualisieren

Elemente

Die folgenden Elemente sind für die Adressen-API verfügbar:

Element Beschreibung Pflichtfeld? Eindeutig? Zulässiger Wert Api_In Field? Api_Out-Feld? Datentyp
aktiv Wenn kein Wert angegeben wird, ist die Adresse inaktiv, sodass sie für Benutzer nicht mehr verfügbar ist. Ein Ja-Wert macht es aktiv und für Benutzer verfügbar.       ja ja boolean
achtung Adresse Standard-Aufmerksamkeitszeile       ja ja string(255)
business-group-name Inhaltsgruppenname für Adresse       ja ja string(255)
ort Name des Ortes ja     ja ja string(255)
content-groups Inhaltsgruppen.       ja ja ContentGroup
land land ja     ja ja Land
created-at Automatisch von Coupa erstellt im Format JJJJ-MM-TTTHH:MM:SS+HH:MMZ         ja datum/Uhrzeit
erstellt von Benutzer der Erstellung         ja Benutzer
iD Eindeutige Kennung von Coupa für die Adresse         ja ganze Zahl
lokale Steuernummer local_tax_number ja     ja ja string(255)
location-code location_code   ja   ja ja string(255)
name Adresse 'Nickname'       ja ja string(255)
pLZ Postleitzahl ja     ja ja string(255)
zwecke Zwecke für Mehrfachkontakte und Adressen für Lieferanten       ja ja Zweck
status Bundesland Kurzbezeichnung     Siehe Anmerkung unter dieser Tabelle, um eine Liste der zulässigen Werte herunterzuladen.  ja ja string(255)
state-iso-code

ISO-Code für den Bundesstaat

Hinweis

In 36.1 wurde die zulässige Syntax für Feldwerte in das Format geändert: CC-SSS, wobei CC den zweistelligen Ländercode und SSS den ein- bis dreistelligen alphanumerischen Unterteilungscode darstellt. Zum Beispiel US-CA. Siehe Anmerkung unter dieser Tabelle, um eine Liste der zulässigen Werte herunterzuladen.

Siehe Anmerkung unter dieser Tabelle, um eine Liste der zulässigen Werte herunterzuladen.  ja ja string(255)
street1 Adresszeile 1 ja     ja ja
street2 Adresszeile 2       ja ja string(255)
street3 Adresszeile 3       ja ja string(255)
street4 Adresszeile 4       ja ja string(255)
steueranmeldungen Steuerliche Registrierungen         ja Steuerregistrierung
updated-at Automatisch von Coupa erstellt im Format JJJJ-MM-TTTHH:MM:SS+HH:MMZ         ja datum/Uhrzeit
aktualisiert von Benutzer der Aktualisierung         ja Benutzer
vAT-Land uSt_COUNTRY       ja ja Land
umsatzsteuer-Identifikationsnummer vat_number       ja ja string(255)
Hinweis
  • Ab der Veröffentlichung im Mai 2023 haben sich die ISO-Codes und -Namen des Staates geändert. Um eine vollständige Liste der Änderungen und zulässigen Werte anzuzeigen, laden Sie die Unterteilungscode-Änderungs-Excel-Datei herunter
  • Das Referenzobjekt Land und der jeweilige Ländername, Code oder ID müssen im System bereits vorhanden sein.
  • Wenn die Adresse deaktiviert oder inaktiv ist, können der Adresseintrag und seine Attribute nicht über die API aktualisiert werden.

Vergleichbare Artikel


Unterschiede zwischen XML und json in Coupa

16 December 2016

Integrationsausführungen-API

24 April 2017

Verwenden Sie diese API, um einen Integrationslauf zu erstellen, abzufragen oder zu aktualisieren sowie den Status zu aktualisieren.

Tagging-API

24 April 2017

Verwenden Sie die Tagging-API, um Tags in Ihr Drittanbietersystem einzubringen und zu exportieren.

Grund-API anfechten

05 August 2017

Hinweis: Einige Inhalte wurden maschinell übersetzt.