---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Spendint-API

# Spendint-API {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 27 Minuten Lesedauer

Die Ausgaben Die API stellt Endpunkte bereit, die den Katalog, den Preis, die Verfügbarkeit, die Bestellung, den Versand, und Rechnungsinformationen von einer Drittpartei an ServiceNowInstanz. Diese API ist Teil von Framework für Source-to-Pay-IntegrationAnwendung.
Diese API erfordert das Beschaffungsintegrations-Framework (com.Glide.sn_spend_intg) und wird in bereitgestellt `sn_Ausgaben_intg `Namespace. Diesbezügliche Informationen finden Sie unter [Procurement File Transfer Framework](https://www.servicenow.com/docs/access?context=procurement-file-transfer-framework&version=yokohama&pubname=yokohama-source-to-pay-operations&ft:locale=en-US).

Um auf diese API zuzugreifen, müssen Sie über die Rolle „sn_spend_intg.procurement_integrator" verfügen.

## Spendint-API -- /sn_spend_intg/Spendint/catalog VERÖFFENTLICHEN {#ariaid-title2}

Ermöglicht Lieferanten das Veröffentlichen mehrerer Kataloge zum Erstellen von Lieferantenprodukten, Modellprodukten, Verträgen und Preisdatensätzen.
In Katalog API-Integration: Wenn Sie Daten aus einem Drittparteikatalog erhalten, können Sie:

1. Erstellen Sie neue Drittparteikategorien, und ordnen Sie diese Kategorien Modellkategorien zu.
   * Falls verfügbar, verwenden Sie den Standardcode der Vereinten Nationen für Produkte und Services (UNSPSC) und dann den Kategorienamen.
   * Wenn UNSPSC nicht verfügbar ist, verwenden Sie nur den Kategorienamen.
   {#spendint-POST-catalog__ul_jds_5yl_kmb}
2. Nachdem Sie eine Drittparteikategorie einer Modellkategorie zugeordnet haben, verwenden Sie die Herstellerteilenummer (MPN), um ein vorhandenes Produktmodell zu finden, falls eines verfügbar ist.
   1. Wenn ein Produktmodell für die MPN gefunden wird, aktualisieren Sie das Produktmodell mit allen Änderungen, und erstellen oder aktualisieren Sie dann alle Lieferantenprodukte, die sich auf das Produktmodell beziehen.
   2. Wenn für die MPN kein Produktmodell vorhanden ist, gehen Sie wie folgt vor:
      1. Eine Produktmodellklasse ist normalerweise in der Modellkategorie verfügbar, auf die die Drittparteikategorie für das Produkt verweist. Verwenden Sie diese Produktmodellklasse, um die Produktmodelltabelle abzurufen, in der das Produktmodell erstellt werden soll, z. B. Hardware, Software, Verbrauchsgüter und so weiter. Wenn keine Produktmodellklasse verfügbar ist, erstellen Sie das Produktmodell in der Basisproduktmodelltabelle.
      2. Nachdem die richtige Produktmodellklasse identifiziert wurde, erstellen Sie wie folgt ein neues Produktmodell in der richtigen Klasse:
         * Hersteller, Herausgeber oder Anbieter müssen dem Hersteller im Produktmodell zugeordnet werden.
         * Der Produktname aus der API muss dem Namen im Produktmodell zugeordnet werden.
         * MPN aus der API muss die Modellnummer aktualisieren.
         * Die Produktbeschreibung aus der API muss die Beschreibung im Produktmodell aktualisieren.
         * Die Modellkategorie muss mit der Produktkategorie aktualisiert werden, auf die im Datensatz der Drittpartei-Kategorie verwiesen wird.
         * Die Produktkategorie muss mit der Produktkategorie aktualisiert werden, auf die im Datensatz der Drittpartei-Kategorie verwiesen wird.
         * Wenn die Ersatzprodukte in der API Werte enthalten, erstellen Sie die Ersatzproduktdatensätze zwischen dem aktuellen Produktmodell und den anderen Produktmodellen.
         * Wenn die kompatiblen Produkte in der API Werte enthalten, erstellen Sie die kompatiblen Produktdatensätze zwischen dem aktuellen Produktmodell und den anderen Produktmodellen.
         * Produktattribute aus der API müssen in der zugehörigen Liste „Produktattribute" für das Produktmodell erstellt oder aktualisiert werden.
         {#spendint-POST-catalog__ul_wvr_jdk_mnb}
      {#spendint-POST-catalog__ol_trv_qck_mnb}
   {#spendint-POST-catalog__ol_rtb_hck_mnb}
3. Wenn ein Produktmodell verfügbar ist, verwenden Sie die Teilenummer des Lieferanten, um die Lieferantenprodukte zu erstellen oder zu aktualisieren, die sich auf das Produktmodell beziehen.
{#spendint-POST-catalog__ol_oqw_3dd_dmb}

### Drittpartei-Zuordnung {#spendint-POST-catalog__section_w4v_nfn_n4b}

Verwenden Sie die folgenden Tabellen, um die Zuordnungen von Drittpartei-Kategorien, -Modellen und -Einheiten durchzuführen:

* Drittparteikategorien: Speichert alle Drittparteikategoriedatensätze für den ShoppingHub-Administrator, um sie internen vorhandenen Modellkategorien zuzuordnen.
* Drittpartei-Modellzuordnungen: Speichert alle Zuordnungsinformationen zwischen Produktmodellen und Drittpartei-Modellkategorien.
* Drittpartei-Einheiten: Speichert alle Drittpartei-Einheitsdatensätze für den ShoppingHub-Administrator, um sie den Produkteinheiten des Lieferanten zuzuordnen.
* Zuordnungen von Drittpartei-Einheiten: Speichert alle Zuordnungsinformationen zwischen Produktmodellen und Drittpartei-Einheiten.

{#spendint-POST-catalog__ul_mgg_dbt_knb}  
Hinweis:  
Ein Drittpartei-Integrationsprodukt wird automatisch veröffentlicht, wenn sowohl die Drittparteikategorie als auch die Drittparteieinheit ordnungsgemäß zugeordnet sind.

### Verkaufsdaten des Lieferantenprodukts {#spendint-POST-catalog__section_mxc_phn_n4b}

Ein Lieferantenprodukt wird eingestellt und nicht mehr im Katalog veröffentlicht, wenn es sein Verkaufsenddatum erreicht hat. Die Startdatum des Vertriebs Und Verkaufsenddatum Felder im Formular „Lieferantenprodukt" werden über die Drittpartei-Integration aus ausgefüllt Katalog API.

### Statustabellen {#spendint-POST-catalog__section_hrm_qts_knb}

Um den Status der Massenproduktimportanforderung 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 Massenimportanforderung fehlgeschlagen ist. Für die Antwort auf Massenproduktimport fragen Sie die Katalogfehlertabelle mit dem folgenden Parameter ab:

`Sysparm_query=outbound_error.Supplier_ID=<supplier_id>^outbound_error.State=20`

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

/api/sn_spend_intg/spendint/catalog

### Unterstützte Anforderungsparameter

{#spendint-POST-catalog__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 1. Pfad-Parameter]

{#spendint-POST-catalog__entry__6}

| 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-catalog__ul_hdr_tkg_ymb} Standard: Asynchron |
[Tabelle : 2. Abfrageparameter]

{#spendint-POST-catalog__entry__10}

| Name | Beschreibung |
|-|-|
| customer_id | Bezeichner für den Kunden. Datentyp: Zeichenfolge Maximale Länge: 100 |
| Catalog_ID | Bezeichner für den Kataloginhalt, der von einem Kunden erworben werden kann. Datentyp: Zeichenfolge Maximale Länge: 100 |
| products | Liste von Objekten, die Produkte definieren, die erstellt oder aktualisiert werden sollen. Jede Transaktion hat ein Limit von 1000 Produkten. Datentyp: Array "products": [ { "available_units": "String", "available_for_country": [Array], "bundled_components": [Array], "contract_agreement": {Object}, "delivery_time": "String", "images": [Array], "manufacturer": "String", "mpn": "String", "parent_bundle": "String", "product_attributes": {Object}, "product_category_name": "String", "product_description": "String", "product_name": "String", "sku": "String", "unit": "String", "unspsc": "String", } ] |
| Products.available_units | Erforderlich für Produkte, die auf Lager gehalten werden. Dieser Wert gibt die Menge der Einheiten an, die für dieses Produkt verfügbar sind. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Products.available_for_Country | Liste der Ländercodes, in denen das Lieferantenprodukt gekauft werden kann. Wenn kein Land angegeben ist, kann ein Anwender aus einem beliebigen Land das Produkt kaufen. Datentyp: Array "available_for_country": ["US","IN","GB"] |
| Products.Bundled_components | Gilt nur für Szenarien beim Senden eines Produktpakets als Teil der Katalog-Nutzlast und gilt nur für die Nutzlasten des übergeordneten Pakets. Dieser Wert enthält den Verweis auf die untergeordneten Paketkomponenten. Die Liste der MPN und Mengen für die untergeordneten Paketkomponenten werden hier verwaltet. Hinweis: Da dieselbe untergeordnete Paketkomponente innerhalb eines Pakets mehrmals hinzugefügt werden kann, ist die eingegebene Menge das Unterscheidungsmerkmal zwischen denselben untergeordneten Paketkomponenten. Die untergeordneten Paketkomponenten und ihre Details (MPN und Mengen) müssen demselben Lieferanten zugeordnet werden. Datentyp: Array "bundled_components": [ { "mpn": "String", "quantity": "String" } ] |
| Products.Contract_Agreement | Details des Vertrags für ein Produkt. Hinweis: Dies ist für untergeordnete Bündelkomponenten nicht erforderlich. Datentyp: Objekt "contract_agreement": { "contract_end_date": "String", "contract_number": "String", "contract_start_date": "String", "negotiated_currency ": "String", "negotiated_price": "String" } |
| products.contract_agreement.contract_end_date | Datum, an dem die Vertragsbedingung endet. Datentyp: Zeichenfolge Maximale Länge: 40 FORMAT: JJJJ-MM-TT |
| Products.Contract_Agreement.Contract_number | Erforderlich. Nummer des aktiven Vertrags, der dem Produkt zugeordnet ist. Datentyp: Zeichenfolge Maximale Länge: 100 |
| products.contract_agreement.contract_start_date | Datum, an dem die Vertragslaufzeit beginnt. Datentyp: Zeichenfolge Maximale Länge: 40 FORMAT: JJJJ-MM-TT |
| Products.Contract_Agreement.closed_currency | Erforderlich. Währung des ausgehandelten Preises. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Products.Contract_Agreement.closed_price | Erforderlich. Stückpreis eines Produkts, wie durch einen Vertrag mit dem Lieferanten oder Wiederverkäufer ausgehandelt. Datentyp: Zeichenfolge Maximale Länge: 40 |
| products.delivery_time | Geschätzte Anzahl der Tage, die für den Versand eines Produkts an den Kunden erforderlich sind. Dieser Wert muss die Anzahl der Tage darstellen und eine ganze Ganzzahl sein. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Produkte.Bilder | Liste der Zeichenfolgen, die die Bild-URLs für das Lieferantenprodukt angeben. Datentyp: Array |
| Produkte.Hersteller | Erforderlich. Unternehmen, das das Produkt herstellt, veröffentlicht oder bereitstellt. Dies ist nicht der Lieferant oder Wiederverkäufer des Produkts. Datentyp: Zeichenfolge Maximale Länge: 100 |
| Produkte.mpn | Erforderlich. Bezeichner für ein Produkt, das vom Hersteller, Herausgeber oder Anbieter bereitgestellt wird. Hinweis: Dies ist für übergeordnete Händlerpakete nicht erforderlich, wenn der SKU-Wert verfügbar ist. Datentyp: Zeichenfolge Maximale Länge: 100 |
| Products.parent_Bundle | Gilt nur für Szenarien beim Senden eines Produktpakets als Teil der Katalognutzlast und gilt nur für die Nutzlasten der untergeordneten Paketkomponente. Im Falle einer untergeordneten Bündelkomponente wird hier der Verweis auf das übergeordnete Element beibehalten. Die übergeordneten MPN- und SKU-Werte werden ebenfalls hier festgelegt. Datentyp: Zeichenfolge Maximale Länge: 100 |
| products.product_attributes | Liste der Schlüssel-Wert-Paare, die Produktattribute definieren, z. B. `„Farbe": „Leerzeichen Grau" `. Mehrere Attribute für ein Produkt sind zulässig. Allerdings sollten nur die Attribute, die sich auf die Preisgestaltung oder Lagerverfügbarkeit auswirken, über die API bereitgestellt werden. Datentyp: Objekt |
| products.product_category_name | Erforderlich. Name, den Sie eingeben, wenn Sie nicht festlegen unspscEigenschaft. Dieser Name ist die Kategorie, zu der ein Produkt gehört. Dieser Kategoriename kann in einem Commerce-Szenario verwendet werden, um für das Produkt einzukaufen. Beispielsweise könnte ein Steckdosenprodukt zu einer Bürogerätekategorie gehören. Datentyp: Zeichenfolge Maximale Länge: 100 |
| products.product_description | Vollständige Beschreibung des Produkts, das einem Käufer innerhalb einer Commerce-Experience angezeigt wird. Hinweis: Es wird empfohlen, dass der Lieferant hier so beschreibend wie möglich ist, insbesondere für Produktpaketkatalogelemente, bei denen untergeordnete Paketkomponenten vorhanden sind. Datentyp: Zeichenfolge Maximale Länge: 65000 |
| products.product_name | Erforderlich. Name des Produkts. Datentyp: Zeichenfolge Maximale Länge: 1000 |
| Produkte.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 |
| Produkte.Einheit | Erforderlich. Einheit oder Rate, zu der das Produkt vom Lieferanten verkauft wird. Beispiel: Teile, Stunden usw. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Produkte.unspsc | Erforderlich. Bezeichner, den Sie eingeben, wenn Sie nicht festlegen product_category_nameEigenschaft. Dieser Bezeichner ist der UNSPSC für die Kategorie, zu der ein Produkt gehört. Beispielsweise ist der UNSPSC-Code 43210000 der Bezeichner für die Produktkategorie Computer. 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 |
| 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-catalog__entry__64}{#spendint-POST-catalog__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-catalog__entry__68}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion.
{#spendint-POST-catalog__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-catalog__table_lml_1qg_ymb}

### Antworttext-Parameter (JSON)

Diese Antworttextparameter werden empfangen, wenn sie im synchronen Modus abgefragt werden.{#spendint-POST-catalog__entry__78}

| Name | Beschreibung |
|-|-|
| Error_response_body | Beschreibung der Fehler, aufgelistet nach SKU, mpn 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.service-now.com/api/sn_spend_intg/spendint/catalog" \
    --request POST \
    --header "Accept:application/json" \
    --user 'username':'password'
    {"root": [{
      "customer_id": "AB-1234323",
      "catalog_id": "ACME CORP-12347898",
      "supplier_id": "SUP-123456",
      "third_party_import_id": "DELL1234567",
      "products": [
        {
          "product_name": "Apple MacBook Pro 13 Core i7",
          "mpn": "Z0WQ-20004301931",
          "sku": "55788741",
          "manufacturer": "Apple",
          "product_category_name": "Computer",
          "parent_bundle": "920-0045362002",
          "bundled_components": {
            "mpn": "Z0WQ-20004301931",
            "quantity": "4",
           },
          "unspsc": "43211500",
          "product_description": "Apple MacBook Pro 13 Core i7 2.8GHz 16GB 512GB - Touch Bar - Space Gray",
          "product_attributes": {
            "Color": "Space Grey",
            "RAM": "16GB",
            "Screen Size": "13inch"
          },
          "images": ["http://test123.image1.png", "http://test123.image2.jpeg"],
          "unit": "Each",
          "available_units": "4",
          "available_for_country": ["US","IN","GB"],
          "delivery_time": "4",
          "contract_agreement": {
            "contract_number": "34567892",
            "contract_start_date": "YYYY-MM-DD",
            "contract_end_date": "YYYY-MM-DD",
            "negotiated_price": "456",
            "negotiated_currency ": "USD"
          }
        }
      ]
    }
    ]}

Mögliche Antworten:

    // Success response:
    {
        "result": {
            "response": "success"
        }
    }

    // Error response:
    {
        "result": {
            "response": [
                {
                    "customer_id": "AB-1234323",
                    "supplier_id": "SUP-123456",
                    "third_party_import_id": "DELL1234567",
                    "status_code": "failure",
                    "error_response_body": [
                        {
                            "sku": "55788741",
                            "mpn": "Z0WQ-20004301931",
                            "error_message": "Field Value empty/Formatting issue Negotiated currency \n"
                        }
                    ]
                }
            ]
        }
    }

## Spendint-API -- NACH /sn_spend_intg/Spendint/price {#ariaid-title3}

Aktualisiert alle Preise für Lieferantenproduktdatensätze.
Wenn Preise für Lieferantenproduktdatensätze verfügbar sind, verwendet die API die Produkt-SKU, um ein vorhandenes Lieferantenprodukt zu finden. Wenn ein übereinstimmendes Lieferantenprodukt vorhanden ist, wird der entsprechende Vertragspreis aktualisiert. Wenn kein übereinstimmendes Lieferantenprodukt gefunden wird, wird eine Fehlermeldung generiert, die angibt, dass das Produkt, für das Sie die Preise aktualisieren möchten, nicht vorhanden ist.

### Statustabellen {#spendint-POST-price__section_hrm_qts_knb}

Um den Status der Preisimportanforderung 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 Preisimportanforderung fehlgeschlagen ist. Um eine Preisimportantwort zu erhalten, fragen Sie die Tabelle „Preisfehler" mit dem folgenden Parameter ab:

`Sysparm_query=outbound_error.Supplier_ID=<supplier_id>^outbound_error.State=20`

Sie finden die Details zur Kunden-ID, Lieferanten-ID, Fehlertyp, eindeutiger Importsatz-ID und Status in der Tabelle „ausgehender Status", der übergeordneten Fehlertabelle.

### URL-Format {#spendint-POST-price__section_dtb_zd2_dmb}

/api/sn_spend_intg/Spendint/price

### Unterstützte Anforderungsparameter

{#spendint-POST-price__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 7. Pfad-Parameter]

{#spendint-POST-price__table_bdb_dck_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-price__ul_hdr_tkg_ymb} Standard: Asynchron |
[Tabelle : 8. Abfrageparameter]

{#spendint-POST-price__table_bdb_dck_ymb} {#spendint-POST-price__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 Produkte definieren, die erstellt oder aktualisiert werden sollen. Jede Transaktion hat ein Limit von 1000 Produkten. Datentyp: Array "products": [ { "contract_agreement": {Array}, "sku": "String" } ] |
| Products.Contract_Agreement | Details des Vertrags für ein Produkt. Datentyp: Objekt "contract_agreement": { "contract_end_date": "String", "contract_number": "String", "contract_start_date": "String", "negotiated_currency ": "String", "negotiated_price": "String" } |
| products.contract_agreement.contract_end_date | Datum, an dem die Vertragsbedingung endet. Datentyp: Zeichenfolge Maximale Länge: 40 FORMAT: JJJJ-MM-TT |
| Products.Contract_Agreement.Contract_number | Erforderlich. Nummer des aktiven Vertrags, der dem Produkt zugeordnet ist. Datentyp: Zeichenfolge Maximale Länge: 100 |
| products.contract_agreement.contract_start_date | Datum, an dem die Vertragslaufzeit beginnt. Datentyp: Zeichenfolge Maximale Länge: 40 FORMAT: JJJJ-MM-TT |
| Products.Contract_Agreement.closed_currency | Erforderlich. Währung des ausgehandelten Preises. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Products.Contract_Agreement.closed_price | Erforderlich. Stückpreis eines Produkts, wie durch einen Vertrag mit dem Lieferanten oder Wiederverkäufer ausgehandelt. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Produkte.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 |
| Supplier_ID | Erforderlich. 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 | Bezeichner, mit dem eine Drittpartei einen Zeichenfolgenwert übergeben kann, um einen Satz importierter Daten eindeutig zu identifizieren. Datentyp: Zeichenfolge Maximale Länge: 100 |
[Tabelle : 9. 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-price__entry__36}{#spendint-POST-price__accept-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 10. Anforderungskopfzeilen.]

Hinweis:  
Nur die application/jsonDas Datenformat wird für das Beschaffungsintegrations-Framework unterstützt.
{#spendint-POST-price__entry__40}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 11. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion.
{#spendint-POST-price__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 : 12. Statuscodes]

{#spendint-POST-price__table_lml_1qg_ymb}

### Antworttext-Parameter (JSON) {#spendint-POST-price__section_iy2_1hk_ymb}

Diese Antworttextparameter werden empfangen, wenn sie im synchronen Modus abgefragt werden.{#spendint-POST-price__table_jy2_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-price__table_jy2_1hk_ymb}  

### Curl-Anforderung

    curl "https://instance.service-now.com/api/sn_spend_intg/spendint/price" \
    --request POST \
    --header "Accept:application/json" \
    --user 'username':'password'
    {"root": [{
      "customer_id": "ACME CORP",
      "catalog_id": "AB-1234323",
      "supplier_id": "SUP-123456",
      "third_party_import_id": "DEL789876",
      "products": [
        {
          "sku": "5578874",
          "contract_agreement": {
            "contract_number": "34567892",
            "contract_start_date": "YYYY-MM-DD",
            "contract_end_date": "YYYY-MM-DD",
            "negotiated_price": "456",
            "negotiated_currency ": "USD"
          }
        }
      ]
    }
    ]}

Mögliche Antworten:

    // Success response:
    {
        "result": {
            "response": "success"
        }
    }

    // Error response:
    {
        "result": {
            "response": [
                {
                    "customer_id": "ACME CORP",
                    "supplier_id": "SUP-123456",
                    "third_party_import_id": "DEL789876",
                    "status_code": "failure",
                    "error_response_body": [
                        {
                            "sku": "5578874",
                            "error_message": "The product for which you are trying to update pricing does not exist\nField Value empty/Formatting issue Negotiated currency\nField Value empty/Formatting issue Contract start date\nField Value empty/Formatting issue Contract end date\n"
                        }
                    ]
                }
            ]
        }
    }

## Spendint-API -- POST /sn_spend_intg/Spendint/Availability {#ariaid-title4}

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=<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 : 13. 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 : 14. 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 : 15. 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 : 16. Anforderungskopfzeilen.]

Hinweis:  
Nur die application/jsonDas Datenformat wird für das Beschaffungsintegrations-Framework unterstützt.
{#spendint-POST-availability__entry__32}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 17. 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 : 18. 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"
                        }
                    ]
                }
            ]
        }
    }

## Spendint-API: /sn_spend_intg/Spendint/orderack VERÖFFENTLICHEN {#ariaid-title5}

Aktualisiert Bestellinformationen, wenn ein Anwender ein Produkt aus einem Drittparteikatalog kauft. Wenn der Anwender auscheckt, wird eine Bestellposition erstellt, damit Genehmigungen oder andere Aufgaben für den Einkauf abgeschlossen werden können.
Wenn eine Bestellung in generiert wird ServiceNowDatenbank, die Reihenfolge wird in die folgenden Tabellen übertragen:

* Ausgehende Bestellung: Enthält den Auftragsheader.
* Ausgehende Auftragsposition: Enthält die Auftragspositionen.
{#spendint-POST-orderack__ul_cvl_3cs_knb}

Lieferanten müssen diese Tabellen abfragen und die für sie ausstehenden Aufträge abrufen. Lieferanten sollten eine bereichsbezogene App für erstellen Workflow-StudioAktionen für die Integration mit ServiceNowDatenbank.  
Fragen Sie die Tabellen mit den folgenden Parametern ab:

* `Sysparm_query=Supplier_ID=<supplier_id>^Purchase_order.Status=20 für Header`
* `Sysparm_query=Purchase_order.Supplier_ID=<supplier_id>^Purchase_order.Status=20 für Header`
{#spendint-POST-orderack__ul_owg_sfs_knb} Wenn eine Bestellposition in eine Bestellposition konvertiert wird, werden die folgenden Prozesse ausgeführt:

1. Die Bestellung und die Bestellposition werden gegebenenfalls an die Enterprise Resource Planning (ERP) übermittelt.
2. Die Bestellung und die Bestellposition werden durch die Integration mit der Kunden-ID, der Lieferanten-ID, der Bestellnummer, dem Auftragsdatum, dem Bestellbetrag, der Bestellmenge, der Drittpartei übertragen. Währung des Bestellbetrags und Bestellpositionen.
3. Die Bestellung und die Bestellposition verbleiben im Status „Ausstehende Übermittlung", bis Bestätigungsnachrichten sowohl von der Drittpartei-Katalogintegration als auch vom ERP empfangen werden. Nach Erhalt der Bestätigung 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 Auftragsbestätigungsanforderung 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 Auftragsbestätigungsanforderung fehlgeschlagen ist. Für eine Auftragsbestätigungsantwort fragen Sie die Tabelle „Auftragsbestätigungsfehler" mit dem folgenden Parameter ab:

`Sysparm_query=outbound_error.Supplier_ID=<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-orderack__section_vkd_122_dmb}

/api/sn_spend_intg/Spendint/orderack

### Unterstützte Anforderungsparameter

{#spendint-POST-orderack__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 19. Pfad-Parameter]

{#spendint-POST-orderack__table_sd3_lck_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-orderack__ul_td3_lck_ymb} Standard: Asynchron |
[Tabelle : 20. 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. Vom Kunden für diese Bestellung bereitgestellte Bestellnummer. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Sales_order_lines | Liste von Objekten, die die Kundenauftragspositionen mit eindeutigen Updates für die Einkä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 | Geschätztes 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 eine bestimmte Bestellung generiert wurde. Datentyp: Zeichenfolge Maximale Länge: 40 |
| sales_order_lines.sales_order_line_number | Vertriebsauftragspositionsnummer, die vom Lieferanten generiert wurde. Diese Nummer ist nur für Überarbeitungen dieses Einkaufs erforderlich. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Sales_order_number | Nummer oder Wert, der vom Lieferanten für diesen Auftrag generiert wird. Datentyp: Zeichenfolge Maximale Länge: 40 |
| status_code | Erforderlich. Status der übermittelten Bestellung, der bestätigt, ob die Bestellung erfolgreich erteilt wurde. Datentyp: Zeichenfolge Gültige Werte: * Bestätigt: Bestellung erfolgreich erteilt. * Abgelehnt: Bestellung 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 die Bestellung erfolgreich aufgegeben wurde und sich im Lieferrückstand befindet. Datentyp: Zeichenfolge Maximale Länge: 1000 |
| Supplier_ID | Erforderlich. 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 | Bezeichner, mit dem eine Drittpartei einen Zeichenfolgenwert übergeben kann, um einen Satz importierter Daten eindeutig zu identifizieren. Datentyp: Zeichenfolge Maximale Länge: 100 |
[Tabelle : 21. 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-orderack__entry__34}{#spendint-POST-orderack__accept-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 22. Anforderungskopfzeilen.]

Hinweis:  
Nur die application/jsonDas Datenformat wird für das Beschaffungsintegrations-Framework unterstützt.
{#spendint-POST-orderack__entry__38}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 23. 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 : 24. Statuscodes]

{#spendint-POST-orderack__table_lml_1qg_ymb}

### Antworttext-Parameter (JSON) {#spendint-POST-orderack__section_cq5_1hk_ymb}

Diese Antworttextparameter werden empfangen, wenn sie im synchronen Modus abgefragt werden.{#spendint-POST-orderack__table_dq5_1hk_ymb__entry__2}

| Name | Beschreibung |
|-|-|
| Error_response_body | Beschreibung der Fehler, aufgeführt 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"
                        }
                    ]
                }
            ]
        }
    }

## Spendint-API: /sn_spend_intg/Spendint/Shipping VERÖFFENTLICHEN {#ariaid-title6}

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=<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 : 25. 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 : 26. 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 : 27. 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 : 28. Anforderungskopfzeilen.]

Hinweis:  
Nur die application/jsonDas Datenformat wird für das Beschaffungsintegrations-Framework unterstützt.
{#spendint-POST-shipment__entry__70}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 29. 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 : 30. 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"
                        }
                    ]
                }
            ]
        }
    }

## Spendint-API: /sn_spend_intg/Spendint/Invoice BUCHEN {#ariaid-title7}

Akzeptiert Rechnungen von Drittanbietern.
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.  
Nachdem eine Rechnung übermittelt wurde, werden die Rechnung und Rechnungspositionen einer Bestellung zugeordnet. Bei einer erfolgreichen Zuordnung wird der Status der Rechnung wie folgt festgelegt:

* Warten auf Lieferung: Wenn keine Belege vorhanden sind, wird der Auftrag teilweise geliefert, oder die Rechnung muss genehmigt werden.
* Rechnung bestätigt: Wenn die Bestellung geliefert wird und der fakturierte Betrag dem Gesamtbetrag der Bestellung entspricht.
* Überprüfung erforderlich: Wenn die Bestellung geliefert wird und der fakturierte Betrag nicht mit dem Gesamtbetrag der Bestellung übereinstimmt.
{#spendint-POST-invoice__ul_mqv_3c2_dmb}

Wenn eine gültige Rechnung für eine Position gebucht wird, kann dieselbe Rechnung nicht aktualisiert werden.

Wenn die angegebene Rechnung keine Bestellnummer hat, wird die Rechnung abgelehnt, und es wird eine Fehlermeldung angezeigt, die angibt, dass mindestens eine der angegebenen Rechnungen keine Bestellnummer hat. Wenn die angegebene Rechnung eine Bestellnummer hat, sie aber nicht mit der Bestellung übereinstimmt oder keine Bestellung vorhanden ist, wird eine Fehlermeldung angezeigt. In der Nachricht wird angegeben, dass mindestens eine Rechnung keine entsprechende Bestellung hat, die der Bestellnummer der Rechnung entspricht. Wenn der vom Drittpartei-Wiederverkäufer in Rechnung gestellte Betrag nicht mit dem in Rechnung gestellten Betrag übereinstimmt, wird die Rechnung abgelehnt.

### Statustabellen {#spendint-POST-invoice__section_hrm_qts_knb}

Um den Status der Rechnungsanforderung 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 Rechnungserstellung fehlgeschlagen ist. Für die Rechnungsantwort fragen Sie die Tabelle „Rechnungsfehler" mit dem folgenden Parameter ab:

`Sysparm_query=outbound_error.Supplier_ID=<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-invoice__section_lxx_b22_dmb}

/api/sn_spend_intg/Spendint/Invoice

### Unterstützte Anforderungsparameter

{#spendint-POST-invoice__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 31. Pfad-Parameter]

{#spendint-POST-invoice__table_jhz_gck_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-invoice__ul_hdr_tkg_ymb} Standard: Asynchron |
[Tabelle : 32. Abfrageparameter]

{#spendint-POST-invoice__table_jhz_gck_ymb} {#spendint-POST-invoice__entry__10}

| Name | Beschreibung |
|-|-|
| currency | Erforderlich. Währung für Zwischensumme, Steuer und Versand. Zwischensumme, Steuer und Versand müssen in derselben Währung angegeben sein. Datentyp: Zeichenfolge Maximale Länge: 40 |
| customer_id | Bezeichner für den Kunden. Datentyp: Zeichenfolge Maximale Länge: 100 |
| Rabatte | Rabatte, die auf die Rechnung angewendet werden. Dies ist ein bearbeitbares Feld. Datentyp: Zeichenfolge Maximale Länge: 100 |
| Invoice_date | Erforderlich. Datum, an dem der Kunde in Rechnung gestellt wurde. Datentyp: Zeichenfolge Maximale Länge: 40 FORMAT: JJJJ-MM-TT |
| Invoice_lines | Liste von Objekten, die die Positionen definieren, die für Einkäufe innerhalb dieses Auftrags in Rechnung gestellt werden. Datentyp: Array "invoice_lines": [ { "invoiced_line_amount": "String", "invoiced_quantity": "String", "line_number": "String", "supplier_invoice_line_number": "String", "sales_order_line_number": "String" } ] |
| invoice_lines.invoiced_line_amount | Erforderlich. Gesamtkosten, ohne Steuern und Versand, die einem Kunden für eine bestimmte Bestellposition in Rechnung gestellt werden. Datentyp: Zeichenfolge Maximale Länge: 40 |
| invoice_lines.invoiced_quantity | Erforderlich. Menge der Waren oder Services, für die ein Kunde in Rechnung gestellt wird. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Invoice_lines.line_number | Erforderlich. Bestellpositionsnummer, die vom Kunden für eine bestimmte Bestellung generiert wird. Datentyp: Zeichenfolge Maximale Länge: 40 |
| invoice_lines.sales_order_line_number | Erforderlich. Vertriebsauftragspositionsnummer, die vom Lieferanten generiert wird. Datentyp: Zeichenfolge Maximale Länge: 40 |
| invoice_lines.supplier_invoice_line_number | Erforderlich. Identifikationsnummer, die von einem Lieferanten für diese Rechnungsposition generiert wird. Datentyp: Zeichenfolge Maximale Länge: 100 |
| Other_Charges | Andere zusätzliche Gebühren, die der Rechnung zugeordnet sind. Dies ist ein bearbeitbares Feld. 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 |
| REMIT_to_address | Erforderlich. Standort, an den eine Zahlung erfolgt. Datentyp: Zeichenfolge Maximale Länge: 1000 |
| Sales_order_number | Erforderlich. Nummer oder Wert, der vom Lieferanten für diesen Auftrag generiert wird. Datentyp: Zeichenfolge Maximale Länge: 40 |
| shipping | Erforderlich. Gesamtversandkosten für den gesamten Einkauf. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Zwischensumme | Erforderlich. Gesamtbetrag des an den Lieferanten zu zahlenden Geldbetrags ohne Steuern und Versandkosten. Datentyp: Zeichenfolge Maximale Länge: 40 |
| 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_Invoice_number | Erforderlich. Identifikationsnummer, die von einem Lieferanten für diese Rechnung generiert wird. Datentyp: Zeichenfolge Maximale Länge: 100 |
| Supplier_TAX_ID | Steuerbezeichner, der dem Drittpartei-Wiederverkäufer zugeordnet ist. Dies ist ein bearbeitbares Feld. Datentyp: Zeichenfolge Maximale Länge: 100 |
| Steuer | Erforderlich. Gesamtbetrag der Steuern, die für den Kauf in Rechnung gestellt werden. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Tax_rate | Steuersatz-Prozentsatz, der für den Auftrag angewendet wird. Dies ist ein bearbeitbares Feld. 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 |
| Total_amount_Invoiced | Erforderlich. Gesamtbetrag des an den Lieferanten zu zahlenden Geldbetrags, einschließlich Steuern und Versandkosten. Datentyp: Zeichenfolge Maximale Länge: 40 |
[Tabelle : 33. 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-invoice__entry__58}{#spendint-POST-invoice__accept-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 34. Anforderungskopfzeilen.]

Hinweis:  
Nur die application/jsonDas Datenformat wird für das Beschaffungsintegrations-Framework unterstützt.
{#spendint-POST-invoice__entry__62}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 35. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion.
{#spendint-POST-invoice__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 : 36. Statuscodes]

{#spendint-POST-invoice__table_lml_1qg_ymb}

### Antworttext-Parameter (JSON) {#spendint-POST-invoice__section_ih4_bhk_ymb}

Diese Antworttextparameter werden empfangen, wenn sie im synchronen Modus abgefragt werden.{#spendint-POST-invoice__table_jh4_bhk_ymb__entry__2}

| Name | Beschreibung |
|-|-|
| Error_response_body | Beschreibung der Fehler, aufgeführt nach Verkaufsauftragspositionsnummer, Verkaufsauftragsnummer, Lieferantenrechnungsnummer, Lieferantenrechnungspositionsnummer und Fehlermeldung. Datentyp: Array |
| error_response_body.error_message | Detaillierte Fehlermeldung. Datentyp: Zeichenfolge |
| status_code | Antwortstatus wie „Erfolg" oder „Fehler". Datentyp: Zeichenfolge |
[ ]

{#spendint-POST-invoice__table_jh4_bhk_ymb}  

### Curl-Anforderung

    curl "https://instance.service-now.com/api/sn_spend_intg/spendint/invoice" \
    --request POST \
    --header "Accept:application/json" \
    --user 'username':'password'
    {"root":[{
      "customer_id": "Customer - A",
      "supplier_id": "SUP-123456",
      "third_party_import_id": "undefined",
      "supplier_invoice_number": "QAAP89873220071",
      "supplier_tax_id": "TIN000000",
      "order_number": "POL7987633",
      "sales_order_number": "SO0000000081",
      "invoice_date": "YYYY-MM-DD",
      "subtotal": "6000",
      "tax_rate": "10%",
      "tax": "600",
      "shipping": "120",
      "other_charges": "100",
      "discounts": "200",
      "total_amount_invoiced": "6620",
      "remit_to_address": "1640 Camino Del Rio North #202, San Diego,CA",
      "currency": "USD",
      "invoice_lines": [
        {
          "supplier_invoice_line_number": "QA789A867877ABN32251",
          "line_number": "POL587667",
          "sales_order_line_number": "SOL00000081",
          "invoiced_quantity": "45",
          "invoiced_line_amount": "4000"
        },
        {
          "line_number": "POL587668",
          "supplier_invoice_line_number": "78987323",
          "sales_order_line_number": "SOL98769",
          "invoiced_quantity": "12",
          "invoiced_line_amount": "2000"
        }
      ]
    }
    ]}

Mögliche Antworten:

    // Success response:
    {
        "result": {
            "response": "success"
        }
    }

    // Error response:
    {
        "result": {
            "response": [
                {
                    "customer_id": "Customer - A",
                    "supplier_id": "SUP-123456",
                    "third_party_import_id": "undefined",
                    "status_code": "failure",
                    "error_response_body": [
                        {
                            "sales_order_line_number": "SOL00000081",
                            "sales_order_number": "SO0000000081",
                            "supplier_invoice_number": "QAAP89873220071",
                            "supplier_invoice_line_number": "QA789A867877ABN32251",
                            "error_message": "The invoice do not have a corresponding purchase order which matches the purchase order number of the invoice provided\n"
                        }
                    ]
                }
            ]
        }
    }


