Entwicklerleitfaden für AP-Rechnungs-API

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, 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
2. Ordnen Sie anwenderdefinierte Felder zwischen Quell- und Zieltabellen zu
3. Ordnen Sie anwenderdefinierte Felder einem Nutzlastquellenformat zu

Definieren Sie Anmeldeinformationen für cXML-Nutzlasten in der Tabelle „Quellsystemanmeldeinformationen“ [sn_spend_intg_Source_System_credential]. Anweisungen dazu finden Sie unter Anmeldeinformationen für die Authentifizierung in der cXML-Nutzlast werden festgelegt.

Siehe auch:

• Accounts Payable Invoice Processing
• Kreditorenrechnungs-API

Fügen Sie anwenderdefinierte Felder für den Rechnungsimport hinzu

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:

Prozedur

1. Navigieren zu Alle > Systemdefinition > Tabellenan.
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]
3. Auf der Tabellenspalten Wählen Sie die Registerkarte aus Neu .
4. Wählen Sie einen Typ aus, der dem Feldwert zugeordnet ist (z. B. Ganzzahl ) Von Typ Menü.
   Hinweis:

   Eine Liste der gültigen Typen finden Sie unter Field types reference.
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 Speichern oder Absenden.
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.
8. Ordnen Sie die Felder zwischen den Quell- und Zieltabellen zu .

Ordnen Sie anwenderdefinierte Felder zwischen Quell- und Zieltabellen zu

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

Vorbereitungen

• Erforderliche Rolle: Administrator
• Anwendungsbereich:

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.

Prozedur

1. Navigieren zu Alle > System-Importsätze > Transformationszuordnungenan.
2. Öffnen Sie die Transformationszuordnung der Tabelle „Rechnungsimport“.
3. Klicken Sie Auf Neu Auf der 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 Speichern oder Absenden.
7. Ordnen Sie anwenderdefinierte Felder einem Nutzlastquellenformat zu.

Ordnen Sie anwenderdefinierte Felder einem Nutzlastquellenformat zu

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
• Ordnen Sie anwenderdefinierte Felder zwischen Quell- und Zieltabellen zu

Prozedur

1. Navigieren zu Alle > Beschaffungsintegrationen > Lieferanten > Zuordnungen 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 Standard .
   • Wenn die Zuordnung spezifisch für ein bestimmtes Quellsystem ist, muss dieser Wert mit dem Wert des in der API empfangenen Headerparameters „Quellsystem“ übereinstimmen.
     Hinweis:

     Alle verbleibenden Feldzuordnungen müssen speziell für dieses Quellsystem konfiguriert werden.
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 einen 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] für Beispiele 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 Speichern oder Absenden.
   Das zugeordnete Feld wird der Tabelle „Rechnungsintegrationsfeldzuordnung“ [sn_spend_intg_Invoice_intg_field_Mapping] hinzugefügt.

Anmeldeinformationen für die Authentifizierung in der cXML-Nutzlast werden festgelegt

Die sn_spend_intg/ap_Invoice/cxml Der 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.

Prozedur

1. Navigieren zu Alle > Beschaffungsintegrationen > Quellsystem-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] aufgeführt ist Quellsystem Feld.
   Der Quellsystemname muss mit dem Quellsystem-Header-Parameter übereinstimmen.
4. Fügen Sie den Anwendernamen hinzu, der in abgerufen werden soll Anwendername Feld.
   Verwenden Sie diesen Wert in /CXML/Header/to/Credential [@Domain='NetworkID']/Identity Element.
5. Fügen Sie dem eine starke Kombination aus Buchstaben, Zahlen und Sonderzeichen hinzu Passwort Feld.
   Verwenden Sie diesen Wert in /CXML/Header/Absender/Credential [@Domain='NetworkID']/SharedSecret Element.
6. Wählen Sie Absenden.