Lieferanteninformations-API (/supplier_information)
Verwenden Sie die Lieferanteninformations-API, um die von Ihnen über SIM gesammelten Lieferanteninformationen an Ihr ERP- oder Finanzsystem zu senden.
Die URL für den Zugriff auf Lieferanteninformationen lautet: https://<instance>/api/supplier_information
SIM-API-Berechtigungen müssen in Ihrem API-Schlüssel enthalten sein, um eine ordnungsgemäße Verwendung zu ermöglichen. Bestehende API-Schlüssel ohne SIM-API-Berechtigungen können nicht auf die Ressource/api/supplier_information zugreifen. Weitere Informationen finden Sie unter Best Practices für API-Schlüsselsicherheit und -Integration.
Hinweis
Ab R31 gibt die API diese Felder in der Nutzlast nicht mehr zurück, wenn Felder NULL sind (z. B. wenn ein Feld leer ist). Wenn die Nutzlast variiert, wirft das Zielsystem eine Fehlermeldung aus.
Aktionen
Mit der Lieferanteninformations-API können Sie:
| Verb | Pfad | Aktion | Beschreibung |
|---|---|---|---|
| BEITRAG | /api/supplier_information |
erstellen | Erstellen. Wenn ein POSTANRUF ohne Angabe der Lieferanten-ID getätigt wird, wird automatisch ein zugeordneter Lieferantendatensatz erstellt. |
| ABFRAGEN | /api/supplier_information |
index | Index |
| ABFRAGEN | /api/supplier_information/:id |
anzeigen | Anzeigen |
| PUT | /api/supplier_information/:id |
aktualisierung | Aktualisieren |
Hinweis
Dieser API-Aufruf gibt möglicherweise einen Ausschnitt des Ruby-Codes als Teil der GET-ANTWORTNUTZLAST ZURÜCK. Dieses Code-Snippet kann ignoriert werden.
Elemente
Die folgenden Elemente stehen für die Lieferanteninformations-API zur Verfügung:
(Blättern Sie in der Tabelle, um die zusätzlichen Spalten anzuzeigen)
| Element | Beschreibung | Erforderlich? | Eindeutig? | Zulässiger Wert | Api In? | Api-Ausgang? | Datentyp |
|---|---|---|---|---|---|---|---|
| allow-cxml-invoicing | CXML-Rechnungsstellung zulassen | ja | boolean | ||||
| allow-inv-choose-billing-account | Auswahl des Verrechnungskontos in Rechnungen zulassen | ja | boolean | ||||
| allow-inv-from-connect | Rechnungen aus Connect zulassen | ja | boolean | ||||
| allow-inv-no-backing-doc-from-connect | Rechnungen ohne Begleitdokument aus Connect zulassen | ja | boolean | ||||
| allow-inv-unbacked-lines-from-connect | Rechnungen mit Positionen ohne Bestellbezug aus Connect zulassen | ja | boolean | ||||
| backend-system-katalog | Für Katalogmanagement verwendetes Backend-System | CatBase, Elastic, iPartner Product Suite, Claritum, Contalog, CatalognTime, Advizia, Aravo, MatrixCMX, SigmaCommerce | ja | ja | string(255) | ||
| backend-system-fakturierung | Für die Rechnung verwendetes Backend-System | SAP, Oracle | ja | ja | string(255) | ||
| buyer-Hold | PO hold zur Prüfung durch den Einkäufer | ja | ja | boolean | |||
| käufer-ID | Einkäufer-ID | ja | ja | ganze Zahl | |||
| kommentar | Kommentartext | ja | ja | text | |||
| comment-source | Kommentarquelle | ja | ja | string(255) | |||
| commodity-id | Warengruppen-ID | ja | ganze Zahl | ||||
| content-groups | Inhaltsgruppen | ja | ja | Geschäftsgruppen | |||
| country-of-Operation | Betriebsland | ja | ja | Land | |||
| country-of-operation-id | Betriebsland-ID | ja | ganze Zahl | ||||
| created-at | Datum und Uhrzeit der Erstellung des SIM-Datensatzes | ja | datum/Uhrzeit | ||||
| erstellt von | Vom Benutzer erstellter SIM-Datensatz | ja | Benutzer | ||||
| currency-id | Währung - ID | ja | ja | ganze Zahl | |||
| cxml-domain | cXML-Domäne | ja | ja | zeichenfolge | |||
| cxml-http-username | cXML-HTTP-Benutzername | ja | ja | zeichenfolge | |||
| cxml-identity | cXML-Identität | ja | ja | zeichenfolge | |||
| cxml-protocol | cXML-Protokoll | ja | ja | zeichenfolge | |||
| cxml-secret | cXML-Geheimnis | ja | ja | zeichenfolge | |||
| cxml-ssl-version | cXML-SSL-Version | ja | ja | zeichenfolge | |||
| cxml-lieferanten-domain | cXML-Domain des Lieferanten | ja | ja | zeichenfolge | |||
| cxml-lieferanten-identität | cXML-Identität des Lieferanten | ja | ja | zeichenfolge | |||
| cxml-url | cXML-URL | ja | ja | zeichenfolge | |||
| default-commodity | Standardwarengruppe | ja | ja | Warengruppen | |||
| default-commodity-id | Standardwarengruppe | ja | ganze Zahl | ||||
| default-invoice-email | Standardmäßige Rechnungs-E-Mail | ja | string(255) | ||||
| disable-cert-verify | Zertifikatsprüfung deaktivieren | ja | ja | boolean | |||
| display-name | Angezeigter Name des Lieferanten | ja | ja | string(255) | |||
| duns-nummer | Dun und Bradstreet Nummer | ja | ja | string(255) | |||
| duplikat vorhanden | Duplikat vorhanden | ja | ja | boolean | |||
| geschätzter Ausgabenbetrag | Geschätzter Ausgabenbetrag | ja | ja | dezimalzahl(30,4) | |||
| fed-reportable | Bundessteuerpflichtiger Indikator | ja | ja | boolean | |||
| bundessteuernummer | Bundessteueridentifikationsnummer | ja | ja | string(255) | |||
| waren-dienstleistungen-erbringung | Bereitgestellte Waren und Dienstleistungen | ja | ja | string(255) | |||
| regierungs-Agentur-Interaktion | Erklärung zur Interaktion mit Regierungsbehörde | ja | ja | text | |||
| govt-Agentur-Interaktionsindikator | Interaktion mit Regierungsbehörde - Indikator | ja | ja | boolean | |||
| govt-allegation-betrug-bestechung | Lieferantenrichtlinie für Regierungsvorwürfe von Betrug und Bestechung | ja | ja | string(255) | |||
| govt-allegation-betrug-bestechungsindikator | Hat der Lieferant eine Richtlinie für staatliche Vorwürfe von Betrug und Bestechung? | ja | ja | boolean | |||
| hold-invoices-for-ap-review | Rechnungen zur Prüfung durch die Buchhaltung zurückstellen | ja | boolean | ||||
| hold-Payment | Zahlungssperre | ja | ja | string(255) | |||
| hold-Payment-Kennzeichen | Hinweis auf Zahlungssperre | ja | ja | boolean | |||
| iD | SIM-ID | ja | ganze Zahl | ||||
| inbound-invoice-domain | E-Mail-Domain für eingehende Rechnung | ja | string(255) | ||||
| inco-Bedingungen | Incoterms | EXW, FCA, CPT, CIP, DAT, DAP, DDP, FAS, FOB, CFR, CIF, DPU | ja | ja | string(255) | ||
| einkommensart | Einkommenstyp | ja | ja | string(255) | |||
| branche | Primärindustrie des Lieferanten | ja | ja | string(255) | |||
| intl-other-explanation | Erklärung zur internationalen Steuerklasse | ja | ja | string(255) | |||
| intl-Steuerklassifizierung | Internationale Steuerklasse | Aktiver NFFE, Passiver NFFE (einschließlich Trusts), Befreite wirtschaftliche Eigentümer, Als konform angesehenes FFI, Kanadisches Finanzinstitut, Finanzinstitut eines anderen Partnerlandes, Teilnehmendes ausländisches Finanzinstitut, Nicht teilnehmendes Finanzinstitut, Spezifizierte US-Person, Nicht spezifizierte US-Person, 1099, C Corp, Kundenrückerstattung, Befreite 1099, Steuerbehörde, Steuer- und Verwaltungsbehörde, Verkäufer, Non-Profit, Partnerempfehlung, S Corp, Ausländisches Unternehmen, Aktiver NFFE, Passiver NFFE (einschließlich Trusts), Befreite wirtschaftliche Eigentümer, Als konform angesehenes FFI, Kanadisches Finanzinstitut, Finanzinstitut eines anderen Partnerlandes, Teilnehmendes ausländisches Finanzinstitut, Nicht teilnehmendes Finanzinstitut, Spezifizierte US-Person, Nicht spezifizierte US-Person | ja | ja | string(255) | ||
| intl-tax-num | Internationale Steuernummer | ja | ja | string(255) | |||
| invoice-amount-limit | Rechnungsgenehmigungslimit | ja | ja | text | |||
| invoice-inbound-E-Mails | Eingehende E-Mails der Rechnung | ja | text | ||||
| rechnungsabgleich-Ebene | Art des Abgleichs für Rechnungen | ja | string(255) | ||||
| last-exported-at | Zuletzt exportiertes Flag | ja | string(255) | ||||
| logo-Inhaltstyp | Logo-Inhaltstyp | ja | string(255) | ||||
| logo-file-name | Logo-Dateiname | ja | string(255) | ||||
| logo-file-size | Logo-Dateigröße | ja | ganze Zahl | ||||
| logo-updated-at | Logo aktualisiert um | ja | datum/Uhrzeit | ||||
| minderheitsindikator | Indikator MWBE | ja | ja | boolean | |||
| minoritätstyp-id | Minderheitenart | 1, 2, 3, 4, 1, 2, 3, 4 | ja | ja | ganze Zahl | ||
| name | Name des Lieferanten | ja | ja | ja |
string(100) |
||
| organisationstyp | Organisationstyp | Kapitalgesellschaft, ausländische Kapitalgesellschaft, natürliche Person, ausländische natürliche Person, Personengesellschaft, ausländische Personengesellschaft | ja | ja | string(255) | ||
| übergeordneter Firmenname | Name des Mutterunternehmens | ja | ja | string(255) | |||
| entgeltgruppe | Zahlungsmethoden | Lastschrift, Standard, Kundenerstattung, Mitarbeiter, Intercompany, Leasing, Partnerempfehlung, Miete, Steuern, Util/Telecom, Lastschrift, Standard, Kundenerstattung, Mitarbeiter, Intercompany, Leasing, Partnerempfehlung, Miete, Steuern, Util/Telecom | ja | ja | string(255) | ||
| zahlungsbedingung | Zahlungsbedingung | ja | ja | Zahlungsbedingungen | |||
| payment-term-id | Zahlungsbedingung | ja | ja | ganze Zahl | |||
| payment-terms-id | Zahlungsbedingung | ja | ja | ganze Zahl | |||
| po-change-methode | Methode für Bestelländerungen | cXML, XML, E-Mail, Eingabeaufforderung, mark_as_sent, buy_online | ja | ja | string(255) | ||
| po-email | E-Mail für Bestellungen | ja | ja | string(255) | |||
| po-method | Bestellmethode | cXML, XML, E-Mail, Eingabeaufforderung, mark_as_sent, buy_online | ja | ja | string(255) | ||
| politik-für-bestechung-korruption | Lieferantenrichtlinie zu Bestechung und Korruption | ja | ja | text | |||
| politik-für-bestechung-korruptionsindikator | Verfügt der Lieferant über eine Richtlinie zu Bestechung und Korruption? | ja | ja | boolean | |||
| bevorzugte Währung | Bevorzugte Währung | ja | ja | Währungen | |||
| preferred-currency-id | Standardwährung - ID | ja | ganze Zahl | ||||
| preferred-language | Bevorzugte Sprache | ja | ja | Sprache | |||
| preferred-language-id | Bevorzugte Sprache - ID | ja | ganze Zahl | ||||
| spar-Pkt. | Prozentuale Einsparungen | ja | dezimalzahl(8,2) | ||||
| send-invoices-to-approvals | Rechnungen zur Genehmigung senden | ja | boolean | ||||
| separater Überweisungsempfänger | Separater Zahlungsempfänger | ja | ja | boolean | |||
| shipping-term-id | Versandbedingungs-ID | ja | ganze Zahl | ||||
| status | Status | ja | ja | ja | string(255) | ||
| supplier-id | Lieferanten-ID | ja | ja | ganze Zahl | |||
| lieferanten-Informations-Adressen | Adressen Unterobjekt | ja | ja | SupplierInformationAddress | |||
| lieferanten-Informations-Artefakte | Unterobjekt Artefakte/Anlagen | ja | ja | SupplierInformationArtifact | |||
| lieferanten-Informationen-Kontakte | Kontakte Unterobjekt | ja | ja | SupplierInformationContact | |||
| lieferantenname | Name des Lieferanten | ja | string(255) | ||||
| lieferanten-Nummer | Lieferantennummer | ja | string(255) | ||||
| lieferanten-region | Lieferantenregion | AMER, EMEA, APAC, Japan | ja | ja | string(255) | ||
| steuerklassifizierung | US-Steuerklasse | 1099, C Corp, Kundenrückerstattung, Steuerbefreiung 1099, Steuerbehörde, Steuer und Regierung, Verkäufer, Non-Profit, Partnerempfehlung, S Corp, Ausländische Gesellschaft | ja | ja | string(255) | ||
| tax-code-id | Steuercode-ID | ja | ja | ganze Zahl | |||
| steuerbefreit-andere-erläuterung | Steuerbefreit - Erklärung | ja | ja | string(255) | |||
| steuerregion | Steuerregion | 1099, C Corp, Customer Refund, Exempt 1099, Tax Authority, Tax & Gov, Vendor, Non Profit, Partner Referral, S Corp, Foreign Company, US, International | ja | ja | string(255) | ||
| drittanbieter-Interaktion | Lieferantenrichtlinie für Interaktionen mit Dritten | ja | ja | text | |||
| third-party-interaction-indicator | Hat der Lieferant eine Richtlinie für seine Interaktionen mit Dritten? | ja | ja | boolean | |||
| updated-at | Datum und Uhrzeit der Aktualisierung des SIM-Datensatzes | ja | datum/Uhrzeit | ||||
| aktualisiert von | SIM-Eintrag vom Benutzer aktualisiert | ja | Benutzer | ||||
| user-id | Benutzer-ID | ja | ja | ganze Zahl | |||
| website | Website | ja | string(255) | ||||
| minor-designation-id | Bezeichnung einer Minderheit | 1, 2, 3 | ja | ja | ganze Zahl | ||
| minoritätstyp-id | minority_type_id |
5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17 |
|||||
| diversitäten | Liste der Lieferanteninformationen - Diversitäten | Diversity-Marker-Codes | ja | ja | [] | ||
| one-time-supplier | Gibt an, ob der Lieferant ein Einmallieferant ist | ja | ja | boolean | |||
| scope-Three-Emissionen | Gibt an, ob der Lieferant Scope 3-Emissionen überwacht | ja | ja | boolean | |||
| website | Website | ja | string(255) | ||||
| rechnungsabgleich-Ebene | Art des Abgleichs für Rechnungen | ja | string(255) | ||||
| shipping-term-id | Versandbedingungs-ID | ja | ganze Zahl | ||||
Diversitäts-Marker-Codes
| Diversitätsmarkierungscode | Beschreibung |
|---|---|
| ABILITYONE | Ability One Program |
| ACDBE | Airport Concession Disadvantaged Business Enterprise |
| AMS | Von Ureinwohner und Minderheiten geführter Lieferant |
| ANC | Von Ureinwohnern Alaskas geführtes Unternehmen |
| BOB | Von Schwarzen geführtes Unternehmen |
| DBE | Benachteiligtes Unternehmen |
| Geburtsdatum | Von Behinderten geführte Unternehmen |
| DVBE | Von behinderten Veteranen geführtes Unternehmen |
| EDWOSB | Von Frauen geführtes wirtschaftlich benachteiligtes Kleinunternehmen |
| EMB | Unternehmen ethnischer Minderheiten (EMBs) |
| HBCU | Historisch afroamerikanische Colleges und Hochschulen /Minderheiteninstitution |
| HUBZone | Historically Underutilized Business Zone |
| IOB | Indigenes Unternehmen |
| LGBTBE | Von Lesben, Schwulen, Bisexuellen, Transgender geführtes Unternehmen |
| LSA | Labor Surplus Area |
| MBE | Von Minderheiten geführtes Unternehmen |
| MGOB | Von Angehörigen einer Minderheitengruppe geführtes Unternehmen |
| NAO | Native American owned |
| NPO | Gemeinnützige Organisation |
| SBA8A | SBA-8(A) |
| SBE | Mittelstandsunternehmen |
| SDB | Kleines benachteiligtes Unternehmen |
| SDVBE | Von Kriegsversehrten geführtes Unternehmen |
| SDVOSB | Von Kriegsversehrten geführtes Kleinunternehmen |
| VOB | Von Veteranen geführtes Unternehmen |
| VVO | Von Vietnamveteranen geführt |
| WBE | Von Frauen geführtes Unternehmen |
| WOSB | Von Frauen geführtes kleines Unternehmen |