Materie prime

L'integrazione delle materie prime (ingredienti/imballaggi/materie prime/SKU) tra V5 Traceability e il sistema ERP di un cliente consente di inviare a V5 Traceability i dettagli delle merci, come costi, unità, tempi di scadenza predefiniti, ecc.

1. Layout del centro di controllo
2. Collegamenti API
3. Modello di integrazione
4. Guida al settore delle materie prime
   1. Chiavi primarie
   2. Campi obbligatori
   3. Campi preferiti
   4. Campi aggiuntivi
5. Metodologia
   1. JSON – Importa
   2. JSON – Esporta
   3. CSV – Importa
   4. CSV – Esporta

In termini di come possiamo mettere in relazione le materie prime con ciò che vediamo in Control center, possiamo vedere che abbiamo solo un singolo pannello da popolare qui, la finestra principale delle materie prime.

 

Utilizzando il gateway V5 possiamo facilmente popolare i dati qui utilizzando un singolo endpoint.

Per saperne di più sulle definizioni di queste classi di database, consultare il seguente collegamento:

Commodities

Il modello di integrazione per Commodities può essere scaricato Qui..

Le chiavi primarie sono l'identificatore univoco per ogni tabella all'interno dell'API V5. Per Commodities, questo è:

code – Il codice identificativo univoco di ogni merce.

Altri campi richiesti da SG per compilare una riga merceologica valida nel Centro di controllo sono:

units.code - L'unità di misura di stoccaggio predefinita della merce.

type - Il tipo di prodotto (ingrediente (0), formula (1) o imballaggio (2)).

recordStock - Se l'utilizzo di questo prodotto deve essere tracciato da V5 Tracciabilità (non registrato (0) o registrato (1)).

I campi preferiti servono per aggiungere ulteriori informazioni sulla merce in questione e, sebbene non obbligatori, sono utili quando si tratta di funzionalità aggiunte all'interno di Tracciabilità V5.

description - La descrizione della merce.

bulkUnit - L' unità sfusa della merce (ad esempio "Borsa" o "Scatola").

bulkQuantity - L'importo dell'unità di misura predefinita (units.code) della merce va nell'unità di massa sopra (ad esempio, "20" per questo e "Bag" inserito per la bulkUnit, con un'unità predefinita di "lb" significa in 1 sacco di questa merce ci sono 20 libbre).

È inoltre possibile includere campi aggiuntivi, ad esempio:

cost – Il costo predefinito (per unità) della merce.

defExpiryDays – Numero predefinito di giorni dal ricevimento in cui verrà impostata la scadenza di un articolo di inventario di questo tipo di merce

gtin – Il GTIN della merce.

Dato che stiamo utilizzando un solo endpoint per questa classe di oggetti, possiamo utilizzare l'endpoint "commodity" per le importazioni ed esportazioni sia JSON che CSV. Ora possiamo esaminarlo di seguito.

Commodity:

‘Commodity’ importa endpoint/URI –

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

Descrizione dell'endpoint

Per questa importazione di esempio, utilizzeremo il file ‘Commodity’ endpoint e strutturando un file di importazione di base per un singolo prodotto, questo potrebbe assomigliare a questo:

Questo file JSON di esempio può essere scaricato Qui..

Possiamo vedere qui un esempio di utilizzo delle classi nidificate relative a ‘Commodity’ punto finale. In questo caso abbiamo incluso il rientro ‘units’ and ‘bulkUnit’ punti dati, che ci consentono di definire sia l'unità di misura predefinita della merce sia la sua unità di massa. Poiché entrambi utilizzano il file ‘WeightUnit’ class, possiamo utilizzare il manuale dell'API V5 per guidarci verso questi datapoint utilizzando il seguente percorso:

Possiamo costruire il resto dei nostri datapoint richiesti utilizzando un metodo di pathfinding simile per passare a classi aggiuntive come ‘Location’ or ‘Container’ come richiesto.

Se dovessimo importare il file di esempio sopra, vedremo nel Centro di controllo che la nostra merce è stata importata.

In termini di ricezione di file relativi alle merci dall'API V5, se controlliamo i riepiloghi dei metodi sotto IntegrationExport class, abbiamo 2 diverse opzioni qui:

Commodity:

Esporta endpoint/URI –

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

Descrizione dell'endpoint

Questo endpoint esporterà un file JSON con tutte le informazioni correlate per un prodotto specifico. Se eseguiamo questa richiesta utilizzando la merce che abbiamo appena importato, otterremo un file simile a questo:

È possibile scaricare un file JSON di esempio Qui..

Commodities:

Esporta endpoint/URI –

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

Descrizione dell'endpoint

Questo endpoint esporterà un file JSON che include un elenco di tutte le informazioni correlate per tutte le merci nel sistema in base al valore del {all} campo. Se questo è ‘true’ allora ritireremo tutte le materie prime, mentre se ‘false’ allora otterremo un rendimento solo per le nuove merci (cioè per le merci che non lo sono contrassegnato come già esportato).

Se eseguiamo questa richiesta come true , otterremo un file simile a questo:

È possibile scaricare un file JSON di esempio Qui..

Nome file definizione intestazione/colonna: “commodity.csvh”

I file di intestazione completati devono essere inseriti in: “<installdir>\SG Control Center\gateway\import\column_defs”

Importa nome file CSV: “commodity-datetime.csv”

I CSV per l'importazione devono essere inseriti in: “<installdir>\SG Control Center\gateway\import”

File di intestazione:

I file di intestazione verranno generalmente compilati da SG Systems prima che abbiano luogo le integrazioni CSV, ma di seguito possiamo vedere un esempio di base che possiamo utilizzare per le materie prime:

Per ulteriori informazioni su come strutturiamo questi file, consultare il file pagina principale di integrazione. Questo file di intestazione di esempio può essere scaricato Qui..

File di importazione CSV:

Possiamo quindi utilizzare l'ordine definito dei punti dati nell'intestazione per strutturare il nostro file di importazione. SG Systems può fornire un file modello per questo, elencando il punto dati per ogni colonna per rendere le cose più chiare durante la compilazione dell'elenco. Si noti che questa prima riga può essere ignorata da Control Center e quindi può essere conservata nel file durante l'invio per l'importazione.

Un esempio di file di importazione CSV che utilizza l'intestazione sopra potrebbe assomigliare a questo:

Questo file di importazione di esempio può essere scaricato Qui..

Una volta completata l'importazione, possiamo vedere che questi prodotti sono stati aggiunti al Centro di controllo.

Quando esportiamo merci utilizzando questo metodo, utilizzeremo le stesse definizioni di classe che abbiamo utilizzato per le importazioni, che possiamo trovare Qui..

Nome file definizione intestazione/colonna: “commodity.csvh”

I file di intestazione completati devono essere inseriti in: “<installdir>\SG Control Center\gateway\export\order”

Esporta nome file CSV: “Commodity-datetime.csv”

I CSV per le esportazioni verranno generati in: “<installdir>\SG Control Center\gateway\export”

Questa esportazione dovrà essere abilitata anche nella sezione Gateway del Centro di controllo. Possiamo scegliere qui di esportare solo ‘Ingredients’ (ingredienti/imballaggio), o formule, o entrambi. Qui ci limiteremo all'esportazione ‘Ingredients’ :

File di intestazione:

Da qui basterebbe semplicemente strutturare il nostro file di intestazione di esportazione per adattarlo alle informazioni che vogliamo ricevere dal sistema.

Potremmo strutturarlo in un modo molto simile a come abbiamo strutturato l'intestazione di importazione:

Questo file di intestazione di esempio può essere scaricato Qui..

File di esportazione CSV:

Con l'intestazione sopra inserita, riceveremmo un CSV di reso per le nostre recenti importazioni che sarebbe simile a questo:

Questo file di esportazione di esempio può essere scaricato Qui..