Rohstoffe

Durch die Integration von Waren (Zutaten/Verpackung/Rohstoffe/SKUs) zwischen V5 Traceability und dem ERP-System eines Kunden können Warendetails wie Kosten, Einheiten, Standardablaufzeiten usw. an V5 Traceability gesendet werden.

1. Layout des Kontrollzentrums
2. API-Links
3. Integrationsvorlage
4. Rohstoff-Feldführer
   1. Primärschlüssel
   2. Benötigte Felder
   3. Bevorzugte Felder
   4. Zusätzliche Felder
5. Methodik
   1. JSON – Importieren
   2. JSON – Exportieren
   3. CSV – Importieren
   4. CSV – Exportieren

Im Hinblick darauf, wie wir Rohstoffe mit dem in Beziehung setzen können, was wir darin sehen Control Centerkönnen wir sehen, dass wir hier nur ein einziges Panel ausfüllen müssen, das Hauptfenster für Waren.

 

Mit dem V5 Gateway können wir die Daten hier einfach über einen einzigen Endpunkt füllen.

Weitere Informationen zu den Definitionen dieser Datenbankklassen finden Sie unter folgendem Link:

Commodities

Die Integrationsvorlage für Commodities kann heruntergeladen werden werden auf dieser Seite erläutert.

Primärschlüssel sind die eindeutige Kennung für jede Tabelle innerhalb der V5-API. Für Commodities, das ist:

code – Der eindeutige Identifikationscode für jede Ware.

Weitere Felder, die SG benötigt, um eine gültige Warenzeile im Control Center auszufüllen, sind:

units.code - Die Standard-Bestandseinheit (ME) der Ware.

type - Die Art der Ware (Zutat (0), Formel (1) oder Verpackung (2)).

recordStock - Ob die Verwendung dieser Ware durch V5 Traceability verfolgt werden soll (nicht aufgezeichnet (0) oder aufgezeichnet (1)).

Bevorzugte Felder dienen dazu, weitere Informationen zu der betreffenden Ware hinzuzufügen. Sie sind zwar nicht erforderlich, aber nützlich, wenn es um zusätzliche Funktionen in V5 Traceability geht.

description - Die Beschreibung der Ware.

bulkUnit - Die Masseneinheit der Ware (z. B. „Tasche“ oder „Box“).

bulkQuantity - Die Menge der Standard-ME (units.code) der Ware geht in die obige Masseneinheit ein (z. B. „20“ für diesen und „Beutel“ für die Masseneinheit, wobei eine Standardeinheit von „lb“ in 1 Beutel bedeutet). Bei dieser Ware handelt es sich um 20 Pfund.

Es können auch zusätzliche Felder eingebunden werden, wie zum Beispiel:

cost – Die Standardkosten (pro Einheit) der Ware.

defExpiryDays – Standardanzahl der Tage ab Erhalt, in denen ein Lagerartikel dieser Warenart ablaufen soll

gtin – Die GTIN der Ware.

Da wir nur einen einzigen Endpunkt für diese Objektklasse verwenden, können wir den „Commodity“-Endpunkt sowohl für JSON- als auch CSV-Importe und -Exporte verwenden. Das können wir uns nun unten ansehen.

Commodity:

‘Commodity’ Endpunkt/URI importieren –

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

Endpunktbeschreibung

Für diesen Beispielimport verwenden wir die ‘Commodity’ Endpunkt erstellen und eine grundlegende Importdatei für eine einzelne Ware strukturieren, könnte dies etwa so aussehen:

Diese JSON-Beispieldatei kann heruntergeladen werden werden auf dieser Seite erläutert.

Wir können hier ein Beispiel für die Verwendung verschachtelter Klassen im Zusammenhang mit sehen ‘Commodity’ Endpunkt. In diesem Fall haben wir das Eingerückte eingefügt ‘units’ , ‘bulkUnit’ Datenpunkte, die es uns ermöglichen, sowohl die Standard-ME der Ware als auch ihre Masseneinheit zu definieren. Da beide davon Gebrauch machen ‘WeightUnit’ Klasse können wir das V5-API-Handbuch verwenden, um uns über den folgenden Pfad zu diesen Datenpunkten zu führen:

