Transfer

L'integrazione dei trasferimenti tra V5 Traceability e il sistema ERP di un cliente consente di inviare dettagli di trasferimento, voci di trasferimento e informazioni di pianificazione a V5 Traceability. Questi trasferimenti possono quindi essere inviati e ricevuti tramite il software V5 WMS, dopodiché informazioni come quali lotti sono stati inviati e ricevuti, quanto è stato inviato, su quale pallet si trovava, ecc. possono essere rinviate all'ERP.

In questo caso V5 può anche fungere da master dei dati e inviare all'ERP i trasferimenti creati all'interno del sistema.

Per ulteriori informazioni su come funziona il modulo trasferimenti in V5 Traceability, consultare la nostra guida al modulo Qui..

1. Layout del centro di controllo
2. Collegamenti API
3. Modello di integrazione
4. Guida sul campo dell'ordine di acquisto
   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 relazionarci ‘Transfers’ e ‘Transfer Lines’ rispetto a ciò che vediamo nel Centro di controllo, possiamo vedere che il pannello superiore qui è per i trasferimenti, dove possono essere importati da/verso siti, numeri di riferimento esterni ecc.

 

Il pannello in basso a sinistra è quindi dove possiamo aggiungere le nostre linee di trasferimento, contenenti i dati relativi alle merci e alle quantità richieste per il trasferimento.

Utilizzando il gateway V5 possiamo facilmente popolare entrambi i pannelli, separatamente o insieme.

Il pannello in basso a destra contiene i dati relativi al punto in cui gli articoli sul trasferimento sono stati prelevati nella posizione "da" e ricevuti nella posizione "a". Questi dati faranno parte dell'esportazione che possiamo ricevere dal Gateway V5.

Per ulteriori informazioni sulle definizioni di queste classi di database, consultare i seguenti collegamenti:

Transfer

Linee di trasferimento

È possibile scaricare il modello di integrazione per i Trasferimenti Qui..

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

reference – Il numero di riferimento univoco per il trasferimento. Essenzialmente il numero dell'ordine di trasferimento.

Per TransferLines, la chiave primaria è o:

reference + commodity.code – Il riferimento/numero del trasferimento insieme alla merce da trasferire.

or

lineID – Per scopi avanzati in cui la stessa merce può apparire su più righe, è possibile specificare un ID riga come identificatore univoco invece del riferimento del trasferimento e del codice merce. Ciò è necessario se nel trasferimento è presente più di una riga della stessa merce.

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

Per TransferLines:

quantityOrdered – la quantità di quella merce ordinata.

Per Transfers:

fromLocation.code - la posizione da cui verrà inviato il trasferimento.

toLocation.code - la posizione a cui verrà inviato il trasferimento.

I campi preferiti servono per aggiungere più dati al trasferimento e, sebbene non siano obbligatori, sono utili quando si tratta di funzionalità all'interno di Tracciabilità V5. Questi sono:

lineID - se non utilizzato come chiave primaria sopra, questo campo dovrebbe essere incluso.

commodity.code – se non utilizzato come chiave primaria sopra, questo campo deve essere incluso. Il codice della merce da trasferire.

transfer.reference - se non utilizzato come chiave primaria sopra, questo campo dovrebbe essere incluso.

Quanto sopra vale per ‘transferLines’. Possiamo applicare gli stessi campi a "transfers' aggiungendo ‘transferLine’ alle prime 2 voci e rimuovendo ‘transfer’ dall'ultimo.

È possibile includere anche campi aggiuntivi, ad esempio for ‘transfer’:

comment – eventuali commenti aggiuntivi per il trasferimento.

fromAddress – l'indirizzo da cui viene inviato il bonifico. Questi sono popolati in ‘Site Addresses‘.

toAddress – l'indirizzo al quale viene ricevuto il bonifico.

directTransfer – se questo trasferimento debba essere a trasferimento diretto o non.

