Lieferanten-API (/suppliers)
Verwenden Sie die Lieferanten-API, um die Lieferanten in Coupa zu erstellen, zu aktualisieren, abzufragen und zu löschen
Übersicht
Verwenden Sie die Lieferanten-API, um die Lieferanten in Coupa zu erstellen, zu aktualisieren und abzufragen
Die URL für den Zugriff auf Lieferanten lautet: https://<instance>/api/suppliers
Weitere Informationen finden Sie unter Integrations-Best Practices.
Aktionen
Mit der Lieferanten-API können Sie:
| Verb | Pfad | Aktion | Beschreibung |
|---|---|---|---|
| BEITRAG | /api/suppliers |
erstellen | Lieferanten erstellen |
| BEITRAG | /api/suppliers/create_supplier_user_preferences |
create_supplier_user_preferences | Benutzereinstellungen für Lieferanten erstellen |
| ABFRAGEN | /api/suppliers |
index | Lieferanten abfragen |
| LÖSCHEN | /api/suppliers/logout_iframe_session |
logout_iframe_session | Iframe-Sitzung abmelden (CSP) |
| ABFRAGEN | /api/suppliers/:id |
anzeigen | Lieferanten anzeigen |
| BEITRAG | /api/suppliers/sync_supplier_user_locale |
sync_supplier_user_locale | Benutzergebietsschema für Lieferanten synchronisieren |
| PUT | /api/suppliers/:id |
aktualisierung | Lieferanten aktualisieren |
Elemente
Die folgenden Elemente sind für die Lieferanten-API verfügbar:
| Element | Beschreibung | Pflichtfeld? | Eindeutig? | Zulässiger Wert | Api_In Field? | Api_Out-Feld? | Datentyp |
|---|---|---|---|---|---|---|---|
| kontonummer | Kontonummer | ja | ja | zeichenfolge | |||
| account-types | Kontoarten | ja | ja | AccountType | |||
| allow-change-requests | Dadurch können Lieferanten Änderungsanforderungen vom CSP erstellen | ja | ja | boolean | |||
| allow-cn-no-backing-doc-from-connect | Bei „Ja“ kann der Lieferant Gutschriften ohne Bezug auf die Rechnung erstellen. | ja | ja | boolean | |||
| allow-csp-access-without-two-factor | Ermöglicht Lieferanten Zugriff auf Kundendaten aus CSP ohne Zwei-Faktor-Authentifizierung | ja | ja | boolean | |||
| allow-cxml-invoicing | CXML-Rechnungsstellung für Lieferanten zulassen | ja | ja | boolean | |||
| allow-inv-choose-billing-account | INV-Abrechnungskonto auswählen zulassen | ja | ja | boolean | |||
| allow-inv-from-connect | Bei „Ja“ kann der Lieferant Rechnungen für seine Bestellungen oder Verträge im CSP erstellen | ja | ja | boolean | |||
| allow-inv-no-backing-doc-from-connect | Bei „Ja“ kann der Lieferant Rechnungen ohne Bezug auf eine Bestellung oder einen Vertrag im ZDL erstellen. | ja | ja | boolean | |||
| allow-inv-unbacked-lines-from-connect | Bei Ja kann der Lieferant ungedeckte Rechnungen ohne Bezug auf eine Bestellung oder einen Vertrag im CSP erstellen. | ja | ja | boolean | |||
| unternehmensgruppen | geschäftsgruppe | ja | ja | ContentGroup | |||
| buyer-Hold | Alle PO's zur Prüfung durch den Einkäufer halten | ja | ja | boolean | |||
| kontakte | nein | nein | alle | ja | Lieferanteninformation - Kontakte | ||
| warengruppe | Standard-Warengruppe, auswählbar aus Dropdown-Menü | ja | ja | ||||
| corporate-url | Unternehmens-URL | ja | zeichenfolge | ||||
| coupa-connect-secret | Coupa Connect Secret | ja | zeichenfolge | ||||
| coupa-pay-financing-only | Nur finanzierte Rechnungen über Coupa Pay zahlen | ja | ja | boolean | |||
| 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 | ||||
| cxml-domain |
„Von“ , unsere Domain cXML-Domäne |
|
ja | ja | zeichenfolge | ||
| cxml-http-password | cXML-HTTP-Kennwort | ja | |||||
| cxml-http-username | cXML-HTTP-Benutzername | ja | ja | zeichenfolge | |||
| cxml-identity |
„Von“, unsere Identität cXML-Identität |
|
ja | ja | zeichenfolge | ||
| cxml-rechnung-käufer-domain | Domäne des Einkäufers für cXML-Rechnungsstellung | ja | ja | zeichenfolge | |||
| cxml-rechnung-käufer-identität | Einkäuferidentität für cXML-Rechnungsstellung | ja | ja | zeichenfolge | |||
| cxml-invoice-secret | Geheimer Schlüssel für cXML-Rechnungsauthentifizierung | ja | ja | zeichenfolge | |||
| cxml-rechnung-lieferanten-domain | Domäne des Lieferanten für cXML-Rechnungsverarbeitung | ja | ja | zeichenfolge | |||
| cxml-rechnung-lieferanten-identität | Lieferantenidentität für cXML-Rechnungsstellung | ja | ja | ja | zeichenfolge | ||
| cxml-protocol |
Übertragungsprotokoll |
|
ja | ja | zeichenfolge | ||
| cxml-secret | Shared Secret |
|
ja | ja | zeichenfolge | ||
| cxml-ssl-version | cXML-SSL-Version | ja | ja | zeichenfolge | |||
| cxml-lieferanten-domain |
„An“, Lieferantendomäne cXML-Lieferantendomäne |
|
ja | ja | zeichenfolge | ||
| cxml-lieferanten-identität |
„An“, Lieferantenidentität cXML-Lieferantenidentität |
|
ja | ja | zeichenfolge | ||
| cxml-url | URL, an die Bestellungen gesendet werden, wenn die Bestellübermittlung "cxml" ist |
|
ja | ja | zeichenfolge | ||
| default-locale | Standardgebietsschema für den Versand von E-Mails an diesen Lieferanten | nein | nein | alle | ja | string(255) | |
| disable-cert-verify |
Zertifikatsverifizierung deaktivieren |
ja | ja | boolean | |||
| display-name | Anzeigename | ja | ja | zeichenfolge | |||
| duns | LIEFERANTEN-NR | ja | ja | zeichenfolge | |||
| unternehmen | Unternehmen | True | ja | ja | Unternehmen | ||
| hold-invoices-for-ap-review | Verhindern Sie, dass Rechnungen von diesem Lieferanten genehmigt werden, bevor die Kreditorenbuchhaltung sie überprüft hat. | ja | boolean | ||||
| iD | Interne Coupa-ID | ja | ganze Zahl | ||||
| rechnungs-E-Mails | Registrierte E-Mail-Adressen dürfen Rechnungen per E-Mail an invoices@yourhost.coupahost.com senden. |
ja | ja | ||||
| rechnungsabgleich-Ebene | Ebene für den Abgleich von Rechnungen | ja | 2-fach, 3-fach, 3-fach-Direkt, kein | ja | ja | zeichenfolge | |
| name | Name des Lieferanten | ja | ja | ja | ja | string(100) | |
| zahl | Lieferantennummer | ja | ja | ja | zeichenfolge | ||
| in der Warteschleife | Lieferant in der Warteschleife | ja | ja | boolean | |||
| online-Shop | Lieferanten-Website | ja | ja | ja | |||
| übergeordnete | übergeordnete | ja | ja | Lieferant | |||
| zahlungsmethode | Standard-Zahlungsmethode, auswählbar aus Dropdown | ja | invoice, pcard, invoice_only, pcard_only, virtual_card | ja | ja | string(255) | |
| zahlungsbedingung | Standard-Zahlungsbedingung, auswählbar aus Dropdown-Liste | ja | ja | ||||
| zahlungsfrist-id-for-api | Zahlungsbedingungs-ID für API | ja | |||||
| po-change-methode |
Bestelländerungsübertragungsmethode |
true | false | cXML, XML, E-Mail, Eingabeaufforderung, mark_as_sent, buy_online | ja | ja | string(255) |
| po-email | E-Mail-Adresse, an die Bestellungen gesendet werden, wenn die Bestellübermittlung "E-Mail" lautet |
|
ja | ja | string(255) | ||
| po-method | Übertragung der Bestellung | cXML, XML, E-Mail, Eingabeaufforderung, mark_as_sent, buy_online | ja | ja | string(255) | ||
| preis-Betrag | Preisbetrag | ja | ja | ||||
| primäradresse | Primäradresse | ja | Lieferantenadresse | ja | ja | Informationen zur Lieferantenadresse | |
| primärer Kontakt | Primäre Kontakt-E-Mail-Adresse des Lieferanten | ja | ja | ja | |||
| überweisung-an-adressen | Zahlungsempfängeradressen | ja | ja | RemitToAddress | |||
| restricted-account-types | Eingeschränkte Kontoarten | ja | ja | AccountType | |||
| spar-Pkt. | Einsparungen für die Verwendung dieses Lieferanten | ja | ja | dezimalzahl | |||
| send-invoices-to-approvals | Bei Ja werden alle Rechnungen unabhängig vom Gesamtbetrag über die Genehmigung versendet. | ja | ja | boolean | |||
| scf-configs | Lieferketten-Finanzkonfigurationen für Lieferanten auf der Whitelist | ja | ja | zeichenfolge | |||
| lieferbedingung | Lieferbedingung des Lieferanten, auswählbar aus Dropdown-Menü | ja | ja | ||||
| status | Lieferantenstatus | ja | zeichenfolge | ||||
| storefront-url | Lieferanten-Website | ja | zeichenfolge | ||||
| lieferanten-Adressen | nein | nein | alle | ja | [] | ||
| ja | SupplierSite | ||||||
| lieferanten-Status | Lieferantenstatus | ja | entwurf | ||||
| steuerkennzeichen | Steuercode des Lieferanten | ja | ja | ||||
| steuer-ID | LIEFERANTEN-NR | ja | ja | zeichenfolge | |||
| 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 | ||||
| website | Lieferanten-Website | ja | ja | zeichenfolge | |||
| whitelist-dd | Whitelist-Lieferanten für dynamische Skontierung | false | false | alle | ja | ja | boolean |
| dd-settings | Einstellungen für dynamische Skontierung für Lieferanten auf der Whitelist | ja | ja | zeichenfolge | |||
| kunden-Support-Kontakte | Enthält eine Liste der Lieferantenkontoinhaber (Kundenbetreuungskontakte) mit ihrem Zweck | ja | ja | [] | |||
| diversitäten | Liste der Lieferantendiversitäten. | Siehe Diversity-Marker-Codes | ja | ja | [] | ||
| business-entity-id | Unternehmen | ja | ja | ganze Zahl | |||
| zahlungsbedingungen | ja | zeichenfolge | |||||
| preferred-commodities | Liste der bevorzugten Warengruppen | ja | ja | zeichenfolge | |||
| tags | Liste der Kennzeichen | ja | ja | zeichenfolge | |||
| markierungen | Liste der Tags | ja | [] | ||||
| typ | Typ | ja | string(255) | ||||
| diversity-Kategorien | Diversitätskategorien | ja | [] | ||||
| bestandsorganisation | Bestandsorganisation | ja | |||||
| order_confirmation_level | Bestätigungsebene der Bestellung | not_applicable, Header, Zeile | ja | ganze Zahl | |||
| confirm_by_hrs | Bestätigen innerhalb von (Stunden) | , | ja | ja | dezimalzahl(10,0) | ||
| one_time_supplier | Gibt an, ob der Lieferant ein Einmallieferant ist | ja | ja | boolean | |||
| scope_three_emissions | Gibt an, ob der Lieferant Scope 3-Emissionen überwacht | ja | ja | boolean | |||
| do_not_beschleunigung | Beschleunigen Sie die Zahlungsbedingungen nicht. Dieses Feld entspricht „Keine statischen Rabatte anbieten“. | nein | ja | boolean |
Hinweis
- Es gibt abhängige Felder, die basierend auf dem Wert aus dem Quellfeld abfragbar werden können. Wenn Sie beispielsweise eine Abfrage gegen po-method=email durchführen, kann po-email als zusätzliches Abfragekriterium hinzugefügt werden. Bitte beachten Sie die Felder mit Ja*.
- Begrenzen Sie bei großen Datensätzen und Leistungsoptimierungen Ihr Ergebnis immer mit einigen GET-Kriterien.
- Wenn Sie keinen Status für den Lieferanten festlegen, ist das System standardmäßig auf Entwurf eingestellt.
- Wenn Sie keine Standard-Zahlungsmethode festlegen, lautet die Standardeinstellung des Systems Rechnung.
- Damit die API benutzerdefinierte Felder erkennen kann, müssen die Felder im Setup als API editierbar festgelegt werden.
- Wenn Sie das Coupa Supplier Portal (CSP) in Ihrer Umgebung aktiviert haben, ist das Feld Allow Supplier to Create Invoice standardmäßig aktiviert.
- Wenn Sie die primäre Adresse des Lieferanten aktualisieren, können Sie jedes Attribut auf dem Adressobjekt aktualisieren, aber Sie können dem Lieferantendatensatz keine andere Adress-ID zuordnen.
- Wenn Sie den primären Kontakt im Lieferantendatensatz aktualisieren, können Sie jedes Attribut in den Kontaktinformationen aktualisieren, aber Sie können dem Lieferantendatensatz keine völlig andere Kontakt-ID zuweisen.
Diversitäts-Marker-Codes
| Diversitätsmarkierungscode | Beschreibung |
|---|---|
| MBE | Von Minderheiten geführtes Unternehmen |
| WBE | Von Frauen geführtes Unternehmen |
| SBE | Mittelstandsunternehmen |
| LGBTBE | Von Lesben, Schwulen, Bisexuellen, Transgender geführtes Unternehmen |
| Geburtsdatum | Von Behinderten geführte Unternehmen |
| NPO | Gemeinnützige Organisation |
| DBE | Benachteiligtes Unternehmen |
| SDB | Kleines benachteiligtes Unternehmen |
| SDVBE | Von Kriegsversehrten geführtes Unternehmen |
| WOSB | Von Frauen geführtes kleines Unternehmen |
| VOB | Von Veteranen geführtes Unternehmen |
| DVBE | Von behinderten Veteranen geführtes Unternehmen |
| SDVOSB | Von Kriegsversehrten geführtes Kleinunternehmen |
| HUBZone | Historically Underutilized Business Zone |
| SBA8A | SBA-8(A) |
| ACDBE | Airport Concession Disadvantaged Business Enterprise |
| ANC | Von Ureinwohnern Alaskas geführtes Unternehmen |
| HBCU | Historisch afroamerikanische Colleges und Hochschulen /Minderheiteninstitution |
| LSA | Labor Surplus Area |
| VVO | Von Vietnamveteranen geführt |
| ABILITYONE | Ability One Program |
| EDWOSB | Von Frauen geführtes wirtschaftlich benachteiligtes Kleinunternehmen |
| NAO | Native American owned |
| IOB | Von Einheimischen geführtes Unternehmen |
| AMS | Von Ureinwohner und Minderheiten geführter Lieferant |
| BOB | Geschäft im Besitz von Schwarzen |
| MGOB | Von Angehörigen einer Minderheitengruppe geführtes Unternehmen |
| EMB | Unternehmen ethnischer Minderheiten (EMBs) |