Transaktions- und Protokollendpunkte
Ihr Leitfaden zur V5-Integration!
Einführung
Zusätzlich zu den Exportendpunkten, die bisher in unseren V5-Integrationshandbüchern gezeigt wurden, verfügt die V5-API auch über mehrere Transaktionsendpunkte, die für die Rückgabe verwendet werden können Systemereignisdeskriptoren/logs an ein externes ERP.
Inhaltsverzeichnis
1. Systemprotokoll-Endpunkte
Generische Endpunkte können verwendet werden, um eine Vielzahl von zurückzugeben Beschreibungen über eine Reihe von verschiedene Module.
Diese Endpunkte geben komplexere Daten zurück als transaktionale/generische Endpunkte und enthalten häufig mehrere Sätze verschachtelter Daten im Zusammenhang mit Deskriptorereignissen. Dies ist zwar in dem Sinne nützlich, dass die richtigen Daten zurückgegeben werden, diese Endpunkte müssen jedoch häufig gefiltert werden, um die zurückgegebenen Daten optimal zu nutzen.
Was das für die V5-API ist, können wir unten sehen:
1.1. Systemprotokolle
Endpunkt/URI –
http://host:port/V5-API/api/integrate/export/system_logs
Dieser Endpunkt stellt eine JSON-Rückgabedatei bereit, die Folgendes enthält alle Systemereignis Beschreibungen und die sie betreffenden Daten. Wenn wir diesen Endpunkt erreichen, erhalten wir eine Rückgabe, die etwa so aussieht:
Wir können hier also sehen, dass wir, obwohl wir am unteren Rand dieses Bildes den Deskriptor „CONSUMED“ für einige Saffron Threads erhalten, die für einen Stapel verwendet werden, auch viele zusätzliche verschachtelte Daten erhalten, wie z. B. eine vollständige Klassenrückgabe für Lieferant und Standort, den wir hier sehen können.
In Ihrem ERP können Filter eingerichtet werden, um gezielt die Daten auszuwählen, die Sie sehen möchten.
Diese Beispieldatei kann heruntergeladen werden werden auf dieser Seite erläutert.
Nützlich zum:
1.2. Systemprotokoll
Endpunkt/URI –
http://host:port/V5-API/api/integrate/export/system_log/{id}
Dieser Endpunkt stellt eine JSON-Rückgabedatei bereit, die ähnlich strukturiert ist wie der Export „Systemprotokolle“ oben, aber hier können wir eine individuelle Protokoll-ID-Nummer angeben, für die die zugehörigen Informationen zurückgegeben werden sollen. Dies ist nützlich, wenn wir uns auf ein bestimmtes Ereignis konzentrieren möchten oder Deskriptor.
Ein Beispiel dieses Dateityps kann heruntergeladen werden werden auf dieser Seite erläutert.
Nützlich zum:
1.3. Anpassungssystemprotokolle
Endpunkt/URI –
http://host:port/V5-API/api/integrate/export/adjustment_logs
Dieser Endpunkt gibt eine JSON-Datei mit einer Liste von Systemprotokollereignissen mit der Angabe „ANPASSUNG“ zurück. Deskriptor, wodurch die Rückgabe von dem, was wir oben für „Systemprotokolle“ gesehen haben, auf Einträge eingegrenzt wird, die nur diesen Deskriptor enthalten. Dies trägt dazu bei, dem ERP je nach Bedarf relevantere Daten zur Verarbeitung bereitzustellen.
Ein Beispiel dieses Dateityps kann heruntergeladen werden werden auf dieser Seite erläutert.
Nützlich zum:
1.4. Verbrauchte/produzierte Systemprotokolle:
Endpunkt/URI –
http://host:port/V5-API/api/integrate/export/system_logs_cp
Dieser Endpunkt gibt eine JSON-Datei mit einer Liste von Systemprotokollereignissen mit entweder „CONSUMED“ oder „PRODUCED“ zurück. Deskriptor, wodurch die Rückgabe von dem, was wir oben für „Systemprotokolle“ gesehen haben, auf Einträge eingegrenzt wird, die diese Deskriptoren enthalten. Diese Protokolle beziehen sich auf den Hauptstapelprozess, insbesondere auf die Reduzierung und Produktion von Lagerbeständen. Dies trägt dazu bei, dem ERP je nach Bedarf relevantere Daten zur Verarbeitung bereitzustellen.
Ein Beispiel dieses Dateityps kann heruntergeladen werden werden auf dieser Seite erläutert.
Nützlich zum:
1.5. Nicht verbrauchte/produzierte Systemprotokolle:
Endpunkt/URI –
http://host:port/V5-API/api/integrate/export/system_logs_noncp
Dieser Endpunkt fungiert praktisch als Umkehrung des oben genannten Endpunkts „Konsumierte/produzierte Systemprotokolle“ und gibt eine JSON-Datei zurück, die Systemprotokolle mit allem anderen als „VERBRAUCHT“ oder „PRODUZIERT“ auflistet. Beschreibungen.
Nützlich zum:
1.6. Nutzungsprotokolle
Endpunkt/URI –
http://host:port/V5-API/api/integrate/export/batch_system_logs
Dieser Endpunkt gibt eine JSON-Datei mit einer Liste von Systemprotokollereignissen zurück, die sich auf die Stapelverarbeitung beziehen, wodurch die Rückgabe von dem, was wir oben für „Systemprotokolle“ gesehen haben, auf Einträge eingegrenzt wird, die Folgendes enthalten Beschreibungen wie „COLLATED“, „BATCH SUSPENDED“ usw. (sowie „CONSUMED“ und „PRODUCED“). Dies trägt dazu bei, dem ERP je nach Bedarf relevantere Daten zur Verarbeitung bereitzustellen.
Ein Beispiel dieses Dateityps kann heruntergeladen werden werden auf dieser Seite erläutert.
Nützlich zum:
1.7. Nutzungsprotokolle (Filterdatum)
Endpunkt/URI –
http://host:port/V5-API/api/integrate/export/batch_system_logs/filterFrom/{filterDate}
Dieser Endpunkt gibt die gleichen Informationen zurück wie „Nutzungsprotokolle“ oben, ermöglicht jedoch bei Bedarf einen Filter nach Datum (Epochenzeitstempel), um die Ergebnisse einzugrenzen.
Nützlich zum:
1.8. Jobprotokolle
Endpunkt/URI –
http://host:port/V5-API/api/integrate/export/job_logs
Dieser Endpunkt stellt eine JSON-Rückgabedatei bereit, die das System enthält Beschreibungen im Zusammenhang mit der Arbeitsproduktion.
Eine Beispieldatei dieses Typs kann heruntergeladen werden werden auf dieser Seite erläutert.
Nützlich zum:
2. Transaktionale/generische Endpunkte
Transaktionsendpunkte werden verwendet, um vereinfachte Informationen zurückzugeben Deskriptor Ereignisse, die sich insbesondere darauf beziehen, wie verschiedene Module die Lagerbestände verwalten. Im Gegensatz zu den generischen Endpunkten, die wir oben gesehen haben und die eine Vielzahl verschachtelter Daten bereitstellen, stellen diese Endpunkte vereinfachte Informationen ohne verschachtelte Daten bereit.
Wie das aussehen würde, können wir in unseren Beispielen unten sehen:
2.1. Anpassungstransaktionen
Endpunkt/URI –
http://host:port/V5-API/api/integrate/export/transactions/adjustments
Dieser Endpunkt kann verwendet werden, um eine Liste der Anpassungstransaktionen bereitzustellen, die im System stattgefunden haben. Über diesen Endpunkt erhalten wir einen zurückgegebenen Eintrag, wenn die Menge einer Charge über Control Center oder WMS geändert (oder angepasst) wird. Dies kann auf Schäden oder abgelaufene Waren zurückzuführen sein, die aus dem System entfernt werden müssen.
Ein Beispielexport dieser Art könnte wie folgt aussehen:
Wie wir hier sehen können, handelt es sich um einen einzelnen Eintrag für eine „ANPASSUNG“. Deskriptor Ereignis und enthält keine der potenziell überflüssigen verschachtelten Daten, die wir beim generischen Endpunkt gesehen haben.
Eine Beispieldatei dieses Typs kann heruntergeladen werden werden auf dieser Seite erläutert.
Nützlich zum:
2.2. Batch-Verbrauchstransaktionen
Endpunkt/URI –
http://host:port/V5-API/api/integrate/export/transactions/batching/{completedBatches}
Beim Batch-Export von Verbrauchstransaktionen wird eine vereinfachte JSON-Datei bereitgestellt, die Verbrauch und Produktion bereitstellt Deskriptor Daten, die für eine bestimmte, abgeschlossene Charge relevant sind, die vom System verarbeitet wurde.
Mithilfe dieses Endpunkts erhalten wir eine Übersicht über alle Waren, die bei der Chargenbildung verbraucht wurden, sowie darüber, wie viel von den Chargen selbst anschließend produziert wurde.
Ein Beispiel dieses Dateityps kann heruntergeladen werden werden auf dieser Seite erläutert.
Nützlich zum:
2.3. Batch-Verbrauchstransaktionen (Filterdatum)
Endpunkt/URI –
http://host:port/V5-API/api/integrate/export/transactions/batching/filterfrom/{filterDate}
Dieser Endpunkt gibt die gleichen Informationen zurück wie „Batch Consumption“ oben, ermöglicht jedoch bei Bedarf einen Filter nach Datum (Epochenzeitstempel), um die Ergebnisse einzugrenzen.
Nützlich zum:
2.4. Bestelltransaktionen
Endpunkt/URI exportieren –
http://host:port/V5-API/api/integrate/export/transactions/purchase
Ein Export von Kauftransaktionen von diesem Endpunkt stellt eine vereinfachte JSON-Datei bereit, die für Bestellungen relevante Empfangsdaten bereitstellt, einschließlich Systemdeskriptoren wie „ERHALTEN“.
Der Endpunkt stellt diese Daten nur für abgeschlossene Bestellungen bereit, die nicht als exportiert markiert wurden.
Ein Beispiel dieses Dateityps kann heruntergeladen werden werden auf dieser Seite erläutert.
Nützlich zum:
2.5. Kundenauftragstransaktionen
Endpunkt/URI exportieren –
http://host:port/V5-API/api/integrate/export/transactions/sales/{true/false}
Ein Export von Verkaufstransaktionen von diesem Endpunkt stellt eine vereinfachte JSON-Datei bereit, die für Verkaufsaufträge relevante Zuordnungs-/Kommissionierungs-/Versanddaten bereitstellt. Durch die Verwendung dieses Endpunkts werden Daten zu allen über Kundenaufträge und verkauften Artikeln zurückgegeben Beschreibungen wie „PICKED“ und „SHIPPED“.
Der Endpunkt kann diese Daten für abgeschlossene Bestellungen (true) oder alle Bestellungen (false) bereitstellen, sofern diese Bestellungen nicht bereits als exportiert markiert wurden.
Ein Beispiel dieses Dateityps kann heruntergeladen werden werden auf dieser Seite erläutert.
Nützlich zum:
