--- 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 -- POST /sn_spend_intg/Spendint/Availability # Spendint-API -- POST /sn_spend_intg/Spendint/Availability {#ariaid-title1} * Freigeben Version: Yokohama * * Aktualisiert 30. Januar 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer Aktualisiert die Verfügbarkeit für Lieferantenproduktdatensätze. Wenn Lieferantenproduktdatensätze verfügbar sind, verwendet die API die Produkt-SKU, um ein vorhandenes Lieferantenprodukt zu finden. Wenn ein übereinstimmendes Lieferantenprodukt vorhanden ist, das entsprechende Available_units Feld wird aktualisiert. Wenn kein übereinstimmendes Lieferantenprodukt gefunden wird, wird eine Fehlermeldung generiert, die angibt, dass das Produkt, für das Sie die Verfügbarkeit aktualisieren möchten, nicht vorhanden ist. ## Statustabellen {#spendint-POST-availability__section_hrm_qts_knb} Um den Status der Verfügbarkeitsanforderung zu erfahren, führen Sie einen REST-Aufruf in durch ServiceNowDatenbank, die verwendet Tabelle REST-API. Die Antwort der API listet die Datensätze auf, bei denen die Aktualisierungsverfügbarkeitsanforderung fehlgeschlagen ist. Um eine Verfügbarkeitsantwort zu aktualisieren, fragen Sie die Tabelle „Verfügbarkeitsfehler" 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-availability__section_alq_xd2_dmb} /api/sn_spend_intg/spendint/availability ## Unterstützte Anforderungsparameter {#spendint-POST-availability__entry__2} | Name | Beschreibung | |-|-| | Keine | | [Tabelle : 1. Pfad-Parameter] {#spendint-POST-availability__table_rdf_2ck_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-availability__ul_hdr_tkg_ymb} Standard: Asynchron | [Tabelle : 2. Abfrageparameter] {#spendint-POST-availability__table_rdf_2ck_ymb} {#spendint-POST-availability__entry__10} | Name | Beschreibung | |-|-| | Catalog_ID | Erforderlich. Bezeichner für den Kataloginhalt, der von einem Kunden erworben werden kann. Datentyp: Zeichenfolge Maximale Länge: 100 | | customer_id | Erforderlich. Bezeichner für den Kunden. Datentyp: Zeichenfolge Maximale Länge: 100 | | products | Liste von Objekten, die die zu aktualisierenden Produkte definieren. Jede Transaktion hat ein Limit von 1000 Produkten. Datentyp: Array "products": [ { "available_units": "String", "sku": "String", "unit": "String" } ] | | Products.available_units | Erforderlich für Produkte, die auf Lager gehalten werden. Anzahl der für dieses Produkt verfügbaren Einheiten. Datentyp: Zeichenfolge Maximale Länge: 40 | | Produkte.SKU | Erforderlich. Nummer, die von einem Lieferanten generiert wird, der ein von diesem Lieferanten verkauftes Produkt eindeutig identifiziert. Datentyp: Zeichenfolge Maximale Länge: 100 | | Produkte.Einheit | Erforderlich. Einheit oder Rate, zu der das Produkt vom Lieferanten verkauft wird. Beispiel: Teile, Stunden usw. Datentyp: Zeichenfolge Maximale Länge: 100 | | Supplier_ID | Bezeichner für den Händler oder Lieferanten, bei dem der Kunde Bestellungen aufgeben kann. Datentyp: Zeichenfolge Maximale Länge: 100 | | third_party_import_id | Ermöglicht einer Drittpartei, einen Zeichenfolgenwert zu übergeben, 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-availability__entry__28}{#spendint-POST-availability__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-availability__entry__32} | Header | Beschreibung | |-|-| | Keine | | [Tabelle : 5. Antwort-Header] ## Statuscodes Die folgenden Statuscodes gelten für diese HTTP-Aktion. {#spendint-POST-availability__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-availability__table_lml_1qg_ymb} ## Antworttext-Parameter (JSON) {#spendint-POST-availability__section_usm_1hk_ymb} Diese Antworttextparameter werden empfangen, wenn sie im synchronen Modus abgefragt werden.{#spendint-POST-availability__table_vsm_1hk_ymb__entry__2} | Name | Beschreibung | |-|-| | Error_response_body | Beschreibung der Fehler, aufgeführt nach SKU und Fehlermeldung. Datentyp: Array | | error_response_body.error_message | Detaillierte Fehlermeldung. Datentyp: Zeichenfolge | | status_code | Antwortstatus wie „Erfolg" oder „Fehler". Datentyp: Zeichenfolge | [ ] {#spendint-POST-availability__table_vsm_1hk_ymb} ## Curl-Anforderung curl "https://instance.servicenow.com/api/sn_spend_intg/spendint/availability" \ --request POST \ --header "Accept:application/json" \ --user 'username':'password' {"root": [{ "customer_id": "AB-1234323", "catalog_id": "ACME CORP", "supplier_id": "SUP-123456", "third_party_import_id": "DEL6789876", "products": [ { "sku": "5578874", "unit": "Each", "available_units": "20" } ] } ]} Mögliche Antworten: // Success response: { "result": { "response": "success" } } Error response: { "result": { "response": [ { "customer_id": "AB-1234323", "supplier_id": "SUP-123456", "third_party_import_id": "DEL6789876", "status_code": "failure", "error_response_body": [ { "sku": "5578874", "error_message": "The product for which you are trying to update availability does not exist\nField Value empty/Formatting issue Unit\n" } ] } ] } }