API für Kreditorenrechnungen

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 29 Minuten Lesedauer

    • Ermöglicht externen Systemen, wie sie beispielsweise von Lieferanten verwendet werden, Rechnungen auf sichere und automatisierte Weise direkt an ein Kreditorensystem zu übermitteln.

    Diese API erfordert die Store-Anwendung Rechnungsbearbeitung für Kreditorenbuchhaltung (com.sn_ap_apm), die im Namespace sn_spend_intg bereitgestellt wird. Informationen hierzu finden Sie unter Accounts Payable Invoice Processing.

    Entwicklerhandbuch für die API für Kreditorenrechnungen erhalten Sie Hilfe bei den folgenden Aufgaben:
    • Definieren Sie ein anwenderdefiniertes Feld für Rechnungen, Rechnungspositionen und Rechnungssteuerpositionen.
    • Ordnen Sie das anwenderdefinierte Feld zwischen Quell- und Zieltabellen zu.
    • Ordnen Sie das anwenderdefinierte Feld einem Nutzlasteintrag in einem bestimmten Format zu, z. B. JSON, cXML oder XML.
    • Anmeldeinformationen für die Authentifizierung festlegen, wenn cXML als Nutzlast verwendet wird.
    Hinweis:
    Die maximale Nutzlastgröße beträgt standardmäßig 100 Datensätze. Dieser Wert ist in der Systemeigenschaft sn_spend_intg.ap.invoice.create.api.record_limit konfigurierbar.

    Kreditorenrechnung: POST sn_spend_intg/ap_invoice/cxml

    Verarbeitet eine automatisierte Rechnung im Commerce XML-Format (cXML).

    Verwenden Sie die Tabelle „Rechnungsintegrationsfeldzuordnungen“ [sn_spend_intg_invoice_intg_field_mapping], um zu bestimmen, wie die Felder cXML-Tags zugeordnet werden.

    Zusätzliche cXML-Ressourcen finden Sie im cXML-Referenzhandbuch unter https://xml.cxml.org.

    Anmeldeinformationen für diese API sind in der Nutzlast enthalten. Sie können Anmeldeinformationen in der Tabelle „Anmeldeinformationen für Quellsystem“ [sn_spend_intg_source_system_credential] einrichten. Anweisungen dazu finden Sie unter Anmeldeinformationen für die Authentifizierung in der cXML-Payload festlegen.

    Sie können anwenderdefinierte Rechnungsfelder für den Anforderungstext definieren. Verwenden Sie den folgenden Flow, um anwenderdefinierte Felder hinzuzufügen, Zieltabellen zuzuordnen und sie für die Verfügbarkeit in der Nutzlast zu formatieren:
    1. Fügen Sie anwenderdefinierte Felder für den Rechnungsimport hinzu
    2. Ordnen Sie anwenderdefinierte Felder zwischen Quell- und Zieltabellen zu
    3. Ordnen Sie einem Nutzlastquellformat anwenderdefinierte Felder zu

    URL-Format

    URL mit Versionsnummer: /api/sn_spend_intg/v1/ap_invoice/cxml

    Standard-URL: /api/sn_spend_intg/ap_invoice/cxml

    Unterstützte Anforderungsparameter

    Tabelle : 1. Pfadparameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden.

    Datentyp: Zeichenfolge
    Tabelle : 2. Abfrageparameter
    Name Beschreibung
    Keine
    Tabelle : 3. Anforderungstextelemente (cXML)
    Pfad Beschreibung
    /cXML/Header/Von /Credential[@domain='VendorID']/Identity Bezeichner für den Reseller oder Lieferanten, bei dem der Kunde Bestellungen aufgeben kann.

    Zielfeld: u_supplier

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader[@invoiceDate] Datum, an dem dem Kunden eine Rechnung ausgestellt wurde.

    Zielfeld: u_invoice_date

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Format: JJJJ-MM-TT
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader[@invoiceID] Rechnungsnummer, die aus einer Drittparteianwendung generiert wurde.

    Zielfeld: u_external_invoice_number

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader[@invoiceOrigin] Externes Quellsystem, von dem die Rechnung empfangen wird. Beispiel: Lieferant.

    Zielfeld: u_inbound_source

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader/InvoicePartner/Contact[@role='billTo']/PostalAddress/Stadt Die Stadt, an die die Rechnung gesendet wird.

    Zielfeld: u_bill_to_city

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader/InvoicePartner/Contact[@role='billTo']/PostalAddress/Country Das Land, an das die Rechnung gesendet wird, im ISO 3166-Format. Beispiel: US.

    Zielfeld: u_bill_to_country

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader/InvoicePartner/Contact[@role='billTo']/PostalAddress/State Das Bundesland oder die Region, an das bzw. die die Rechnung gesendet wird.

    Zielfeld: u_bill_to_state_or_province

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /cXML/Request/InvoiceDetailRequest /InvoiceDetailRequestHeader/InvoicePartner /Contact[@role='billTo']/PostalAddress/Street Die Straße, an die die Rechnung gesendet wird.

    Zielfeld: u_bill_to_street

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader/InvoicePartner/Contact[@role='billTo']/PostalAddress/PostalCode Die Postleitzahl, an die die Rechnung gesendet wird.

    Zielfeld: u_bill_to_zip_or_postal_code
    Kontakt[@role="remitTo"]/PostalAddress/Street Die Straße, an die die Zahlung erfolgt.

    Zielfeld: u_remit_address
    Kontakt[@role="remitTo"]/PostalAddress/Stadt Die Stadt, an die die Zahlung erfolgt.

    Zielfeld: u_remit_to_city
    Kontakt[@role="remitTo"]/PostalAddress/State Das Bundesland oder der Kanton, an den die Zahlung erfolgt.

    Zielfeld: u_remit_to_state_or_province
    Kontakt[@role="remitTo"]/PostalAddress/PostalCode Die Postleitzahl, an die die Zahlung erfolgt.

    Zielfeld: u_remit_to_zip_or_postal_code
    Kontakt[@role="remitTo"]/PostalAddress/Land Das Land, an das die Zahlung erfolgt, im ISO 3166-Format. Beispiel: US.

    Zielfeld: u_remit_to_country
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader /InvoiceDetailShiping/Contact[@role="shipFrom"]/PostalAddress/Street Straße, von der die Artikel in der Bestellung versandt werden.

    Zielfeld: u_ship_from_street

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader /InvoiceDetailShiping/Contact[@role="shipFrom"]/PostalAddress/Stadt Stadt, aus der die Artikel auf der Bestellung versandt werden.

    Zielfeld: u_ship_from_city

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader /InvoiceDetailShiping/Contact[@role="shipFrom"]/PostalAddress/State Bundesland, aus dem die Artikel auf der Bestellung versendet werden.

    Zielfeld: u_ship_from_state_or_province

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader/InvoiceDetailShiping/Contact[@role="shipFrom"]/PostalAddress/PostalCode Postleitzahl, von der die Artikel auf der Bestellung versendet werden.

    Zielfeld: u_ship_from_zip_or_postal_code

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader /InvoiceDetailShiping/Contact[@role="shipFrom"]/PostalAddress/Country Land, aus dem die Artikel auf der Bestellung versandt werden.

    Zielfeld: u_ship_from_country

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader /InvoicePartner/Contact[@role="billTo"] [@addressID] Name der juristischen Person des Lieferanten. Befindet sich in der Tabelle „Juristische Person“ [sn_fin_legal_entity].

    Zielfeld: u_legal_entity

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    Kontakt[@role="shipTo"]/Name Name des Kontakts, an den die Artikel auf der Bestellung versendet werden sollen.

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    Kontakt[@role="shipTo"]/PostalAddress/Street Straße, an die die Artikel in der Bestellung versandt werden.

    Zielfeld: u_ship_to_street

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    Kontakt[@role="shipTo"]/PostalAddress/Stadt Stadt, in die die Artikel auf der Bestellung versandt werden.

    Zielfeld: u_ship_to_city

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    Kontakt[@role="shipTo"]/PostalAddress/State Bundesland oder Region, an das bzw. die die Artikel auf der Bestellung versandt werden.

    Zielfeld: u_ship_to_state_or_province
    Kontakt[@role="shipTo"]/PostalAddress/PostalCode Postleitzahl, an die die Artikel auf der Bestellung versendet werden.

    Zielfeld: u_ship_to_zip_or_postal_code

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    Kontakt[@role="shipTo"]/PostalAddress/Land Land, an das die Artikel auf der Bestellung versandt werden.

    Zielfeld: u_ship_from_country

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader/PaymentTerm Der vereinbarte Zeitpunkt und die Bedingungen, unter denen eine Zahlung an einen Lieferanten erfolgt. Beispiel: Netto 30.

    Zielfeld: u_payment_terms

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder/InvoiceDetailItem[@description]/ Beschreibung der Rechnungsposition.

    Zielfeld: u_line_description
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder/InvoiceDetailItem[@quantity]/ Menge der Waren oder Dienstleistungen, die einem Kunden in Rechnung gestellt wird.

    Zielfeld: u_line_quantity
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder/InvoiceDetailItem/Distribution/Accounting/AccountingSegment[1]/Name Kontonummer der Kostenstelle, für die die Rechnung generiert wird. In der Tabelle „Kostenstelle“ [cmn_cost_center] aufgeführt.

    Zielfeld: u_cost_center
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder/InvoiceDetailItem/Distribution/Accounting/AccountingSegment[2]/Name Kontonummer des Hauptbuchs, das zum Generieren der Rechnung verwendet wird.

    Zielfeld: u_gl_account

    Siehe auch:
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder/InvoiceDetailItem/SubtotalAmount/Money Gesamtbetrag, der an den Lieferanten zu zahlen ist, ausschließlich Steuern und Versandkosten.

    Zielfeld: u_subtotal

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder/InvoiceDetailItem/NetAmount/Money Gesamtkosten (ohne Steuern und Versand), die einem Kunden für eine bestimmte Bestellposition in Rechnung gestellt werden.

    Zielfeld: u_line_amount_invoiced

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder/InvoiceDetailOrderInfo/OrderReference Kaufauftragsnummer, die der Kunde für diese Bestellung angegeben hat. In der Bestelltabelle [sn_shop_purchase_order] aufgeführt.

    Zielfeld: u_purchase_order

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder/InvoiceDetailItem/UnitPrice/UnitOfMeasure Basismaßeinheit, die zum Zählen des Artikels auf der Rechnung verwendet wird.

    Zielfeld: u_uom

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder/InvoiceDetailItem/UnitPrice/Money Stückpreis der Position auf der Rechnung.

    Zielfeld: u_line_unit_Price

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder/InvoiceDetailItem/UnitPrice/Money[@currency] Währung für die Position. Beispiel: USD.

    Zielfeld: u_currency

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder/InvoiceDetailItem/InvoiceDetailItemReference[@lineNumber] Bestellpositions-ID für den referenzierten Lieferanten. In der Tabelle Bestellposition [sn_shop_purchase_order_line] aufgeführt.

    Zielfeld: u_purchase_order_line

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder/InvoiceDetailItem/InvoiceDetailItemReference/ItemID/SupplierPartID Teilenummer, die von einem Lieferanten für diese Rechnungsposition generiert wird.

    Zielfeld: u_supplier_part_number

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder/InvoiceDetailItem/InvoiceDetailItemReference/Description Beschreibung der Bestellposition für die Rechnung.

    Zielfeld: u_po_line_description

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder/InvoiceDetailItem/Tax/Money Gesamtbetrag der Steuern, die für den Kauf in Rechnung gestellt werden.

    Zielfeld: u_tax_amount

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder/InvoiceDetailItem/Tax/Description Eindeutiger Steuercode, der aus der ERP-Quelle generiert wird.

    Zielfeld: u_tax_code

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary/SubtotalAmount/Money Gesamtbetrag, der an den Lieferanten zu zahlen ist, ausschließlich Steuern und Versandkosten.

    Zielfeld: u_subtotal

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary /Tax/Money Gesamtbetrag der Steuern, die für den Kauf in Rechnung gestellt werden.

    Zielfeld: u_tax_amount

    Zugehörige Tabelle: Import von Rechnungssteuerpositionen [sn_spend_intg_imp_invoice_tax_line]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary/Tax/TaxDetail[@category] Typ der auf die Rechnung anzuwendenden Steuer. In der Tabelle „Steuertyp“ [sn_fin_tax_type] aufgeführt.

    Zielfeld: u_tax_type

    Zugehörige Tabelle: Import von Rechnungssteuerpositionen [sn_spend_intg_imp_invoice_tax_line]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary/Tax/TaxDetail[@percentageRate] Der vom Lieferanten erhobene Steuersatz

    Zugehörige Tabelle: Import von Rechnungssteuerpositionen [sn_spend_intg_imp_invoice_tax_line]

    Zielfeld: u_supplier_tax_rate

    Zugehörige Tabelle: Import von Rechnungssteuerpositionen [sn_spend_intg_imp_invoice_tax_line]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary/SpecialHandlingAmount/Money Andere zusätzliche Gebühren, die der Rechnung zugeordnet sind. Dies ist ein bearbeitbares Feld.

    Zielfeld: u_other_charges

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary/Versandbetrag/Money Gesamtversandkosten für den gesamten Kauf.

    Zielfeld: u_shipping_amount

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary/GrossAmount/Money Erforderlich Währung für die Zwischensumme, die Steuern und den Versand. Die Zwischensumme, die Steuern und der Versand müssen in derselben Währung angegeben sein.

    Zielfeld: u_currency

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary/InvoiceDetailDiscount/Money Rabatte, die auf die Rechnung angewendet werden.

    Zielfeld: u_discounts

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary/NetAmount/Money Gesamtbetrag, der an den Lieferanten zu zahlen ist, einschließlich Steuern und Versandkosten.

    Zielfeld: u_amount_invoiced

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Header

    Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter Unterstützte REST API-Header.

    Tabelle : 4. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Inhaltstyp Datenformat des Anforderungstexts. Unterstützt nur application/xml.
    Quellsystem Gibt das Quellsystem an, aus dem die Anforderung stammt.

    Verfügbare Systeme sind in der Tabelle „Anmeldeinformationen für Quellsysteme“ [sn_spend_intg_source_system_credential] aufgeführt.

    Mit dieser Einstellung kann bestimmt werden, ob die bereitgestellte Anforderung der Struktur in der Tabelle „Feldzuordnung für Rechnungsintegration“ [sn_spend_intg_invoice_intg_field_mapping] entspricht.

    Diese Einstellung wird auch verwendet, um Anmeldeinformationen aus der Tabelle „Anmeldeinformationen für Quellsystem“ [sn_spend_intg_source_system_credential] abzurufen.
    Tabelle : 5. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Keine

    Statuscodes

    Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter HTTP-Antwortcodes der REST-API.

    Tabelle : 6. Statuscodes
    Statuscode Beschreibung
    202 Anforderung akzeptiert. Die Anforderung ist erfolgreich, und die Rechnungsverarbeitung wird ausgeführt.
    400 Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt.
    429 Zu viele Anforderungen. Die Anforderungsrate hat das Maximum von 10 Anforderungen pro Stunde überschritten.

    Parameter des Antwort-Haupttexts

    Name Beschreibung
    batch_id Eindeutiger Bezeichner für die Batch-Anforderung. Diese ID kann verwendet werden, um den Status der Anforderung zu verfolgen. Dieser Datensatz wird in der Tabelle „Rechnungsintegrationsprotokoll“ [sn_spend_intg_invoice_integration_log] gespeichert.

    Datentyp: Zeichenfolge
    Fehler Enthält eine Fehlermeldung und Details, wenn die Anforderung fehlschlägt.
    {
  "detail": String,
  "message": String
}

    Datentyp: Objekt
    Fehler.detail Zusätzliche Details zum Anforderungsfehler.
    Mögliche Ergebnisse:
    • ACL-Validierung auf API-Ebene fehlgeschlagen: Der Anwender hat keinen Lese-/Schreibzugriff auf die Ressource.
    • Quotenbegrenzung von 13 Anforderungen pro Stunde für Kreditorenrechnung überschritten – Die Anzahl der Datensätze im Batch überschreitet die festgelegte Batch-Größe.
    • Zur Angabe von Auth-Informationen erforderlich: Entweder ist das Passwort falsch oder der Anwendername falsch.

    Datentyp: Zeichenfolge
    Fehlernachricht Fehlermeldung, die den Grund für das Fehlschlagen der Anforderung enthält
    Mögliche Fehler:
    • Ungültige Nutzlast – Ungültiger Inhaltstyp.
    • Ungültige Nutzlast – Fehler: Ungültige Nutzlaststruktur.
    • Ungültige Nutzlast – Fehler: Nutzlast überschreitet das zulässige Rechnungslimit in einem Batch. Die Anzahl der Datensätze im Batch überschreitet die festgelegte Batch-Größe. Die maximale Nutzlastgröße beträgt standardmäßig 100 Datensätze. Dieser Wert ist in der Systemeigenschaft sn_spend_intg.ap.invoice.create.api.record_limit konfigurierbar.
    • Ungültige Nutzlast – Fehler: leere Rechnungen. Keine Daten zum Verarbeiten. Die Anzahl der Datensätze im Batch ist 0.
    • Quotenbegrenzung von 500 Anforderungen pro Stunde für APO-Rechnungserfassung überschritten.
    • Anwender nicht authentifiziert. Entweder ist das Passwort oder der Anwendername falsch.
    • ACL-Validierung auf API-Ebene fehlgeschlagen: Der Anwender hat keinen Lese-/Schreibzugriff auf die Ressource.

    Datentyp: Zeichenfolge
    Nachricht Erfolgsnachricht, z. B. Ihre Anforderung wurde erfolgreich empfangen und wird verarbeitet.

    Sie können den Status der Anforderung in der Tabelle „Rechnungsintegrationsprotokoll“ [sn_spend_intg_invoice_integration_log] anzeigen.

    Datentyp: Zeichenfolge
    status Gibt das Ergebnis der Anforderung an.
    Mögliche Werte:
    • Erfolg
    • Fehlgeschlagen

    Datentyp: Zeichenfolge

    cURL-Anforderung

    Das folgende Beispiel zeigt, wie eine Rechnung verarbeitet wird, die als Anforderung im cXML-Format bereitgestellt wurde.

    curl -X POST https://instance.servicenow.com/api/sn_spend_intg/v1/ap_invoice/cxml \