Wir können den Rest unserer erforderlichen Datenpunkte mithilfe einer ähnlichen Pfadfindungsmethode aufbauen, um zu zusätzlichen Klassen zu gelangen, z ‘Location’ or ‘Container’ nach Bedarf.

Wenn wir die obige Beispieldatei importieren würden, würden wir im Control Center sehen, dass unsere Ware importiert wurde.

Im Hinblick auf den Empfang von Dateien im Zusammenhang mit Waren von der V5-API, wenn wir die Methodenzusammenfassungen unter überprüfen IntegrationExport Klasse, wir haben hier 2 verschiedene Möglichkeiten:

Commodity:

Endpunkt/URI exportieren –

http://host:port/V5-API/api/integrate/export/commodity/{code}

Endpunktbeschreibung

Dieser Endpunkt exportiert eine JSON-Datei mit allen zugehörigen Informationen für eine bestimmte Ware. Wenn wir diese Anfrage mit dem gerade importierten Commodity ausführen, erhalten wir eine Datei, die etwa so aussieht:

Eine Beispiel-JSON-Datei kann heruntergeladen werden werden auf dieser Seite erläutert.

Commodities:

Endpunkt/URI exportieren –

http://host:port/V5-API/api/integrate/export/commodites/{all}

Endpunktbeschreibung

Dieser Endpunkt exportiert eine JSON-Datei, die je nach Wert eine Liste aller zugehörigen Informationen für alle Waren im System enthält {all} Feld. Wenn das ist ‘true’ dann werden wir alle Waren ziehen, während wenn ‘false’ dann erhalten wir nur eine Rendite für neue Waren (also Waren, die es nicht sind). als bereits exportiert markiert).

Wenn wir diese Anfrage ausführen als true , erhalten wir eine Datei, die etwa so aussieht:

Eine Beispiel-JSON-Datei kann heruntergeladen werden werden auf dieser Seite erläutert.

Dateiname der Kopf-/Spaltendefinition: “commodity.csvh”

Fertige Header-Dateien sollten abgelegt werden in: “<installdir>\SG Control Center\gateway\import\column_defs”

CSV-Dateiname importieren: “commodity-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 Waren 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.

Eine beispielhafte CSV-Importdatei mit dem obigen Header könnte etwa so aussehen:

Diese Beispielimportdatei kann heruntergeladen werden werden auf dieser Seite erläutert.

Nach Abschluss des Imports können wir sehen, dass diese Waren zum Control Center hinzugefügt wurden.

Wenn wir Waren mit dieser Methode exportieren, würden wir dieselben Klassendefinitionen verwenden wie für Importe, die wir finden können werden auf dieser Seite erläutert.

Dateiname der Kopf-/Spaltendefinition: “commodity.csvh”

Fertige Header-Dateien sollten abgelegt werden in: “<installdir>\SG Control Center\gateway\export\order”

CSV-Dateiname exportieren: “Commodity-datetime.csv”

CSVs für Exporte werden generiert in: “<installdir>\SG Control Center\gateway\export”

Dieser Export müsste auch im Gateway-Bereich des Control Centers aktiviert werden. Wir können hier nur den Export wählen ‘Ingredients’ (Zutaten/Verpackung) oder Formeln oder beides. Hier schauen wir uns nur den Export an ‘Ingredients’ :

Header-Datei:

Von hier aus wäre es ein einfacher Fall, unsere Export-Header-Datei so zu strukturieren, dass sie den Informationen entspricht, die wir vom System zurückerhalten möchten.

Wir könnten es auf eine sehr ähnliche Weise strukturieren, wie wir den Import-Header strukturiert haben:

Diese Beispiel-Header-Datei kann heruntergeladen werden werden auf dieser Seite erläutert.

CSV-Exportdatei:

Wenn der obige Header vorhanden wäre, würden wir eine CSV-Rückgabe für unsere letzten Importe erhalten, die etwa so aussehen würde:

Diese Beispielexportdatei kann heruntergeladen werden werden auf dieser Seite erläutert.