• Zuletzt bearbeitet am: 01 August 2022

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

PaymentTerm

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

Versandbedingungen

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)
  • Inhalt