ZotSell
Wizzard Home | Tracciati Completi |
Campi previsti 20
Attenzione i campi con M nella colonna Note sono obbligatori
*
Datetime: Formati data riconosciuti
YYYY/MM/DD HH:mm:ss
aaaa/MM/gg
gg/MM/aaaa hh:mm:ss
gg/MM/aaaa
aaaammgghhmmss
** Decimale(N,D): dove N è il numero massimo di cifre prima della virgola e D il numero massimo di cifre dopo la virgola. Come virgola può essere usato la virgola o il punto.
*** Definiti come valori percentuali: il numero 22 significa 22%.
Il codice ordine Zotsell che viene generato in importazione è la composizione del campo
IPAD_"date_order" + "_" +"agent_code"
La data transata può essere completa aaaammgghhiiss ma in tal caso deve essere univoca per lo specifico codice agente altrimenti il sistema tenderebbe a generare due ordini con lo stesso codice interno.
Quindi se popolata nel formato completo `AAAA/MM/DD HH:mm:ss` allora viene utilizzato solo `date_order` per la generazione del codice interno Zotsell
Es. date_order=2019/01/01 01:01:01 si ottiene IPAD_20190101010101
(Analogo per i formati DD/MM/YYYY HH:mm:ss ,YYYYMMDDHHmmss)
In alternativa è possibile transare solo la data Ordine aaaammgg e il sistema di importazione genererà il codice ordine univoco Zotsell utilizzando il contenuto di id_order
Es. date_order=2019/01/01 e id_order=ABC si ottiene IPAD_20190101000ABC
E' ovviamente indispensabile che tutte le righe di uno stesso ordine (id_order uguale) abbiano lo stesso valore di date_order
Indica una nota testuale generica da associare all'ordine . E' un dato denormalizzato. Essendo logicamente un dato univoco per l'ordine e' ovviamente indispensabile che tutte le righe di uno stesso ordine (id_order uguale) abbiano lo stesso valore di note . Il valore verrà visualizzato solo se la stampa ordine è configurata per la visualizzazione del dato.
Si presentano alcune casistiche particolari
a) Nel caso in cui il codice articolo indicato (codice) non esiste in DB il testo viene utilizzato per popolare sia il nome che la descrizione articolo
b) Nel caso in cui l'articolo indicato (codice) non abbia un nome in DB il testo viene utilizzato per popolare sia il nome che la descrizione articolo
c) Nel caso in cui non venga popolato non sarà associata alcuna descrizione breve all'articolo
Permette di indicare uno stato ordine tramite un codice analogamente alla caratteristica della guida Codice e Stati Ordine da Gestionale
ma per gli ordini esterni. Essendo logicamente un dato univoco per l'ordine e' ovviamente indispensabile che tutte le righe di uno stesso ordine
(id_order uguale) abbiano lo stesso valore di management_status .
La gestione delle etichette da presentare in base al codice di stato viene gestito tramite l'utilizzo del tracciato liste_supporto.csv al fine di passare delle etichette corrispondenti al codice indicato nel campo ordini_esterni.csv
Le righe del tracciato liste_supporto.csv devono essere popolate nel seguente modo
contesto = sempre valorizzato “ORDINE_STATO_GESTIONALE"
Indica una nota testuale generica da associare all'ordine . E' un dato denormalizzato. Essendo logicamente un dato univoco per l'ordine e' ovviamente indispensabile che tutte le righe di uno stesso ordine (id_order uguale) abbiano lo stesso valore di note . Il valore verrà visualizzato solo se la stampa ordine è configurata per la visualizzazione del dato.
Permette di indicare uno codice proprio che ha quel documento nel gestionale in modo da riconciliare per gli utenti il Codice Ordine Zotsell a Codice ordine nel Gestionale
analogamente alla caratteristica della guida Codice e Stati Ordine da Gestionale ma per gli ordini esterni.
Essendo logicamente un dato univoco per l'ordine e' ovviamente indispensabile che tutte le righe di uno stesso ordine
(id_order uguale) abbiano lo stesso valore di management_code.
Attenzione La modifica dei setting di default è un operazione che comporta delle attività di riconfigurazione e ri-compilazione e personalizzazione e come tale comporterà un costo.
| Cod. | Ultima revisione |
|
Cod. Sviluppo |
| 131 | 2016/02/09 - RV | zz_raw_external_orders |
ordini_esterni.csv
Il tracciato è da utilizzare per la caratteristica descritta in questa guida Importazione Storico Ordini da gestionale ossia permette di popolare il DB Ordini in server Zotsell con ordini provenienti dal gestionaleCampi previsti 20
Schema
Di seguito la sequenza dei campi previsti per il tracciatoAttenzione i campi con M nella colonna Note sono obbligatori
| Campo | Descrizione del campo | Formato | Note |
| id_order | Codice identificativo ordine per raggruppare le righe di un ordine | varchar(255) | M |
| record_code | Codice utilizzato nel gestionale per il cliente |
varchar(32)
|
M |
| record_destination_code |
Codice della destinazione
|
varchar(64)
|
M |
| agent_code |
Codice dell'agente che ha eseguito l'ordine
(Gli ordini vengono consegnati all'ipad dell'utente che ha assegnato questo codice ) |
varchar(255)
|
M |
| date_access | Campo di servizio lasciare Vuoto |
Datetime(*)
|
|
| date_order | Data Ordine |
Datetime(*)
|
M |
| data_consegna | Data di consegna di testata | Datetime(*) |
|
| note | Nota di testata |
varchar(255)
|
|
| codice_articolo | Codice articolo |
varchar(255)
|
M |
| codice_variante | Codice Variante |
varchar(255)
|
|
| descrizione | Descrizione variante/articolo |
varchar(255)
|
|
| label_unita_misura | Unità di misura della Quantità ordinata (Pz. Kg, Lt ecc) |
varchar(255)
|
|
| quantita | Quantità di riga |
decimale(10,4)**
|
M |
| prezzo | Prezzo unitario di riga |
decimale(10,4)**
|
M |
| sconto*** | Sconto di riga | decimale(2,4)** |
|
| totale_riga | Totale di riga scontato |
decimale(10,4)**
|
M |
| aliquota*** | Valore aliquota tassazione (Iva) |
decimale(2,4)**
|
M
|
|
nota_di_riga
|
Nota di riga |
varchar(255)
|
|
| management_status |
Codice Stato Ordine (Etichetta da gestire tramite tracciato liste_supporto.csv
vedi approfondimenti visualizzare) |
varchar(255)
|
|
| management_code | Codice Ordine del gestionale |
varchar(255)
|
|
YYYY/MM/DD HH:mm:ss
aaaa/MM/gg
gg/MM/aaaa hh:mm:ss
gg/MM/aaaa
aaaammgghhmmss
** Decimale(N,D): dove N è il numero massimo di cifre prima della virgola e D il numero massimo di cifre dopo la virgola. Come virgola può essere usato la virgola o il punto.
*** Definiti come valori percentuali: il numero 22 significa 22%.
Approfondimenti
id_order
Il campo Id order è un informazione che serve al sistema per raggruppare le righe di uno stesso ordine e non è da confondere con il codice ordine che il sistema attribuirà all'ordine in fase di importazione.Il codice ordine Zotsell che viene generato in importazione è la composizione del campo
IPAD_"date_order" + "_" +"agent_code"
record_code, record_destination_code
Se l'ordine si riferisce a dei codici che non sono presenti nel tracciato anagrafiche l'ordine relativo verrà scartato in importazioneagent_code
Se le righe di un ordine si riferiscono ad un agente non codificato nel sistema Zotsell (Nessun utente presente con quel codice agente) l'ordine viene scartatodate_order
Indica la data di creazione dell'ordine e viene utilizzata dal sistema di importazione per creare un codice Zotsell univoco per l'ordine nel formato IPAD_aaaammgghhiiss_ agent_code.La data transata può essere completa aaaammgghhiiss ma in tal caso deve essere univoca per lo specifico codice agente altrimenti il sistema tenderebbe a generare due ordini con lo stesso codice interno.
Quindi se popolata nel formato completo `AAAA/MM/DD HH:mm:ss` allora viene utilizzato solo `date_order` per la generazione del codice interno Zotsell
Es. date_order=2019/01/01 01:01:01 si ottiene IPAD_20190101010101
(Analogo per i formati DD/MM/YYYY HH:mm:ss ,YYYYMMDDHHmmss)
In alternativa è possibile transare solo la data Ordine aaaammgg e il sistema di importazione genererà il codice ordine univoco Zotsell utilizzando il contenuto di id_order
Es. date_order=2019/01/01 e id_order=ABC si ottiene IPAD_20190101000ABC
Es. date_order=2019/01/01 e id_order=ABCDEFG si ottiene IPAD_20190101ABCDEFG
E' ovviamente indispensabile che tutte le righe di uno stesso ordine (id_order uguale) abbiano lo stesso valore di date_order
data_consegna
Indica la data di consegna da associare all'ordine . E' un dato denormalizzato. Essendo logicamente un dato univoco per l'ordine e' ovviamente indispensabile che tutte le righe di uno stesso ordine (id_order uguale) abbiano lo stesso valore di data_consegna . Il valore verrà visualizzato solo se la stampa ordine è configurata per la visualizzazione del dato.note
Indica una nota testuale generica da associare all'ordine . E' un dato denormalizzato. Essendo logicamente un dato univoco per l'ordine e' ovviamente indispensabile che tutte le righe di uno stesso ordine (id_order uguale) abbiano lo stesso valore di note . Il valore verrà visualizzato solo se la stampa ordine è configurata per la visualizzazione del dato.
codice_articolo
Se una riga si riferisce ad un articolo non presente nel sistema Zotsell non viene impostato un Nome articolo altrimenti viene popolato il nome articolo prelevandolo dalla tabella articoli.codice_variante
descrizione
Va ha popolare il corrispondente campo descrizione breve articolo. (Non viene prelevato dalla scheda articolo)Si presentano alcune casistiche particolari
a) Nel caso in cui il codice articolo indicato (codice) non esiste in DB il testo viene utilizzato per popolare sia il nome che la descrizione articolo
b) Nel caso in cui l'articolo indicato (codice) non abbia un nome in DB il testo viene utilizzato per popolare sia il nome che la descrizione articolo
c) Nel caso in cui non venga popolato non sarà associata alcuna descrizione breve all'articolo
label_unita_misura
quantita
prezzo
sconto
totale_riga
aliquota
nota_di_riga
management_status
Permette di indicare uno stato ordine tramite un codice analogamente alla caratteristica della guida Codice e Stati Ordine da Gestionale
ma per gli ordini esterni. Essendo logicamente un dato univoco per l'ordine e' ovviamente indispensabile che tutte le righe di uno stesso ordine
(id_order uguale) abbiano lo stesso valore di management_status .
La gestione delle etichette da presentare in base al codice di stato viene gestito tramite l'utilizzo del tracciato liste_supporto.csv al fine di passare delle etichette corrispondenti al codice indicato nel campo ordini_esterni.csv
Le righe del tracciato liste_supporto.csv devono essere popolate nel seguente modo
contesto = sempre valorizzato “ORDINE_STATO_GESTIONALE"
label = Etichetta da visualizzare sull’ordine
descrizione = Presente ma vuoto
icona = Presente ma vuoto
chiave = lo stesso valore che si troverà dentro a management_status
tipo_controllo = Presente ma vuoto
valore_controllo = Presente ma vuoto
Esempio Tracciato liste_supporto.csv:
ORDINE_STATO_GESTIONALE;Fatturato;;;F;;
ORDINE_STATO_GESTIONALE;Sospeso;;;S;;
descrizione = Presente ma vuoto
icona = Presente ma vuoto
chiave = lo stesso valore che si troverà dentro a management_status
tipo_controllo = Presente ma vuoto
valore_controllo = Presente ma vuoto
Esempio Tracciato liste_supporto.csv:
ORDINE_STATO_GESTIONALE;Fatturato;;;F;;
ORDINE_STATO_GESTIONALE;Sospeso;;;S;;
Indica una nota testuale generica da associare all'ordine . E' un dato denormalizzato. Essendo logicamente un dato univoco per l'ordine e' ovviamente indispensabile che tutte le righe di uno stesso ordine (id_order uguale) abbiano lo stesso valore di note . Il valore verrà visualizzato solo se la stampa ordine è configurata per la visualizzazione del dato.
management_code
Permette di indicare uno codice proprio che ha quel documento nel gestionale in modo da riconciliare per gli utenti il Codice Ordine Zotsell a Codice ordine nel Gestionale
analogamente alla caratteristica della guida Codice e Stati Ordine da Gestionale ma per gli ordini esterni.
Essendo logicamente un dato univoco per l'ordine e' ovviamente indispensabile che tutte le righe di uno stesso ordine
(id_order uguale) abbiano lo stesso valore di management_code.
Esempi
Esempio tracciato ordini_esterni.csvid_order;record_code;record_destination_code;agent_code;date_access;date_order;data_consegna;note;codice_articolo;codice_variante;descrizione;label_unita_misura;quantita;prezzo;sconto;totale_riga;aliquota;nota_di_riga;management_status;management_code "20.VOR.17442";"C002993";"C003953";"005";"2020/08/06";"2020/08/06";"2020/08/07";"";"VITNDEVTE18";"";"";"Bottiglia";"12.00000000000000000000";"8.60000000000000000000";"0.00000000000000000000";"98.04000000000000000000";"22.000000";"";"OV_CON_CON";"20.VOR.17442" "20.VOR.17442";"C002993";"C003953";"005";"2020/08/06";"2020/08/06";"2020/08/07";"";"VITNGONSL15";"";"";"Bottiglia";"6.00000000000000000000";"44.00000000000000000000";"0.00000000000000000000";"250.80000000000000000000";"22.000000";"";"OV_CON_CON";"20.VOR.17442" "19.VOR.24137";"C002993";"C004112";"009";"2019/08/12";"2019/08/12";"2019/08/13";"";"VILOCALCHI18";"";"a";"Bottiglia";"6.00000000000000000000";"6.30000000000000000000";"0.00000000000000000000";"35.91000000000000000000";"22.000000";"";"OV_CON_CON";"19.VOR.24137" "19.VOR.24137";"C002993";"C004112";"009";"2019/08/12";"2019/08/12";"2019/08/13";"";"VILOCALLUP18";"";"";"Bottiglia";"12.00000000000000000000";"5.40000000000000000000";"0.00000000000000000000";"61.56000000000000000000";"22.000000";"";"OV_CON_CON";"19.VOR.24137" "19.VOR.24137";"C002993";"C004112";"009";"2019/08/12";"2019/08/12";"2019/08/13";"";"VIVEBATSO18";"";"";"Bottiglia";"6.00000000000000000000";"5.00000000000000000000";"0.00000000000000000000";"28.50000000000000000000";"22.000000";"";"OV_CON_CON";"19.VOR.24137" "19.VOR.24137";"C002993";"C004112";"009";"2019/08/12";"2019/08/12";"2019/08/13";"";"VILOCALCHIP18";"";"Cà Lojera";"Bottiglia";"6.00000000000000000000";"4.40000000000000000000";"0.00000000000000000000";"25.08000000000000000000";"22.000000";"";"OV_CON_CON";"19.VOR.24137" "19.VOR.20936";"C002993";"C012978";"005";"2019/07/10";"2019/07/10";"2019/07/10";"";"VITNARMFT15";"";"";"Bottiglia";"3.00000000000000000000";"7.30000000000000000000";"0.00000000000000000000";"20.80000000000000000000";"22.000000";"";"OV_CON_CON";"19.VOR.20936" "19.VOR.20936";"C002993";"C012978";"005";"2019/07/10";"2019/07/10";"2019/07/10";"";"VITNARMPN17";"";"";"Bottiglia";"3.00000000000000000000";"6.50000000000000000000";"0.00000000000000000000";"18.53000000000000000000";"22.000000";"";"OV_CON_CON";"19.VOR.20936" "19.VOR.20936";"C002993";"C012978";"005";"2019/07/10";"2019/07/10";"2019/07/10";"";"VITNFEDTE16";"";"";"Bottiglia";"3.00000000000000000000";"8.20000000000000000000";"0.00000000000000000000";"23.37000000000000000000";"22.000000";"";"OV_CON_CON";"19.VOR.20936" "19.VOR.20936";"C002993";"C012978";"005";"2019/07/10";"2019/07/10";"2019/07/10";"";"VITNCADPN16";"";"";"Bottiglia";"3.00000000000000000000";"13.90000000000000000000";"0.00000000000000000000";"39.61000000000000000000";"22.000000";"";"OV_CON_CON";"19.VOR.20936" "19.VOR.20936";"C002993";"C012978";"005";"2019/07/10";"2019/07/10";"2019/07/10";"";"VITNPELKE17";"";"";"Bottiglia";"3.00000000000000000000";"8.00000000000000000000";"0.00000000000000000000";"22.80000000000000000000";"22.000000";"";"OV_CON_CON";"19.VOR.20936" "19.VOR.20936";"C002993";"C012978";"005";"2019/07/10";"2019/07/10";"2019/07/10";"";"VITNPOLLA16";"";"";"Bottiglia";"3.00000000000000000000";"11.20000000000000000000";"0.00000000000000000000";"31.92000000000000000000";"22.000000";"";"OV_CON_CON";"19.VOR.20936" "19.VOR.20936";"C002993";"C012978";"005";"2019/07/10";"2019/07/10";"2019/07/10";"";"VITNVLLCAS18";"";"";"Bottiglia";"3.00000000000000000000";"8.00000000000000000000";"0.00000000000000000000";"22.80000000000000000000";"22.000000";"";"OV_CON_CON";"19.VOR.20936" "19.VOR.20936";"C002993";"C012978";"005";"2019/07/10";"2019/07/10";"2019/07/10";"";"VITNVLLFU14";"";"";"Bottiglia";"3.00000000000000000000";"11.80000000000000000000";"0.00000000000000000000";"33.63000000000000000000";"22.000000";"";"OV_CON_CON";"19.VOR.20936"
Settings base
| Setting | Descrizione | Codice riferimento |
|---|---|---|
| Aggiornamento ordini esterni già importati | - |
update_external_orders
|