Simile a sopra, se si crea un "transferLine', possiamo semplicemente passare alla classe di trasferimento aggiungendo ‘transfer’ all'inizio dei parametri di cui sopra.

Data la natura del ‘Transfer’ e ‘TransferLine’, possiamo scegliere di importare i dati in 2 modi:

1. Possiamo usare il ‘Transfer’ endpoint per importare i trasferimenti e quindi, come vedremo di seguito, passare al file ‘TransferLine’ class per includere quindi tutti gli elementi pubblicitari dei componenti in un unico file. Questo è il modo più logico per importare interi trasferimenti poiché richiede solo 1 set di informazioni di intestazione e quindi le voci successive. Tieni presente che questo è anche l'unico endpoint che possiamo utilizzare per modificare le informazioni dell'intestazione per il trasferimento.
2. Possiamo usare il ‘TransferLine’ endpoint per modificare o aggiungere linee di trasferimento una volta creato il trasferimento. Questo può ancora essere utilizzato per importare interi trasferimenti, ma è meno efficiente poiché ciascuna voce di trasferimento dovrebbe contenere un riferimento nidificato all'intestazione del trasferimento (come il riferimento). Come indicato sopra, questo endpoint non può essere utilizzato per apportare modifiche alle informazioni sull'intestazione del trasferimento (riferimento/da e verso posizioni ecc.).

Quale di questi endpoint utilizzeremo dipenderà in gran parte dal fatto che utilizziamo un'importazione JSON o CSV. Ora possiamo guardarli di seguito.

Trasferimento:

‘Transfer’ importa endpoint/URI –

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

Descrizione dell'endpoint

Per questa importazione di esempio, utilizzeremo il file ‘Transfer’ endpoint e strutturando un file di importazione di base di un trasferimento con 2 righe, questo potrebbe assomigliare a questo:

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

Possiamo capire perché dovremmo usare il file ‘Transfer’ endpoint per questo formato, data la capacità dei file JSON di contenere dati nidificati, permettendoci di includere indented ‘TransferLines’ elenchi e successivamente ‘Commodity’ punti dati nell'importazione, che possono essere determinati utilizzando il manuale dell'API SG. Ad esempio, il ‘commodity code’ il datapoint può essere trovato utilizzando il seguente percorso nel manuale API:

Possiamo costruire il resto dei nostri punti dati richiesti utilizzando un metodo di ricerca del percorso simile.

Utilizzando il file sopra, possiamo vedere che il nostro nuovo trasferimento è stato creato nel Centro di controllo.

Linee di trasferimento:

‘TransferLine’ importa endpoint/URI –

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

Descrizione dell'endpoint

Come discusso sopra, possiamo usare il file ‘TransferLine’ endpoint per aggiungere o modificare righe di un trasferimento esistente. Possiamo anche aggiungere trasferimenti utilizzando questo endpoint, ma è importante ricordare che possiamo modificare un'intestazione Transfer solo utilizzando il file ‘Transfer’ URI sopra. Tieni inoltre presente che le informazioni di trasferimento dovrebbero essere nidificate qui per ciascuna riga di trasferimento.

Possiamo vedere un esempio di a ‘TransferLine’ File JSON di seguito, dove aggiungeremo un'altra riga da trasferire ‘TR-1882’ che abbiamo creato sopra:

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

Una volta inviata questa richiesta, possiamo tornare al Centro di controllo e vedere che una terza riga è stata aggiunta a questo trasferimento.

In termini di ricezione di file relativi ai trasferimenti dall'API V5, se controlliamo i riepiloghi dei metodi nella sezione ‘IntegrationExport‘ class, allora abbiamo alcune opzioni diverse qui:

trasferimenti:

Esporta endpoint/URI –

http://host:port/V5-API/api/integrate/export/transfers

Descrizione dell'endpoint

Questo endpoint esporterà i file JSON di trasferimento completo utilizzando la classe del database di trasferimento e includerà ogni trasferimento che non è già stato contrassegnato come esportato dal sistema o che è stato modificato dalla prima esportazione. Ciò non includerà alcun dato sul movimento dell'inventario, ma fornirà piuttosto un rendimento per ciascun punto dati nel file ‘Transfer’ classe.

È possibile scaricare un esempio di questo tipo di file JSON Qui..

Trasferimento:

Esporta endpoint/URI –

http://host:port/V5-API/api/integrate/export/transfer/{referenceNumber}

Ulteriore documentazione

Questo endpoint esporterà i file JSON di trasferimento completo utilizzando la classe del database di trasferimento, ma solo per il trasferimento specificato e solo se questo trasferimento non è già stato contrassegnato come esportato dal sistema. Come sopra, questo non includerà alcun dato sui movimenti di inventario, ma piuttosto fornirà un rendimento per ciascun punto dati nel file ‘Transfer’ classe.

È possibile scaricare un esempio di questo tipo di file JSON Qui..

Possiamo anche utilizzare endpoint transazionali e di registro per recuperare informazioni più rilevanti sulle merci ricevute sugli ordini di acquisto.

Per i trasferimenti, ne abbiamo 1 Registro di sistema endpoint che possiamo utilizzare:

Registri di sistema:

Esporta endpoint/URI –

http://host:port/V5-API/api/integrate/export/system_logs

Ulteriore documentazione

L'utilizzo di questo endpoint restituirà un elenco completo di eventi del registro di sistema che non sono stati contrassegnati come precedentemente esportati. È possibile trovare ulteriori informazioni su questo endpoint Qui.. Questi risultati possono essere filtrati per cercare trasferimenti specifici descrittori, come ‘MOVED OUT/IN’, ‘PALLET MOVED OUT/IN’ e ‘PALLET TRANSFER OUT/IN’.

È possibile scaricare un esempio di questo tipo di file JSON Qui..

Tieni presente che per le importazioni CSV, normalmente utilizzeremmo solo il file ‘TransferLine’ endpoint, permettendoci di generare trasferimenti e le relative voci attraverso l'uso di un'unica importazione CSV.

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

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

Importa nome file CSV: “transferLine-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 i trasferimenti:

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 puntiamo a creare un trasferimento simile a quello che abbiamo creato utilizzando la metodologia JSON. Questo file di importazione di esempio può essere scaricato Qui..

Una volta completata l'importazione, possiamo vedere che questo trasferimento, insieme agli elementi pubblicitari richiesti, sono stati aggiunti al Centro di controllo. Tieni presente che se il ‘Created Date’ i dati non sono inclusi nell'importazione, la data inserita farà riferimento alla data odierna.

Quando si cerca di esportare le informazioni di trasferimento tramite questo metodo, questo farebbe parte di un file ‘SystemLog’ esportare. Possiamo vedere le definizioni di classe per questo endpoint 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”

Questo endpoint può essere utilizzato per estrarre un'ampia varietà di dati attraversando i datapoint disponibili collegati da esso.

Intestazione:

Possiamo utilizzare datapoint come ‘user’, ‘timestamp’ e ‘quantity’ su questa cima ‘System Log’ livello, ma poi possiamo passare al ‘TransferLine’ classe per aggiungere campi come il numero di riferimento e le merci richieste al momento del trasferimento, nonché al file ‘Stock’ classe per recuperare informazioni come le posizioni da/in cui gli elementi sono stati spostati.

A un livello molto elementare, la nostra parte dell'intestazione del registro di sistema che si occupa dei trasferimenti potrebbe assomigliare a questa:

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

Con questa intestazione a posto dovremmo anche assicurarci di aver selezionato per l'esportazione ‘System Logs’ nella scheda di esportazione del Gateway in Control Center.

Con la nostra intestazione a posto e l'esportazione abilitata (non dimenticare di riavviare Control Center per applicare eventuali modifiche apportate nel Gateway!), otterremo successivamente un file di ritorno per questo trasferimento (insieme a qualsiasi altro trasferimento precedentemente non esportato) che assomiglia a Questo: