Wizard Home | Indice Tracciati

Cod.	Ultima revisione	Wiki	Note
437	2020/02/05 - PG

Lista dei tracciati per la gestione delle schede Articolo suoi assortimenti e metodi di navigazione e filtri

---

articoli.csv

Permette di inserire i dati base delle schede prodotto comprensive di descrizioni, caratteristiche, unità di vendita, aliquota, immagini e miniature.

Schema

Di seguito la sequenza dei campi previsti per il tracciato. Campi previsti 12

Campo	Descrizione del campo	Formato	Note
codice articolo*	codice famiglia articolo per il raggruppamento delle varianti	varchar(255)
nome articolo		varchar(255)
descrizione breve	da utilizzare nelle liste articoli	varchar(255)
descrizione estesa	da utilizzare in scheda articolo	varchar(4000)
caratteristiche		varchar(4000)	per descrizioni aggiuntive
immagine miniatura**	nome file	varchar(255)	Le immagini devono essere caricate nel deposito file tramite admin ZotSell in alternativa si convenziona un prelevamento da spazio ftp.
immagine**	nome file	varchar(255)	Le immagini devono essere caricate nel deposito file tramite admin ZotSell in alternativa si convenziona un prelevamento da spazio ftp.
codice gruppo articoli		varchar(255)
codice Aliquota		varchar(255)	Se necessario passare un codice nel file ordine per il gestionale
valore Aliquota			indicare valore numerico es 21% = 21.00
unita di misura		varchar(16)	Unità di misura principale per la vendita. Per indicare la modalità di vendita principale: Pz,Numero,Capo, Kg, g, lt ecc.
decimale	per indicare se vendibile a sfuso o meno	integer	i valori stanno a indicare : 0 immissione quantità intere 1 immissione quantità a una cifra decimale 2 immissione quantità a due cifre decimali

* codice articolo : Unico e obbligatorio
** immagine miniatura, immagine :il sistema è case sensitive , questo significa che il file IMMAGINE.JPG è diverso da immagine.jpg Pertanto si consiglia di prestare attenzione alla coerenza fra caratteri maiuscoli e minuscoli.

Approfondimenti

Esistono due modi per costruire un prodotto, il primo riguarda l'inserimento di un articolo finito ( esempio Divano modello Relax ) il secondo la creazione di una sorta di contenitore (Modello) di una serie di varianti ( Tavolo da cucina le cui varianti potrebbero riguardare colore, dimensione ecc... ) ad esempio nell'ambito dell'abbigliamento, lo stesso modello di jeans può possedere differenti taglie o colori.

Per le varianti è necessario utilizzare in abbinata il tracciato  varianti.csv (Vedi di seguito) il campo di collegamento è Codice articolo che in questo caso rappresenta il modello 
contenitore delle varianti.

Per la gestione delle varianti si veda  questa guida

---

articoli_opzioni_aggiuntive.csv

Permette di inserire delle informazioni supplementari associate al singolo articolo. Fra le informazioni sono stati convenzionati alcuni campi utili per definire la geolocalizzazione del prodotto , le confezioni multiple, quantità minime o di default.

Vedi questa guida

varianti.csv

Il tracciato permette di associare alla singola scheda prodotto una serie di varianti dello stesso articolo. Le varianti saranno visibili in fase di acquisto su una griglia bidimensionale comprensiva di eventuali immagini identificative

Schema

Di seguito la sequenza dei campi previsti per il tracciato.

