--- sourceDocument: Yokohama – Finanzen und Lieferkette sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/source-to-pay-operations Release : - yokohama ft:locale : - de-DE ft:publication_title : - Yokohama – Finanzen und Lieferkette ft:clusterId : - stpop bundleId : - stpop workflow : - Creator --- # Spendint-API: /sn_spend_intg/Spendint/Shipping VERÖFFENTLICHEN # Spendint-API: /sn_spend_intg/Spendint/Shipping VERÖFFENTLICHEN {#ariaid-title1} * Freigeben Version: Yokohama * * Aktualisiert 30. Januar 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 Minuten Lesedauer Verwenden Sie diesen Endpunkt, um Aktualisierungen für Käufe von Drittparteien zu akzeptieren. Wenn Sie Daten erhalten, müssen Sie die Versanddaten mit einer Bestellposition abgleichen, indem Sie die Verkaufsauftragspositionsnummer verwenden. Sie können die Nachverfolgungsnummer verwenden, um einen vorhandenen Versanddetaildatensatz zu suchen Das sich auf die Bestellposition bezieht. Wenn kein solcher Datensatz gefunden wird, erstellen Sie einen neuen Versanddetaildatensatz. Wenn für die Versanddaten keine Bestellung oder Bestellposition vorhanden ist, wird eine Fehlermeldung angezeigt, die angibt, dass die Bestellung für diese Sendung nicht vorhanden ist. Hinweis: Wenn sich die Bestellung und die Bestellpositionen im Status „Ausstehende Übermittlung" befinden und der Kundenauftrag und die Kundenauftragspositionen nicht ausgefüllt sind, ist die Versand- und Rechnungsbuchung durch den Drittpartei-Händler nicht zulässig. Dies ist nur zulässig, wenn der Status der Bestellung und Bestellpositionen „bestellt" lautet. Außerdem gibt es keine sequenzielle Einschränkung für Versand- und Rechnungsbuchung. ## Statustabellen {#spendint-POST-shipment__section_hrm_qts_knb} Um den Status der Versandanforderung zu erfahren, führen Sie einen REST-Anruf in durch ServiceNowDatenbank, die verwendet Tabelle REST-API. Die Antwort der API listet die Datensätze auf, bei denen das Versandupdate fehlgeschlagen ist. Um eine Versandantwort zu erhalten, fragen Sie die Tabelle „Versandfehler" mit dem folgenden Parameter ab: `Sysparm_query=outbound_error.Supplier_ID=^outbound_error.State=20` Die Details zur Kunden-ID, Lieferanten-ID, zum Fehlertyp, zur eindeutigen Importsatz-ID und zum Status finden Sie in der Tabelle „ausgehender Status", der übergeordneten Fehlertabelle. ## URL-Format {#spendint-POST-shipment__section_ejb_b22_dmb} /api/sn_spend_intg/Spendint/shipment ## Unterstützte Anforderungsparameter {#spendint-POST-shipment__table_hqb_pfp_gmb__entry__2} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 1. Pfad-Parameter] {#spendint-POST-shipment__table_hqb_pfp_gmb} {#spendint-POST-shipment__table_igy_fck_ymb__entry__2} | Name | Beschreibung | |-|-| | Modus | Unterstützung für asynchrone und synchrone Modi für die Integration von Drittparteien. Datentyp: Zeichenfolge Gültige Werte: * Asynchron: Asynchroner Modus. * Synchronisierung: Synchroner Modus. {#spendint-POST-shipment__ul_hdr_tkg_ymb} Standard: Asynchron | [Tabelle : 2. Abfrageparameter] {#spendint-POST-shipment__table_igy_fck_ymb} {#spendint-POST-shipment__entry__10} | Name | Beschreibung | |-|-| | customer_id | Bezeichner für den Kunden. Datentyp: Zeichenfolge Maximale Länge: 100 | | order_number | Erforderlich. Bestellnummer, die vom Kunden für diese Bestellung bereitgestellt wird. Datentyp: Zeichenfolge Maximale Länge: 40 | | Sales_order_number | Erforderlich. Nummer oder Wert, der vom Lieferanten für diesen Auftrag generiert wird. Datentyp: Zeichenfolge Maximale Länge: 40 | | Shipment_lines | Liste der Versandpositionen, die die Seriennummer, IMEI-Nummer und Asset-Tag-Details der Assets enthalten können. Datentyp: Array "shipment_lines": [ { "actual_shipment_date": "String", "estimated_arrival_date": "String", "line_number": "String", "planned_shipment_date": "String", "product_details": [Array], "sales_order_line_number": "String", "shipping_address": {Object}, "shipping_carrier": "String", "shipment_quantity": "String", "ship_to": "String", "tracking_number": "String" } ] | | shipment_lines.actual_shipment_date | Datum, an dem die Sendung den Standort des Lieferanten verlässt. Datentyp: Zeichenfolge Maximale Länge: 40 FORMAT: JJJJ-MM-TT | | shipment_lines.estimated_arrival_date | Datum, an dem die Sendung voraussichtlich am angegebenen Standort ankommt. Datentyp: Zeichenfolge Maximale Länge: 40 FORMAT: JJJJ-MM-TT | | Shipment_lines.line_number | Erforderlich. Bestellpositionsnummer, die vom Kunden für eine bestimmte Bestellung generiert wird. Datentyp: Zeichenfolge Maximale Länge: 40 | | shipment_lines.planned_shipment_date | Datum, an dem die Sendung den Standort des Lieferanten verlassen soll. Datentyp: Zeichenfolge Maximale Länge: 40 FORMAT: JJJJ-MM-TT | | shipment_lines.product_details | Liste von Objekten, die die Details zu den versendeten Produkten definieren. Zu den Optionen gehören die Seriennummer, die IMEI-Nummer und Details zum Asset-Tag. Datentyp: Array "product_details": [ { "asset_tag": "String", "imei": "String", "serial_number": "String" } ] | | shipment_lines.product_details.asset_tag | Asset-Tag des versendeten Produkts. Datentyp: Zeichenfolge Maximale Länge: 100 | | shipment_lines.product_details.imei | IMEI-Nummer des versendeten Produkts. Datentyp: Zeichenfolge Maximale Länge: 100 | | shipment_lines.product_details.serial_number | Erforderlich. Seriennummer des versendeten Produkts. Datentyp: Zeichenfolge Maximale Länge: 100 | | shipment_lines.sales_order_line_number | Vertriebsauftragspositionsnummer, die vom Lieferanten generiert wird. Diese Nummer ist nur für Überarbeitungen dieses Einkaufs erforderlich. Datentyp: Zeichenfolge Maximale Länge: 40 | | Shipment_lines.Shipping_address | Adresse, an die die Produkte versendet werden. Datentyp: Objekt "shipping_address": { "city": "String", "country": "String", "name": "String", "state": "String", "street": "String", "zip_code": "String" } | | shipment_lines.shipping_address.city | Name der Stadt, an die die Produkte versendet werden. Datentyp: Zeichenfolge Maximale Länge: 1000 | | shipment_lines.shipping_address.country | Land, in das die Produkte versendet werden. Datentyp: Zeichenfolge Maximale Länge: 40 | | shipment_lines.shipping_address.name | Name des Kunden, an den die Produkte versendet werden. Datentyp: Zeichenfolge Maximale Länge: 1000 | | Shipment_lines.Shipping_address.State | Bundesland, an den die Produkte gesendet werden. Datentyp: Zeichenfolge Maximale Länge: 1000 | | Shipment_lines.Shipping_address.Street | Name der Straße, an die die Produkte versendet werden. Datentyp: Zeichenfolge Maximale Länge: 1000 | | shipment_lines.shipping_address.zip_code | Postleitzahl oder Postleitzahl, an die die Produkte gesendet werden. Datentyp: Zeichenfolge Maximale Länge: 40 | | Shipment_lines.shipment_quantity | Erforderlich. Anzahl der Produkte, die als physische Waren versendet werden. Die Nummer muss die Menge der Produkte enthalten, die sich in der Sendung befinden. Datentyp: Zeichenfolge Maximale Länge: 40 | | Shipment_lines.Shipping_Carrier | Versandunternehmen, das das Produkt an den angegebenen Standort liefert, z. B. FedEx, UPS, USPS usw. Datentyp: Zeichenfolge Maximale Länge: 100 | | Shipment_lines.Ship_to | Name des Empfängers, an den die Produkte versendet werden. Datentyp: Zeichenfolge Maximale Länge: 100 | | Sendungszeilen.Tracking_number | Nachverfolgungsnummer, die vom Versandunternehmen für den gesamten oder einen Teil des Einkaufs bereitgestellt wird. Datentyp: Zeichenfolge Maximale Länge: 100 | | Supplier_ID | Erforderlich. Bezeichner für den Händler oder Lieferanten, bei dem der Kunde Bestellungen aufgeben kann. Datentyp: Zeichenfolge Maximale Länge: 100 | | Supplier_shipment_number | Erforderlich. Identifikationsnummer, die für diese Sendung generiert wird. Normalerweise wird diese Zahl von einem ERP-System (Enterprise Resource Planning) oder einem Auftragsnachverfolgungssystem generiert. Datentyp: Zeichenfolge Maximale Länge: 100 | | third_party_import_id | Bezeichner, mit dem eine Drittpartei einen Zeichenfolgenwert übergeben kann, um einen Satz importierter Daten eindeutig zu identifizieren. Datentyp: Zeichenfolge Maximale Länge: 100 | [Tabelle : 3. Anforderungstext-Parameter (XML oder JSON)] ## Header Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. {#spendint-POST-shipment__entry__66}{#spendint-POST-shipment__accept-RESTAPI} | Header | Beschreibung | |-|-| | Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json | [Tabelle : 4. Anforderungskopfzeilen.] Hinweis: Nur die application/jsonDas Datenformat wird für das Beschaffungsintegrations-Framework unterstützt. {#spendint-POST-shipment__entry__70} | Header | Beschreibung | |-|-| | Keine | | [Tabelle : 5. Antwort-Header] ## Statuscodes Die folgenden Statuscodes gelten für diese HTTP-Aktion. {#spendint-POST-shipment__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-shipment__table_lml_1qg_ymb} ## Antworttext-Parameter (JSON) {#spendint-POST-shipment__section_hgg_bhk_ymb} Diese Antworttextparameter werden empfangen, wenn sie im synchronen Modus abgefragt werden.{#spendint-POST-shipment__table_igg_bhk_ymb__entry__2} | Name | Beschreibung | |-|-| | Error_response_body | Beschreibung der Fehler, aufgeführt nach Vertriebsauftragspositionsnummer, Verkaufsauftragsnummer, Versandnummer des Lieferanten und Fehlermeldung. Datentyp: Array | | error_response_body.error_message | Detaillierte Fehlermeldung. Datentyp: Zeichenfolge | | status_code | Antwortstatus wie „Erfolg" oder „Fehler". Datentyp: Zeichenfolge | [ ] {#spendint-POST-shipment__table_igg_bhk_ymb} ## Curl-Anforderung curl "https://instance.service-now.com/api/sn_spend_intg/spendint/shipment" \ --request POST \ --header "Accept:application/json" \ --user 'username':'password' {"root":[{ "customer_id" : "ACME CORP", "supplier_id" : "SUP-123456", "third_party_import_id": "DEL2134324", "supplier_shipment_number" : "TN-YU67898723", "order_number": "PO0001002", "sales_order_number": "SO00223002", "shipment_lines": [ { "line_number": "POL0001005", "sales_order_line_number": "SOL0231325", "shipment_quantity": "4", "shipping_carrier": "FedEx", "tracking_number": "E-901290092", "shipping_address": { "name" : "1640 Camino Del Rio North #202, San Diego,CA", "street" : "1640 Camino Del Rio North", "city" : "San Diego", "state" : "CA", "zip_code" : "92108-1512", "country" : "US" }, "ship_to": "John doe", "planned_shipment_date": "YYYY-MM-DD", "actual_shipment_date": "YYYY-MM-DD", "estimated_arrival_date": "YYYY-MM-DD", "product_details": [ { "serial_number": "FL1234-23242319001", "imei": "2134890294", "asset_tag": "" },{ "serial_number": "FL1234-23242319110", "imei": "245499003", "asset_tag": "" } ] } ] } ]} Mögliche Antworten: // Success response: { "result": { "response": "success" } } // Error response: { "result": { "response": [ { "customer_id": "ACME CORP", "supplier_id": "SUP-123456", "third_party_import_id": "DEL2134324", "status_code": "failure", "error_response_body": [ { "sales_order_line_number": "SOL0231325", "sales_order_number": "SO00223002", "supplier_shipment_number": "TN-YU67898723", "error_message": "The purchase order for this shipment does not exist\nThe purchase order line for this shipment does not exist\n" } ] } ] } }