-H "Source-System: Ariba" \
-H "Content-Type: application/json" \
-d '{
    "content": "------=_Part_1367_1859161670.1709186492411\r\nContent-Type: text/xml; charset=UTF-8\r\n
Content-ID: 1709186492411.10815535@produs-c4-an-s2-z3-1.us2.gcpint.ariba.com\r\n<?xml version=\"1.0\" 
encoding=\"UTF-8\"?>\r\n<!DOCTYPE cXML SYSTEM \"https://protect-us.mimecast.com/s/fgKrCERVqQU35PNzBuw39pz?domain=xml.cxml.org\">
\r\n<cXML timestamp=\"2024-02-28T22:01:32-08:00\" payloadID=\"1709186492411-3401013259654180284@10.209.37.74\">
\r\n    <Response>\r\n        <Status code=\"200\" text=\"OK\" />\r\n        <DataResponse>\r\n            <Attachment>
\r\n                <URL>186492411.10815535@produs-c4-an-s2-z3-1.us2.gcpint.ariba.com.110</URL>\r\n            </Attachment>
\r\n            <Attachment>\r\n                <URL>1709186492403.306612238@produs-c4-an-s2-z3-1.us2.gcpint.ariba.com.108</URL>
\r\n            </Attachment>\r\n        </DataResponse>\r\n    </Response>\r\n</cXML>\r\n------=_Part_1367_1859161670.1709186492411
\r\nContent-Type: text/xml; charset=UTF-8\r\nContent-ID: 1709186492403.306612238@produs-c4-an-s2-z3-1.us2.gcpint.ariba.com.108
\r\n<?xml version=\"1.0\" encoding=\"UTF-8\"?>\r\n
<!DOCTYPE cXML SYSTEM \"https://protect-us.mimecast.com/s/7QpfCG6VRKf15gQPwFpUTKe?domain=xml.cxml.org\">\r\n
<cXML payloadID=\"1705930173863-1790846563502652473@10.209.37.98\" timestamp=\"2024-01-22T05:29:33-08:00\" version=\"1.2.060\">\r\n
    <Header>\r\n        <From>\r\n            <Credential domain=\"NetworkID\">\r\n                <Identity>AN01532216648-T</Identity>\r\n
            </Credential>\r\n            <Credential domain=\"VendorID\">\r\n                <Identity>3245545</Identity>\r\n
            </Credential>\r\n            <Credential domain=\"PrivateID\">\r\n                <Identity>0000099123</Identity>\r\n
            </Credential>\r\n        </From>\r\n        <To>\r\n            <Credential domain=\"NetworkID\">\r\n
                <Identity>AN01404744424-T</Identity>\r\n            </Credential>\r\n            <Credential domain=\"SystemID\">\r\n
                <Identity>ERP1</Identity>\r\n            </Credential>\r\n            <Credential domain=\"EndPointID\">\r\n
                <Identity>CIG</Identity>\r\n            </Credential>\r\n        </To>\r\n        <Sender>\r\n
            <Credential domain=\"NetworkID\">\r\n                <Identity>AN01000000001</Identity>\r\n
                <SharedSecret>Ariba@123</SharedSecret>\r\n            </Credential>\r\n            <UserAgent>Supplier</UserAgent>\r\n
        </Sender>\r\n    </Header>\r\n    <Request deploymentMode=\"test\">\r\n        <InvoiceDetailRequest>\r\n
            <InvoiceDetailRequestHeader invoiceDate=\"2024-01-22\" invoiceID=\"\" invoiceOrigin=\"supplier\" operation=\"new\ purpose=\"PO Invoice\">\r\n
                <InvoiceDetailHeaderIndicator></InvoiceDetailHeaderIndicator>\r\n
                <InvoiceDetailLineIndicator></InvoiceDetailLineIndicator>\r\n                <InvoicePartner>\r\n
                    <Contact addressID=\"Test123\" role=\"remitTo\">\r\n
                        <Name xml:lang=\"en-US\">Oil and Natural Gas Corporation Limited</Name>\r\n
                        <PostalAddress>\r\n                            <Street>Xyz street</Street>\r\n                            <City>USA</City>\r\n
                            <State isoStateCode=\"US-NY\">NY</State>\r\n                            <PostalCode>10001</PostalCode>\r\n
                            <Country isoCountryCode=\"US\">United States</Country>\r\n                        </PostalAddress>\r\n
                    </Contact>\r\n                </InvoicePartner>\r\n                <InvoicePartner>\r\n
                    <Contact addressID=\"9009\" role=\"billTo\">\r\n                        <Name xml:lang=\"EN\">Bristlecone Inc</Name>\r\n
                        <PostalAddress>\r\n                            <Street>10 Boulvard-10</Street>\r\n
                            <City>San Jose</City>\r\n                            <State>CA</State>\r\n
                            <PostalCode>94077</PostalCode>\r\n                            <Country isoCountryCode=\"US\"></Country>\r\n
                        </PostalAddress>\r\n                        <Phone>\r\n                            <TelephoneNumber>\r\n
                                <CountryCode isoCountryCode=\"US\">1</CountryCode>\r\n                                <Number>7687687799</Number>\r\n
                            </TelephoneNumber>\r\n                        </Phone>\r\n                        <Fax>\r\n
                            <TelephoneNumber>\r\n                                <CountryCode isoCountryCode=\"US\">1</CountryCode>\r\n
                                <Number>768-FAX-NUMBER</Number>\r\n                            </TelephoneNumber>\r\n                        </Fax>\r\n
                    </Contact>\r\n                </InvoicePartner>\r\n                <InvoicePartner>\r\n                    <Contact role=\"from\">\r\n
                        <Name xml:lang=\"en-US\">Oil and Natural Gas Corporation Limited</Name>\r\n                        <PostalAddress>\r\n
                            <Street>123 , street no 5</Street>\r\n                            <City>Dallas</City>\r\n
                            <State isoStateCode=\"US-AL\">AL</State>\r\n                            <PostalCode>36615</PostalCode>\r\n
                            <Country isoCountryCode=\"US\">United States</Country>\r\n                        </PostalAddress>\r\n
                    </Contact>\r\n                </InvoicePartner>\r\n                <InvoiceDetailShipping>\r\n
                    <Contact role=\"shipFrom\">\r\n                        <Name xml:lang=\"en-US\">Oil and Natural Gas Corporation Limited</Name>\r\n
                        <PostalAddress>\r\n                            <Street>Deendayal Urja Bhawan</Street>\r\n
                            <City>New Delhi</City>\r\n                            <State isoStateCode=\"IN-MH\">Maharashtra</State>\r\n
                            <PostalCode>110070</PostalCode>\r\n                            <Country isoCountryCode=\"IN\">India</Country>\r\n
                        </PostalAddress>\r\n                    </Contact>\r\n                    <Contact addressID=\"9999\" role=\"shipTo\">\r\n
                        <Name xml:lang=\"EN\">Buyer Plant Bristlecone</Name>\r\n                        <PostalAddress name=\"default\">\r\n
                            <Street>18 Hanoi Road</Street>\r\n                            <City>San Jose</City>\r\n
                            <State>CA</State>\r\n                            <PostalCode>77077</PostalCode>\r\n
                            <Country isoCountryCode=\"US\"></Country>\r\n                        </PostalAddress>\r\n
                        <Email name=\"default\" preferredLang=\"en\">test@test.com</Email>\r\n                    </Contact>\r\n
                </InvoiceDetailShipping>\r\n            </InvoiceDetailRequestHeader>\r\n            <InvoiceDetailOrder>\r\n
                <InvoiceDetailOrderInfo>\r\n                    <OrderReference orderID=\"\">\r\n
                        <DocumentReference payloadID=\"0AAF8EA1FA5F1EDE9FDC97460BCB03E1\"></DocumentReference>\r\n
                    </OrderReference>\r\n                </InvoiceDetailOrderInfo>\r\n
                <InvoiceDetailItem invoiceLineNumber=\"2\" quantity=\"25\" description=\"Indian Oil\">\r\n
                    <UnitOfMeasure>EA</UnitOfMeasure>\r\n                    <UnitPrice>\r\n                        <Money currency=\"USD\">50</Money>\r\n
                    </UnitPrice>\r\n                    <SubtotalAmount>\r\n                        <Money currency=\"USD\">1250.00</Money>\r\n
                    </SubtotalAmount>\r\n                </InvoiceDetailItem>\r\n            </InvoiceDetailOrder>\r\n        </InvoiceDetailRequest>\r\n
    </Request>\r\n</cXML>\r\n------=_Part_1367_1859161670.1709186492411--"
}'

    Das folgende Ergebnis zeigt, dass die Anforderung erfolgreich war und die Rechnungsdaten verarbeitet werden. Sie können den Status der Anforderung in der Tabelle „Rechnungsintegrationsprotokoll“ [sn_spend_intg_invoice_integration_log] anzeigen. Verwenden Sie die in der Spalte „Batch ID“ aufgeführte Batch-ID, um die Rechnung zu finden.

    {
    "batchId": "APIINV1729711710733280",
    "status": "Success",
    "message": "Your request has been successfully received and is being processed."
}

    Kreditorenrechnung: POST sn_spend_intg/ap_invoice/json

    Verarbeitet eine automatisierte Rechnung im JSON-Format.

    Erforderliche Rolle: sn_spend_intg.procurement_integrator

    Verwenden Sie die Tabelle „Rechnungsintegrationsfeldzuordnungen“ [sn_spend_intg_invoice_intg_field_mapping], um zu bestimmen, wie die Felder JSON-Eigenschaften zugeordnet werden.

    Sie können anwenderdefinierte Rechnungsfelder für den Anforderungstext definieren. Verwenden Sie den folgenden Flow, um anwenderdefinierte Felder hinzuzufügen, Zieltabellen zuzuordnen und sie für die Verfügbarkeit in der Nutzlast zu formatieren:
    1. Fügen Sie anwenderdefinierte Felder für den Rechnungsimport hinzu
    2. Ordnen Sie anwenderdefinierte Felder zwischen Quell- und Zieltabellen zu
    3. Ordnen Sie einem Nutzlastquellformat anwenderdefinierte Felder zu

    URL-Format

    URL mit Versionsnummer: /api/sn_spend_intg/v1/ap_invoice/json

    Standard-URL: /api/sn_spend_intg/ap_invoice/json

    Unterstützte Anforderungsparameter

    Tabelle : 7. Pfadparameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden.

    Datentyp: Zeichenfolge
    Tabelle : 8. Abfrageparameter
    Name Beschreibung
    Keine
    Tabelle : 9. Anforderungstextparameter
    Name Beschreibung
    Rechnungen Liste, die jede zu verarbeitende Rechnung enthält.

    Datentyp: Objekt mit geschachtelten Rechnungsobjekten.

    "invoices": {
  {
    "amount_invoiced": "String",
    "bill_to_city": "String",
    "bill_to_country": "String",
    "bill_to_state_or_province": "String",
    "bill_to_street": "String",
    "bill_to_zip_or_postal_code": "String",
    "business_owner": "String",
    "currency": "String",
    "discounts": "String",
    "erp_number": "String",
    "external_invoice_number": "String",
    "invoice_date": "String",
    "invoice_line_count": "String",
    "invoice_lines": [Array],
    "invoice_type": "String",
    "legal_entity": "String",
    "original_invoice": "String",
    "other_charges": "String",
    "payment_terms": "String",
    "purchase_order": "String",
    "remit_address": "String",
    "remit_to_city": "String",
    "remit_to_country": "String",
    "remit_to_state_or_province": "String",
    "remit_to_zip_or_postal_code": "String",
    "ship_from_city": "String",
    "ship_from_country": "String",
    "ship_from_state_or_province": "String",
    "ship_from_street": "String",
    "ship_from_zip_or_postal_code": "String",
    "ship_to_city": "String",
    "ship_to_country": "String",
    "ship_to_state_or_province": "String",
    "ship_to_street": "String",
    "ship_to_zip_or_postal_code": "String",
    "shipping_amount": "String",
    "subtotal": "String",
    "supplier": "String",
    "supplier_invoice_number": "String",
    "supplier_tax_id": "String"
  }
}
    rechnungen.amount_invoiced Gesamtbetrag, der an den Lieferanten zu zahlen ist, einschließlich Steuern und Versandkosten.

    Zielfeld: u_amount_invoiced

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    bill_to_city Die Stadt, an die die Rechnung gesendet wird.

    Zielfeld: u_bill_to_city

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    bill_to_country Das Land, an das die Rechnung gesendet wird, im ISO 3166-Format. Beispiel: US.

    Zielfeld: u_bill_to_country

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    bill_to_state_or_province Das Bundesland oder die Region, an das bzw. die die Rechnung gesendet wird.

    Zielfeld: u_bill_to_state_or_province

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    bill_to_street Die Straße, an die die Rechnung gesendet wird.

    Zielfeld: u_bill_to_street

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    bill_to_zip_or_postal_code Die Postleitzahl, an die die Rechnung gesendet wird.

    Zielfeld: u_bill_to_zip_or_postal_code
    rechnungen.business_owner Name des Besitzers, der die Anwendung von der Geschäftsseite besitzt.

    Zielfeld: u_business_owner

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    Rechnungen.Währung Erforderlich Währung für die Zwischensumme, die Steuern und den Versand. Die Zwischensumme, die Steuern und der Versand müssen in derselben Währung angegeben sein.

    Zielfeld: u_currency

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    rechnungen.rabatte Rabatte, die auf die Rechnung angewendet werden.

    Zielfeld: u_discounts

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    Rechnungen.erp_number Eindeutige Nummer, die im ERP-System (Enterprise Resource Planning) für die Bestellung generiert wird. Informationen hierzu finden Sie unter Purchase order integration.

    Zielfeld: u_erp_number

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    Rechnungen. external_invoice_number Erforderlich. Rechnungsnummer, die aus einer Drittparteianwendung generiert wurde.

    Zielfeld: u_external_invoice_number

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    rechnungen.rechnung_datum Erforderlich. Datum, an dem dem Kunden eine Rechnung ausgestellt wurde.

    Zielfeld: u_invoice_date

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 40

    Format: JJJJ-MM-TT
    Rechnungen.invoice_line_count Anzahl der Positionen auf der Rechnung.

    Zielfeld: u_invoice_line_count

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    rechnungen.invoice_lines Liste der Objekte, die die Positionen definieren, die für Käufe in dieser Bestellung in Rechnung gestellt werden. Rechnungspositionen werden in der Tabelle „Rechnungspositionsimport eingehend“ [sn_spend_intg_imp_invoice_line] bereitgestellt.

    Datentyp: Array

    "invoice_lines": [
  {
    "cost_center": "String",
    "currency": "String",
    "external_invoice_number": "String",
    "gl_account": "String",
    "line_amount_invoiced": "String",
    "line_description": "String",
    "line_quantity": "String",
    "line_unit_price": "String",
    "po_line_description": "String",
    "purchase_order_line": "String",
    "ship_to_city": "String",
    "ship_to_country": "String",
    "ship_to_state_or_province": "String",
    "ship_to_street": "String",
    "ship_to_zip_or_postal_code": "String",
    "subtotal": "String",
    "supplier_part_number": "String",
    "tax_code": "String",
    "tax_details": [Array],
    "uom": "String"
  }
]
    rechnungen.invoice_lines „cost_center“ Kontonummer der Kostenstelle, für die die Rechnung generiert wird. In der Tabelle „Kostenstelle“ [cmn_cost_center] aufgeführt.

    Zielfeld: u_cost_center

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    rechnungen.invoice_lines Währung Währung für die Position. Beispiel: USD.

    Zielfeld: u_currency

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    rechnungen.invoice_lines external_invoice_number Erforderlich. Rechnungsnummer, die aus einer Drittparteianwendung generiert wurde.

    Zielfeld: u_external_invoice_number

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    rechnungen.invoice_lines gl_account Kontonummer des Hauptbuchs, das zum Generieren der Rechnung verwendet wird.

    Zielfeld: u_gl_account

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]

    Datentyp: Zeichenfolge

    Maximale Länge: 40

    Siehe auch:
    rechnungen.invoice_lines „line_amount_invoiced“ Erforderlich. Gesamtkosten (ohne Steuern und Versand), die einem Kunden für eine bestimmte Bestellposition in Rechnung gestellt werden.

    Zielfeld: u_line_amount_invoiced

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    rechnungen.invoice_lines „line_description“ Erforderlich. Beschreibung der Rechnungsposition.

    Zielfeld: u_line_description

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    rechnungen.invoice_lines „line_quantity“ Erforderlich. Menge der Waren oder Dienstleistungen, die einem Kunden in Rechnung gestellt wird.

    Zielfeld: u_line_quantity

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    rechnungen.invoice_lines Linie_Einheit_Preis Stückpreis der Position auf der Rechnung.

    Zielfeld: u_line_unit_Price

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    rechnungen.invoice_lines „po_line_description“ Beschreibung der Bestellposition für die Rechnung.

    Zielfeld: u_po_line_description

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    rechnungen.invoice_lines procurement_order_line Erforderlich. Bestellpositions-ID für den referenzierten Lieferanten. In der Tabelle Bestellposition [sn_shop_purchase_order_line] aufgeführt.

    Zielfeld: u_purchase_order_line

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    rechnungen.invoice_lines versenden_zu_Stadt Stadt, in die die Artikel auf der Bestellung versandt werden.

    Zielfeld: u_ship_to_city

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    rechnungen.invoice_lines „ship_to_country“ Land, an das die Artikel auf der Bestellung versandt werden.

    Zielfeld: u_ship_to_country

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    rechnungen.invoice_lines „ship_to_state_or_province“ Bundesland oder Region, an das bzw. die die Artikel auf der Bestellung versandt werden.

    Zielfeld: u_ship_to_state_or_province

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    rechnungen.invoice_lines versenden_zu_Strasse Straße, an die die Artikel in der Bestellung versandt werden.

    Zielfeld: u_ship_to_street

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    rechnungen.invoice_lines „ship_to_zip_or_postal_code“ Postleitzahl, an die die Artikel auf der Bestellung versendet werden.

    Zielfeld: u_ship_to_zip_or_postal_code

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    rechnungen.invoice_lines Zwischensumme Erforderlich. Gesamtbetrag, der an den Lieferanten zu zahlen ist, ausschließlich Steuern und Versandkosten.

    Zielfeld: u_subtotal

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    rechnungen.invoice_lines vendor_part_number Erforderlich. Teilenummer, die von einem Lieferanten für diese Rechnungsposition generiert wird.

    Zielfeld: u_supplier_part_number

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    rechnungen.invoice_lines tax_code Eindeutiger Steuercode, der aus der ERP-Quelle generiert wird.

    Zielfeld: u_tax_code

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    rechnungen.invoice_lines tax_details Liste der Steuerpositionen für Einkäufe, die der Rechnungsposition zugeordnet sind.

    Datentyp: Array von Objekten

    "tax_details": [
  {
    "tax_amount": "String",
    "tax_rate": "String",
    "tax_type": "String"
  }
]
    rechnungen.invoice_lines tax_details.tax_amount Erforderlich. Gesamtbetrag der Steuern, die für den Kauf in Rechnung gestellt werden.

    Zielfeld: u_tax_amount

    Zugehörige Tabelle: Import von Rechnungssteuerpositionen [sn_spend_intg_imp_invoice_tax_line]

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    rechnungen.invoice_lines tax_details.tax_rate Der vom Lieferanten erhobene Steuersatz

    Zielfeld: u_supplier_tax_rate

    Zugehörige Tabelle: Import von Rechnungssteuerpositionen [sn_spend_intg_imp_invoice_tax_line]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    rechnungen.invoice_lines tax_details.tax_type Typ der auf die Rechnung anzuwendenden Steuer. In der Tabelle „Steuertyp“ [sn_fin_tax_type] aufgeführt.

    Zielfeld: u_tax_type

    Zugehörige Tabelle: Import von Rechnungssteuerpositionen [sn_spend_intg_imp_invoice_tax_line]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    Rechnungen.invoice_lines.uom Basismaßeinheit, die zum Zählen des Artikels auf der Rechnung verwendet wird.

    Zielfeld: u_uom

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    rechnungen.rechnungstyp Typ der zu verarbeitenden Rechnung.

    Zielfeld: u_invoice_type

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    rechnungen.legal_entity Name der juristischen Person des Lieferanten. Befindet sich in der Tabelle „Juristische Person“ [sn_fin_legal_entity].

    Zielfeld: u_legal_entity

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    rechnungen.vorlage_rechnung Eindeutige Rechnungsnummer, die vom Lieferanten erstellt wurde.

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Zielfeld: u_Original_Invoice

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    rechnungen.other_charges Andere zusätzliche Gebühren, die der Rechnung zugeordnet sind. Dies ist ein bearbeitbares Feld.

    Zielfeld: u_other_charges

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    Rechnungen.payment_terms Der vereinbarte Zeitpunkt und die Bedingungen, unter denen eine Zahlung an einen Lieferanten erfolgt. Beispiel: Netto 30.

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    rechnungen.purchase_order Erforderlich. Kaufauftragsnummer, die der Kunde für diese Bestellung angegeben hat. In der Bestelltabelle [sn_shop_purchase_order] aufgeführt.

    Zielfeld: u_purchase_order

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    rechnungen.remit_address Erforderlich. Die Straße, an die die Zahlung erfolgt.

    Zielfeld: u_remit_address

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    rechnungen.remit_to_city Erforderlich. Die Stadt, an die die Zahlung erfolgt.

    Zielfeld: u_remit_to_city

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    rechnungen.remit_to_country Erforderlich. Das Land, an das die Zahlung erfolgt, im ISO 3166-Format. Beispiel: US.

    Zielfeld: u_remit_to_country

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    Rechnungen. remit_to_state_or_province Erforderlich. Das Bundesland oder der Kanton, an den die Zahlung erfolgt.

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    Rechnungen. remit_to_zip_or_postal_code Erforderlich. Die Postleitzahl, an die die Zahlung erfolgt.

    Zielfeld: u_remit_to_state_or_province

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    rechnungen.ship_from_city Stadt, aus der die Artikel auf der Bestellung versandt werden.

    Zielfeld: u_ship_from_city

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    rechnungen.ship_from_country Land, aus dem die Artikel auf der Bestellung versandt werden.

    Zielfeld: u_ship_from_country

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    Rechnungen. „ship_from_state_or_province“ Bundesland, aus dem die Artikel auf der Bestellung versendet werden.

    Zielfeld: u_ship_from_state_or_province

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    rechnungen.versand_von_straße Straße, von der die Artikel in der Bestellung versandt werden.

    Zielfeld: u_ship_from_street

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    Rechnungen. „ship_from_zip_or_postal_code“ Postleitzahl, von der die Artikel auf der Bestellung versendet werden.

    Zielfeld: u_ship_from_zip_or_postal_code

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    rechnungen.ship_to_city Stadt, in die die Artikel auf der Bestellung versandt werden.

    Zielfeld: u_ship_to_city

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    rechnungen.ship_to_country Land, an das die Artikel auf der Bestellung versandt werden.

    Zielfeld: u_ship_to_country

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    Rechnungen. „ship_to_state_or_province“ Bundesland, in das die Artikel auf der Bestellung versandt werden.

    Zielfeld: u_ship_to_state_or_province

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    rechnungen.ship_to_street Straße, an die die Artikel in der Bestellung versandt werden.

    Zielfeld: u_ship_to_street

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    Rechnungen. „ship_to_zip_or_postal_code“ Postleitzahl, an die die Artikel auf der Bestellung versendet werden.

    Zielfeld: u_ship_to_zip_or_postal_code

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    rechnungen.versand_betrag Erforderlich. Gesamtversandkosten für den gesamten Kauf.

    Zielfeld: u_shipping_amount

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    Rechnungen.Zwischensumme Erforderlich. Gesamtbetrag, der an den Lieferanten zu zahlen ist, ausschließlich Steuern und Versandkosten.

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 40
    Rechnungen.Lieferant Erforderlich. Bezeichner für den Reseller oder Lieferanten, bei dem der Kunde Bestellungen aufgeben kann.

    Zielfeld: u_supplier

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    Rechnungen. vendor_invoice_number Erforderlich. Identifikationsnummer, die von einem Lieferanten für diese Rechnung generiert wird.

    Zielfeld: u_supplier_invoice_number

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    rechnungen.supplier_tax_id Steuerbezeichner, der dem Drittpartei-Reseller zugeordnet ist. Dies ist ein bearbeitbares Feld.

    Zielfeld: u_supplier_tax_id

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Datentyp: Zeichenfolge

    Maximale Länge: 100
    rechnungen.target_erp ERP-Datensatz, in dem die Rechnung gebucht wird. Befindet sich in der Tabelle „ERP-Quelle“ [sn_fin_erp_source]. Weitere Informationen finden Sie unter ERP source.

    Datentyp: Zeichenfolge

    Header

    Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter Unterstützte REST API-Header.

    Tabelle : 10. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Inhaltstyp Datenformat des Anforderungstexts. Unterstützt nur application/json.
    Quellsystem Gibt das Quellsystem an, aus dem die Anforderung stammt.

    Mit dieser Einstellung kann bestimmt werden, ob die bereitgestellte Anforderung der Struktur in der Tabelle „Feldzuordnung für Rechnungsintegration“ [sn_spend_intg_invoice_intg_field_mapping] entspricht.
    Tabelle : 11. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Keine

    Statuscodes

    Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter HTTP-Antwortcodes der REST-API.

    Tabelle : 12. Statuscodes
    Statuscode Beschreibung
    202 Anforderung akzeptiert. Die Anforderung ist erfolgreich, und die Rechnungsverarbeitung wird ausgeführt.
    400 Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt.
    429 Zu viele Anforderungen. Die Anforderungsrate hat das Maximum von 10 Anforderungen pro Stunde überschritten.

    Parameter des Antwort-Haupttexts

    Name Beschreibung
    batch_id Eindeutiger Bezeichner für die Batch-Anforderung. Diese ID kann verwendet werden, um den Status der Anforderung zu verfolgen. Dieser Datensatz wird in der Tabelle „Rechnungsintegrationsprotokoll“ [sn_spend_intg_invoice_integration_log] gespeichert.

    Datentyp: Zeichenfolge
    Fehler Enthält eine Fehlermeldung und Details, wenn die Anforderung fehlschlägt.
    {
  "detail": String,
  "message": String
}

    Datentyp: Objekt
    Fehler.detail Zusätzliche Details zum Anforderungsfehler.
    Mögliche Ergebnisse:
    • ACL-Validierung auf API-Ebene fehlgeschlagen: Der Anwender hat keinen Lese-/Schreibzugriff auf die Ressource.
    • Quotenbegrenzung von 13 Anforderungen pro Stunde für Kreditorenrechnung überschritten – Die Anzahl der Datensätze im Batch überschreitet die festgelegte Batch-Größe.
    • Zur Angabe von Auth-Informationen erforderlich: Entweder ist das Passwort falsch oder der Anwendername falsch.

    Datentyp: Zeichenfolge
    Fehlernachricht Fehlermeldung, die den Grund für das Fehlschlagen der Anforderung enthält
    Mögliche Fehler:
    • Ungültige Nutzlast – Ungültiger Inhaltstyp.
    • Ungültige Nutzlast – Fehler: Ungültige Nutzlaststruktur.
    • Ungültige Nutzlast – Fehler: Nutzlast überschreitet das zulässige Rechnungslimit in einem Batch. Die Anzahl der Datensätze im Batch überschreitet die festgelegte Batch-Größe. Die maximale Nutzlastgröße beträgt standardmäßig 100 Datensätze. Dieser Wert ist in der Systemeigenschaft sn_spend_intg.ap.invoice.create.api.record_limit konfigurierbar.
    • Ungültige Nutzlast – Fehler: leere Rechnungen. Keine Daten zum Verarbeiten. Die Anzahl der Datensätze im Batch ist 0.
    • Quotenbegrenzung von 500 Anforderungen pro Stunde für APO-Rechnungserfassung überschritten.
    • Anwender nicht authentifiziert. Entweder ist das Passwort oder der Anwendername falsch.
    • ACL-Validierung auf API-Ebene fehlgeschlagen: Der Anwender hat keinen Lese-/Schreibzugriff auf die Ressource.

    Datentyp: Zeichenfolge
    Nachricht Erfolgsnachricht, z. B. Ihre Anforderung wurde erfolgreich empfangen und wird verarbeitet.

    Sie können den Status der Anforderung in der Tabelle „Rechnungsintegrationsprotokoll“ [sn_spend_intg_invoice_integration_log] anzeigen.

    Datentyp: Zeichenfolge
    status Gibt das Ergebnis der Anforderung an.
    Mögliche Werte:
    • Erfolg
    • Fehlgeschlagen

    Datentyp: Zeichenfolge

    cURL-Anforderung

    Das folgende Beispiel zeigt, wie eine Rechnung verarbeitet wird, die als Anforderung im JSON-Format bereitgestellt wurde.

    curl "https://instance.servicenow.com/api/sn_spend_intg/v1/ap_invoice/json" \
