---
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


---

# Kreditorenrechnungs-API

# Kreditorenrechnungs-API {#ariaid-title1}

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

Ermöglicht externen Systemen, z. B. denen, die von Lieferanten verwendet werden, die Rechnungen auf strukturierte und automatisierte Weise direkt an ein Kreditorenbuchhaltungssystem zu übermitteln.
Diese API erfordert Rechnungsbearbeitung für Kreditorenbuchhaltung(Com.sn_ap_apm) Store-Anwendung, die in bereitgestellt wird `sn_Ausgaben_intg `Namespace. Informationen hierzu finden Sie unter [Accounts Payable Invoice Processing](https://www.servicenow.com/docs/access?context=acc-pay-invoice-processing&version=yokohama&pubname=yokohama-source-to-pay-operations&ft:locale=en-US).  
Siehe [API-Entwicklerleitfaden für Kreditorenrechnungen](https://servicenow-prod.fluidtopics.net/WbThWfcfnhFuJejjYPPTdg#apInvoice-dev-guide "In diesem Entwicklerleitfaden wird beschrieben, wie anwenderdefinierte Rechnungsfelder definiert werden, die nicht standardmäßig mit bereitgestellt werden Kreditorenrechnung API für Rechnungsbearbeitung für Kreditorenbuchhaltung. Anweisungen zum Festlegen der Authentifizierung werden auch bereitgestellt, wenn cXML als Nutzlast verwendet wird.")Um Hilfe bei den folgenden Aufgaben zu erhalten:

* 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 werden festgelegt, wenn cXML als Nutzlast verwendet wird.
{#ap-invoice-api__ul_nns_lmr_tdc}  
Hinweis:  
Die maximale Standardnutzlastgröße beträgt 100 Datensätze. Dieser Wert ist in konfigurierbar sn_spend_intg.ap.invoice.create.api.record_limitSystemeigenschaft.

## Kreditorenrechnung: sn_spend_intg/ap_Invoice/cxml BUCHEN {#ariaid-title2}

Verarbeitet eine automatisierte Rechnung im Commerce-XML-Format (cXML).
Verwenden Sie die Tabelle „Feldzuordnungen für Rechnungsintegration" \[sn_spend_intg_invoice_intg_field_mapping\], um zu bestimmen, wie die Felder cXML-Tags zugeordnet werden.

Zusätzliche cXML-Ressourcen finden Sie unter CXML-Referenzhandbuch Um [https://xml.cxml.org](https://xml.cxml.org/current/cXMLReferenceGuide.pdf).

Anmeldeinformationen für diese API sind in der Nutzlast enthalten. Sie können Anmeldeinformationen in der Tabelle „Quellsystem-Anmeldeinformationen" \[sn_spend_intg_source_system_credential\] einrichten. Anweisungen finden Sie unter [Anmeldeinformationen für die Authentifizierung in der cXML-Nutzlast werden festgelegt](https://servicenow-prod.fluidtopics.net/WbThWfcfnhFuJejjYPPTdg#apInvoice-setCxmlCreds "Die sn_spend_intg/ap_Invoice/cxml Endpunkt wird in der Nutzlast mithilfe von Anmeldeinformationen authentifiziert, die in der Tabelle „Quellsystem-Anmeldeinformationen“ [sn_spend_intg_source_system_credential] gespeichert sind.").  
Sie können anwenderdefinierte Rechnungsfelder für den Anforderungstext definieren. Verwenden Sie den folgenden Flow, um anwenderdefinierte Felder hinzuzufügen, sie 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](https://servicenow-prod.fluidtopics.net/WbThWfcfnhFuJejjYPPTdg#apInvoice-addColToTable "Verwenden Sie das folgende Verfahren, um anwenderdefinierte Felder für Rechnungen, Rechnungspositionen und Rechnungssteuerpositionen hinzuzufügen, die mit verwendet werden sollen Kreditorenrechnung API.")
2. [Ordnen Sie anwenderdefinierte Felder zwischen Quell- und Zieltabellen zu](https://servicenow-prod.fluidtopics.net/WbThWfcfnhFuJejjYPPTdg#apInvoice-mapFieldsTransform "Verwenden Sie das folgende Verfahren, um anwenderdefinierte Felder zwischen Quell- und Zieltabellen für die Kreditorenrechnungs-API zuzuordnen.")
3. [Ordnen Sie anwenderdefinierte Felder einem Nutzlastquellenformat zu](https://servicenow-prod.fluidtopics.net/WbThWfcfnhFuJejjYPPTdg#apInvoice-mapFieldsTSrcFormat "Verwenden Sie das folgende Verfahren, um anwenderdefinierte Felder einem Nutzlasteintrag in JSON, cXML oder XML für die Kreditorenrechnungs-API zuzuordnen.")
{#ap_invoice-POST-cxml__ul_kcx_5fx_sdc}

### URL-Format

Versionierte URL: /api/sn_spend_intg/v1/ap_Invoice/cxml

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

### Unterstützte Anforderungsparameter

{#ap_invoice-POST-cxml__entry__2}{#ap_invoice-POST-cxml__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 1. Pfad-Parameter]

{#ap_invoice-POST-cxml__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 2. Abfrageparameter]

{#ap_invoice-POST-cxml__entry__10}

| Pfad | Beschreibung |
|-|-|
| /CXML/Header/from /Credential\[@Domain='VendorID'\]/Identity | Bezeichner für den Händler oder Lieferanten, bei dem der Kunde Bestellungen aufgeben kann. Zielfeld: u_Supplier Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] |
| /CXML/Anforderung/Rechnungsdetails Anforderung /RechnungsDetailRequestHeader\[@invoiceDate\] | Datum, an dem der Kunde in Rechnung gestellt wurde. Zielfeld: u_INVOICE_DATE Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] FORMAT: JJJJ-MM-TT |
| /CXML/Anforderung/Rechnungsdetails Anforderung /RechnungsDetailRequestHeader\[@invoiceID\] | Rechnungsnummer, die aus einer Drittpartei-Anwendung generiert wurde. Zielfeld: u_external_INVOICE_number Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] |
| /CXML/Anforderung/Rechnungsdetails Anforderung /RechnungsDetailRequestHeader\[@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/Anforderung/Rechnungsdetails Anforderung /RechnungsDetailRequestHeader/Rechnungspartner /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/Anforderung/Rechnungsdetails Anforderung /RechnungsDetailRequestHeader/Rechnungspartner /Contact\[@role='billTo'\]/PostalAddress/Land | Das Land, in das die Rechnung im ISO 3166-Format gesendet wird. Beispiel: `USA `. Zielfeld: u_Bill_to_Country Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] |
| /CXML/Anforderung/Rechnungsdetails Anforderung /RechnungsDetailRequestHeader/Rechnungspartner /Contact\[@role='billTo'\]/PostalAddress/State | Das Bundesland oder die Provinz, an das die Rechnung gesendet wird. Zielfeld: u_bill_to_state_or_province Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] |
| /CXML/Anforderung/Rechnungsdetails Anforderung /RechnungsDetailRequestHeader/Rechnungspartner /Contact\[@role='billTo'\]/PostalAddress/Straße | Die Straße, an die die Rechnung gesendet wird. Zielfeld: u_Bill_to_Street Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] |
| /CXML/Anforderung/Rechnungsdetails Anforderung /RechnungsDetailRequestHeader/Rechnungspartner /Contact\[@role='billTo'\]/PostalAddress/PostalCode | Die Postleitzahl, an die die Rechnung gesendet wird. Zielfeld: u_bill_to_zip_or_postal_code |
| Kontakt\[@role="remitTo"\]/Postadresse/Straße | Die Straße, an die die Zahlung erfolgt. Zielfeld: u_remit_address |
| Kontakt\[@role="remitTo"\]/Postadresse/Stadt | Die Stadt, an die die Zahlung erfolgt. Zielfeld: u_remit_to_City |
| Kontakt\[@role="remitTo"\]/Postadresse/Bundesland | Das Bundesland oder die Provinz, an das die Zahlung erfolgt. Zielfeld: u_remit_to_state_or_province |
| Kontakt\[@role="remitTo"\]/Postadresse /Postleitzahl | Die Postleitzahl, an die die Zahlung erfolgt. Zielfeld: u_remit_to_zip_or_postal_code |
| Kontakt\[@role="remitTo"\]/Postadresse /Land | Das Land, in das die Zahlung erfolgt, im ISO 3166-Format. Beispiel: `USA `. Zielfeld: u_remit_to_Country |
| /CXML/Anforderung/Rechnungsdetails Anforderung/RechnungsDetailRequestHeader /RechnungsDetailVersand/Kontakt\[@role="shipFrom"\]/Postadresse /Straße | Straße, von der die Artikel in der Bestellung versendet werden. Zielfeld: u_SHIP_from_Street Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] |
| /CXML/Anforderung/Rechnungsdetails Anforderung/RechnungsDetailRequestHeader /RechnungsDetailVersand/Kontakt\[@role="shipFrom"\]/Postadresse /Stadt | Stadt, aus der die Artikel in der Bestellung versandt werden. Zielfeld: u_SHIP_from_City Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] |
| /CXML/Anforderung/Rechnungsdetails Anforderung/RechnungsDetailRequestHeader /RechnungsDetailVersand/Kontakt\[@role="shipFrom"\]/Postadresse /Bundesland | Bundesland, aus dem die Artikel in der Bestellung versandt werden. Zielfeld: u_ship_from_state_or_province Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] |
| /CXML/Anforderung/Rechnungsdetails Anforderung/RechnungsDetailRequestHeader /RechnungsDetailVersand/Kontakt\[@role="shipFrom"\]/PostAddress /PostalCode | Postleitzahl, von der die Artikel auf der Bestellung versandt werden. Zielfeld: u_ship_from_zip_or_postal_code Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] |
| /CXML/Anforderung/Rechnungsdetails Anforderung/RechnungsDetailRequestHeader /RechnungsDetailVersand/Kontakt\[@role="shipFrom"\]/Postadresse /Land | Land, aus dem die Artikel in der Bestellung versandt werden. Zielfeld: u_SHIP_from_Country Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] |
| /CXML/Anforderung/Rechnungsdetails Anforderung/RechnungsDetailRequestHeader /Rechnungsdetails/Kontakt\[@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 in der Bestellung versendet werden sollen. Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] |
| Kontakt\[@role="ShipTo"\]/Postadresse/Straße | Straße, an die die Artikel in der Bestellung versendet werden. Zielfeld: u_SHIP_to_Street Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] |
| Kontakt\[@role="ShipTo"\]/Postadresse/Stadt | Stadt, an die die Artikel in der Bestellung versandt werden. Zielfeld: u_SHIP_to_City Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] |
| Kontakt\[@role="ShipTo"\]/Postadresse/Bundesland | Bundesland oder Kanton, an das die Artikel in der Bestellung versendet werden. Zielfeld: u_ship_to_state_or_province |
| Kontakt\[@role="ShipTo"\]/Postadresse /Postleitzahl | Postleitzahl, an die die Artikel in der Bestellung versandt werden. Zielfeld: u_ship_to_zip_or_postal_code Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] |
| Kontakt\[@role="ShipTo"\]/Postadresse /Land | Land, in das die Artikel in der Bestellung versandt werden. Zielfeld: u_SHIP_from_Country Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] |
| /CXML/Anforderung/Rechnungsdetails Anforderung /RechnungsDetailRequestHeader/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/Anforderung/Rechnungsdetails Anforderung/RechnungsDetailAnforderung/RechnungsDetailOrder /Rechnungsdetails Element\[@description\]/ | Beschreibung der Rechnungsposition. Zielfeld: u_line_description |
| /CXML/Anforderung/RechnungsdetailAnforderung/RechnungsDetailOrder /RechnungsDetailItem\[@quantity\]/ | Menge der Waren oder Services, für die ein Kunde in Rechnung gestellt wird. Zielfeld: u_line_quantity |
| /CXML/Anforderung/Rechnungsdetails Anforderung/RechnungsDetailAnforderung/RechnungsDetailOrder /RechnungsDetailElement/Verteilung/Buchhaltung /AccountingSegment\[1\]/Name | Kontonummer der Kostenstelle, für die die Rechnung generiert wird. Aufgeführt in der Tabelle „Kostenstelle" \[cmn_Cost_Center\]. Zielfeld: u_Cost_Center |
| /CXML/Anforderung/Rechnungsdetails Anforderung/RechnungsDetailAnforderung/RechnungsDetailOrder /RechnungsDetailElement/Verteilung/Buchhaltung /AccountingSegment\[2\]/Name | Kontonummer des Hauptbuchs, das zum Generieren der Rechnung verwendet wird. Zielfeld: u_gl_Account Siehe auch: * [ERP source](https://www.servicenow.com/docs/access?context=erp-source&version=yokohama&pubname=yokohama-source-to-pay-operations&ft:locale=en-US) * [Ledger account](https://www.servicenow.com/docs/access?context=ledger-account&version=yokohama&pubname=yokohama-source-to-pay-operations&ft:locale=en-US) {#ap_invoice-POST-cxml__ul_u23_b3r_cdc} |
| /CXML/Anforderung/Rechnungsdetails Anforderung/RechnungsDetailAuftrag /RechnungsDetailElement/TeilsummenBetrag/Geld | Gesamtbetrag des an den Lieferanten zu zahlenden Geldbetrags ohne Steuern und Versandkosten. Zielfeld: u_subtotal Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] |
| /CXML/Anforderung/Rechnungsdetails Anforderung/RechnungsDetailAuftrag /RechnungsDetailItem/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/Anforderung/Rechnungsdetails Anforderung/RechnungsDetailAnforderung/RechnungsDetailOrder /Rechnungsdetails OrderInfo/Bestellreferenz | Bestellnummer, die vom Kunden für diese Bestellung bereitgestellt wird. In der Tabelle „Bestellung" \[sn_shop_purchase_order\] aufgeführt. Zielfeld: u_Purchase_order Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] |
| /CXML/Anforderung/Rechnungsdetails Anforderung/RechnungsDetailAnforderung/RechnungsDetailOrder /Rechnungsdetails Element/UnitPrice/UnitOfMeasure | Basismaßeinheit (ME), die zum Zählen des Artikels in der Rechnung verwendet wird. Zielfeld: u_uom Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] |
| /CXML/Anforderung/Rechnungsdetails Anforderung/RechnungsDetailAuftrag /RechnungsDetailElement/Einheitspreis/Geld | Stückpreis der Position auf der Rechnung. Zielfeld: u_line_unit_price Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] |
| /CXML/Anforderung/Rechnungsdetails Anforderung/RechnungsDetailAuftrag /RechnungsDetailItem/EinheitPreis/Geld\[@currency\] | Währung für die Position. Beispiel: `USD `. Zielfeld: u_currency Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] |
| CXML/Anforderung/Rechnungsdetails Anforderung/Rechnungsdetails Auftrag /RechnungsDetailElement /RechnungsDetailElement /RechnungsDetailItemReference\[@lineNumber\] | Bestellpositions-ID für den referenzierten Lieferanten. In der Tabelle „Bestellposition" \[sn_shop_purchase_order_line\] aufgeführt. Zielfeld: u_Purchasing_order_line Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] |
| CXML/Anforderung/Rechnungsdetails Anforderung/Rechnungsdetails Bestellung /RechnungsDetailElement/RechnungsDetailElement/RechnungsDetailItemReferenz /ElementID/LieferantenteilID | 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/Anforderung/RechnungsdetailAnforderung/RechnungsDetailOrder /RechnungsDetailElement/RechnungsDetailItemReferenz /Beschreibung | Beschreibung der Bestellposition für die Rechnung. Zielfeld: u_po_line_description Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] |
| CXML/Anforderung/Rechnungsdetails Anforderung/RechnungsDetailAuftrag /RechnungsDetailElement/Steuer/Geld | 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/Anforderung/RechnungsdetailAnforderung/RechnungsDetailOrder /RechnungsDetailElement/Steuer/Beschreibung | Eindeutiger Steuercode, der aus der ERP-Quelle generiert wurde. Zielfeld: u_TAX_Code Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] |
| /CXML/Anforderung/Rechnungsdetails Anforderung/ RechnungsDetailzusammenfassung /SubtotalAmount/Money | Gesamtbetrag des an den Lieferanten zu zahlenden Geldbetrags ohne Steuern und Versandkosten. Zielfeld: u_subtotal Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] |
| /CXML/Anforderung/Rechnungsdetails Anforderung/RechnungsDetailzusammenfassung /Steuer/Geld | Gesamtbetrag der Steuern, die für den Kauf in Rechnung gestellt werden. Zielfeld: u_TAX_amount Zugehörige Tabelle: Import der Rechnungssteuerposition \[sn_spend_intg_imp_invoice_tax_line\] |
| /CXML/Anforderung/RechnungsdetailAnforderung/RechnungsDetailzusammenfassung /Steuer/Steuerdetail\[@category\] | Typ der auf die Rechnung anwendbaren Steuer. Aufgeführt in der Tabelle „Steuertyp" \[sn_fin_tax_type\]. Zielfeld: u_Tax_type Zugehörige Tabelle: Import der Rechnungssteuerposition \[sn_spend_intg_imp_invoice_tax_line\] |
| /CXML/Anforderung/RechnungsdetailAnforderung/RechnungsDetailzusammenfassung /Steuer/Steuerdetail\[@prozentageRate\] | Der vom Lieferanten berechnete Steuersatz. Zugehörige Tabelle: Import der Rechnungssteuerposition \[sn_spend_intg_imp_invoice_tax_line\] Zielfeld: u_Supplier_Tax_rate Zugehörige Tabelle: Import der Rechnungssteuerposition \[sn_spend_intg_imp_invoice_tax_line\] |
| /CXML/Anforderung/Rechnungsdetails Anforderung/RechnungsDetailzusammenfassung /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/Anforderung/Rechnungsdetails Anforderung/RechnungsDetailzusammenfassung /VersandAmount/Money | Gesamtversandkosten für den gesamten Einkauf. Zielfeld: u_Shipping_amount Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] |
| /CXML/Anforderung/Rechnungsdetails Anforderung/RechnungsDetailzusammenfassung /Bruttobetrag/Geld | Erforderlich. Währung für Zwischensumme, Steuer und Versand. Zwischensumme, Steuer und Versand müssen in derselben Währung angegeben sein. Zielfeld: u_currency Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] |
| /CXML/Anforderung/RechnungsdetailAnforderung/RechnungsDetailzusammenfassung /RechnungsDetailDiscount/Geld | Rabatte, die auf die Rechnung angewendet werden. Zielfeld: u_Rabatte Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] |
| /CXML/Anforderung/Rechnungsdetails Anforderung/RechnungsDetailzusammenfassung /NetAmount/Money | Gesamtbetrag des an den Lieferanten zu zahlenden Geldbetrags, einschließlich Steuern und Versandkosten. Zielfeld: u_amount_Invoiced Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] |
[Tabelle : 3. Anforderungstext-Elemente (cXML)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#ap_invoice-POST-cxml__entry__114}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/xml. |
| Quellsystem | Gibt das Quellsystem an, aus dem die Anforderung stammt. Verfügbare Systeme werden in der Tabelle „Quellsysteme-Anmeldeinformationen" \[sn_spend_intg_source_system_credential\] aufgeführt. Diese Einstellung hilft zu bestimmen, ob die angegebene Anforderung der Struktur in der Zuordnungstabelle des Rechnungsintegrationsfelds \[sn_spend_intg_invoice_intg_field_mapping\] folgt. Diese Einstellung wird auch verwendet, um Anmeldeinformationen aus der Tabelle „Quellsystem-Anmeldeinformationen" \[sn_spend_intg_source_system_credential\] abzurufen. |
[Tabelle : 4. Anforderungskopfzeilen.]

{#ap_invoice-POST-cxml__entry__120}

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

### 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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#ap_invoice-POST-cxml__table_wqv_qxk_ddc__entry__2}{#ap_invoice-POST-cxml__entry-400-status-code}

| Statuscode | Beschreibung |
|-|-|
| 202 | Anforderung Akzeptiert. Die Anforderung ist erfolgreich, und die Rechnungsverarbeitung wird ausgeführt. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 429 | Zu viele Anforderungen. Die Anforderungsrate hat das Maximum von 10 Anforderungen pro Stunde überschritten. |
[Tabelle : 6. Statuscodes]

{#ap_invoice-POST-cxml__table_wqv_qxk_ddc}

### Antworttext-Parameter

{#ap_invoice-POST-cxml__entry__132}

| Name | Beschreibung |
|-|-|
| batch_id | Eindeutiger Bezeichner für die Batch-Anforderung. Diese ID kann verwendet werden, um den Status der Anforderung nachzuverfolgen. Dieser Datensatz wird in der Tabelle „Rechnungs-Integrationsprotokoll" \[sn_spend_intg_invoice_integration_log\] gespeichert. Datentyp: Zeichenfolge |
| Fehler | Enthält Fehlermeldung und Details, wenn die Anforderung fehlschlägt. { "detail": String, "message": String } Datentyp: Objekt |
| error.detail | Zusätzliche Details zum Anforderungsfehler. Mögliche Ergebnisse: * Fehler bei ACL-Validierung auf API-Ebene -- Anwender hat keinen Lese-/Schreibzugriff auf die Ressource. * Quotenlimit von 13 Anforderungen pro Stunde für Kreditorenrechnung überschritten -- die Anzahl der Datensätze im Batch ist größer als die festgelegte Batch-Größe. * Erforderlich, um Authentifizierungsinformationen anzugeben -- entweder ist das Passwort falsch oder der Anwendername ist falsch. {#ap_invoice-POST-cxml__ul_ukg_sht_c2c} Datentyp: Zeichenfolge |
| Fehler.Nachricht | Fehlermeldung mit dem Grund, warum die Anforderung fehlgeschlagen ist 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 ist größer als die festgelegte Batch-Größe. Die maximale Standardnutzlastgröße beträgt 100 Datensätze. Dieser Wert ist in konfigurierbar sn_spend_intg.ap.invoice.create.api.record_limitSystemeigenschaft. * Ungültige Nutzlast -- Fehler: Leere Rechnungen. Keine Daten zum Verarbeiten vorhanden. Die Anzahl der Datensätze im Batch ist null. * Quotenlimit von 500 Anforderungen pro Stunde für APO-Rechnungserfassung überschritten. * Anwender nicht authentifiziert Entweder ist das Passwort falsch oder der Anwendername ist falsch. * Fehler bei ACL-Validierung auf API-Ebene -- Anwender hat keinen Lese-/Schreibzugriff auf die Ressource. {#ap_invoice-POST-cxml__ul_knb_fhr_2dc} Datentyp: Zeichenfolge |
| Nachricht | Erfolgsmeldung, z. B. Ihre Anforderung wurde erfolgreich empfangen und wird verarbeitet . Sie können den Status der Anforderung in der Tabelle „Rechnungs-Integrationsprotokoll" \[sn_spend_intg_invoice_integration_log\] anzeigen. Datentyp: Zeichenfolge |
| Status | Gibt das Ergebnis der Anforderung an. Mögliche Werte: * Erfolg * Fehlgeschlagen {#ap_invoice-POST-cxml__ul_zfp_shr_2dc} Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung {#ap_invoice-POST-cxml__example_mnp_3dm_ddc}

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

    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 ist und die Rechnungsdaten verarbeitet werden. Sie können den Status der Anforderung in der Tabelle „Rechnungs-Integrationsprotokoll" \[sn_spend_intg_invoice_integration_log\] anzeigen. Verwenden Sie die Batch-ID, die in der Spalte Batch-ID aufgeführt ist, um die Rechnung zu finden.

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

## Kreditorenrechnung: sn_spend_intg/ap_Invoice/JSON BUCHEN {#ariaid-title3}

Verarbeitet eine automatisierte Rechnung im JSON-Format.
Erforderliche Rolle: sn_spend_intg.procurement_integrator

Verwenden Sie die Tabelle „Feldzuordnungen für Rechnungsintegration" \[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, sie 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](https://servicenow-prod.fluidtopics.net/WbThWfcfnhFuJejjYPPTdg#apInvoice-addColToTable "Verwenden Sie das folgende Verfahren, um anwenderdefinierte Felder für Rechnungen, Rechnungspositionen und Rechnungssteuerpositionen hinzuzufügen, die mit verwendet werden sollen Kreditorenrechnung API.")
2. [Ordnen Sie anwenderdefinierte Felder zwischen Quell- und Zieltabellen zu](https://servicenow-prod.fluidtopics.net/WbThWfcfnhFuJejjYPPTdg#apInvoice-mapFieldsTransform "Verwenden Sie das folgende Verfahren, um anwenderdefinierte Felder zwischen Quell- und Zieltabellen für die Kreditorenrechnungs-API zuzuordnen.")
3. [Ordnen Sie anwenderdefinierte Felder einem Nutzlastquellenformat zu](https://servicenow-prod.fluidtopics.net/WbThWfcfnhFuJejjYPPTdg#apInvoice-mapFieldsTSrcFormat "Verwenden Sie das folgende Verfahren, um anwenderdefinierte Felder einem Nutzlasteintrag in JSON, cXML oder XML für die Kreditorenrechnungs-API zuzuordnen.")
{#ap_invoice-POST-json__ul_kcx_5fx_sdc}

### URL-Format

Versionierte URL: /api/sn_spend_intg/v1/ap_Invoice/JSON

Standard-URL: /api/sn_spend_intg/ap_Invoice/JSON

### Unterstützte Anforderungsparameter

{#ap_invoice-POST-json__entry__2}{#ap_invoice-POST-json__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 7. Pfad-Parameter]

{#ap_invoice-POST-json__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 8. Abfrageparameter]

{#ap_invoice-POST-json__entry__10}

| Name | Beschreibung |
|-|-|
| Rechnungen | Liste, die jede zu verarbeitende Rechnung enthält. Datentyp: Objekt geschachtelter Rechnungsobjekte. "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 des an den Lieferanten zu zahlenden Geldbetrags, 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, in das die Rechnung im ISO 3166-Format gesendet wird. Beispiel: `USA `. Zielfeld: u_Bill_to_Country Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] |
| bill_to_state_or_province | Das Bundesland oder die Provinz, an das 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 auf 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 Zwischensumme, Steuer und Versand. Zwischensumme, Steuer und 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_Rabatte Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] Datentyp: Zeichenfolge Maximale Länge: 100 |
| Rechnungen.erp_Nummer | Eindeutige Nummer, die im ERP-System (Enterprise Resource Planning) für die Bestellung generiert wird. Informationen hierzu finden Sie unter [Purchase order integration](https://www.servicenow.com/docs/access?context=purchase-order-integration-2&version=yokohama&pubname=yokohama-source-to-pay-operations&ft:locale=en-US). 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 Drittpartei-Anwendung generiert wurde. Zielfeld: u_external_INVOICE_number Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] Datentyp: Zeichenfolge Maximale Länge: 40 |
| invoices.invoice_date | Erforderlich. Datum, an dem der Kunde in Rechnung gestellt wurde. Zielfeld: u_INVOICE_DATE Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] Datentyp: Zeichenfolge Maximale Länge: 40 FORMAT: JJJJ-MM-TT |
| invoices.invoice_line_count | Anzahl der Positionen in der Rechnung. Zielfeld: u_INVOICE_Line_COUNT Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] Datentyp: Zeichenfolge Maximale Länge: 40 |
| invoices.invoice_lines | Liste von Objekten, die die Positionen definieren, die für Einkäufe innerhalb dieses Auftrags in Rechnung gestellt werden. Rechnungspositionen werden in der Tabelle „eingehender Rechnungspositionsimport" \[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" } ] |
| invoices.invoice_lines. Cost_Center | Kontonummer der Kostenstelle, für die die Rechnung generiert wird. Aufgeführt in der Tabelle „Kostenstelle" \[cmn_Cost_Center\]. Zielfeld: u_Cost_Center Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] Datentyp: Zeichenfolge Maximale Länge: 40 |
| invoices.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 |
| invoices.invoice_lines. External_INVOICE_number | Erforderlich. Rechnungsnummer, die aus einer Drittpartei-Anwendung generiert wurde. Zielfeld: u_external_INVOICE_number Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] Datentyp: Zeichenfolge Maximale Länge: 40 |
| invoices.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: * [ERP source](https://www.servicenow.com/docs/access?context=erp-source&version=yokohama&pubname=yokohama-source-to-pay-operations&ft:locale=en-US) * [Ledger account](https://www.servicenow.com/docs/access?context=ledger-account&version=yokohama&pubname=yokohama-source-to-pay-operations&ft:locale=en-US) {#ap_invoice-POST-json__ul_u23_b3r_cdc} |
| invoices.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 |
| invoices.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 |
| invoices.invoice_lines. Line_quantity | Erforderlich. Menge der Waren oder Services, für die ein Kunde in Rechnung gestellt wird. Zielfeld: u_line_quantity Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] Datentyp: Zeichenfolge Maximale Länge: 40 |
| invoices.invoice_lines. Line_unit_price | 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 |
| invoices.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 |
| invoices.invoice_lines. Purchasing_order_line | Erforderlich. Bestellpositions-ID für den referenzierten Lieferanten. In der Tabelle „Bestellposition" \[sn_shop_purchase_order_line\] aufgeführt. Zielfeld: u_Purchasing_order_line Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] Datentyp: Zeichenfolge Maximale Länge: 40 |
| invoices.invoice_lines. Ship_to_City | Stadt, an die die Artikel in 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 |
| invoices.invoice_lines. Ship_to_Country | Land, in das die Artikel in 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 |
| invoices.invoice_lines. ship_to_state_or_province | Bundesland oder Kanton, an das die Artikel in der Bestellung versendet werden. Zielfeld: u_ship_to_state_or_province Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] Datentyp: Zeichenfolge Maximale Länge: 100 |
| invoices.invoice_lines. Ship_to_Street | Straße, an die die Artikel in der Bestellung versendet werden. Zielfeld: u_SHIP_to_Street Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] Datentyp: Zeichenfolge Maximale Länge: 100 |
| invoices.invoice_lines. ship_to_zip_or_postal_code | Postleitzahl, an die die Artikel in der Bestellung versandt 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 |
| invoices.invoice_lines. zwischensumme | Erforderlich. Gesamtbetrag des an den Lieferanten zu zahlenden Geldbetrags ohne Steuern und Versandkosten. Zielfeld: u_subtotal Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] Datentyp: Zeichenfolge Maximale Länge: 100 |
| invoices.invoice_lines. Supplier_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 |
| invoices.invoice_lines. TAX_Code | Eindeutiger Steuercode, der aus der ERP-Quelle generiert wurde. Zielfeld: u_TAX_Code Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] Datentyp: Zeichenfolge Maximale Länge: 100 |
| invoices.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" } ] |
| invoices.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 der Rechnungssteuerposition \[sn_spend_intg_imp_invoice_tax_line\] Datentyp: Zeichenfolge Maximale Länge: 40 |
| invoices.invoice_lines. Tax_Details.Tax_rate | Der vom Lieferanten berechnete Steuersatz. Zielfeld: u_Supplier_Tax_rate Zugehörige Tabelle: Import der Rechnungssteuerposition \[sn_spend_intg_imp_invoice_tax_line\] Datentyp: Zeichenfolge Maximale Länge: 100 |
| invoices.invoice_lines. Tax_Details.Tax_type | Typ der auf die Rechnung anwendbaren Steuer. Aufgeführt in der Tabelle „Steuertyp" \[sn_fin_tax_type\]. Zielfeld: u_Tax_type Zugehörige Tabelle: Import der Rechnungssteuerposition \[sn_spend_intg_imp_invoice_tax_line\] Datentyp: Zeichenfolge Maximale Länge: 100 |
| invoices.invoice_lines.uom | Basismaßeinheit (ME), die zum Zählen des Artikels in der Rechnung verwendet wird. Zielfeld: u_uom Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] Datentyp: Zeichenfolge Maximale Länge: 100 |
| invoices.invoice_type | 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_Entität | 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.Original_Invoice | 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.andere_Gebü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\] 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. Bestellnummer, die vom Kunden für diese Bestellung bereitgestellt wird. In der Tabelle „Bestellung" \[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, in das die Zahlung erfolgt, im ISO 3166-Format. Beispiel: `USA `. 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 die Provinz, an das 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 in der Bestellung versandt werden. Zielfeld: u_SHIP_from_City Datentyp: Zeichenfolge Maximale Länge: 100 |
| Rechnungen.Ship_from_Country | Land, aus dem die Artikel in 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 in der Bestellung versandt werden. Zielfeld: u_ship_from_state_or_province Datentyp: Zeichenfolge Maximale Länge: 100 |
| Rechnungen.Ship_from_Street | Straße, von der die Artikel in der Bestellung versendet 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 versandt werden. Zielfeld: u_ship_from_zip_or_postal_code Datentyp: Zeichenfolge Maximale Länge: 100 |
| Rechnungen.Ship_to_City | Stadt, an die die Artikel in 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, in das die Artikel in 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, an den die Artikel in 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 versendet 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 in der Bestellung versandt 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.Shipping_amount | Erforderlich. Gesamtversandkosten für den gesamten Einkauf. Zielfeld: u_Shipping_amount Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] Datentyp: Zeichenfolge Maximale Länge: 40 |
| Rechnungen.Zwischensumme | Erforderlich. Gesamtbetrag des an den Lieferanten zu zahlenden Geldbetrags ohne 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 Händler 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. Supplier_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-Wiederverkäufer 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 ERP-Quelltabelle \[sn_fin_erp_source\]. Weitere Informationen finden Sie unter [ERP source](https://www.servicenow.com/docs/access?context=erp-source&version=yokohama&pubname=yokohama-source-to-pay-operations&ft:locale=en-US). Datentyp: Zeichenfolge |
[Tabelle : 9. Anforderungstext-Parameter]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#ap_invoice-POST-json__entry__142}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
| Quellsystem | Gibt das Quellsystem an, aus dem die Anforderung stammt. Diese Einstellung hilft zu bestimmen, ob die angegebene Anforderung der Struktur in der Zuordnungstabelle des Rechnungsintegrationsfelds \[sn_spend_intg_invoice_intg_field_mapping\] folgt. |
[Tabelle : 10. Anforderungskopfzeilen.]

{#ap_invoice-POST-json__entry__148}

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

### 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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#ap_invoice-POST-json__table_wqv_qxk_ddc__entry__2}{#ap_invoice-POST-json__entry-400-status-code}

| Statuscode | Beschreibung |
|-|-|
| 202 | Anforderung Akzeptiert. Die Anforderung ist erfolgreich, und die Rechnungsverarbeitung wird ausgeführt. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 429 | Zu viele Anforderungen. Die Anforderungsrate hat das Maximum von 10 Anforderungen pro Stunde überschritten. |
[Tabelle : 12. Statuscodes]

{#ap_invoice-POST-json__table_wqv_qxk_ddc}

### Antworttext-Parameter {#ap_invoice-POST-json__section_hg4_h1l_ddc}

{#ap_invoice-POST-json__table_ig4_h1l_ddc__entry__2}

| Name | Beschreibung |
|-|-|
| batch_id | Eindeutiger Bezeichner für die Batch-Anforderung. Diese ID kann verwendet werden, um den Status der Anforderung nachzuverfolgen. Dieser Datensatz wird in der Tabelle „Rechnungs-Integrationsprotokoll" \[sn_spend_intg_invoice_integration_log\] gespeichert. Datentyp: Zeichenfolge |
| Fehler | Enthält Fehlermeldung und Details, wenn die Anforderung fehlschlägt. { "detail": String, "message": String } Datentyp: Objekt |
| error.detail | Zusätzliche Details zum Anforderungsfehler. Mögliche Ergebnisse: * Fehler bei ACL-Validierung auf API-Ebene -- Anwender hat keinen Lese-/Schreibzugriff auf die Ressource. * Quotenlimit von 13 Anforderungen pro Stunde für Kreditorenrechnung überschritten -- die Anzahl der Datensätze im Batch ist größer als die festgelegte Batch-Größe. * Erforderlich, um Authentifizierungsinformationen anzugeben -- entweder ist das Passwort falsch oder der Anwendername ist falsch. {#ap_invoice-POST-json__ul_ukg_sht_c2c} Datentyp: Zeichenfolge |
| Fehler.Nachricht | Fehlermeldung mit dem Grund, warum die Anforderung fehlgeschlagen ist 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 ist größer als die festgelegte Batch-Größe. Die maximale Standardnutzlastgröße beträgt 100 Datensätze. Dieser Wert ist in konfigurierbar sn_spend_intg.ap.invoice.create.api.record_limitSystemeigenschaft. * Ungültige Nutzlast -- Fehler: Leere Rechnungen. Keine Daten zum Verarbeiten vorhanden. Die Anzahl der Datensätze im Batch ist null. * Quotenlimit von 500 Anforderungen pro Stunde für APO-Rechnungserfassung überschritten. * Anwender nicht authentifiziert Entweder ist das Passwort falsch oder der Anwendername ist falsch. * Fehler bei ACL-Validierung auf API-Ebene -- Anwender hat keinen Lese-/Schreibzugriff auf die Ressource. {#ap_invoice-POST-json__ul_knb_fhr_2dc} Datentyp: Zeichenfolge |
| Nachricht | Erfolgsmeldung, z. B. Ihre Anforderung wurde erfolgreich empfangen und wird verarbeitet . Sie können den Status der Anforderung in der Tabelle „Rechnungs-Integrationsprotokoll" \[sn_spend_intg_invoice_integration_log\] anzeigen. Datentyp: Zeichenfolge |
| Status | Gibt das Ergebnis der Anforderung an. Mögliche Werte: * Erfolg * Fehlgeschlagen {#ap_invoice-POST-json__ul_zfp_shr_2dc} Datentyp: Zeichenfolge |
[ ]

{#ap_invoice-POST-json__table_ig4_h1l_ddc}  

### Curl-Anforderung

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

    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 ist und die Rechnungsdaten verarbeitet werden. Sie können den Status der Anforderung in der Tabelle „Rechnungs-Integrationsprotokoll" \[sn_spend_intg_invoice_integration_log\] anzeigen. Verwenden Sie die Batch-ID, die in der Spalte Batch-ID aufgeführt ist, um die Rechnung zu finden.

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

## Kreditorenrechnung: sn_spend_intg/ap_Invoice/xml BUCHEN {#ariaid-title4}

Verarbeitet eine automatisierte Rechnung im XML-Format.
Verwenden Sie die Tabelle „Feldzuordnungen für Rechnungsintegration" \[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, sie 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](https://servicenow-prod.fluidtopics.net/WbThWfcfnhFuJejjYPPTdg#apInvoice-addColToTable "Verwenden Sie das folgende Verfahren, um anwenderdefinierte Felder für Rechnungen, Rechnungspositionen und Rechnungssteuerpositionen hinzuzufügen, die mit verwendet werden sollen Kreditorenrechnung API.")
2. [Ordnen Sie anwenderdefinierte Felder zwischen Quell- und Zieltabellen zu](https://servicenow-prod.fluidtopics.net/WbThWfcfnhFuJejjYPPTdg#apInvoice-mapFieldsTransform "Verwenden Sie das folgende Verfahren, um anwenderdefinierte Felder zwischen Quell- und Zieltabellen für die Kreditorenrechnungs-API zuzuordnen.")
3. [Ordnen Sie anwenderdefinierte Felder einem Nutzlastquellenformat zu](https://servicenow-prod.fluidtopics.net/WbThWfcfnhFuJejjYPPTdg#apInvoice-mapFieldsTSrcFormat "Verwenden Sie das folgende Verfahren, um anwenderdefinierte Felder einem Nutzlasteintrag in JSON, cXML oder XML für die Kreditorenrechnungs-API zuzuordnen.")
{#ap_invoice-POST-xml__ul_kcx_5fx_sdc}

### URL-Format

Versionierte URL: /api/sn_spend_intg/v1/ap_Invoice/xml

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

### Unterstützte Anforderungsparameter

{#ap_invoice-POST-xml__entry__2}{#ap_invoice-POST-xml__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 13. Pfad-Parameter]

{#ap_invoice-POST-xml__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 14. Abfrageparameter]

{#ap_invoice-POST-xml__entry__10}

| Pfad | Beschreibung |
|-|-|
| /Rechnung/AngestelltFakturiert | Gesamtbetrag des an den Lieferanten zu zahlenden Geldbetrags, einschließlich Steuern und Versandkosten. Zielfeld: u_amount_Invoiced Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] |
| Rechnung/AbrechnungsToCity | Die Stadt, an die die Rechnung gesendet wird. Zielfeld: u_Bill_to_City Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] |
| /Rechnung/RechnungsToCountry | Das Land, in das die Rechnung im ISO 3166-Format gesendet wird. Beispiel: `USA `. Zielfeld: u_Bill_to_Country Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] |
| /Invoice/BillToStateOrProvince | Das Bundesland oder die Provinz, an das die Rechnung gesendet wird. Zielfeld: u_bill_to_state_or_province Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] |
| /Rechnung/BillToStreet | Die Straße, an die die Rechnung gesendet wird. Zielfeld: u_Bill_to_Street Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] |
| /Rechnung/RechnungsToZipOrPostleitzahl | Die Postleitzahl, an die die Rechnung gesendet wird. Zielfeld: u_bill_to_zip_or_postal_code |
| /Rechnung/Währung | Erforderlich. Währung für Zwischensumme, Steuer und Versand. Zwischensumme, Steuer und Versand müssen in derselben Währung angegeben sein. Zielfeld: u_currency Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] |
| /Invoice/DATEFORMAT | Legt das Rechnungsdatumsformat vom Standard JJJJ-MM-TT auf ein anderes unterstütztes Datumsformat fest. Der Datumswert wird in festgelegt InvoiceDateElement. 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/mm/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 {#ap_invoice-POST-xml__ul_d12_xkt_c2c} Hinweis: Der Eintrag im MMM-Format stellt einen Monat in den ersten drei Buchstaben dar, z. B. Aug Der Eintrag im MMMM-Format stellt den vollständigen Monatsnamen dar, 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_Rabatte Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] |
| /Invoice/ExternalInvoiceNumber | Rechnungsnummer, die aus einer Drittpartei-Anwendung generiert wurde. Zielfeld: u_external_INVOICE_number Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] |
| /Rechnung/Rechnungsdatum | Datum, an dem der Kunde in Rechnung gestellt wurde.Verwenden Sie DateFormatElement zum Hinzufügen des Datums in einem unterstützten nicht standardmäßigen Format. 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/sonstige Gebü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\] |
| /Rechnung/Überweisungsadresse | Die Straße, an die die Zahlung erfolgt. Zielfeld: u_remit_address |
| Rechnung/Überweisungsort | Die Stadt, an die die Zahlung erfolgt. Zielfeld: u_remit_to_City |
| /Rechnung/RemitToCountry | Das Land, in das die Zahlung erfolgt, im ISO 3166-Format. Beispiel: `USA `. Zielfeld: u_remit_to_Country |
| /Rechnung/ÜberweisungOStateOProvince | Das Bundesland oder die Provinz, an das die Zahlung erfolgt. Zielfeld: u_remit_to_state_or_province |
| /Rechnung/RemitToPostleitzahl | Die Postleitzahl, an die die Zahlung erfolgt. Zielfeld: u_remit_to_zip_or_postal_code |
| /Rechnung/LieferFromCity | Stadt, aus der die Artikel in der Bestellung versandt werden. Zielfeld: u_SHIP_from_City Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] |
| /Rechnung/VersandFromCountry | Land, aus dem die Artikel in der Bestellung versandt werden. Zielfeld: u_SHIP_from_Country Zugehörige Tabelle: Rechnungsposition \[sn_spend_intg_imp_invoice\] |
| /Rechnung/Versandstatus OrProvince | Bundesland, aus dem die Artikel in der Bestellung versandt werden. Zielfeld: u_ship_from_state_or_province Zugehörige Tabelle: Rechnungsposition \[sn_spend_intg_imp_invoice\] |
| /Rechnung/Versandstraße | Straße, von der die Artikel in der Bestellung versendet werden. Zielfeld: u_SHIP_from_Street Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] |
| /Rechnung/VersandFromPostleitzahl | Postleitzahl, von der die Artikel auf der Bestellung versandt werden. Zielfeld: u_ship_from_zip_or_postal_code Zugehörige Tabelle: Rechnungsposition \[sn_spend_intg_imp_invoice\] |
| /Rechnung/VersandAmount | Gesamtversandkosten für den gesamten Einkauf. Zielfeld: u_Shipping_amount Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] |
| /Rechnung/Zwischensumme | Gesamtbetrag des an den Lieferanten zu zahlenden Geldbetrags ohne Steuern und Versandkosten. Zielfeld: u_subtotal Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] |
| /Rechnung/Lieferant | Bezeichner für den Händler oder Lieferanten, bei dem der Kunde Bestellungen aufgeben kann. Zielfeld: u_Supplier Zugehörige Tabelle: Rechnungsimport \[sn_spend_intg_imp_invoice\] |
| /Rechnungszeile/Kostenstelle | Kontonummer der Kostenstelle, für die die Rechnung generiert wird. Aufgeführt in der Tabelle „Kostenstelle" \[cmn_Cost_Center\]. 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\] |
| /Rechnungszeile/GLAccount | Kontonummer des Hauptbuchs, das zum Generieren der Rechnung verwendet wird. Zielfeld: u_gl_Account Siehe auch: * [ERP source](https://www.servicenow.com/docs/access?context=erp-source&version=yokohama&pubname=yokohama-source-to-pay-operations&ft:locale=en-US) * [Ledger account](https://www.servicenow.com/docs/access?context=ledger-account&version=yokohama&pubname=yokohama-source-to-pay-operations&ft:locale=en-US) {#ap_invoice-POST-xml__ul_u23_b3r_cdc} |
| /Rechnungszeile/ZeilenAmountInvoiced | 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\] |
| /Rechnungszeile/Positionsbeschreibung | Beschreibung der Rechnungsposition. Zielfeld: u_line_description |
| /Rechnungsposition/Positionsmenge | Menge der Waren oder Services, für die ein Kunde in Rechnung gestellt wird. Zielfeld: u_line_quantity |
| /Rechnungsposition/ZeilenUnitPrice | Stückpreis der Position auf der Rechnung. Zielfeld: u_line_unit_price Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] |
| /Rechnungszeile/POLineBeschreibung | Beschreibung der Bestellposition für die Rechnung. Zielfeld: u_po_line_description Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] |
| /Rechnungsposition/Bestellposition | Bestellnummer, die vom Kunden für diese Bestellung bereitgestellt wird. In der Tabelle „Bestellung" \[sn_shop_purchase_order\] aufgeführt. Zielfeld: u_Purchase_order Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] |
| /Rechnungszeile/Lieferort | Stadt, an die die Artikel in der Bestellung versandt werden. Zielfeld: u_SHIP_to_City Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] |
| /Rechnungszeile/LieferToCountry | Land, in das die Artikel in der Bestellung versandt werden. Zielfeld: u_SHIP_to_Country Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] |
| /Rechnungszeile/Lieferstatus OrProvince | Bundesland oder Kanton, an das die Artikel in der Bestellung versendet werden. Zielfeld: u_ship_to_state_or_province |
| /Rechnungslinie/Lieferadresse | Straße, an die die Artikel in der Bestellung versendet werden. Zielfeld: u_SHIP_to_Street Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] |
| /Rechnungsposition/VersandToPostleitzahl | Postleitzahl, an die die Artikel in der Bestellung versandt werden. Zielfeld: u_ship_to_zip_or_postal_code Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] |
| /Rechnungszeile/Zwischensumme | Gesamtbetrag des an den Lieferanten zu zahlenden Geldbetrags ohne Steuern und Versandkosten. Zielfeld: u_subtotal Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] |
| /Rechnungsposition/LieferantenPartNumber | 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\] |
| /Rechnungsposition/Steuercode | Eindeutiger Steuercode, der aus der ERP-Quelle generiert wurde. Zielfeld: u_TAX_Code Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] |
| /Rechnungsposition/ME | Basismaßeinheit (ME), die zum Zählen des Artikels in der Rechnung verwendet wird. Zielfeld: u_uom Zugehörige Tabelle: Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\] |
| /TaxDetail/TaxType | Typ der auf die Rechnung anwendbaren Steuer. Aufgeführt in der Tabelle „Steuertyp" \[sn_fin_tax_type\]. Zielfeld: u_Tax_type Zugehörige Tabelle: Import der Rechnungssteuerposition \[sn_spend_intg_imp_invoice_tax_line\] |
| /TaxDetail/Steuersatz | Der vom Lieferanten berechnete Steuersatz. Zugehörige Tabelle: Import der Rechnungssteuerposition \[sn_spend_intg_imp_invoice_tax_line\] Zielfeld: u_Supplier_Tax_rate Zugehörige Tabelle: Import der Rechnungssteuerposition \[sn_spend_intg_imp_invoice_tax_line\] |
[Tabelle : 15. Anforderungstext-Elemente (XML)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#ap_invoice-POST-xml__entry__106}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/xml. |
| Quellsystem | Gibt das Quellsystem an, aus dem die Anforderung stammt. Verfügbare Systeme werden in der Tabelle „Quellsysteme-Anmeldeinformationen" \[sn_spend_intg_source_system_credential\] aufgeführt. Diese Einstellung hilft zu bestimmen, ob die angegebene Anforderung der Struktur in der Zuordnungstabelle des Rechnungsintegrationsfelds \[sn_spend_intg_invoice_intg_field_mapping\] folgt. Diese Einstellung wird auch verwendet, um Anmeldeinformationen aus der Tabelle „Quellsystem-Anmeldeinformationen" \[sn_spend_intg_source_system_credential\] abzurufen. |
[Tabelle : 16. Anforderungskopfzeilen.]

{#ap_invoice-POST-xml__entry__112}

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

### 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 [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#ap_invoice-POST-xml__table_wqv_qxk_ddc__entry__2}{#ap_invoice-POST-xml__entry-400-status-code}

| Statuscode | Beschreibung |
|-|-|
| 202 | Anforderung Akzeptiert. Die Anforderung ist erfolgreich, und die Rechnungsverarbeitung wird ausgeführt. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 429 | Zu viele Anforderungen. Die Anforderungsrate hat das Maximum von 10 Anforderungen pro Stunde überschritten. |
[Tabelle : 18. Statuscodes]

{#ap_invoice-POST-xml__table_wqv_qxk_ddc}

### Antworttext-Parameter

{#ap_invoice-POST-xml__entry__124}

| Name | Beschreibung |
|-|-|
| batch_id | Eindeutiger Bezeichner für die Batch-Anforderung. Diese ID kann verwendet werden, um den Status der Anforderung nachzuverfolgen. Dieser Datensatz wird in der Tabelle „Rechnungs-Integrationsprotokoll" \[sn_spend_intg_invoice_integration_log\] gespeichert. Datentyp: Zeichenfolge |
| Fehler | Enthält Fehlermeldung und Details, wenn die Anforderung fehlschlägt. { "detail": String, "message": String } Datentyp: Objekt |
| error.detail | Zusätzliche Details zum Anforderungsfehler. Mögliche Ergebnisse: * Fehler bei ACL-Validierung auf API-Ebene -- Anwender hat keinen Lese-/Schreibzugriff auf die Ressource. * Quotenlimit von 13 Anforderungen pro Stunde für Kreditorenrechnung überschritten -- die Anzahl der Datensätze im Batch ist größer als die festgelegte Batch-Größe. * Erforderlich, um Authentifizierungsinformationen anzugeben -- entweder ist das Passwort falsch oder der Anwendername ist falsch. {#ap_invoice-POST-xml__ul_ukg_sht_c2c} Datentyp: Zeichenfolge |
| Fehler.Nachricht | Fehlermeldung mit dem Grund, warum die Anforderung fehlgeschlagen ist 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 ist größer als die festgelegte Batch-Größe. Die maximale Standardnutzlastgröße beträgt 100 Datensätze. Dieser Wert ist in konfigurierbar sn_spend_intg.ap.invoice.create.api.record_limitSystemeigenschaft. * Ungültige Nutzlast -- Fehler: Leere Rechnungen. Keine Daten zum Verarbeiten vorhanden. Die Anzahl der Datensätze im Batch ist null. * Quotenlimit von 500 Anforderungen pro Stunde für APO-Rechnungserfassung überschritten. * Anwender nicht authentifiziert Entweder ist das Passwort falsch oder der Anwendername ist falsch. * Fehler bei ACL-Validierung auf API-Ebene -- Anwender hat keinen Lese-/Schreibzugriff auf die Ressource. {#ap_invoice-POST-xml__ul_knb_fhr_2dc} Datentyp: Zeichenfolge |
| Nachricht | Erfolgsmeldung, z. B. Ihre Anforderung wurde erfolgreich empfangen und wird verarbeitet . Sie können den Status der Anforderung in der Tabelle „Rechnungs-Integrationsprotokoll" \[sn_spend_intg_invoice_integration_log\] anzeigen. Datentyp: Zeichenfolge |
| Status | Gibt das Ergebnis der Anforderung an. Mögliche Werte: * Erfolg * Fehlgeschlagen {#ap_invoice-POST-xml__ul_zfp_shr_2dc} Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung {#ap_invoice-POST-xml__example_mnp_3dm_ddc}

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

    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 ist und die Rechnungsdaten verarbeitet werden. Sie können den Status der Anforderung in der Tabelle „Rechnungs-Integrationsprotokoll" \[sn_spend_intg_invoice_integration_log\] anzeigen. Verwenden Sie die Batch-ID, die in der Spalte Batch-ID aufgeführt ist, um die Rechnung zu finden.

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


