Transferdienste
Ihr Leitfaden zur V5-Integration!
Durch die Integration von Übertragungen zwischen V5 Traceability und dem ERP-System eines Kunden können Übertragungsdetails, Übertragungseinzelposten und Planungsinformationen an V5 Traceability gesendet werden. Diese Übertragungen können dann über die V5 WMS-Software gesendet und empfangen werden. Anschließend können Informationen, z. B. welche Chargen gesendet und empfangen wurden, wie viel gesendet wurde, auf welcher Palette sich diese befanden usw., an das ERP zurückgesendet werden.
V5 kann in diesem Fall auch als Datenmaster fungieren und im System erstellte Überweisungen an das ERP senden.
Weitere Informationen zur Funktionsweise des Übertragungsmoduls in V5 Traceability finden Sie in unserem Modulhandbuch werden auf dieser Seite erläutert.
Inhaltsverzeichnis
1. Layout des Kontrollzentrums
In Bezug darauf, wie wir uns identifizieren können ‘Transfers’ , ‘Transfer Lines’ Im Vergleich zu dem, was wir im Kontrollzentrum sehen, können wir sehen, dass das obere Feld hier für die Übertragungen ist, wohin zu/von Standorten, externe Referenznummern usw. importiert werden können.
Im unteren linken Bereich können wir dann unsere Transferlinien hinzufügen, die Daten enthalten, die für die für den Transfer erforderlichen Waren und Mengen relevant sind.
Mit dem V5 Gateway können wir problemlos beide Panels einzeln oder zusammen bestücken.
Das untere rechte Feld enthält Daten dazu, woher die Artikel der Übertragung am „Von“-Standort entnommen und am „Nach“-Standort empfangen wurden. Diese Daten sind Teil des Exports, den wir vom V5-Gateway zurückerhalten können.
2. API-Links
Weitere Informationen zu den Definitionen dieser Datenbankklassen finden Sie unter den folgenden Links:
3. Integrationsvorlage
Die Integrationsvorlage für Transfers kann heruntergeladen werden werden auf dieser Seite erläutert.
4. Leitfaden für den Transferbereich
4.1. Primärschlüssel
Primärschlüssel sind die eindeutige Kennung für jede Tabelle innerhalb der V5-API. Für Transfers, das ist:
reference – Die eindeutige Referenznummer für die Überweisung. Im Wesentlichen die Nummer des Überweisungsauftrags.
Für TransferLines, der Primärschlüssel ist entweder:
reference + commodity.code – Die Überweisungsreferenz/-nummer zusammen mit der zu übertragenden Ware.
or
lineID – Für erweiterte Zwecke, bei denen dieselbe Ware in mehreren Zeilen erscheinen kann, können Sie anstelle der Übertragungsreferenz und des Warencodes eine Zeilen-ID als eindeutige Kennung angeben. Dies ist erforderlich, wenn mehr als eine Zeile derselben Ware in der Übertragung enthalten ist.
4.2. Benötigte Felder
Weitere Felder, die von SG benötigt werden, um einen gültigen Eintrag im Control Center auszufüllen, sind:
Für TransferLines:
quantityOrdered – die Menge der bestellten Ware.
Für Transfers:
fromLocation.code - der Ort, von dem aus die Überweisung gesendet wird.
toLocation.code - der Ort, an den die Überweisung gesendet wird.
4.3. Bevorzugte Felder
Bevorzugte Felder dienen dazu, der Übertragung weitere Daten hinzuzufügen. Sie sind zwar nicht erforderlich, aber nützlich, wenn es um die Funktionalität von V5 Traceability geht. Diese sind:
lineID - Wenn es oben nicht als Primärschlüssel verwendet wird, sollte dieses Feld einbezogen werden.
commodity.code – Wenn es oben nicht als Primärschlüssel verwendet wird, sollte dieses Feld einbezogen werden. Der Code der zu übertragenden Ware.
transfer.reference - Wenn es oben nicht als Primärschlüssel verwendet wird, sollte dieses Feld einbezogen werden.
Das oben Gesagte gilt für „transferLines'. Wir können dieselben Felder auf ' anwendentransfers' beim Hinzufügen ‘transferLine’ zu den ersten beiden Einträgen und Entfernen ‘transfer’ vom letzten.
4.4. Weitere Felder
Es können auch zusätzliche Felder eingebunden werden, wie z ‘transfer’:
comment – etwaige zusätzliche Kommentare zur Übertragung.
fromAddress – die Adresse, von der die Überweisung gesendet wird. Diese sind besiedelt ‘Site Addresses‘.
toAddress – die Adresse, an der die Überweisung eingeht.
directTransfer – ob diese Übertragung erfolgen soll Direkte Überweisung oder nicht.
Ähnlich wie oben, wenn Sie ein ' erstellentransferLine'-Datei können wir einfach durch Hinzufügen zur Übertragungsklasse wechseln ‘transfer’ an den Anfang der oben genannten Parameter.
5. Methodik
Angesichts der Art der ‘Transfer’ , ‘TransferLine’können wir Daten auf zwei Arten importieren:
- Wir können das benutzen ‘Transfer’ Endpunkt, um Übertragungen zu importieren und dann, wie wir weiter unten sehen werden, zum zu gelangen ‘TransferLine’ Klasse, um dann die Komponenteneinzelposten alle in einer Datei einzuschließen. Dies ist die logischste Methode zum Importieren ganzer Überweisungen, da nur ein Satz Kopfinformationen und dann die nachfolgenden Einzelposten erforderlich sind. Beachten Sie, dass dies auch der einzige Endpunkt ist, den wir zum Ändern der Header-Informationen für die Übertragung verwenden können.
- Wir können das benutzen ‘TransferLine’ Endpunkt, um Übertragungsleitungen zu ändern oder hinzuzufügen, sobald die Übertragung erstellt wurde. Dies kann immer noch zum Importieren ganzer Überweisungen verwendet werden, ist jedoch weniger effizient, da jede Überweisungsposition einen verschachtelten Verweis auf den Übertragungskopf (z. B. die Referenz) enthalten müsste. Wie oben angegeben, kann dieser Endpunkt nicht zum Vornehmen von Änderungen an den Transfer-Header-Informationen (Referenz/zu und von Standorten usw.) verwendet werden.
Welchen dieser Endpunkte wir verwenden, hängt weitgehend davon ab, ob wir einen JSON- oder CSV-Import verwenden. Diese können wir uns nun unten ansehen.
5.1. JSON – Importieren
Übertragung:
‘Transfer’ Endpunkt/URI importieren –
http://host:port/V5-API/api/integrate/import/transfer
Für diesen Beispielimport verwenden wir die ‘Transfer’ Endpunkt erstellen und eine grundlegende Importdatei einer Übertragung mit 2 Zeilen strukturieren, könnte dies etwa so aussehen:
Diese JSON-Beispieldatei kann heruntergeladen werden werden auf dieser Seite erläutert.
Wir können sehen, warum wir das verwenden würden ‘Transfer’ Endpunkt für dieses Format, da JSON-Dateien in der Lage sind, verschachtelte Daten zu speichern, sodass wir eingerückte Daten einschließen können ‘TransferLines’ Listen und anschließend ‘Commodity’ Datenpunkte im Import, die mithilfe des SG-API-Handbuchs ermittelt werden können. Zum Beispiel die ‘commodity code’ Der Datenpunkt kann über den folgenden Pfad im API-Handbuch gefunden werden:
Den Rest unserer benötigten Datenpunkte können wir mit einer ähnlichen Pfadfindungsmethode aufbauen.
Anhand der obigen Datei können wir sehen, dass unsere neue Übertragung im Control Center erstellt wurde.
Transferlinien:
‘TransferLine’ Endpunkt/URI importieren –
http://host:port/V5-API/api/integrate/import/transfer_line
Wie oben besprochen, können wir das verwenden ‘TransferLine’ Endpunkt zum Hinzufügen oder Bearbeiten von Zeilen einer vorhandenen Übertragung. Wir können auch Transfers über diesen Endpunkt hinzufügen, aber es ist wichtig zu bedenken, dass wir einen Transfer-Header nur mit dem bearbeiten können ‘Transfer’ URI oben. Beachten Sie außerdem, dass die Transferinformationen hier für jede Transferzeile verschachtelt werden müssten.
Wir können ein Beispiel für a sehen ‘TransferLine’ JSON-Datei unten, wo wir eine weitere Zeile zur Übertragung hinzufügen werden ‘TR-1882’ das wir oben erstellt haben:
Diese JSON-Beispieldatei kann heruntergeladen werden werden auf dieser Seite erläutert.
Sobald diese Anfrage gepostet wurde, können wir zum Kontrollzentrum zurückkehren und sehen, dass dieser Übertragung eine dritte Zeile hinzugefügt wurde.
5.2. JSON – Exportieren
In Bezug auf den Empfang von Dateien im Zusammenhang mit Rückübertragungen von der V5-API, wenn wir die Methodenzusammenfassungen unter überprüfen ‘IntegrationExport‘ Klasse, dann haben wir hier ein paar verschiedene Möglichkeiten:
Transfers:
Endpunkt/URI exportieren –
http://host:port/V5-API/api/integrate/export/transfers
Dieser Endpunkt exportiert vollständige JSON-Übertragungsdateien mithilfe der Übertragungsdatenbankklasse und schließt alle Übertragungen ein, die nicht bereits vom System als exportiert markiert wurden oder seit dem ersten Export geändert wurden. Dies beinhaltet keine Bestandsbewegungsdaten, sondern liefert vielmehr eine Rückgabe für jeden Datenpunkt im ‘Transfer’ Klasse.
Ein Beispiel für diese Art von JSON-Datei kann heruntergeladen werden werden auf dieser Seite erläutert.
Übertragung:
Endpunkt/URI exportieren –
http://host:port/V5-API/api/integrate/export/transfer/{referenceNumber}
Dieser Endpunkt exportiert vollständige JSON-Übertragungsdateien mithilfe der Übertragungsdatenbankklasse, jedoch nur für die angegebene Übertragung und nur, wenn diese Übertragung nicht bereits vom System als exportiert markiert wurde. Wie oben umfasst dies keine Bestandsbewegungsdaten, sondern liefert vielmehr eine Rückgabe für jeden Datenpunkt im ‘Transfer’ Klasse.
Ein Beispiel für diese Art von JSON-Datei kann heruntergeladen werden werden auf dieser Seite erläutert.
können wir auch verwerten Transaktions- und Protokollendpunkte um relevantere Informationen über die auf Bestellungen erhaltenen Waren abzurufen.
Für Transfers haben wir 1 Systemprotokoll Endpunkt, den wir verwenden können:
Systemprotokolle:
Endpunkt/URI exportieren –
http://host:port/V5-API/api/integrate/export/system_logs
Die Verwendung dieses Endpunkts gibt eine vollständige Liste der Systemprotokollereignisse zurück, die nicht als zuvor exportiert markiert wurden. Weitere Informationen zu diesem Endpunkt finden Sie hier werden auf dieser Seite erläutert. Diese Ergebnisse können gefiltert werden, um übertragungsspezifisch zu suchen Beschreibungen, sowie ‘MOVED OUT/IN’, ‘PALLET MOVED OUT/IN’ , ‘PALLET TRANSFER OUT/IN’.
Ein Beispiel für diese Art von JSON-Datei kann heruntergeladen werden werden auf dieser Seite erläutert.
5.3. CSV – Importieren
Beachten Sie, dass wir für CSV-Importe normalerweise nur verwenden würden ‘TransferLine’ Endpunkt, der es uns ermöglicht, Überweisungen und deren Einzelposten mithilfe eines einzigen CSV-Imports zu generieren.
Dateiname der Kopf-/Spaltendefinition: “transferLine.csvh”
Fertige Header-Dateien sollten abgelegt werden in: “<installdir>\SG Control Center\gateway\import\column_defs”
CSV-Dateiname importieren: “transferLine-datetime.csv”
CSVs für den Import sollten abgelegt werden in: “<installdir>\SG Control Center\gateway\import”
Header-Datei:
Header-Dateien werden im Allgemeinen von SG Systems kompiliert, bevor CSV-Integrationen stattfinden, aber wir sehen unten ein einfaches Beispiel dafür, wie wir es für Übertragungen verwenden können:
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:
Anschließend können wir die definierte Reihenfolge der Datenpunkte im Header verwenden, um unsere Importdatei zu strukturieren. SG Systems kann hierfür eine Vorlagendatei bereitstellen, die den Datenpunkt für jede Spalte auflistet, um die Dinge beim Ausfüllen der Liste klarer zu gestalten. Beachten Sie, dass diese erste Zeile vom Control Center ignoriert werden kann und daher bei der Übermittlung zum Import in der Datei beibehalten werden kann.
Hier sehen wir, dass wir eine ähnliche Übertragung anstreben wie die, die wir mit der JSON-Methodik erstellt haben. Diese Beispielimportdatei kann heruntergeladen werden werden auf dieser Seite erläutert.
Nach Abschluss des Imports können wir sehen, dass diese Übertragung zusammen mit den erforderlichen Einzelposten zum Control Center hinzugefügt wurde. Beachten Sie, dass, wenn die ‘Created Date’ Da die Daten nicht in den Import einbezogen werden, bezieht sich das eingegebene Datum auf das heutige Datum.
5.4. CSV – Exportieren
Wenn Sie Übertragungsinformationen über diese Methode exportieren möchten, wäre dies Teil eines ‘SystemLog’ Export. Wir können die Klassendefinitionen für diesen Endpunkt sehen werden auf dieser Seite erläutert.
Dateiname der Kopf-/Spaltendefinition: “SystemLog.csvh”
Fertige Header-Dateien sollten abgelegt werden in: “<installdir>\SG Control Center\gateway\export\order”
CSV-Dateiname exportieren: “SystemLog-datetime.csv”
CSVs für Exporte werden generiert in: “<installdir>\SG Control Center\gateway\export”
Dieser Endpunkt kann verwendet werden, um eine Vielzahl von Daten zu extrahieren, indem die verfügbaren Datenpunkte durchlaufen werden, die mit ihm verknüpft sind.
Header:
Wir können Datenpunkte verwenden wie ‘user’, ‘timestamp’ , ‘quantity’ auf dieser Spitze ‘System Log’ Ebene, aber dann können wir zum überqueren ‘TransferLine’ Klasse, um Felder wie die Referenznummer und die Waren hinzuzufügen, die bei der Übertragung angefordert wurden, sowie zum ‘Stock’ -Klasse, um Informationen wie die Orte abzurufen, aus denen die Elemente heraus-/hineinbewegt wurden.
Grundsätzlich könnte unser Teil des Systemprotokoll-Headers, der sich mit Übertragungen befasst, etwa so aussehen:
Diese Beispiel-Header-Datei kann heruntergeladen werden werden auf dieser Seite erläutert.
Wenn dieser Header vorhanden ist, sollten wir auch sicherstellen, dass wir den Export ausgewählt haben ‘System Logs’ im Export-Tab des Gateways im Control Center.
Wenn unser Header vorhanden und der Export aktiviert ist (vergessen Sie nicht, das Control Center neu zu starten, um alle im Gateway vorgenommenen Änderungen zu übernehmen!), erhalten wir anschließend eine Rückgabedatei für diese Übertragung (zusammen mit allen anderen zuvor nicht exportierten Übertragungen), die wie folgt aussieht: Das:
