Adresse
Ihr Leitfaden zur V5-Integration!
Der Importendpunkt „Adresse“ kann verwendet werden, um Adressen zu Lieferanten und Kunden hinzuzufügen, die dann verwendet werden können für Versand , Empfang. Adressen können auch als 'Standortadressen', die verwendet werden für Transferdienste.
Verknüpfte Integrationshandbücher:
In diesem Handbuch wird die Verwendung dieses „Adress“-Endpunkts sowohl über den CSV-Import als auch über die Verwendung von JSON über die V5-API erläutert.
Inhaltsverzeichnis
1. Layout des Kontrollzentrums
Um zu sehen, wie wir den Adressendpunkt mit dem in Verbindung bringen können, was wir im V5 Control Center sehen, sehen wir uns hier die Tabelle „Kunde“ an. Die Tabelle „Lieferant“ würde auf die gleiche Weise funktionieren, da sowohl Lieferanten als auch Kunden denselben Endpunkt „Kunde“ teilen.
2. API-Links
Weitere Informationen zu den Definitionen dieser Datenbankklasse „Adresse“ finden Sie unter dem folgenden Link:
3. Adressfeld-Leitfaden
3.1. Primärschlüssel
Für den Import über den Endpunkt „Adresse“ lautet der Primärschlüssel:
Name - Der eindeutige Name für diese Adresse
3.2. Benötigte Felder
Weitere Felder, die zum Erstellen eines gültigen Eintrags in V5 erforderlich sind:
Typ – der Adresstyp. Dieser sollte 0 für die Verwendung mit Clients und 1 für die Verwendung als Site-Adresse für Übertragungen (Modlink) sein.
Client_Code – Wenn Sie eine Kundenadresse angeben, ist diese für die Verknüpfung mit dem Kunden/Lieferanten erforderlich.
3.3. Weitere Felder
Line1 - Die erste Zeile der Adresse.
Line2 - Die zweite Zeile der Adresse.
Line3 - Die dritte Zeile der Adresse.
Stadt – Die Stadt, in der sich die Adresse befindet.
Staat – Der Bundesstaat, in dem sich die Adresse befindet.
Land auswählen – Das Land, in dem sich die Adresse befindet.
PLZ – Die Postleitzahl der Adresse.
Kontakt – Ein Kontaktname für die Adresse.
– Mit der Adresse verknüpfte Telefonnummer.
E-Mail – Mit der Adresse verknüpfte E-Mail-Adresse.
Lieferadressen (sofern sie von der oben eingegebenen Adresse abweichen) und Kontakte/Details für den Notfallrückruf können hier ebenfalls hinzugefügt werden. In unserem Beispiel verwenden wir jedoch nur die oben genannten Datenpunkte.
4. Beispieldatensatz
In diesem Artikel werden wir versuchen, dem Kunden, der im CC-Feld oben angezeigt wird, eine Adresse hinzuzufügen. Dieser Kunde wurde dem System zuvor mit dem Befehl ' hinzugefügt.Kunden'-Endpunkt.
5. Methodik
5.1. JSON – Importieren
'Adresse' Import Endpunkt/URI –
http://host:port/V5-API/api/integrate/import/address
Proben:
Mithilfe des Endpunkts „Adresse“ können wir eine Importdatei für die oben genannten Ergänzungen wie folgt strukturieren:
Diese JSON-Beispieldatei kann heruntergeladen werden werden auf dieser Seite erläutert.
Nachdem wir dies im System gebucht haben, können wir sehen, dass diese Adresse dem Kunden „CUS01“ hinzugefügt wurde:
5.2. CSV – Importieren
Da Kunden/Lieferanten mehrere Adressen zugewiesen haben können, fügen wir dem Kunden „CUS01“, den wir im obigen JSON-Beispiel hinzugefügt haben, einfach eine weitere Adresse hinzu.
Für CSV-Importe müssen wir zuerst eine Header-Datei für unsere Importe erstellen.
Dateiname der Kopf-/Spaltendefinition: „adresse.csvh“
Fertige Header-Dateien sollten abgelegt werden in: „ \SG Control Center\gateway\import\column_defs“
CSV-Dateiname importieren: „Adresse-Datum/Uhrzeit.csv“
CSVs für den Import sollten abgelegt werden in: „ \SG Control Center\gateway\import”
Proben:
Header-Datei:
Unten sehen Sie ein Beispiel für eine Header-Datei. Wir verwenden dieselben Felder wie beim JSON-Import.
Weitere Informationen zur Strukturierung dieser Dateien finden Sie im Hauptintegrationsseite. Diese Beispiel-Header-Datei kann heruntergeladen werden werden auf dieser Seite erläutert.
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 heruntergeladen werden werden auf dieser Seite erläutert.
Wir können diese Datei dann wie oben definiert in unseren Importordner ablegen. Sobald der Import abgeschlossen ist, können wir sehen, dass diese Adresse demselben Kunden hinzugefügt wurde.