Campo	Descrizione del campo	Formato	Note	Salvato in ordine
codice articolo	codice famiglia articolo per il raggruppamento delle varianti	varchar(255)	riferito a articoli.csv serve per raggruppare le opzioni diverse all'interno della stessa scheda	SI
codice dimensione 01			taglia,misura è il codice da passare in file ordine x il gestionale	SI
descrizione dimensione 01			descrittiva da presentare all'agente es XL, L, 6(Diametro) ecc.	SI
posizione dimensione 01			Per indicare un ordinamento da presentare all'agente nelle griglie. Es Posizione Taglia	NO
immagine dimensione 01				NO
codice dimensione 02			è il codice eventuamlmente da passare in file ordine x il gestionale	SI
descrizione dimensione 02			(Es: descrittiva da presentare all'agente es colore tinta,tessuto,fantasia,finitura ecc)	SI
posizione dimensione 02			Per indicare un ordinamento da presentare all'agente nelle griglie	NO
immagine dimensione 02				NO
codice variante			Campo che indica la variante specifica combinazione di  Codice articolo + Codice dimensione 01 + Codice dimensione 02 Deve essere univoca nel sistema ed è  il codice che verrà indicato in stampa ordine e nle tracciato gestionale per indicare quale variante è stata acquistata	SI

Esempi

ESEMPIO
Record 1

• Codice Articolo = A123
• Codice Dimensione 01 = BNC
• Descrizione Dimensione 01 = Bianco
• Posizione Dimensione 01 = 1
• Codice Dimensione 02 = 1MT
• Descrizione Dimensione 02 = 1 metro
• Posizione Descrizione 02 = 1
• Codice Variante = V45

Record 2

• Codice Articolo = A123
• Codice Dimensione 01 = BNC
• Descrizione Dimensione 01 = Bianco
• Posizione Dimensione 01 = 1
• Codice Dimensione 02 = 2MT
• Descrizione Dimensione 02 = 2 metri
• Posizione Descrizione 02 = 2
• Codice Variante = V46

Funzionamento :

• Codice Articolo rappresenta il codice dell'articolo per il quale si stanno costruendo le varianti
• Codice Dimensione 01 rappresenta il codice attraverso il quale definire univocamente l'opzione associata alla colonna della variante che si sta creando
• Descrizione dimensione 01 : Rappresenta l'etichetta da associare all'intestazione di colonna della variante che si sta configurando.
• Posizione dimensione 01 : Permette di settare l'ordine ( ovvero la posizione della colonna )
• Codice Dimensione 02 rappresenta il codice attraverso il quale definire univocamente l'opzione associata alla riga della variante che si sta creando
• Descrizione dimensione 01 : Rappresenta l'etichetta da associare all'intestazione di riga della variante che si sta configurando.
• Posizione dimensione 01 : Permette di settare l'ordine ( ovvero la posizione della riga )
• Codice Variante: E' l'identificativo univoco nel sistema della variante specifica

NOTE
In base ai dati presenti all'interno del tracciato varianti.csv il sistema si comporta in maniera differente :
CASO A : Quando è presente soltanto la prima dimensione l'elemento viene visto come variante singola ( monovariante )
CASO B : Se è presente soltanto la seconda dimensione il sistema rileva l'errore ma si comporta come nel CASO A ( questo tipo di errore determina comunque un rallentamento dell'app in fase di elaborazione )
ATTENZIONE : I campi "posizione posizione dimensione 01" e "posizione dimensione 02" devono essere interi. Nel caso in cui vengano passati valori diversi da interi il sistema fa un "Cast" ovvero tenta di trasformare la stringa in intero. Questo tipo di situazione va comunque evitata in quanto riduce il controllo all'interno del sistema sull'ordinamento degli elementi in griglia.

In caso dovesse esserci la necessità di caricare un articolo  Mono variante 
la variante dimensione 2 NON va valorizzata nei campi ma devono esserci i ;

Es:
A037;01;Diametro 01;;;;;;;V037-0

---

disponibilita.csv

Il tracciato disponibilita.csv permette di definire la disponibilità dei singoli prodotti o la disponibilità prevista entro una specifica data di approvigionamento.

Schema

Campo	Descrizione del campo	Formato	Note
codice articolo	codice famiglia articolo per il raggruppamento delle varianti	varchar(255)	riferito a articoli.csv
codice variante		varchar(255)	riferito a varianti.csv
disponibilita		decimal	sparatore decimale , (virgola)
data disponibilita		varchar(255)	data formato aaaammgg
disponibilita programmata		decimal	sparatore decimale , (virgola)

La tabella disponibilità offre la possibilità di fornire informazioni in merito alla disponibilità di singoli prodotti ed il loro approvvigionamento previsto nel campo "data disponibilità".
Il campo disponibilità programmata serve a dare una indicazione quantità di prodotti disponibili dopo la data di approvvigionamento ( data disponibilità ). Ovviamente la disponibilità deve essere considerato un valore puramente indicativo la cui attendibilità è legata alla frequenza di sincronizzazione fra ZotSell e la base dati del cliente.

---

Approfondimenti

