--- sourceDocument: Source-to-Pay Operations in Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/source-to-pay-operations Release : - xanadu ft:locale : - de-DE ft:publication_title : - Source-to-Pay Operations in Xanadu ft:clusterId : - stpop bundleId : - stpop workflow : - Creator --- # Spendint API - POST /sn_spend_intg/spendint/orderack # Spendint API - POST /sn_spend_intg/spendint/orderack {#ariaid-title1} * Freigeben Version: Xanadu * * Aktualisiert 1. August 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer Aktualisiert Bestellinformationen für den Fall, dass ein Benutzer ein Produkt aus einem Drittpartei-Katalog kauft. Wenn der Benutzer den Bezahlvorgang durchführt, wird eine Bestellposition erstellt, damit Genehmigungen und andere Aufgaben für den Kauf abgeschlossen werden können. Wenn eine Bestellung in der ServiceNow-Datenbank generiert wird, wird die Bestellung in die folgenden Tabellen verschoben: * Ausgehende Bestellung: Enthält den Auftragsheader. * Ausgehende Bestellposition: Enthält die Auftragspositionen. {#spendint-POST-orderack__ul_cvl_3cs_knb} Lieferanten müssen diese Tabellen abfragen und die für sie ausstehenden Bestellungen abrufen. Lieferanten sollten eine bereichsbezogene App für Workflow-Studio-Aktionen erstellen, um die Integration mit der ServiceNow-Datenbank durchzuführen. Fragen Sie die Tabellen mit den folgenden Parametern ab: * `sysparm_query=supplier_id=^purchase_order.status=20 for header` * `sysparm_query=purchase_order.supplier_id=^purchase_order.status=20 for header` {#spendint-POST-orderack__ul_owg_sfs_knb} Wenn eine Bestellanforderungsposition in eine Bestellposition konvertiert wird, werden die folgenden Prozesse ausgeführt: 1. Die Bestellung und die Bestellposition werden ggf. an Enterprise Resource Planning (ERP) übermittelt. 2. Die Bestellung und die Bestellposition werden mit der Kunden-ID, der Lieferanten-ID, die Kaufauftragsnummer, dem Bestelldatum, dem Bestellbetrag, der Bestellbetragwährung und den Bestellpositionen über die Integration an die Drittpartei übertragen. 3. Die Bestellung und die Bestellposition verbleiben im Status „Ausstehende Übermittlung", bis sowohl von der Drittpartei-Katalogintegration als auch von ERP eine Bestätigungsnachricht eingeht. Nachdem die Bestätigung eingegangen ist, wird der Status in „Bestellt" aktualisiert. Wenn keine ERP-Integration beteiligt ist, ist eine Bestätigungsnachricht nur von der Drittpartei-Integration erforderlich. {#spendint-POST-orderack__ol_bzv_51p_znb} ## Statustabellen {#spendint-POST-orderack__section_hrm_qts_knb} Um den Status der Anforderung zur Auftragsbestätigung zu erfahren, führen Sie in der ServiceNow-Datenbank mit der Tabelle „REST-APIs" einen REST-Aufruf durch. Die Antwort der API listet die Datensätze auf, bei denen die Anforderung zur Auftragsbestätigung fehlgeschlagen ist. Um eine Auftragsbestätigungsantwort zu erhalten, fragen Sie die Tabelle „Auftragsbestätigungsfehler" mit dem folgenden Parameter ab: `sysparm_query=outbound_error.supplier_id=^outbound_error.state=20` Die Detailinformationen zu Kunden-ID, Lieferanten-ID, Fehlertyp, eindeutiger Import Set-ID und Status finden Sie in der Tabelle „Ausgehender Status", der übergeordneten Fehlertabelle. ## URL-Format {#spendint-POST-orderack__section_vkd_122_dmb} /api/sn_spend_intg/spendint/orderack ## Unterstützte Anforderungsparameter {#spendint-POST-orderack__entry__2} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 1. Pfadparameter] {#spendint-POST-orderack__table_sd3_lck_ymb__entry__2} | Name | Beschreibung | |-|-| | Modus | Unterstützung des asynchronen und des synchronen Modus für die Drittanbieterintegration. Datentyp: Zeichenfolge Gültige Werte: * async: asynchroner Modus. * sync: synchroner Modus. {#spendint-POST-orderack__ul_td3_lck_ymb} Standard: async | [Tabelle : 2. Abfrageparameter] {#spendint-POST-orderack__table_sd3_lck_ymb} {#spendint-POST-orderack__entry__10} | Name | Beschreibung | |-|-| | customer_id | Erforderlich. Bezeichner für den Kunden. Datentyp: Zeichenfolge Maximale Länge: 100 | | order_number | Erforderlich. Bestellnummer, die der Kunde für diesen Auftrag angegeben hat. Datentyp: Zeichenfolge Maximale Länge: 40 | | sales_order_lines | Liste der Objekte, die die Kundenauftragspositionen mit eindeutigen Aktualisierungen für die Käufe in diesem Auftrag definieren. Datentyp: Array "sales_order_lines":[ { "estimated_arrival_date": "String", "line_number": "String", "sales_order_line_number": "String" } ] | | sales_order_lines.estimated_arrival_date | Voraussichtliches Ankunftsdatum der Bestellung. Datentyp: Zeichenfolge Maximale Länge: 40 Format: JJJJ-MM-TT | | sales_order_lines.line_number | Erforderlich. Bestellpositionsnummer, die vom Kunden für einen bestimmten Kauf generiert wurde. Datentyp: Zeichenfolge Maximale Länge: 40 | | sales_order_lines.sales_order_line_number | Verkaufsauftragspositionsnummer, die vom Lieferanten generiert wurde. Diese Nummer ist nur für Überarbeitungen dieses Kaufs erforderlich. Datentyp: Zeichenfolge Maximale Länge: 40 | | sales_order_number | Nummer oder Wert, die/der vom Lieferanten für diesen Auftrag generiert wird. Datentyp: Zeichenfolge Maximale Länge: 40 | | status_code | Erforderlich. Status des übermittelten Auftrags, der bestätigt, ob der Auftrag erfolgreich erteilt wurde. Datentyp: Zeichenfolge Gültige Werte: * confirmed: Auftrag erfolgreich erteilt. * rejected: Auftrag nicht erteilt. {#spendint-POST-orderack__ul_hdr_tkg_ymb} | | status_message | Nachricht, die an einen Statuscode angehängt ist. Beispielsweise könnte die Nachricht lauten, dass der Auftrag erfolgreich erteilt wurde und im Lieferrückstand ist. Datentyp: Zeichenfolge Maximale Länge: 1.000 | | supplier_id | Erforderlich. Bezeichner für den Reseller oder Lieferanten, bei dem der Kunde Bestellungen aufgeben kann. Datentyp: Zeichenfolge Maximale Länge: 100 | | third_party_import_id | Bezeichner, der es einer Drittpartei ermöglicht, einen Zeichenfolgenwert zu übergeben, um einen Satz importierter Daten eindeutig zu identifizieren. Datentyp: Zeichenfolge Maximale Länge: 100 | [Tabelle : 3. Anforderungstextparameter (XML oder JSON)] ## Header Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder sie gelten für diese Aktion auf besondere Weise. {#spendint-POST-orderack__entry__34}{#spendint-POST-orderack__accept-RESTAPI} | Kopfzeile | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json | [Tabelle : 4. Anforderungsheader] Hinweis: Für Procurement Integration Framework wird nur das Datenformat application/json unterstützt. {#spendint-POST-orderack__entry__38} | Kopfzeile | Beschreibung | |-|-| | Keine | | [Tabelle : 5. Antwort-Header] ## Statuscodes Die folgenden Statuscodes gelten für diese HTTP-Aktion. {#spendint-POST-orderack__table_lml_1qg_ymb__entry__2} | Statuscode | Beschreibung | |-|-| | Erfolg | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. | | Fehler | Nicht erfolgreich. Die Anforderung wurde mit Fehlern verarbeitet. | [Tabelle : 6. Statuscodes] {#spendint-POST-orderack__table_lml_1qg_ymb} ## Parameter des Antwort-Haupttexts (JSON) {#spendint-POST-orderack__section_cq5_1hk_ymb} Diese Antworttextparameter werden bei einer Abfrage im synchronen Modus empfangen.{#spendint-POST-orderack__table_dq5_1hk_ymb__entry__2} | Name | Beschreibung | |-|-| | error_response_body | Beschreibung der Fehler, aufgelistet nach Verkaufsauftragsnummer, Verkaufsauftragspositionsnummer und Fehlermeldung. Datentyp: Array | | error_response_body.error_message | Detaillierte Fehlermeldung. Datentyp: Zeichenfolge | | status_code | Antwortstatus wie „Erfolg" oder „Fehler". Datentyp: Zeichenfolge | [ ] {#spendint-POST-orderack__table_dq5_1hk_ymb} ## cURL-Anforderung curl "https://instance.service-now.com/api/sn_spend_intg/spendint/orderack" \ --request POST \ --header "Accept:application/json" \ --user 'username':'password' {"root":[{ "customer_id": "ACME CORP", "supplier_id": "SUP-123456", "third_party_import_id": "undefined", "order_number": "PO08903323", "sales_order_number": "SO03323212", "status_code": "CONFIRMED", "status_message": "BACKORDERED", "sales_order_lines":[ { "line_number": "POL6789876", "sales_order_line_number": "SOL5678909", "estimated_arrival_date": "YYYY-MM-DD" } ] } ]} Mögliche Antworten: // Success response: { "result": { "response": "success" } } // Error response: { "result": { "response": [ { "customer_id": "ACME CORP", "supplier_id": "SUP-123456", "third_party_import_id": "undefined", "status_code": "failure", "error_response_body": [ { "sales_order_number": "SO03323212", "sales_order_line_number": "SOL5678909", "error_message": "Field Value empty/Formatting issue Purchase order number\nField Value empty/Formatting issue Purchase order line number\n" } ] } ] } }