Spendint API - POST /sn_spend_intg/spendint/availability

Aktualisiert die Verfügbarkeit für Lieferantenproduktdatensätze.

Wenn Lieferantenproduktdatensätze verfügbar sind, verwendet die API die Produkt-SKU für die Suche nach einem vorhandenen Lieferantenprodukt. Wenn ein passendes Lieferantenprodukt vorhanden ist, wird das entsprechende Feld available_units aktualisiert. Wenn kein passendes Lieferantenprodukt gefunden wird, wird eine Fehlermeldung generiert, die besagt, dass das Produkt, für das Sie die Verfügbarkeit aktualisieren möchten, nicht vorhanden ist.

Statustabellen

Um den Status der Anforderung zum Aktualisieren der Verfügbarkeit zu erfahren, führen Sie mit der Tabelle „REST-APIs“ einen REST-Aufruf in der ServiceNow-Datenbank durch. Die Antwort der API listet die Datensätze auf, bei denen die Anforderung zum Aktualisieren der Verfügbarkeit fehlgeschlagen ist. Um eine Antwort zur Aktualisierung der Verfügbarkeit zu erhalten, fragen Sie die Tabelle „Verfügbarkeitsfehler“ mit dem folgenden Parameter ab:

sysparm_query=outbound_error.supplier_id=<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

/api/sn_spend_intg/spendint/availability

Unterstützte Anforderungsparameter

Tabelle : 1. Pfadparameter

Name	Beschreibung
Keine

Tabelle : 2. Abfrageparameter

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. Standard: async

Tabelle : 3. Anforderungstextparameter (XML oder JSON)

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 der Objekte, die die zu aktualisierenden Produkte definieren. Jede Transaktion hat ein Limit von 1.000 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
products.sku	Erforderlich. Nummer, die von einem Lieferanten generiert wird und ein Produkt eindeutig identifiziert, das von diesem Lieferanten verkauft wird. Datentyp: Zeichenfolge Maximale Länge: 100
products.unit	Erforderlich. Einheit oder Tarif für den Verkauf dieses Produktes durch den Lieferanten. Beispiele: Stücke, Stunden usw. Datentyp: Zeichenfolge Maximale Länge: 100
supplier_id	Bezeichner für den Reseller 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

Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder sie gelten für diese Aktion auf besondere Weise.

Tabelle : 4. Anforderungsheader

Kopfzeile	Beschreibung
Akzeptieren	Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json

Hinweis:

Für Procurement Integration Framework wird nur das Datenformat application/json unterstützt.

Tabelle : 5. Antwort-Header

Kopfzeile	Beschreibung
Keine

Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion.

Tabelle : 6. Statuscodes

Statuscode	Beschreibung
Erfolg	Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet.
Fehler	Nicht erfolgreich. Die Anforderung wurde mit Fehlern verarbeitet.

Parameter des Antwort-Haupttexts (JSON)

Diese Antworttextparameter werden bei einer Abfrage im synchronen Modus empfangen.

Name	Beschreibung
error_response_body	Beschreibung der Fehler, aufgelistet nach SKU und Fehlermeldung. Datentyp: Array
error_response_body.error_message	Detaillierte Fehlermeldung. Datentyp: Zeichenfolge
status_code	Antwortstatus wie „Erfolg“ oder „Fehler“. Datentyp: Zeichenfolge

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"
                    }
                ]
            }
        ]
    }
}