Ubicazione dell'inventario/magazzino
La tua guida all'integrazione V5!
L'integrazione dell'inventario/ubicazione delle scorte tra la tracciabilità V5 e il sistema ERP del cliente consente merce dettagli di inventario come numeri di lotto, quantità disponibili e posizioni da inviare a V5 Traceability. Questi dettagli consentiranno quindi di utilizzare tali merci per la produzione/ordinazione, ecc.
A seconda della nostra configurazione ERP, esistono diversi modi in cui possiamo gestire l'inventario/stock:
- ERP come master azionario: In questo caso l'ERP inserirà i dati di inventario in V5, quindi V5 restituirà aggiustamenti/consumo/produzione/ecc. (più comune) (immagazzinamento, disconnessione). Questo può essere fatto in 2 modi; Il valore azionario aggiornato dal registro (il lotto 123 è ora di 50 libbre); Oppure puoi guardare il valore di aggiustamento nel registro (Lot123 -50LBS). La prima opzione mantiene le cose più sincronizzate ma ha maggiori probabilità di perdere una transazione.
- V5 come master di serie: V5 fornisce i dati di inventario all'ERP. L'ERP restituisce quindi i livelli di inventario aggiornati a intervalli regolari. (scorte esaurite, scorte in entrata)
- ERP come master azionario: L'ERP alimenta le scorte V5, quindi V5 restituisce regolarmente i livelli delle scorte e l'ERP aggiorna il suo conteggio. Ciò è vantaggioso perché l'ERP e la V5 saranno sempre sincronizzati. Tuttavia, ciò può essere problematico a causa dei tempi e della frequenza della sincronizzazione, soprattutto se le scorte possono essere detratte nell'ERP stesso; questi livelli modificati potrebbero essere sovrascritti alla successiva sincronizzazione V5. Questo metodo può essere utile se l'ERP/MRP non modifica direttamente l'inventario, ma lo conserva solo per i dati finanziari. (stock in entrata, stock in esaurimento)
Se non sei sicuro del percorso migliore da intraprendere per la tua particolare configurazione ERP, SG Systems può organizzare una sessione di consulenza per valutare al meglio la metodologia ottimale per il tuo sistema.
Sommario
1. Layout del centro di controllo
In termini di come possiamo mettere in relazione i dettagli di inventario/ubicazione delle scorte con ciò che vediamo nel Centro di controllo, utilizzeremo questo endpoint principalmente per popolare il pannello in basso a sinistra per importare ed esportare i nostri livelli/posizioni di scorte per le materie prime esistenti.
Utilizzando il gateway V5 possiamo facilmente popolare i dati qui utilizzando due endpoint, ‘Stock’ e ‘StockLocation’.
2. Collegamenti API
Per ulteriori informazioni sulle definizioni di queste classi di database, consultare i seguenti collegamenti:
3. Modello di integrazione
È possibile scaricare il modello di integrazione per l'ubicazione dello stock qui.
4. Guida sul campo StockLocation
4.1. Chiavi primarie
Le chiavi primarie sono l'identificatore univoco per ogni tabella all'interno dell'API V5. Per StockLocation, questi sono:
location.code – Il codice identificativo univoco del ubicazione delle scorte.
stock.commodity.code – Il codice identificativo univoco del merce
stock.lotNo – Il numero di lotto dello stock.
Per Stock, le chiavi primarie sono:
lotNo – Il numero di lotto dello stock.
commodity.code – Il codice identificativo univoco della merce.
Tieni presente che i numeri di lotto possono essere generati automaticamente dal sistema o inseriti manualmente. I numeri di lotto del fornitore possono essere inseriti utilizzando il campo descritto di seguito. I numeri di lotto possono essere generati a livello globale (non possono esserci 2 numeri di lotto uguali) o in base al prodotto.
4.2. Campi richiesti
Altri campi richiesti da SG per compilare una riga merceologica valida nel Centro di controllo V5 sono:
stock.expiry – La data di scadenza del lotto specifico.
qty – La quantità della merce in quel lotto.
4.3. Campi preferiti
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.
stock.supplier.code - Il codice del fornitore che ha fornito il lotto della merce.
stock.cost - Il costo (per UM) della merce.
stock.dateReceived - La data in cui il lotto è stato registrato nell'inventario.
stock.supplierLotNo - Il numero di lotto assegnato dal fornitore.
4.4. Campi aggiuntivi
È inoltre possibile includere campi aggiuntivi, ad esempio:
stock.commodity.description - La descrizione della merce.
stock.commodity.units.code - L'unità di misura predefinita della merce.
stock.commodity.recordStock – Se l'uso di questo prodotto verrà tracciato con la tracciabilità V5.
Si noti che questi campi aggiuntivi possono essere utilizzati per creare voci di merci in Tracciabilità V5 nonché per assegnare ubicazioni e quantità di stock a fronte di esse. Quando si utilizza il Metodo CSV dello scambio di dati dobbiamo assicurarci che "Crea entità secondarie" sia selezionato nel "Gateway" del Centro di controllo. Tuttavia, le materie prime esistenti non possono essere aggiornate nel V5-API utilizzando questo endpoint, dobbiamo invece affrontarli direttamente utilizzando il 'Merce'endpoint invece.
5. Μεθοδολογία
A seconda dello scopo della nostra integrazione API, possiamo utilizzare il file ‘StockLocation’ or ‘Stock’ endpoint per importazioni ed esportazioni sia JSON che CSV. Ora possiamo esaminarlo di seguito.
5.1. JSON – Importa
StockLocation:
Possiamo utilizzare il ‘StockLocation’ endpoint per inserire record di stock rispetto alle merci (esistenti o meno) in V5 Traceability che contiene informazioni relative a date di ricezione/scadenza, numeri di lotto/fornitore e, naturalmente, ubicazione delle scorte.
‘StockLocation’ importa endpoint/URI –
http://host:port/V5-API/api/integrate/import/stock_location
Per questo esempio importare utilizzando il file ‘StockLocation’ endpoint, possiamo strutturare un file di importazione di base per un singolo lotto come di seguito:
Questo file JSON di esempio può essere scaricato Qui..
Utilizzando il manuale API possiamo vedere qui che stiamo utilizzando solo il file ‘qty’ valore dal ‘StockLocation’ classe, con tutti gli altri valori nidificati sotto il file ‘stock’ or ‘location’ classe. Possiamo anche vedere che il ‘code’ e ‘units’ i punti dati sono nidificati ulteriormente sotto il file ‘commodity’ classe.
Di seguito possiamo vedere un riepilogo di questo processo di flusso di dati:
Se eseguiamo il file JSON sopra, vedremo che il nostro lotto per commodity ‘I015’ (Jalepenos) ora questo lotto è stato importato nel Centro di controllo.
Tuttavia, ciò che non possiamo fare con il ‘StockLocation’ l'endpoint è la modifica di valori come il numero di lotto del fornitore e la data di scadenza dell'inventario esistente. Per fare ciò dovremmo utilizzare il file ‘Stock’ punto finale.
Image:
Come accennato in precedenza, il ‘StockLocation’ l'endpoint può essere utilizzato per inserire i record di magazzino e le ubicazioni associate. Tuttavia, se desideriamo aggiornare i dettagli relativi a questi lotti che rientrano nel ‘Stock’ intestazione, dobbiamo usare il file ‘Stock’ punto finale. Ciò include dettagli come il numero di lotto del fornitore, la data di scadenza e il peso ricevuto.
‘Stock’ importa endpoint/URI –
http://host:port/V5-API/api/integrate/import/stock
Per un uso molto semplice ‘Stock’ file di importazione che aggiornerà la data di scadenza e il numero di lotto del fornitore del lotto creato sopra, possiamo utilizzare quanto segue:
Il risultato è che le informazioni sul lotto vengono aggiornate nella V5:
5.2. JSON – Esporta
In termini di ricezione di file relativi alle posizioni delle scorte di inventario dall'API V5, se controlliamo i riepiloghi dei metodi nella sezione IntegrationExport classe, potremmo pensarlo ‘StockLocations’ (export/locations/stock) sarebbe quello che stiamo cercando. Tuttavia, questo non è il caso poiché questo endpoint esporterà un elenco di ubicazioni di magazzino (rispetto a ubicazioni di produzione) esistenti nel sistema.
Per ricevere informazioni sulla posizione e sui livelli di inventario delle nostre materie prime, possiamo utilizzare:
Merce individuale+Lotto Stock:
Esporta endpoint/URI –
http://host:port/V5-API/api/integrate/export/stock/{commodityCode}/{lotNumber}
Questo endpoint esporterà un file JSON con tutte le informazioni correlate per il lotto specificato di una singola merce. Se eseguiamo questa richiesta utilizzando le informazioni sul lotto che abbiamo appena importato, otterremo un file simile a questo:
È possibile scaricare un file JSON di esempio di questo tipo Qui..
Tutto in magazzino:
Esporta endpoint/URI –
http://host:port/V5-API/api/integrate/export/stock/{all}
Questo endpoint esporterà un file JSON che include un elenco di tutte le informazioni correlate per tutti i lotti di ogni merce nel sistema, a seconda del valore del campo {all}. Se questo è ‘true’ quindi elimineremo tutti i lotti di inventario, mentre if ‘false’ in tal caso otterremo semplicemente un reso per i nuovi articoli dell'inventario (vale a dire molti beni che non sono contrassegnati come già esportati).
Se eseguiamo questa richiesta come ‘true’ (così http://host:port/V5-API/api/integrate/export/stock/true) , otterremo un file simile a questo:
È possibile scaricare un file JSON di esempio di questo tipo Qui..
Gli endpoint di cui sopra forniranno solo i livelli attuali delle scorte. Ma cosa succede se vogliamo tenere traccia dei livelli delle nostre scorte durante la produzione? Qui abbiamo alcune opzioni diverse a seconda di come utilizziamo l'API e ci integriamo con un sistema ERP.
Possiamo anche utilizzare una varietà di endpoint transazionali e di registro per recuperare informazioni più pertinenti sulle modifiche del livello di inventario.
Per Registro di sistema endpoint, questi sono:
Registri di sistema consumati/prodotti
Registri di sistema di regolazione
Per Transazionale/Generico endpoint, questi sono:
5.3. CSV – Importa
Nome file definizione intestazione/colonna: “stockLocation.csvh”
I file di intestazione completati devono essere inseriti in: “<installdir>\SG Control Center\gateway\import\column_defs”
Importa nome file CSV: “stockLocation-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 avvengano le integrazioni CSV, ma possiamo vedere un esempio di base di uno che possiamo utilizzare per inventario/stock, utilizzando il file precedentemente definito definizioni di classe, sotto:
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 potrebbe assomigliare a questo:
Qui possiamo vedere che stiamo importando 3 nuovi lotti da 2 fornitori diversi. Questo file di importazione di esempio può essere scaricato Qui..
Una volta completata l'importazione, possiamo vedere che questi lotti aggiuntivi di Jalapeno sono stati aggiunti al Centro di controllo. Nota la differenza qui tra ‘Qty’ (a portata di mano) e ‘Stock_WeightReceived’ nel nostro CSV di importazione.
5.4. CSV – Esporta
Come per le esportazioni JSON, qui abbiamo un paio di opzioni diverse:
StockLocation:
Quando esportiamo merci utilizzando questo metodo, possiamo utilizzare lo stesso endpoint e definizioni di classe come abbiamo fatto per le importazioni.
Nome file definizione intestazione/colonna: “stockLocation.csvh”
I file di intestazione completati devono essere inseriti in: “<installdir>\SG Control Center\gateway\export\order”
Esporta nome file CSV: “StockLocation-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 ‘Stock’ .
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:
Ciò fornirebbe un CSV di ritorno per le nostre recenti importazioni che sarebbe simile all'esempio seguente. Qui possiamo vedere che abbiamo recuperato tutte le linee di stock precedentemente non esportate, inclusa l'aggiunta di alcuni prodotti realizzati all'inizio della giornata.
Questo file di esportazione di esempio può essere scaricato Qui..
Tuttavia, come con le esportazioni JSON di cui sopra, ciò non restituirebbe alcun dato transazionale, quindi ancora una volta possiamo utilizzare il ‘SystemLog’ endpoint invece per recuperare dati più rilevanti in termini di transazioni e aggiustamenti di inventario.
SystemLog:
Questo endpoint può essere utilizzato per estrarre un'ampia varietà di dati attraversando i datapoint disponibili collegati da qui. Possiamo vedere le definizioni che possiamo usare Qui..
Nome file definizione intestazione/colonna: “SystemLog.csvh”
I file di intestazione completati devono essere inseriti in: “<installdir>\SG Control Center\gateway\export\order”
Esporta nome file CSV: “SystemLog-datetime.csv”
I CSV per le esportazioni verranno generati in: “<installdir>\SG Control Center\gateway\export”
Come sopra, questo dovrebbe essere abilitato nella sezione Gateway del Centro di controllo:
File di intestazione:
Da qui possiamo strutturare la nostra intestazione a seconda dei dati transazionali che vogliamo ricevere all'ERP. Per i nostri scopi qui questo potrebbe assomigliare a questo:
Questo file di intestazione di esempio può essere scaricato Qui..
File di esportazione CSV:
Quindi possiamo vedere qui che riceveremo dati specificatamente adattati alle nostre esigenze, inclusi dati come la merce, il numero di lotto, la quantità originale, eventuali aggiustamenti e l'utente che ha eseguito l'azione, insieme a eventuali ragioni e lavoro pertinente /informazioni sul lotto.
Se eseguiamo il registro di sistema con l'intestazione sopra otterremo un'esportazione simile a questa:
Questo file di esportazione di esempio può essere scaricato Qui..