disponibilita: I valori interpretati dall'app  sono solo quelli  >= 0 

disponibilita programmata: I valori interpretati dall'app sono solo quelli >= 0  

---

Esempi

AZ327a;;71;;
AZ327b;;71;20190923;120
AZ327c;;71;20190923;
AZ327d;;71;;120
AZ327e;;;20190923;120
AZ327f;;;20190923;
AZ327g;;;;120
AZ327h;;30;20190923;120

---

Frequenti

Permette di transare delle informazioni aggiuntive legate all'articolo scelto e al cliente a carrello Vedi  questa guida per i dettagli

frequenti.csv

Il tracciato frequenti ha effetto sull'app all'interno del modulo vendite. Fra le varie modalità di visualizzazione è possibile scegliere "Modalità frequenti" e visualizzare la lista dei prodotti che vengono venduti più di frequente ad uno specifico cliente.
Per alimentare l'area e sufficiente specificare all'interno del tracciato il codice_cliente ed il codice_articolo che si intende associare a quel cliente.

Campo	Descrizione del campo	Formato	Note
codice_cliente*		varchar(255)
codice_articolo*		varchar(255)

  * Campi obbligatori

frequenti_01.csv

Campo	Descrizione del campo	Formato	Note
codice_cliente*		varchar(255)
codice_articolo*		varchar(255)
ordered	campo per note - Indicativamente 50 char	varchar(255)	più caratteri ci sono più piccola viene la scritta

* Campi obbligatori 

Esempi

C000;A000;2018/04/21 P:26.5 -Sconto:50.0% Q.tà 50
C000;A000;2016/09/23 P:27.5 -Sconto:30.0% Q.tà 250
C000;A001;Ultimo prezzo pagato: 36.5 - Sconto applicato 1: 55.0%
C000;A027;Ultimo prezzo pagato: 26.5 - Sconto applicato 1: 50.0%
C000;A028;Ultimo prezzo pagato: 10 - Sconto applicato 1: 20.0%
C000;A041;Ultimo prezzo pagato: 30.5 - Sconto applicato 1: 13.0%
C000;A044;Ultimo prezzo pagato: 1123.55 - Sconto applicato 1: 8.0%
C000;A062;Ultimo prezzo pagato: 61 - Sconto applicato 1: 31.0%
C000;A063;Ultimo prezzo pagato: 34 - Sconto applicato 1: 40.0%
C000;A206;Ultimo prezzo pagato: 28 - Sconto applicato 1: 5.0%
C000;A207;Ultimo prezzo pagato: 19 - Sconto applicato 1: 8.0%
C000;V205002;Ultimo acquisto 20160421 q = 10 Prezzo 21 sconto 50 
C000;V205003;Ultimo acquisto 20160421 q = 10 Prezzo 21 sconto 50 
C000;V205004;Ultimo acquisto 20160421 q = 10 Prezzo 21 sconto 50 
C000;V205005;Ultimo acquisto 20160421 q = 10 Prezzo 21 sconto 50 
C000;V205006;Ultimo acquisto 20160421 q = 10 Prezzo 21 sconto 50 
C000;V205007;Ultimo acquisto 20160421 q = 10 Prezzo 21 sconto 50 
C000;V205008;Ultimo acquisto 20160421 q = 10 Prezzo 21 sconto 50 
C000;V205009;Ultimo acquisto 20160421 q = 10 Prezzo 21 sconto 50 
C000;V205010;Ultimo acquisto 20160421 q = 10 Prezzo 21 sconto 50 
C000;V205011;Ultimo acquisto 20160421 q = 10 Prezzo 21 sconto 50 
C000;V205012;Ultimo acquisto 20160421 q = 10 Prezzo 21 sconto 50 
C000;V205013;Ultimo acquisto 20160421 q = 10 Prezzo 21 sconto 50 
C000;V205024;Ultimo acquisto 20160421 q = 10 Prezzo 21 sconto 50 
C000;V205025;Ultimo acquisto 20160421 q = 10 Prezzo 21 sconto 50 
C000;V205026;Ultimo acquisto 20160421 q = 10 Prezzo 21 sconto 50 
C000;V205027;Ultimo acquisto 20160421 q = 10 Prezzo 21 sconto 50 
C000;V205028;Ultimo acquisto 20160421 q = 10 Prezzo 21 sconto 50 
C000;V205029;Ultimo acquisto 20160421 q = 10 Prezzo 21 sconto 50 
C201;V205014;Ultimo acquisto 20160421 q = 10 Prezzo 21 sconto 50 
C201;V205015;Ultimo acquisto 20160421 q = 10 Prezzo 21 sconto 50 
C201;V205016;Ultimo acquisto 20160421 q = 10 Prezzo 21 sconto 50 
C201;V205017;Ultimo acquisto 20160421 q = 10 Prezzo 21 sconto 50 
C201;V205018;Ultimo acquisto 20160421 q = 10 Prezzo 21 sconto 50 
C201;V205019;Ultimo acquisto 20160421 q = 10 Prezzo 21 sconto 50 
C201;V205020;Ultimo acquisto 20160421 q = 10 Prezzo 21 sconto 50 
C201;V205021;Ultimo acquisto 20160421 q = 10 Prezzo 21 sconto 50 
C201;V205022;Ultimo acquisto 20160421 q = 10 Prezzo 21 sconto 50 
C201;V205023;Ultimo acquisto 20160421 q = 10 Prezzo 21 sconto 50

