Auftraggeber (Lieferanten & Kunden)

Über den Import-Endpunkt „Client“ können sowohl Lieferanten als auch Kunden im V5-Traceability-System angelegt werden, die dann zum Empfangen von Bestellungen bzw. zum Versenden von Verkaufsaufträgen verwendet werden können.

Zugehörige Integrationsleitfäden:

Kauforder

Verkaufsaufträge

Adresse 

In diesem Handbuch wird die Verwendung dieses „Client“-Endpunkts sowohl über den CSV-Import als auch über die Verwendung von JSON über die V5-API erläutert.

1. Kontrollzentrum-Layouts
2. API-Links
3. Client-Feldhandbuch
   1. Primärschlüssel
   2. Benötigte Felder
   3. Zusätzliche Felder
4. Beispieldatensatz
5. Methodik
   1. 1. JSON – Importieren
      2. CSV – Importieren

Die Zuordnung des Client-Endpunkts zu den Informationen im V5 Control Center betrifft sowohl die Fenster „ Lieferanten “ als auch „ Kunden “. Für Lieferanten gilt Folgendes:

Und für Kunden:

Weitere Informationen zu den Definitionen für diesen „Client“ und die zugehörige Datenbankklasse finden Sie unter dem folgenden Link:

Kunden 

Für den Import über den Endpunkt „Client“ lautet der Primärschlüssel:

Code – Der eindeutige Code für den Lieferanten oder Kunden.

Weitere Felder, die zum Erstellen eines gültigen Eintrags in V5 erforderlich sind:

Typ – der Kundentyp; dieser sollte für Lieferanten 0 und für Kunden 1 sein.

Weitere Optionen, die wir hier aus der Datenbankklasse „Client“ hinzufügen können, sind:

Name – Der Name des Lieferanten/Kunden.

Unterschrift erforderlich – eine 0 oder 1, um anzugeben, ob beim Empfang vom/Versand an den Kunden eine Unterschrift erforderlich ist.

Darüber hinaus gibt es einige zusätzliche Felder, die speziell für Lieferanten gelten :

Website – Die Website des Anbieters.

Currency_Name – zur Festlegung der Währung, die der Lieferant verwendet.

Und für Kunden :

LabelSet_Description – ermöglicht die Zuweisung eines Etikettensatzes zur Verwendung mit den Produkten dieses Kunden.

In diesem Teil betrachten wir den Import von einem Lieferanten und einem Kunden, um zu sehen, wie unsere Importmethoden in der Praxis funktionieren.

'Client' Import-Endpunkt/URI –

http://host:port/V5-API/api/integrate/import/client

Endpunktbeschreibung

Proben:

Mithilfe des Endpunkts „Client“ können wir eine Importdatei strukturieren, um einen Lieferanten und einen Kunden wie folgt hinzuzufügen:

Diese JSON-Beispieldatei kann hier heruntergeladen werden.

Sobald wir dies im System veröffentlicht haben, können wir sehen, dass der neue Lieferant hinzugefügt wurde:

Zusammen mit dem neuen Kunden:

Für CSV-Importe müssen wir zuerst eine Header-Datei für unsere Importe erstellen.

Dateiname für Header-/Spaltendefinitionen: „client.csvh“

Die fertigen Header-Dateien sollten in folgendem Verzeichnis abgelegt werden: „<installdir>\SG Control Center\gateway\import\column_defs“

Import-CSV-Dateiname: „client-datetime.csv“

Die CSV-Dateien für den Import sollten hier abgelegt werden: „<installdir>\SG Control Center\gateway\import“

Proben:

Header-Datei:

Unten sehen Sie ein Beispiel für eine Header-Datei. Wie oben fügen wir einen Kunden und einen Lieferanten mit denselben Parametern hinzu:

Weitere Informationen zur Struktur dieser Dateien finden Sie auf der Hauptseite zur Integration . Diese Beispiel-Headerdatei kann hier heruntergeladen werden.

CSV-Importdatei:

Wir können dann die definierte Reihenfolge der Datenpunkte im Header verwenden, um unsere Importdatei zu strukturieren. Beachten Sie, dass diese erste Zeile vom Control Center ignoriert und daher beim Senden zum Import in der Datei beibehalten werden kann. Ein Beispielimport basierend auf unseren oben genannten Anforderungen würde folgendermaßen aussehen:

Diese Beispielimportdatei kann hier heruntergeladen werden.

Wir können diese Datei dann wie oben definiert in unseren Importordner ziehen. Sobald der Import abgeschlossen ist, können wir erneut sehen, dass unser Lieferant:

Und Kunden wurden erstellt: