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


---

# API-Entwicklerleitfaden für Kreditorenrechnungen

# API-Entwicklerleitfaden für Kreditorenrechnungen {#ariaid-title1}

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

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.
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.")
{#apInvoice-dev-guide__ul_kcx_5fx_sdc}

Definieren Sie Anmeldeinformationen für cXML-Nutzlasten in der Tabelle „Quellsystem-Anmeldeinformationen" \[sn_spend_intg_source_system_credential\]. 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.").  
Siehe auch:

* [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)
* [Kreditorenrechnungs-API](https://servicenow-prod.fluidtopics.net/OQZNJribPpmOPgqeeE8QMw#ap-invoice-api "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.")
{#apInvoice-dev-guide__ul_vlt_xxw_sdc}

## Fügen Sie anwenderdefinierte Felder für den Rechnungsimport hinzu {#ariaid-title2}

Verwenden Sie das folgende Verfahren, um anwenderdefinierte Felder für Rechnungen, Rechnungspositionen und Rechnungssteuerpositionen hinzuzufügen, die mit verwendet werden sollen Kreditorenrechnung API.

### Vorbereitungen

* Erforderliche Rolle: Administrator
* Anwendungsbereich:
{#apInvoice-addColToTable__ul_d2n_2k5_pdc}

### Prozedur

1. Navigieren zu AlleSystemdefinitionTabellenan.
2. Wählen Sie eine der folgenden Rechnungsimporttabellen aus:  
   * Rechnungsimport \[sn_spend_intg_imp_invoice\]
   * Rechnungspositionsimport \[sn_spend_intg_imp_invoice_line\]
   * Import der Rechnungssteuerposition \[sn_spend_intg_imp_invoice_tax_line\]
   {#apInvoice-addColToTable__ul_trr_2bg_tdc}
3. Auf Tabellenspalten Registerkarte auswählen Neu .
4. Wählen Sie einen Typ aus, der dem Feldwert zugeordnet ist (z. B. <kbd class="ph userinput">Ganzzahl </kbd>) Von Typ Menü.  
   Hinweis:  
   Eine Liste der gültigen Typen finden Sie unter [Field types reference](https://www.servicenow.com/docs/access?context=r_FieldTypes&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US).
5. Geben Sie einen aussagekräftigen Namen in ein Spaltenbezeichnung Feld.  
   Text, der die Bezeichnung enthält, wird automatisch in ausgefüllt Spaltenname Feld.
6. Wählen Sie Aus Speichern Oder Übermitteln .
7. Fügen Sie der Tabelle „Rechnung" \[sn_Shop_Invoice\] eine Spalte mit demselben Namen und Typ hinzu.  
   Hinweis:  
   Weitere Informationen zu Spalten und Feldern finden Sie unter [Exploring field administration](https://www.servicenow.com/docs/access?context=c_IntroductionToFields&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US).
8. [Ordnen Sie die Felder zwischen den 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.").
{#apInvoice-addColToTable__steps_uxf_c4g_ndc}

## Ordnen Sie anwenderdefinierte Felder zwischen Quell- und Zieltabellen zu {#ariaid-title3}

Verwenden Sie das folgende Verfahren, um anwenderdefinierte Felder zwischen Quell- und Zieltabellen für die Kreditorenrechnungs-API zuzuordnen.

### Vorbereitungen

* Erforderliche Rolle: Administrator
* Anwendungsbereich:
{#apInvoice-mapFieldsTransform__ul_d2n_2k5_pdc}

Erstellen Sie Tabellenspalten für die Zuordnung des neuen Felds aus der Quelltabelle zur Zieltabelle. Führen Sie die Schritte in aus [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.").

### Prozedur

1. Navigieren zu AlleSystem-ImportsätzeTransformationszuordnungenan.
2. Öffnen Sie die Transformationszuordnung der Tabelle „Rechnungsimport".
3. Klicken Sie Auf Neu Auf Feldzuordnungen Registerkarte.
4. Wählen Sie den Namen des anwenderdefinierten Felds aus Quellfeld Menü.
5. Wählen Sie den Namen des anwenderdefinierten Felds aus Zielfeld Menü.
6. Wählen Sie Aus Speichern Oder Übermitteln .
7. [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.").
{#apInvoice-mapFieldsTransform__steps_uxf_c4g_ndc}

## Ordnen Sie anwenderdefinierte Felder einem Nutzlastquellenformat zu {#ariaid-title4}

Verwenden Sie das folgende Verfahren, um anwenderdefinierte Felder einem Nutzlasteintrag in JSON, cXML oder XML für die Kreditorenrechnungs-API zuzuordnen.

### Vorbereitungen

* Erforderliche Rolle: Administrator
* Anwendungsbereich:
* [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.")
* [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.")
{#apInvoice-mapFieldsTSrcFormat__ul_d2n_2k5_pdc}

### Prozedur

1. Navigieren zu AlleBeschaffungsintegrationenLieferantenZuordnungen des Rechnungsintegrationsfeldsan.
2. Wählen Sie Neu.
3. Fügen Sie den Namen des Quellsystems zu hinzu Quellsystem Feld.  
   * Wenn diese Feldzuordnung für alle Quellsysteme gilt, geben Sie ein <kbd class="ph userinput">Standard </kbd>.
   * Wenn die Zuordnung spezifisch für ein bestimmtes Quellsystem ist, muss dieser Wert mit dem Wert des Quellsystem-Headerparameters übereinstimmen, der in der API empfangen wurde.  
     Hinweis:  
     Alle verbleibenden Feldzuordnungen müssen speziell für dieses Quellsystem konfiguriert werden.
   {#apInvoice-mapFieldsTSrcFormat__ul_ih3_rl2_tdc}
4. Wählen Sie das Format des Quellsystems aus, für das die Zuordnung erstellt wird Quellformat Auswahlliste (cXML oder JSON).
5. Geben Sie einen Namen (JSON-Eigenschaft) oder Pfad (cXML/XML-Attribut oder -Element) für den Nutzlasteintrag in an Quellfeld Feld.  
   Sie können die Tabelle „Rechnungsintegrationsfeldzuordnung" \[sn_spend_intg_invoice_intg_field_mapping\] mit Beispielen für cXML- und XML-Pfadeinstellungen anzeigen.
6. Fügen Sie den Namen eines Attributs hinzu, wenn das Feld als Elementattribut für cXML-Nutzlasten definiert werden soll. Lassen Sie andernfalls das Feld leer.
7. Wählen Sie den Namen der Zieltabelle aus, die Ihr anwenderdefiniertes Feld enthält Zugehörige Tabelle Liste.
8. Wählen Sie den Namen des anwenderdefinierten Felds aus Zielfeld Liste.
9. Wählen Sie Aus Speichern Oder Übermitteln .  
   Das zugeordnete Feld wird der Zuordnungstabelle für das Rechnungsintegrationsfeld \[sn_spend_intg_invoice_intg_field_mapping\] hinzugefügt.
{#apInvoice-mapFieldsTSrcFormat__steps_uxf_c4g_ndc}

## Anmeldeinformationen für die Authentifizierung in der cXML-Nutzlast werden festgelegt {#ariaid-title5}

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.

### Vorbereitungen

Erforderliche Rolle: Administrator

Identifizieren Sie das Quellsystem der Nutzlast, das in der Tabelle „Rechnungsintegrationsfeldzuordnungen" \[sn_spend_intg_invoice_intg_field_mapping\] aufgeführt ist.

Siehe auch [Kreditorenrechnung: sn_spend_intg/ap_Invoice/cxml BUCHEN](https://servicenow-prod.fluidtopics.net/OQZNJribPpmOPgqeeE8QMw#ap_invoice-POST-cxml "Verarbeitet eine automatisierte Rechnung im Commerce-XML-Format (cXML).").

### Prozedur

1. Navigieren zu AlleBeschaffungsintegrationenQuellsystem-Anmeldeinformationenan.
2. Wählen Sie Neu.
3. Fügen Sie den Namen des Quellsystems hinzu, das in der Tabelle „Rechnungsintegrationsfeldzuordnungen \[sn_spend_intg_invoice_intg_field_mapping\]" in aufgeführt ist Quellsystem Feld.  
   Der Quellsystemname muss mit dem Header-Parameter des Quellsystems übereinstimmen.
4. Fügen Sie den abzurufenden Anwendernamen in hinzu Anwendername Feld.  
   Verwenden Sie diesen Wert in /CXML/Header/to/Credential \[@Domain='NetworkID'\]/Identität Element.
5. Fügen Sie der eine starke Kombination aus Buchstaben, Ziffern und Sonderzeichen hinzu Passwort Feld.  
   Verwenden Sie diesen Wert in /CXML/Header/Absender/Anmeldeinformation \[@Domain='NetworkID'\]/SharedSecret Element.
6. Wählen Sie Absenden.
{#apInvoice-setCxmlCreds__steps_uxf_c4g_ndc}

