Ordini di vendita
La tua guida all'integrazione V5!
L'integrazione degli ordini di vendita (SO) tra V5 Traceability e il sistema ERP di un cliente consente di inviare dettagli dell'ordine, voci dell'ordine e informazioni di pianificazione a V5 Traceability. In questo caso V5 può anche fungere da data master e inviare gli ordini creati all'interno del sistema all'ERP.
Questi ordini possono quindi essere ricevuti tramite il software V5 WMS, dopodiché informazioni quali quantità prelevate e spedite, ubicazione e allocazioni di container/pallet possono essere rinviate all'ERP.
Per ulteriori informazioni su come funziona il modulo degli ordini di vendita in V5 Traceability, consultare la nostra guida al modulo Qui..
Sommario
1. Layout del centro di controllo
In termini di come possiamo relazionarci ‘Sales Orders’ e ‘Sales Order Lines’ rispetto a ciò che vediamo nel Centro di controllo, possiamo vedere che il pannello superiore qui è per gli ordini di vendita, dove è possibile importare clienti, date di ordine e consegna, numeri di riferimento esterni ecc.
Il pannello inferiore è quindi dove possiamo aggiungere le nostre righe dell'ordine di vendita, contenente i dati relativi alle merci, alle quantità e al costo delle voci della riga dell'ordine.
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 vengono prelevati gli elementi sul SO quando il SO viene elaborato. Questi dati faranno parte dei dati esportati che possiamo ricevere dal Gateway V5.
2. Collegamenti API
Per saperne di più sulle definizioni delle classi di database che possono essere utilizzate per gli ordini di vendita, consultare i seguenti collegamenti:
3. Modello di integrazione
È possibile scaricare il modello di integrazione per gli ordini di vendita Qui..
4. Guida ai campi dell'ordine di vendita
4.1. Chiavi primarie
Le chiavi primarie sono l'identificatore univoco per ogni tabella all'interno dell'API V5. Per SalesOrders, questo è:
salesOrder.orderNumber – il numero SO.
Per SalesOrderLines, la chiave primaria è o:
salesOrder.orderNumber + commodity.code – il numero SO insieme alla merce da ordinare
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 numero dell'ordine e del codice merce. Ciò è necessario se nell'ordine è presente più di una riga della stessa merce.
4.2. Campi richiesti
Altri campi richiesti da SG per compilare un file valido ‘SalesOrderLine’ nel Centro di controllo sono:
quantity – la quantità di quella merce/prodotto venduta.
4.3. Campi preferiti
I campi preferiti servono per aggiungere più dati all'ordine di vendita e, sebbene non siano obbligatori, sono utili quando si tratta di funzionalità all'interno di Tracciabilità V5. Se si utilizza il ‘SalesOrderLine’ endpoint dovremmo idealmente aggiungere:
lineID - se non utilizzato come chiave primaria sopra, questo campo dovrebbe essere incluso.
commodity.code – se non utilizzato come chiave primaria sopra, questo campo dovrebbe essere incluso.
salesOrder.orderNumber – se non utilizzato come chiave primaria sopra, questo campo dovrebbe essere incluso.
salesOrder.customer.code – il codice univoco utilizzato per identificare il cliente.
salesOrder.placedDate - la data in cui è stato effettuato l'ordine.
salesOrder.deliveryDate – la data di consegna prevista per l'ordine.
Nota che per gli ultimi 4 di questi punti stiamo passando al ‘SalesOrder’ classe da ‘SalesOrderLine’. Se invece usassimo il file ‘SalesOrder’ classe che potremmo semplicemente rimuovere ‘salesOrder’ dalle 4 voci precedenti.
4.4. Campi aggiuntivi
È possibile includere anche campi aggiuntivi, ad esempio for ‘SalesOrderLine’:
salesOrder.referenceNumber – eventuali note/riferimenti aggiuntivi relativi all'OD.
5. Μεθοδολογία
Data la natura del ‘SalesOrder’ e ‘SalesOrderLine’, possiamo scegliere di importare e gestire i dati in diversi modi:
- Possiamo usare il ‘SalesOrder’ endpoint per importare gli ordini di vendita e quindi, come vedremo di seguito, passare al file ‘SalesOrderLine’ class per includere quindi tutti gli elementi pubblicitari dei componenti in un unico file. Questo è il modo più logico per importare interi ordini 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 sull'intestazione dell'ordine di vendita.
- Possiamo usare il ‘SalesOrderLine’ endpoint per modificare o aggiungere righe una volta creato l'ordine. Questo può ancora essere utilizzato per importare interi ordini, ma è meno efficiente poiché ciascuna voce dell'ordine dovrebbe contenere un riferimento nidificato all'intestazione dell'ordine di vendita (come il numero dell'ordine). Come indicato sopra, questo endpoint non può essere utilizzato per apportare modifiche alle informazioni dell'intestazione dell'ordine (numero dell'ordine/date di consegna, ecc.).
5.1. JSON – Importa
Ordine di vendita:
‘SalesOrder’ importa endpoint/URI –
http://host:port/V5-API/api/integrate/import/sales
Per questa importazione di esempio, utilizzeremo il file ‘SalesOrder’ endpoint e strutturando un file di importazione di base, questo potrebbe assomigliare a questo:
Questo file JSON di esempio può essere scaricato Qui..
Possiamo capire perché dovremmo usare il file ‘SalesOrder’ endpoint per questo formato, data la capacità dei file JSON di contenere dati nidificati, permettendoci di includere indented ‘SalesOrderLine’ 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.
Righe ordine di vendita:
‘SalesOrderLine’ importa endpoint/URI –
http://host:port/V5-API/api/integrate/import/sales_line
Possiamo anche usare il ‘SalesOrderLine’ endpoint per aggiungere o modificare righe di un ordine esistente. Possiamo anche aggiungere ordini di vendita utilizzando questo endpoint, ma è importante ricordare che possiamo modificare solo l'intestazione di un ordine di vendita utilizzando il comando ‘SalesOrder’ URI. Si noti inoltre che le informazioni SO dovrebbero essere nidificate qui per ciascuna riga SO.
Possiamo vedere un esempio di a ‘SalesOrderLine’ File JSON di seguito, dove aggiungeremo un'altra riga d'ordine all'ordine ‘SO-8471’ che abbiamo creato sopra:
Questo file JSON di esempio può essere scaricato Qui..
Possiamo quindi vedere nel Centro di controllo che il nostro ordine è stato importato insieme alla riga aggiuntiva che abbiamo appena aggiunto. Tieni presente che informazioni come la data di consegna/invio e il numero di riferimento sono state importate dall'originale ‘SalesOrder’ file.
5.2. JSON – Esporta
In termini di ricezione di file relativi agli ordini di vendita dall'API V5, se controlliamo i riepiloghi dei metodi sotto la voce "IntegrazioneEsporta‘ servizio, allora abbiamo alcune opzioni diverse qui:
Ordini di vendita:
Esporta endpoint/URI –
http://host:port/V5-API/api/integrate/export/sales_orders
Questo endpoint esporterà i file JSON completi degli ordini di vendita utilizzando la classe del database degli ordini di vendita e includerà tutti gli ordini di vendita che non sono già stati contrassegnati come esportati dal sistema. Ciò fornirà un ritorno per ogni punto dati nel file ‘SalesOrder’ classe e includere eventuali informazioni sul prelievo degli articoli spediti.
È possibile scaricare un file JSON di esempio di questo tipo Qui..
Ordine di vendita:
Esporta endpoint/URI –
http://host:port/V5-API/api/integrate/export/sales_order/{ordernumber}
Questo endpoint esporterà i file JSON completi degli ordini di vendita utilizzando la classe del database degli ordini di vendita, ma solo per l'ordine specificato e solo se tale ordine non è già stato contrassegnato come esportato dal sistema. Come sopra, ciò fornirà un ritorno per ogni punto dati nel file ‘SalesOrder’ classe e includere eventuali informazioni sul prelievo degli articoli spediti.
Possiamo vedere l'inizio di un esempio di esportazione di questo tipo di seguito:
Questo file JSON di esempio può essere scaricato Qui..
Registri degli ordini di vendita:
Esporta endpoint/URI –
http://host:port/V5-API/api/integrate/export/sales_logs
Questo endpoint può essere utilizzato per recuperare un elenco di registri degli ordini di vendita relativi agli eventi che si verificano durante la spedizione degli ordini di vendita. Questo si avvale di ‘SystemLog’ classe dati per fornire dati transazionali come descrittori di sistema. L'endpoint fornisce questi dati solo per gli ordini completati che non sono stati contrassegnati come esportati.
È possibile scaricare un file JSON di esempio di questo tipo Qui..
Registro ordini di vendita:
Esporta endpoint/URI –
http://host:port/V5-API/api/integrate/export/sales_log/{id}
Questo endpoint funziona allo stesso modo dei "Registri degli ordini di vendita" di cui sopra, ma può essere utilizzato per restituire le informazioni per un numero di registro specifico, come definito dal sistema V5. Come prima, questo utilizza il file ‘SystemLog’ classe dati per fornire dati transazionali come descrittori di sistema. L'endpoint fornisce questi dati solo per i log degli ordini completati che non sono stati contrassegnati come già esportati.
Possiamo vedere l'inizio di un esempio di esportazione di questo tipo di seguito:
Possiamo anche utilizzare a endpoint transazionali e di registro per recuperare informazioni più rilevanti su merci e prodotti venduti negli ordini di vendita.
ne abbiamo uno Transazionale/Generico endpoint che possiamo usare qui:
5.3. CSV – Importa
Tieni presente che per le importazioni CSV, normalmente utilizzeremmo solo il file ‘SalesOrderLine’ endpoint, permettendoci di generare ordini di vendita e le relative voci attraverso l'uso di un'unica importazione CSV.
Nome file definizione intestazione/colonna: “salesOrderLine.csvh”
I file di intestazione completati devono essere inseriti in: “<installdir>\SG Control Center\gateway\import\column_defs”
Importa nome file CSV: “salesOrderLine-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 gli ordini di vendita:
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 ordine 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 questi ordini, insieme agli elementi pubblicitari richiesti, sono stati aggiunti al Centro di controllo. Tieni presente che se il ‘Date Placed’ i dati non sono inclusi nell'importazione, la data inserita farà riferimento alla data odierna.
5.4. CSV – Esporta
Quando si desidera esportare le informazioni sull'ordine di vendita tramite questo metodo, ciò costituirebbe parte di un file ‘SalesLog’ esportare. Possiamo vedere le definizioni di classe per questo endpoint Qui..
Nome file definizione intestazione/colonna: “SalesLog.csvh”
I file di intestazione completati devono essere inseriti in: “<installdir>\SG Control Center\gateway\export\order”
Esporta nome file CSV: “SalesLog-datetime.csv”
I CSV per le esportazioni verranno generati in: “<installdir>\SG Control Center\gateway\export”
Questa esportazione dovrebbe essere abilitata anche nella sezione Gateway del Centro di controllo. Si tratterebbe semplicemente di controllare il ‘Sales Order’ casella e assicurandosi di applicare l'impostazione e riavviare Control Center.
File di intestazione:
Possiamo utilizzare datapoint come ‘user’, ‘timestamp’ e ‘quantity’ su questa cima ‘Sales Log’, livello, ma possiamo anche utilizzare le pagine Ordine di vendita e Riga ordine di vendita per creare ulteriormente le informazioni di cui abbiamo bisogno, come il numero dell'ordine, gli articoli venduti e il luogo da cui sono stati prelevati. Si noti che qui il ‘SalesOrder’ è necessario accedere alla classe tramite il file ‘Line’ classe, come mostrato nell'esempio seguente
A un livello molto elementare, la nostra parte del ‘Sales Log’ l'intestazione che tratta i nostri ordini di vendita potrebbe assomigliare a questa:
Questo file di intestazione di esempio può essere scaricato Qui..
File di esportazione CSV:
Con la nostra intestazione a posto e l'esportazione abilitata, otterremo successivamente un file di reso per questo ordine (insieme a qualsiasi altro ordine precedentemente non esportato) simile al seguente:
Questo file di esportazione di esempio può essere scaricato Qui..
