Il connettore EsportaCatalogo è in grado di leggere file CSV provenienti da fonti esterne qualora non sia praticabile l’accesso diretto al database.
Una controindicazione di questo approccio è che non si può usare la sintassi SQL per effettuare operazioni condizionali, sommatorie, valutazioni di record più o meno recenti, per cui è necessario che eventuali filtri siano valutati prima di generare i file CSV. La prima riga di intestazioni è opzionale.
Di preferenza il nostro connettore NON gradisce le virgolette per i campi testuali. Il separatore è punto e virgola di default ma è possibile configurarlo.
I nomi dei file e dei campi indicati sono indicativi, generalmente consigliamo vivamente di usare i nomi corrispondenti alle reali colonne del database invece che i nostri.
IMPORTANTE: il connettore è in grado di leggere tutti i dati di un articolo in un singolo passaggio (es. tutti in articoli.csv) ma può anche precaricare delle informazioni (es. categorie, listini) da file separati, quindi invitiamo a NON fare join problematici quanto è molto più semplice generare file sparati. L’esempio più frequente è se un articolo ha un numero variabile di listini, allora non ha senso provare ad aggiungere un numero imprecisato di campi (es. listino1, listino2, listino3, …, listino8) al file articoli.csv ma è più efficiente creare un listini.csv separato.
articoli.csv
File contenente i dati principali dei prodotti.
- codice articolo
- descrizione
- unità di misura principale
- pezzi per confezione (usato come multiplo in app durante l’aggiunta a carrello)
- prezzo (se il prezzo è unico, va bene inserirlo in articoli.csv altrimenti preferibile un listini.csv dedicato)
- categoria (posso indicare direttamente la descrizione categoria, oppure un id categoria se esiste una struttura ad albero che leggerò da categorie.csv)
- codice iva (posso indicare solo il codice iva e fornire una tabella iva.csv separata, oppure direttamente l’aliquota)
- disponibilità (se calcolata come valore unico, altrimenti può essere calcolata con un file disponibilita.csv separato in cui poter elencare anche magazzini diversi)
iva.csv
File opzionale con la tabella delle aliquote iva, obbligatoria solo nel caso si gestiscano esenzioni iva (es. clienti esteri).
- codice iva
- aliquota
- descrizione iva
categorie.csv
File contenente l’associazione fra id categoria e la descrizione, o l’eventuale struttura ad albero.
- id categoria
- descrizione categoria
- categoria padre (se la struttura è ad albero, deve riferirsi ad un altro id categoria)
articoli_promozione.csv
File opzionale per marcare degli articoli come “in promozione” o “novità”, il fatto che un articolo sia marcato non impone necessariamente che il prezzo abbia delle condizioni diverse dal prezzo di listino. Se non necessita di logica particolare, questo flag promo/novità può anche essere un campo di articoli.csv.
- codice articolo
- valore promo/novità (1 se in promozione, 2 se novità)
barcode.csv
File opzionale per associare codici supplementari agli articoli, ogni riga è un codice supplementare quindi il codice articolo può essere ripetuto più volte nel file.
- codice articolo
- codice aggiuntivo
disponibilita.csv
File opzionale con le disponibilità degli articoli, un articolo può comparire su più righe e in quel caso il valore viene calcolato con la somma di tutte le righe di ogni articolo.
- codice articolo
- codice magazzino
- esistenza fisica
- impegnato cliente
- ordinato a fornitore
listini.csv
File opzionale con i prezzi articoli, se non sono specificati già nel file articoli.csv.
- codice articolo
- codice listino
- prezzo
- sconto1..scontoN (se gestita l’applicazione incondizionata di uno o più sconti sul prezzo di listino)
sconti.csv
File opzionale per definire eccezioni di prezzi per specifici clienti, o gruppi di clienti, o prezzi netti o prezzi per quantità, con date di inizio e fine se necessario.
- codice cliente (alternativo a gruppo clienti)
- gruppo clienti (alternativo a singolo codice cliente)
- codice articolo (alternativo a categoria articoli)
- categoria articoli (alternativo a singolo codice articolo)
- prezzo netto dedicato (alternativo a sconti percentuali)
- sconto1..scontoN dedicato (anche su più campi ad es. 10+5, alternativo a prezzo netto dedicato)
- data inizio (se gestita)
- data fine (se gestita)
- quantità minima
- quantità massima
clienti.csv
File con i dati di base dei clienti, dove è obbligatorio codice e denominazione, fortemente consigliata partita iva o codice fiscale, opzionali tutti gli altri dati.
- codice cliente
- denominazione
- indirizzo
- città
- cap
- provincia
- nazione
- telefono*
- email*
- cellulare*
- pec*
- sdi*
- fido massimo* (se gestito)
- blocco sì/no* (se gestito)
* se alcuni dei campi indicati si trovano nativamente su tabelle diverse è possibile creare file separati ad es. clienti_pec.csv contenenti il solo codice cliente e la pec.
sedi.csv
File con le destinazioni diverse dei clienti.
- codice cliente
- codice sede
- indirizzo
- città
- cap
- provincia
- nazione
- telefono sede
- email sede
- flag default sì/no (se gestito, fa in modo che alla selezione del cliente questa sede venga direttamente impostata nel documento)
sospesi.csv
File opzionale con le scadenze sospese del cliente, ogni riga è una singola rata. È possibile considerare anche scadenze future virtualmente già saldate (es. RI.BA. con scadenza futura) passando i campi dare e avere con pari valore, in questo modo la rata apparirà nell’estratto conto ma non farà cumulo sul totale.
- codice cliente
- id sospeso
- descrizione sospeso
- dare
- avere
- data documento
- data scadenza rata
agenti.csv
File opzionale usato per associare un codice agente al suo nominativo ed indirizzo email, oltre a poter specificare un capoarea per ogni agente che ne riceverebbe tutti i clienti in app.
- Codice agente
- denominazione agente
- email agente (se gestita)
- capoarea (se gestito)
province.csv
File opzionale che permette di far selezionare le province da un elenco invece che inserirle a testo libero.
- id provincia
- descrizione
nazioni.csv
File opzionale che permette di far selezionare la nazione da un elenco invece che inserirla a testo libero.
- id nazione
- descrizione
pagamenti.csv
File opzionale con i tipi di pagamento ed eventuali sconti o costi di incasso collegati.
- codice pagamento
- descrizione pagamento
- sconto percentuale collegato
- costi di incasso
provvigioni.csv
File opzionale per inviare un elenco di provvigioni, maturate o da maturare, ad ognuno degli agenti. Le provvigioni sono consultabili con l’apposito tasto PROVVIGIONI che di default non è attivo in app.
- codice agente
- descrizione documento
- importo provvigione
- importo maturato
- importo già pagato all’agente (oppure flag pagato sì/no)
componenti.csv
File opzionale per definire i componenti di un articolo composto, è necessario che l’articolo padre sia presente in articoli.csv. Il codice padre comparirà più volte nel file per ognuno dei suoi componenti.
- codice padre
- codice componente
- quantità componente
Altri file opzionali ancora non documentati:
- Statistiche di vendita clienti/agenti (ogni riga corrisponde a una testata documento purché di vendita e purché data documento > 01/01/annoprecedente, sarà il connettore ad assemblare le statistiche sommando per mese)
Codice cliente, codice sede, codice agente, data documento, netto merce (generalmente escluso iva e spese trasporto/varie)
- Storico dell’acquistato (una riga è una riga documento purché di vendita e purché data documento > oggi-365)
Codice cliente, codice sede, data documento, numero documento, serie, codice articolo, quantità, prezzo, sconto (anche su più campi se 10+5)
- Dettaglio arrivi futuri merce (una riga è una riga di ordini a fornitore ancora non evasi purché non obsoleti)
Codice articolo, data documento, data consegna prevista, quantità ordinata, quantità parzialmente evasa