Unità di misura

L'integrazione delle unità di misura tra V5 Traceability e il sistema ERP di un cliente consente di inviare a V5 Traceability le unità di misura utilizzate da un sistema ERP/di terze parti. Queste unità possono quindi essere applicate all'immagazzinamento e alla formulazione/produzione all'interno del sistema V5 Traceability.

La flessibilità del sistema V5 Traceability consente una configurazione di unità completamente personalizzata, con la possibilità di impostare conversioni di unità personalizzate per grandi quantità come casse e fusti, oltre a poter impostare tassi di conversione specifici per le merci. I tassi di conversione specifici sono particolarmente utili per articoli con densità specifica, come vedremo nell'esempio seguente.

Per le classi 'WeightUnit' e 'UnitCommodity' che esamineremo qui sono disponibili solo le importazioni; le esportazioni non sono disponibili tramite le metodologie JSON o CSV.

Per maggiori informazioni su come funzionano le unità di misura in V5 Traceability, consulta la nostra guida al modulo Qui..

1. Layout del centro di controllo
2. Collegamenti API
3. Modello di integrazione
4. Guida sul campo delle unità
   1. Chiavi primarie
   2. Campi obbligatori
   3. Campi preferiti
   4. Campi aggiuntivi
5. Metodologia
6. PesoUnità
   1. JSON – Importa
   2. JSON – Esporta
   3. CSV – Importa
   4. CSV – Esporta
7. Unità merce
   1. JSON – Importa
   2. JSON – Esporta
   3. CSV – Importa
   4. CSV – Esporta

Per quanto riguarda il modo in cui possiamo collegare le unità e i tassi di conversione specifici delle materie prime a ciò che vediamo nel Centro di controllo, possiamo vedere che il pannello superiore serve per immettere le unità di misura, mentre il pannello inferiore serve per i tassi di conversione specifici delle materie prime per l'unità selezionata nel pannello superiore.

Se una voce nel pannello inferiore non è presente per una determinata merce, il sistema tornerà al tasso di conversione impostato nel pannello superiore quando una merce viene utilizzata con quell'unità. Una volta che una merce viene aggiunta nel pannello inferiore e un tasso di conversione aggiunto ad essa (la "UnitCommodity"), questo sovrascrive il tasso di conversione nel pannello superiore.

 

Utilizzando il Gateway V5 possiamo popolare facilmente entrambi i pannelli.

Per saperne di più sulle definizioni delle 2 classi di database che utilizzeremo per aggiungere le nostre unità, consulta i seguenti link:

PesoUnità

Unità merce

È possibile scaricare il modello di integrazione per WeightUnit (unità di misura) Qui..

È possibile scaricare il modello di integrazione per UnitCommodity (tassi di conversione specifici per le materie prime) Qui..

Le chiavi primarie sono l'identificatore univoco per ciascuna tabella all'interno dell'API V5.

Per PesoUnità, questo è:

codice – Il codice univoco per l'unità di misura (ad esempio g, kg, lb, oz ecc.)

Per Unità merce, le chiavi primarie sono:

codice.unità – il codice univoco per l’unità di misura, come sopra.

and

codice.merce – Il codice univoco della merce a cui applicare il tasso di conversione specifico.

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

Per Unità di peso:

tasso di conversione - Tasso di conversione per questa unità, in relazione all'unità con ID 1 nel database.

Per Unità merce:

tasso di conversione – il tasso di conversione specifico per la merce specifica.

I campi preferiti servono per aggiungere ulteriori informazioni all'unità di misura (PesoUnità) e, sebbene non siano obbligatori, sono utili quando si tratta di funzionalità all'interno di V5 Traceability.

descrizione - descrizione dell'unità (chili, libbre ecc.)

Possono essere inclusi anche campi aggiuntivi per PesoUnità, Quali:

note – eventuali note aggiuntive per l’unità

Data la natura relativamente semplice di questa classe, possiamo usare l'integrazione JSON o CSV per importare unità in V5. Esamineremo questo dal punto di vista di un'importazione iniziale per portare tutte le unità mancanti nel sistema (weightUnit), dopodiché assegneremo conversioni specifiche per le merci usando le unità nel sistema (UnitCommodity). Si noti ancora una volta che non sono disponibili esportazioni per nessuno dei due endpoint/classi.

''WeightUnit' importa Endpoint/URI –

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

Descrizione dell'endpoint

Campioni:

Per questa importazione di esempio, utilizzeremo l'endpoint 'WeighUnit' per aggiungere libbre e once alla tabella Control Center Units mostrata sopra nell'introduzione. Il file JSON per fare ciò sarebbe simile a questo:

Si noti che i tassi di conversione saranno sempre calcolati a partire dall'unità predefinita (vale a dire la prima unità nella tabella delle unità), quindi in questo caso li calcoliamo in chilogrammi (kg).

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

Utilizzando il file soprastante, possiamo vedere che le nostre nuove unità sono state create nel Centro di controllo.

Non è disponibile alcuna esportazione JSON per la classe 'WeightUnit'.

Nome file definizione intestazione/colonna: “unitàpeso.csvh”

I file di intestazione completati devono essere inseriti in: “ \SG Control Center\gateway\import\def_colonna”

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

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

Campioni:

File di intestazione:

In genere, i file di intestazione vengono compilati da SG Systems prima che avvengano le integrazioni CSV, ma di seguito possiamo vedere un esempio di base di uno che possiamo utilizzare per le unità:

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.

Qui possiamo vedere che stiamo creando le stesse nuove unità dell'esempio JSON precedente, sebbene utilizziamo lettere minuscole per il codice delle unità, in modo da visualizzarle più chiaramente nel Centro di controllo.

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

Una volta completata l'importazione, possiamo vedere che sono state create nuovamente queste nuove unità.

Come per le esportazioni JSON, non è disponibile alcuna esportazione CSV per la classe 'WeightUnit'.

'UnitCommodity' importazione Endpoint/URI –

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

Descrizione dell'endpoint

Campioni:

Per questa importazione di esempio, utilizzeremo l'endpoint 'UnitCommodity' per aggiungere una conversione di unità specifica per i litri di latte. Abbiamo visto nel Control Center sopra che i litri di solito si convertono in un rapporto 1:1 da litri a kg, ovvero 1 litro di acqua pesa 1 kg. Un litro di latte, tuttavia, peserebbe leggermente di più (1.035 kg), quindi vedremo come possiamo impostarlo per un'importazione JSON di seguito.

Quindi quello che stiamo dicendo al sistema è che, quando si usa il latte, la conversione usata sarà 1.035, ignorando il tasso di conversione predefinito per l'unità litro.

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

Utilizzando il file soprastante, possiamo vedere che il nostro tasso di conversione specifico per il latte è stato aggiunto al pannello inferiore di "litro".

Non è disponibile alcuna esportazione JSON per la classe 'UnitCommodity'.

Nome file definizione intestazione/colonna: “unitàCommodity.csvh”

I file di intestazione completati devono essere inseriti in: “ \SG Control Center\gateway\import\def_colonna”

Importa nome file CSV: “unitàCommodity-datetime.csv”

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

Campioni:

File di intestazione:

In genere, i file di intestazione vengono compilati da SG Systems prima che avvengano le integrazioni CSV, ma di seguito possiamo vedere un esempio di un file che possiamo utilizzare per la conversione di unità specifiche per una merce:

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.

Qui possiamo vedere che stiamo creando la stessa conversione di unità di misura specifica per la merce che abbiamo utilizzato nell'esempio JSON precedente.

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

Una volta completata l'importazione, possiamo vedere che è stata nuovamente creata questa nuova conversione di unità di misura specifica per la merce.

Come per le esportazioni JSON, non è disponibile alcuna esportazione CSV per la classe 'UnitCommodity'.