--request \
 POST \
--header \
 "Source-System: Coupa" \
--header \
 "Content-Type: application/json" \
--user 'username' \
:'password' \
--data \
 '{
    "invoices": [
        {
            "invoice_type": "non_po_invoice",
            "supplier_invoice_number": "SPOTLIGHT98",
            "external_invoice_number": "SPOTLIGHT98",
            "erp_number": "RTest12345",
            "purchase_order": "R0030R16537",
            "business_owner": "paula.smith@example.com",
            "supplier": "3245545",
            "original_invoice": "SIN188191",
            "invoice_date": "2023-08-15",
            "payment_terms": "Net 30",
            "legal_entity": "1000",
            "subtotal": "100.00",
            "shipping_amount": "50.00",
            "other_charges": "20.00",
            "discounts": "100.00",
            "amount_invoiced": "150.00",
            "currency": "USD",
            "invoice_line_count": "2",
            "ship_to_city": "",
            "ship_to_country": "USA",
            "ship_to_state_or_province": "NY",
            "ship_to_street": "123 Main St",
            "ship_to_zip_or_postal_code": "10001",
            "ship_from_city": "Los Angeles",
            "ship_from_country": "USA",
            "ship_from_state_or_province": "CA",
            "ship_from_street": "456 Oak Ave",
            "ship_from_zip_or_postal_code": "90001",
            "remit_address": "789 Elm St, Suite 200",
            "remit_to_city": "Chicago",
            "remit_to_country": "USA",
            "remit_to_state_or_province": "IL",
            "remit_to_zip_or_postal_code": "60601",
            "bill_to_city": "San Diego",
            "bill_to_country": "USA",
            "bill_to_state_or_province": "CA",
            "bill_to_street": "4810 Eastgate Mall",
            "bill_to_zip_or_postal_code": "92121",
            "supplier_tax_id": "123456789",
            "tax_details": [
                {
                    "tax_type": "Central Goods and Services Tax",
                    "tax_amount": "25",
                    "tax_rate": ""
                },
                {
                    "tax_type": "Sales tax",
                    "tax_amount": "10",
                    "tax_rate": "10"
                },
                {
                    "tax_type": "IGST",
                    "tax_amount": "",
                    "tax_rate": "15"
                },
                {
                    "tax_type": "State Goods and Service Tax",
                    "tax_amount": "20",
                    "tax_rate": "10"
                }
            ],
            "invoice_lines": [
                {
                    "external_invoice_number": "SPOTLIGHT98",
                    "line_description": "Laptop",
                    "line_quantity": "5",
                    "line_unit_price": "20.00",
                    "subtotal": "100.00",
                    "line_amount_invoiced": "100.00",
                    "purchase_order_line": "232432",
                    "po_line_description": "Mac laptop",
                    "currency": "USD",
                    "cost_center": "41605600",
                    "gl_account": "141101",
                    "tax_code": "A0 - Sales tax, standard rate",
                    "ship_to_city": "New York",
                    "ship_to_country": "USA",
                    "ship_to_state_or_province": "NY",
                    "ship_to_street": "123 Main St",
                    "ship_to_zip_or_postal_code": "10001",
                    "supplier_part_number": "SPN-001",
                    "uom": "Hours",
                    "tax_details": [
                        {
                            "tax_type": "Central Goods and Services Tax",
                            "tax_amount": "25",
                            "tax_rate": ""
                        },
                        {
                            "tax_type": "Sales tax",
                            "tax_amount": "",
                            "tax_rate": "10"
                        }
                    ]
                },
                {
                    "external_invoice_number": "SPOTLIGHT98",
                    "line_description": "Charger",
                    "line_quantity": "5",
                    "line_unit_price": "40.00",
                    "subtotal": "200.00",
                    "line_amount_invoiced": "200.00",
                    "purchase_order_line": "232432",
                    "po_line_description": "Mac laptop",
                    "currency": "USD",
                    "cost_center": "41605600",
                    "gl_account": "141101",
                    "tax_code": "A0 - Sales tax, standard rate",
                    "ship_to_city": "New York",
                    "ship_to_country": "USA",
                    "ship_to_state_or_province": "NY",
                    "ship_to_street": "123 Main St",
                    "ship_to_zip_or_postal_code": "10001",
                    "supplier_part_number": "SPN-001",
                    "uom": "Hours",
                    "tax_details": [
                        {
                            "tax_type": "Central Goods and Services Tax",
                            "tax_amount": "25",
                            "tax_rate": ""
                        },
                        {
                            "tax_type": "Sales tax",
                            "tax_amount": "",
                            "tax_rate": "10"
                        }
                    ]
                }
            ]
        }
    ],
    "target_erp": ""
}'

    Das folgende Ergebnis zeigt, dass die Anforderung erfolgreich war und die Rechnungsdaten verarbeitet werden. Sie können den Status der Anforderung in der Tabelle „Rechnungsintegrationsprotokoll“ [sn_spend_intg_invoice_integration_log] anzeigen. Verwenden Sie die in der Spalte „Batch ID“ aufgeführte Batch-ID, um die Rechnung zu finden.

    {
    "batchId": "APIINV1729711710733280",
    "status": "Success",
    "message": "Your request has been successfully received and is being processed."
}

    Kreditorenrechnung: POST sn_spend_intg/ap_invoice/xml

    Verarbeitet eine automatisierte Rechnung im XML-Format.

    Verwenden Sie die Tabelle „Rechnungsintegrationsfeldzuordnungen“ [sn_spend_intg_invoice_intg_field_mapping], um zu bestimmen, wie die Felder XML-Tags zugeordnet werden.

    Sie können anwenderdefinierte Rechnungsfelder für den Anforderungstext definieren. Verwenden Sie den folgenden Flow, um anwenderdefinierte Felder hinzuzufügen, Zieltabellen zuzuordnen und sie für die Verfügbarkeit in der Nutzlast zu formatieren:
    1. Fügen Sie anwenderdefinierte Felder für den Rechnungsimport hinzu
    2. Ordnen Sie anwenderdefinierte Felder zwischen Quell- und Zieltabellen zu
    3. Ordnen Sie einem Nutzlastquellformat anwenderdefinierte Felder zu

    URL-Format

    URL mit Versionsnummer: /api/sn_spend_intg/v1/ap_invoice/xml

    Standard-URL: /api/sn_spend_intg/ap_invoice/xml

    Unterstützte Anforderungsparameter

    Tabelle : 13. Pfadparameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden.

    Datentyp: Zeichenfolge
    Tabelle : 14. Abfrageparameter
    Name Beschreibung
    Keine
    Tabelle : 15. Anforderungstextelemente (XML)
    Pfad Beschreibung
    /Invoice/AmountInvoiced Gesamtbetrag, der an den Lieferanten zu zahlen ist, einschließlich Steuern und Versandkosten.

    Zielfeld: u_amount_invoiced

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    Rechnung/BillTocity Die Stadt, an die die Rechnung gesendet wird.

    Zielfeld: u_bill_to_city

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /Rechnung/BillToCountry Das Land, an das die Rechnung gesendet wird, im ISO 3166-Format. Beispiel: US.

    Zielfeld: u_bill_to_country

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /Invoice/BillToStateOrProvince Das Bundesland oder die Region, an das bzw. die die Rechnung gesendet wird.

    Zielfeld: u_bill_to_state_or_province

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /Invoice/BillToStreet Die Straße, an die die Rechnung gesendet wird.

    Zielfeld: u_bill_to_street

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /Invoice/BillToZipOrPostalCode Die Postleitzahl, an die die Rechnung gesendet wird.

    Zielfeld: u_bill_to_zip_or_postal_code
    /Rechnung/Währung Erforderlich Währung für die Zwischensumme, die Steuern und den Versand. Die Zwischensumme, die Steuern und der Versand müssen in derselben Währung angegeben sein.

    Zielfeld: u_currency

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /Rechnung/Datumsformat Legt das Rechnungsdatumsformat vom Standardformat JJJJ-MM-TT auf ein anderes unterstütztes Datumsformat fest. Der Datumswert wird im Element InvoiceDate festgelegt.
    Unterstützte Datumsformate:
    • TT MMM JJJJ
    • TT MMM, JJ
    • TT MMM, JJJJ
    • TT MMMM JJJJ
    • TT MMMM, JJ
    • TT MMMM, JJJJ
    • TT-MM-JJ
    • TT-MM-JJJJ
    • TT-MMM-JJ
    • TT-MMM-JJJJ
    • TT.MM.JJ
    • TT.MM.JJJJ
    • TT/MM/JJ
    • TT/MM/JJJJ
    • TT/MMM/JJJJ
    • MM-TT-JJ
    • MM-TT-JJJJ
    • MM.TT.JJ
    • MM.TT.JJJJ
    • MM/TT/JJ
    • MM/TT/JJJJ
    • MMM TT JJJJ
    • MMM TT, JJ
    • MMM TT, JJJJ
    • MMMM TT JJJJ
    • MMMM TT, JJ
    • MMMM TT, JJJJ
    • JJ-MM-TT
    • JJ.MM.TT
    • JJ/MM/TT
    • JJJJ-MM-TT (Standard)
    • JJJJ.MM.TT
    • JJJJ/MM/TT
    Hinweis:
    Der MMM-Formateintrag stellt einen Monat in seinen ersten drei Buchstaben dar, z. B. August. Der MMMM-Formateintrag gibt den vollständigen Monatsnamen an, z. B. August.

    Zielfeld: u_date_format

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Standardformat: JJJJ-MM-TT
    /Rechnung/Rabatte Rabatte, die auf die Rechnung angewendet werden.

    Zielfeld: u_discounts

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /Invoice/ExternalInvoiceNumber Rechnungsnummer, die aus einer Drittparteianwendung generiert wurde.

    Zielfeld: u_external_invoice_number

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /Invoice/InvoiceDate Datum, an dem dem Kunden eine Rechnung ausgestellt wurde. Verwenden Sie das Element DateFormat, um das Datum in einem unterstützten, nicht standardmäßigen Format hinzuzufügen.

    Zielfeld: u_invoice_date

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]

    Standardformat: JJJJ-MM-TT
    /Rechnung/LegalEntity Name der juristischen Person des Lieferanten. Befindet sich in der Tabelle „Juristische Person“ [sn_fin_legal_entity].

    Zielfeld: u_legal_entity

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /Rechnung/AndereGebühren Andere zusätzliche Gebühren, die der Rechnung zugeordnet sind. Dies ist ein bearbeitbares Feld.

    Zielfeld: u_other_charges

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /Rechnung/Zahlungsbedingungen Der vereinbarte Zeitpunkt und die Bedingungen, unter denen eine Zahlung an einen Lieferanten erfolgt. Beispiel: Netto 30.

    Zielfeld: u_payment_terms

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /Invoice/RemitAddress Die Straße, an die die Zahlung erfolgt.

    Zielfeld: u_remit_address
    Rechnung/RemitToStadt Die Stadt, an die die Zahlung erfolgt.

    Zielfeld: u_remit_to_city
    /RemitToCountry Das Land, an das die Zahlung erfolgt, im ISO 3166-Format. Beispiel: US.

    Zielfeld: u_remit_to_country
    /Invoice/RemitToStateOrProvince Das Bundesland oder der Kanton, an den die Zahlung erfolgt.

    Zielfeld: u_remit_to_state_or_province
    /RemitToZipOrPostalCode Die Postleitzahl, an die die Zahlung erfolgt.

    Zielfeld: u_remit_to_zip_or_postal_code
    /Rechnung/ShipFromStadt Stadt, aus der die Artikel auf der Bestellung versandt werden.

    Zielfeld: u_ship_from_city

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /Invoice/ShipFromCountry Land, aus dem die Artikel auf der Bestellung versandt werden.

    Zielfeld: u_ship_from_country

    Zugehörige Tabelle: Rechnungsposition [sn_spend_intg_imp_invoice]
    /Invoice/ShipFromStateOrProvince Bundesland, aus dem die Artikel auf der Bestellung versendet werden.

    Zielfeld: u_ship_from_state_or_province

    Zugehörige Tabelle: Rechnungsposition [sn_spend_intg_imp_invoice]
    /Invoice/ShipFromStreet Straße, von der die Artikel in der Bestellung versandt werden.

    Zielfeld: u_ship_from_street

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /Invoice/ShipFromZipOrPostalCode Postleitzahl, von der die Artikel auf der Bestellung versendet werden.

    Zielfeld: u_ship_from_zip_or_postal_code

    Zugehörige Tabelle: Rechnungsposition [sn_spend_intg_imp_invoice]
    /Rechnung/Versandbetrag Gesamtversandkosten für den gesamten Kauf.

    Zielfeld: u_shipping_amount

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /Rechnung/Zwischensumme Gesamtbetrag, der an den Lieferanten zu zahlen ist, ausschließlich Steuern und Versandkosten.

    Zielfeld: u_subtotal

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /Rechnung/Lieferant Bezeichner für den Reseller oder Lieferanten, bei dem der Kunde Bestellungen aufgeben kann.

    Zielfeld: u_supplier

    Zugehörige Tabelle: Rechnungsimport [sn_spend_intg_imp_invoice]
    /InvoiceLine/CostCenter Kontonummer der Kostenstelle, für die die Rechnung generiert wird. In der Tabelle „Kostenstelle“ [cmn_cost_center] aufgeführt.

    Zielfeld: u_cost_center
    /Rechnungsposition/Währung Währung für die Position. Beispiel: USD.

    Zielfeld: u_currency

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    /InvoiceLine/GLAccount Kontonummer des Hauptbuchs, das zum Generieren der Rechnung verwendet wird.

    Zielfeld: u_gl_account

    Siehe auch:
    /InvoiceLine/LineAmountInvoiced Gesamtkosten (ohne Steuern und Versand), die einem Kunden für eine bestimmte Bestellposition in Rechnung gestellt werden.

    Zielfeld: u_line_amount_invoiced

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    /InvoiceLine/LineDescription Beschreibung der Rechnungsposition.

    Zielfeld: u_line_description
    /InvoiceLine/LineQuantity Menge der Waren oder Dienstleistungen, die einem Kunden in Rechnung gestellt wird.

    Zielfeld: u_line_quantity
    /InvoiceLine/LineUnitPrice Stückpreis der Position auf der Rechnung.

    Zielfeld: u_line_unit_Price

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    /InvoiceLine/POLineDescription Beschreibung der Bestellposition für die Rechnung.

    Zielfeld: u_po_line_description

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    /InvoiceLine/PurchaseOrderLine Kaufauftragsnummer, die der Kunde für diese Bestellung angegeben hat. In der Bestelltabelle [sn_shop_purchase_order] aufgeführt.

    Zielfeld: u_purchase_order

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    /InvoiceLine/ShipTocity Stadt, in die die Artikel auf der Bestellung versandt werden.

    Zielfeld: u_ship_to_city

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    /InvoiceLine/ShipToCountry Land, an das die Artikel auf der Bestellung versandt werden.

    Zielfeld: u_ship_to_country

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    /InvoiceLine/ShipToStateOrProvince Bundesland oder Region, an das bzw. die die Artikel auf der Bestellung versandt werden.

    Zielfeld: u_ship_to_state_or_province
    /InvoiceLine/ShipToStreet Straße, an die die Artikel in der Bestellung versandt werden.

    Zielfeld: u_ship_to_street

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    /InvoiceLine/ShipToZipOrPostalCode Postleitzahl, an die die Artikel auf der Bestellung versendet werden.

    Zielfeld: u_ship_to_zip_or_postal_code

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    /InvoiceLine/Subtotal Gesamtbetrag, der an den Lieferanten zu zahlen ist, ausschließlich Steuern und Versandkosten.

    Zielfeld: u_subtotal

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    /InvoiceLine/SupplierPartNumber Teilenummer, die von einem Lieferanten für diese Rechnungsposition generiert wird.

    Zielfeld: u_supplier_part_number

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    /InvoiceLine/TaxCode Eindeutiger Steuercode, der aus der ERP-Quelle generiert wird.

    Zielfeld: u_tax_code

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    /InvoiceLine/UOM Basismaßeinheit, die zum Zählen des Artikels auf der Rechnung verwendet wird.

    Zielfeld: u_uom

    Zugehörige Tabelle: Rechnungspositionsimport [sn_spend_intg_imp_invoice_line]
    /TaxDetail/TaxType Typ der auf die Rechnung anzuwendenden Steuer. In der Tabelle „Steuertyp“ [sn_fin_tax_type] aufgeführt.

    Zielfeld: u_tax_type

    Zugehörige Tabelle: Import von Rechnungssteuerpositionen [sn_spend_intg_imp_invoice_tax_line]
    /TaxDetail/TaxRate Der vom Lieferanten erhobene Steuersatz

    Zugehörige Tabelle: Import von Rechnungssteuerpositionen [sn_spend_intg_imp_invoice_tax_line]

    Zielfeld: u_supplier_tax_rate

    Zugehörige Tabelle: Import von Rechnungssteuerpositionen [sn_spend_intg_imp_invoice_tax_line]

    Header

    Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter Unterstützte REST API-Header.

    Tabelle : 16. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Inhaltstyp Datenformat des Anforderungstexts. Unterstützt nur application/xml.
    Quellsystem Gibt das Quellsystem an, aus dem die Anforderung stammt.

    Verfügbare Systeme sind in der Tabelle „Anmeldeinformationen für Quellsysteme“ [sn_spend_intg_source_system_credential] aufgeführt.

    Mit dieser Einstellung kann bestimmt werden, ob die bereitgestellte Anforderung der Struktur in der Tabelle „Feldzuordnung für Rechnungsintegration“ [sn_spend_intg_invoice_intg_field_mapping] entspricht.

    Diese Einstellung wird auch verwendet, um Anmeldeinformationen aus der Tabelle „Anmeldeinformationen für Quellsystem“ [sn_spend_intg_source_system_credential] abzurufen.
    Tabelle : 17. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Keine

    Statuscodes

    Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter HTTP-Antwortcodes der REST-API.

    Tabelle : 18. Statuscodes
    Statuscode Beschreibung
    202 Anforderung akzeptiert. Die Anforderung ist erfolgreich, und die Rechnungsverarbeitung wird ausgeführt.
    400 Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt.
    429 Zu viele Anforderungen. Die Anforderungsrate hat das Maximum von 10 Anforderungen pro Stunde überschritten.

    Parameter des Antwort-Haupttexts

    Name Beschreibung
    batch_id Eindeutiger Bezeichner für die Batch-Anforderung. Diese ID kann verwendet werden, um den Status der Anforderung zu verfolgen. Dieser Datensatz wird in der Tabelle „Rechnungsintegrationsprotokoll“ [sn_spend_intg_invoice_integration_log] gespeichert.

    Datentyp: Zeichenfolge
    Fehler Enthält eine Fehlermeldung und Details, wenn die Anforderung fehlschlägt.
    {
  "detail": String,
  "message": String
}

    Datentyp: Objekt
    Fehler.detail Zusätzliche Details zum Anforderungsfehler.
    Mögliche Ergebnisse:
    • ACL-Validierung auf API-Ebene fehlgeschlagen: Der Anwender hat keinen Lese-/Schreibzugriff auf die Ressource.
    • Quotenbegrenzung von 13 Anforderungen pro Stunde für Kreditorenrechnung überschritten – Die Anzahl der Datensätze im Batch überschreitet die festgelegte Batch-Größe.
    • Zur Angabe von Auth-Informationen erforderlich: Entweder ist das Passwort falsch oder der Anwendername falsch.

    Datentyp: Zeichenfolge
    Fehlernachricht Fehlermeldung, die den Grund für das Fehlschlagen der Anforderung enthält
    Mögliche Fehler:
    • Ungültige Nutzlast – Ungültiger Inhaltstyp.
    • Ungültige Nutzlast – Fehler: Ungültige Nutzlaststruktur.
    • Ungültige Nutzlast – Fehler: Nutzlast überschreitet das zulässige Rechnungslimit in einem Batch. Die Anzahl der Datensätze im Batch überschreitet die festgelegte Batch-Größe. Die maximale Nutzlastgröße beträgt standardmäßig 100 Datensätze. Dieser Wert ist in der Systemeigenschaft sn_spend_intg.ap.invoice.create.api.record_limit konfigurierbar.
    • Ungültige Nutzlast – Fehler: leere Rechnungen. Keine Daten zum Verarbeiten. Die Anzahl der Datensätze im Batch ist 0.
    • Quotenbegrenzung von 500 Anforderungen pro Stunde für APO-Rechnungserfassung überschritten.
    • Anwender nicht authentifiziert. Entweder ist das Passwort oder der Anwendername falsch.
    • ACL-Validierung auf API-Ebene fehlgeschlagen: Der Anwender hat keinen Lese-/Schreibzugriff auf die Ressource.

    Datentyp: Zeichenfolge
    Nachricht Erfolgsnachricht, z. B. Ihre Anforderung wurde erfolgreich empfangen und wird verarbeitet.

    Sie können den Status der Anforderung in der Tabelle „Rechnungsintegrationsprotokoll“ [sn_spend_intg_invoice_integration_log] anzeigen.

    Datentyp: Zeichenfolge
    status Gibt das Ergebnis der Anforderung an.
    Mögliche Werte:
    • Erfolg
    • Fehlgeschlagen

    Datentyp: Zeichenfolge

    cURL-Anforderung

    Das folgende Beispiel zeigt, wie eine Rechnung verarbeitet wird, die als Anforderung im XML-Format bereitgestellt wurde.

    curl -X POST https://instance.servicenow.com/api/sn_spend_intg/v1/ap_invoice/xml \
-H "Source-System: Ariba" \
-H "Content-Type: application/json" \
-d '<Invoices>
    <Invoice>
        <InvoiceType>invoice</InvoiceType>
        <SupplierInvoiceNumber>S-432432425</SupplierInvoiceNumber>
        <ExternalInvoiceNumber>EXT-INV-003</ExternalInvoiceNumber>
        <Supplier>3245545</Supplier>
        <PurchaseOrder>0004511198</PurchaseOrder>
        <BusinessOwner>Paula Smith</BusinessOwner>
        <InvoiceDate>2023-09-02</InvoiceDate>
        <PaymentTerms>Net 60</PaymentTerms>
        <OriginalInvoice></OriginalInvoice>
        <LegalEntity></LegalEntity>
        <Subtotal>23985.00</Subtotal>
        <ShippingAmount>750.00</ShippingAmount>
        <OtherCharges></OtherCharges>
        <Discounts></Discounts>
        <AmountInvoiced>27073.54</AmountInvoiced>
        <Currency>USD</Currency>
        <InvoiceLineCount>2</InvoiceLineCount>
        <ShipToCity>Los Angeles</ShipToCity>
        <ShipToCountry>USA</ShipToCountry>
        <ShipToStateOrProvince>CA</ShipToStateOrProvince>
        <ShipToStreet>456 Oak Ave</ShipToStreet>
        <ShipToZipOrPostalCode>90001</ShipToZipOrPostalCode>
        <ShipFromCity>Addison</ShipFromCity>
        <ShipFromCountry>USA</ShipFromCountry>
        <ShipFromStateOrProvince>TX</ShipFromStateOrProvince>
        <ShipFromStreet>15725 Dallas P</ShipFromStreet>
        <ShipFromZipOrPostalCode>55555</ShipFromZipOrPostalCode>
        <RemitAddress>47 W 11th St</RemitAddress>
        <RemitToCity>New York</RemitToCity>
        <RemitToCountry>USA</RemitToCountry>
        <RemitToStateOrProvince>NY</RemitToStateOrProvince>
        <RemitToZipOrPostalCode>99999</RemitToZipOrPostalCode>
        <BillToStreet>4810 Eastgate Mall</BillToStreet>
        <BillToCity>San Diego</BillToCity>
        <BillToCountry>USA</BillToCountry>
        <BillToStateOrProvince>CA</BillToStateOrProvince>
        <BillToZipOrPostalCode>92121</BillToZipOrPostalCode>
        <SupplierTaxID>7894328742</SupplierTaxID>
        <TaxDetails>
            <TaxDetail>
                <TaxType>CGST</TaxType>
                <TaxAmount></TaxAmount>
                <TaxRate>15</TaxRate>
            </TaxDetail>
            <TaxDetail>
                <TaxType>SGST</TaxType>
                <TaxAmount>100</TaxAmount>
                <TaxRate></TaxRate>
            </TaxDetail>
        </TaxDetails>
        <InvoiceLines>
            <InvoiceLine>
                <ExternalInvoiceNumber>EXT-INV-002</ExternalInvoiceNumber>
                <LineDescription>NowX Laptop</LineDescription>
                <PurchaseOrderLine></PurchaseOrderLine>
                <LineQuantity>15</LineQuantity>
                <LineUnitPrice>1500.00</LineUnitPrice>
                <Subtotal>22500.00</Subtotal>
                <LineAmountInvoiced>24693.75</LineAmountInvoiced>
                <Currency>USD</Currency>
                <CostCenter></CostCenter>
                <GLAccount></GLAccount>
                <TaxCode></TaxCode>
                <ShipToCity></ShipToCity>
                <ShipToCountry></ShipToCountry>
                <ShipToStateOrProvince></ShipToStateOrProvince>
                <ShipToStreet></ShipToStreet>
                <ShipToZipOrPostalCode></ShipToZipOrPostalCode>
                <SupplierPartNumber></SupplierPartNumber>
                <UOM>Individual Unit</UOM>
                <TaxDetails>
                    <TaxDetail>
                        <TaxType>WHTTax</TaxType>
                        <TaxAmount>2193.75</TaxAmount>
                        <TaxRate>9.75</TaxRate>
                    </TaxDetail>
                </TaxDetails>
            </InvoiceLine>
            <InvoiceLine>
                <ExternalInvoiceNumber>EXT-INV-002</ExternalInvoiceNumber>
                <LineDescription>NowX Charger</LineDescription>
                <PurchaseOrderLine>PO-6789-001</PurchaseOrderLine>
                <LineQuantity>15</LineQuantity>
                <LineUnitPrice>99.00</LineUnitPrice>
                <Subtotal>1485.00</Subtotal>
                <LineAmountInvoiced>1629.79</LineAmountInvoiced>
                <Currency>USD</Currency>
                <CostCenter></CostCenter>
                <GLAccount></GLAccount>
                <TaxCode></TaxCode>
                <ShipToCity></ShipToCity>
                <ShipToCountry></ShipToCountry>
                <ShipToStateOrProvince></ShipToStateOrProvince>
                <ShipToStreet></ShipToStreet>
                <ShipToZipOrPostalCode></ShipToZipOrPostalCode>
                <SupplierPartNumber></SupplierPartNumber>
                <UOM>Individual Unit</UOM>
                <TaxDetails>
                    <TaxDetail>
                        <TaxType>GSTTax</TaxType>
                        <TaxAmount>144.79</TaxAmount>
                        <TaxRate>9.75</TaxRate>
                    </TaxDetail>
                    <TaxDetail>
                        <TaxType>CGST</TaxType>
                        <TaxAmount>1000</TaxAmount>
                        <TaxRate>12</TaxRate>
                    </TaxDetail>
                </TaxDetails>
            </InvoiceLine>
        </InvoiceLines>
    </Invoice>
    <Invoice>
        <InvoiceType>invoice</InvoiceType>
        <SupplierInvoiceNumber>S-432432426</SupplierInvoiceNumber>
        <ExternalInvoiceNumber>EXT-INV-006</ExternalInvoiceNumber>
        <Supplier>3245545</Supplier>
        <PurchaseOrder>0004511198</PurchaseOrder>
        <BusinessOwner>Paula Smith</BusinessOwner>
        <InvoiceDate>2023-09-02</InvoiceDate>
        <PaymentTerms>Net 60</PaymentTerms>
        <OriginalInvoice></OriginalInvoice>
        <LegalEntity></LegalEntity>
        <Subtotal>23985.00</Subtotal>
        <ShippingAmount>750.00</ShippingAmount>
        <OtherCharges></OtherCharges>
        <Discounts></Discounts>
        <AmountInvoiced>27073.54</AmountInvoiced>
        <Currency>USD</Currency>
        <InvoiceLineCount>2</InvoiceLineCount>
        <ShipToCity>Los Angeles</ShipToCity>
        <ShipToCountry>USA</ShipToCountry>
        <ShipToStateOrProvince>CA</ShipToStateOrProvince>
        <ShipToStreet>456 Oak Ave</ShipToStreet>
        <ShipToZipOrPostalCode>90001</ShipToZipOrPostalCode>
        <ShipFromCity>Addison</ShipFromCity>
        <ShipFromCountry>USA</ShipFromCountry>
        <ShipFromStateOrProvince>TX</ShipFromStateOrProvince>
        <ShipFromStreet>15725 Dallas P</ShipFromStreet>
        <ShipFromZipOrPostalCode>55555</ShipFromZipOrPostalCode>
        <RemitAddress>47 W 11th St</RemitAddress>
        <RemitToCity>New York</RemitToCity>
        <RemitToCountry>USA</RemitToCountry>
        <RemitToStateOrProvince>NY</RemitToStateOrProvince>
        <RemitToZipOrPostalCode>99999</RemitToZipOrPostalCode>
        <BillToStreet>4810 Eastgate Mall</BillToStreet>
        <BillToCity>San Diego</BillToCity>
        <BillToCountry>USA</BillToCountry>
        <BillToStateOrProvince>CA</BillToStateOrProvince>
        <BillToZipOrPostalCode>92121</BillToZipOrPostalCode>
        <SupplierTaxID>7894328742</SupplierTaxID>
        <TaxDetails>
            <TaxDetail>
                <TaxType>VATTax</TaxType>
                <TaxAmount>2338.54</TaxAmount>
                <TaxRate></TaxRate>
            </TaxDetail>
        </TaxDetails>
        <InvoiceLines>
            <InvoiceLine>
                <ExternalInvoiceNumber>EXT-INV-002</ExternalInvoiceNumber>
                <LineDescription>NowX Laptop</LineDescription>
                <PurchaseOrderLine></PurchaseOrderLine>
                <LineQuantity>15</LineQuantity>
                <LineUnitPrice>1500.00</LineUnitPrice>
                <Subtotal>22500.00</Subtotal>
                <LineAmountInvoiced>24693.75</LineAmountInvoiced>
                <Currency>USD</Currency>
                <CostCenter></CostCenter>
                <GLAccount></GLAccount>
                <TaxCode></TaxCode>
                <ShipToCity></ShipToCity>
                <ShipToCountry></ShipToCountry>
                <ShipToStateOrProvince></ShipToStateOrProvince>
                <ShipToStreet></ShipToStreet>
                <ShipToZipOrPostalCode></ShipToZipOrPostalCode>
                <SupplierPartNumber></SupplierPartNumber>
                <UOM>Individual Unit</UOM>
                <TaxDetails>
                </TaxDetails>
            </InvoiceLine>
            <InvoiceLine>
                <ExternalInvoiceNumber>EXT-INV-002</ExternalInvoiceNumber>
                <LineDescription>NowX Charger</LineDescription>
                <PurchaseOrderLine>PO-6789-001</PurchaseOrderLine>
                <LineQuantity>15</LineQuantity>
                <LineUnitPrice>99.00</LineUnitPrice>
                <Subtotal>1485.00</Subtotal>
                <LineAmountInvoiced>1629.79</LineAmountInvoiced>
                <Currency>USD</Currency>
                <CostCenter></CostCenter>
                <GLAccount></GLAccount>
                <TaxCode></TaxCode>
                <ShipToCity></ShipToCity>
                <ShipToCountry></ShipToCountry>
                <ShipToStateOrProvince></ShipToStateOrProvince>
                <ShipToStreet></ShipToStreet>
                <ShipToZipOrPostalCode></ShipToZipOrPostalCode>
                <SupplierPartNumber></SupplierPartNumber>
                <UOM>Individual Unit</UOM>
                <TaxDetails>
                </TaxDetails>
            </InvoiceLine>
        </InvoiceLines>
    </Invoice>
    <TargetERP>ERP1</TargetERP>
</Invoices>'

    Das folgende Ergebnis zeigt, dass die Anforderung erfolgreich war und die Rechnungsdaten verarbeitet werden. Sie können den Status der Anforderung in der Tabelle „Rechnungsintegrationsprotokoll“ [sn_spend_intg_invoice_integration_log] anzeigen. Verwenden Sie die in der Spalte „Batch ID“ aufgeführte Batch-ID, um die Rechnung zu finden.

    {
    "batchId": "APIINV1736249646168148",
    "status": "Success",
    "message": "Your request has been successfully received and is being processed."
}