Nb: Per generare più righe di dettaglio è sufficiente transare più righe nel tracciato

frequenti_02.csv

Rispetto ai tracciati precedenti questo tracciato permette di associare il frequente anche specificatamente ad una destinazione in modo che la lista e le informazioni presentate dipendano dal cliente e dalla destinazione impostata a carrello 

Attenzione la presenza di questo tracciato prevale sugli eventuali  tracciati  frequenti.csv e  frequenti_01.csv qualora presenti  in FTP
Attenzione : la presenza di questo tracciato prevale sul tracciato frequenti.csv frequenti_01.csv qualora presenti  in FTP
E' comunque opportuno togliere da FTP i tracciati obsoleti perchè comunque appesantiscono il sistema di controllo e importazione


.... In fase di documentazione

Campo	Descrizione del campo	Formato	Note
codice_cliente*		varchar(255)
codice_destinazione*		varchar(255)
codice_articolo*		varchar(255)
ordered	campo per note - Indicativamente 50 char	varchar(255)	più caratteri ci sono più piccola viene la scritta
extra_data	campo riservato interno	varchar(255)	Deve essere presente ma non popolato

* Campi obbligatori 

Esempi

C210;D01;A008;8 In data 8 Gennaio 2019;
C210;D02;A009;9 In data 9 Gennaio 2019;
C210;D03;A010;10 In data 10 Gennaio 2019;
C210;D04;A011;11 In data 11 Gennaio 2019;

Nb: Per generare più righe di dettaglio è sufficiente transare più righe nel tracciato

---

Box

La modalità di acquisto a box permette l'acquisto di un insieme di varianti predefinito nell'assortimento e nella quantità. L'utente può acquistare solo multipli del box acquistare.

Per predisporre questa caratteristica è necessario transare gli assortimenti tramite i seguenti tracciati.

box.csv

Campo	Descrizione del campo	Formato	Note
codice_articolo	Codice dell'articolo a cui il box si riferisce	varchar(32)	Deve essere presente in articoli.csv
codice_assortimento	Codice del box	varchar(32)	deve essere univoco all'interno dei box dello stesso articolo
contesto	Fisso = box	varchar(32)	per sviluppi futuri il sistema attende il valore fisso = 'box'
titolo_assortimento	E' una stringa breve di testo	varchar(64)	La descrittiva utente per il box
ordinamento	Serve per gestire una priorità in visualizzazione	int(6)
descrizione	E' una stringa breve di testo	varchar(255)	Premette una descrizione aggiuntiva del box

---

box_items.csv

Campo	Descrizione del campo	Formato	Note
codice_articolo	Codice dell'articolo a cui il box si riferisce	varchar(32)	Deve essere presente in articoli.csv
codice_assortimento	Codice del box a cui la riga si riferisce	varchar(32)	Deve essere univoco all'interno dei box dello stesso articolo
codice_variante	Codice della variante articolo da presentare valorizzata nel box	varchar(32)	Deve essere presente in varianti.csv e corrispondere a un
quantita	Il valore in quantita da presentare per la variante nel box	boolean	La descrittiva utente per il box

*Tutti i campi obbligatori

---

---