Help & Tips - View Manuals

Wizard Home > Integrazione con Gestionale/CRM esterni (Autonoma) > Importazione Gestionale verso Zotsell

Cod.	Ultima revisione	Wiki	Note
11	2016/06/09 - PG

In questa guida sono documentati i vari tracciati che servono ad alimentare Zotsell.

Premesse

Per quanto riguarda i tracciati prodotti e posizionati in FTP per l'elaborazione sono sempre da tenere in considerazione questi punti. Quando si verificano delle incongruenze o errori tra quanto trasmesso e quanto poi visualizzato in App verificare che siano rispettati.

Nomi dei tracciati
I tracciati devono essere nominati esattamente come riportato nella guida.
Separatore di campo
Il separatore da utilizzare può essere scelto e configurato nel server fra questi
- Punto e virgola - ";" (Default)
- Pipe - "|"
- Virgola - ","
- tab (Carattere tabulazione)
Per utilizzare un separatore diverso da quello di default (fra quelli indicati sopra) è necessario effettuare una richiesta di riconfigurazione tramite assistenza

Quando si utilizzano file con campi separati da un delimitatore, come il punto e virgola (;), si consiglia di formattare i contenuti dei campi racchiudendoli tra virgolette doppie ("), nel seguente modo: "campo1";"campo2"
Nel caso in cui il contenuto di un campo contenga delle virgolette doppie, è necessario raddoppiarle per evitare ambiguità. In questo modo il sistema riconosce correttamente le virgolette come parte del contenuto del campo e non come il delimitatore del campo stesso.
Esempio: "la misura del diametro è di 23"" ";"123.00"
Ritorno a capo
Per inserire ritorni a capo all'interno di testi lunghi contenuti nei campi utilizzare i caratteri: "\r" o "\n"
Fine riga (Record)
Il carattere di ritorno a capo per il fine riga può essere scelto fra i seguenti:
- Ritorno a carrello + Nuova linea (Stile Windows consigliato!)
- Ritorno a carrello (Stile Apple)
- Nuova Linea (Stile Unix)
Charset
Il charset da utilizzare per i file dei tracciati è sempre UTF8 - No bom.
Utilizzo di altri charset può comportare la non corretta e completa visualizzazione dei dati

Struttura Excell

Per comodità rendiamo disponibile la struttura in excell dei tracciati disponibili Download

Schede Contatti

Di seguito i tracciati che permettono di gestire le schede presenti nel modulo Contatti

anagrafiche.csv

Permette di gestire i dati base delle singole schede anagrafiche dei clienti indicando oltre all'indirizzo base fatturazione anche eventuali indirizzi aggiuntivi di spedizione. Ad ogni anagrafica di fatturazione può essere attribuito un listino base di partenza per i prezzi Cliente (default).

Vedi questa guida anagrafiche.csv

anagrafiche_opzioni_aggiuntive.csv

Permette di aggiungere alle anagrafiche dei dati aggiuntivi personalizzati di corredo alla scheda contatto liberamente , come ad esempio una email secondaria, delle informazioni aggiuntive.

Vedi questa guida anagrafiche_opzioni_aggiuntive.csv

liste_supporto.csv

Liste di supporto permette di creare degli elenchi di opzioni da cui il tracciato anagrafiche_opzioni_aggiuntive potrà attingere. Può essere utile per inserire una lista di provincie, un elenco di metodi di pagamento od una serie di valori convenzionati.

Vedi questa guida liste_supporto.csv

risorse_anagrafiche.csv

Permette di associare dei file alle schede anagrafiche visibili dalla scheda

Vedi questa guida risorse_anagrafiche.csv

anagrafiche_agenti.csv

Premette di limitare le schede anagrafiche che un agente può visualizzare.

Vedi questa guida anagrafiche_agenti.csv

scadenze.csv

Permette di indicare delle scadenze fatture per alimentare il modulo incassi .

Vedi questa guida scadenze.csv

Schede Articoli

Di seguito i tracciati per la gestione delle schede articolo del Modulo prodotti (Catalogo Vendita)

articoli.csv

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

Vedi questa guida articoli.csv

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,associazione di barcode.

Vedi questa guida articoli_opzioni_aggiuntive.csv

varianti.csv

Il tracciato permette di associare alla singola scheda prodotto una serie di varianti dello stesso articolo. Il tracciato darà vita all'interno di ZotSell ad una griglia comprensiva di varianti e relative immagini identificative .

Vedi questa guida varianti.csv

catalogo_01.csv

Serve a produrre un struttura di navigazione per il raggiungimento delle schede articolo (Vedi : Vista Cartelle)

Vedi questa guida catalogo_01.csv

Tracciati alternativi

E' possibile utilizzare dei tracciati alternativi per per transare la struttura del catalogo
Vedi questa guida:

disponibilita.csv

Permette di indicare la disponibilità dei singoli prodotti (Giacenze) o la disponibilità prevista entro una specifica data di approvigionamento.

Vedi questa guida disponibilita.csv

frequenti.csv

Permette di transare delle informazioni aggiuntive legate all'articolo scelto e al cliente a carrello.

Vedi questa guida frequenti.csv

Traduzioni in lingua

Di seguito i tracciati che permettono di gestire le traduzioni in lingua di alcuni archivi Rif: Traduzioni

articoli_tr.csv

Permette di gestire le traduzioni delle descrittive articolo

Vedi questa guida articoli_tr.csv

catalogo_01_tr.csv

Permette di gestire le traduzioni delle descrittive catalogo

Vedi questa guida catalogo_01_tr.csv

risorse_articoli_01_tr.csv

Permette di gestire le traduzioni delle descrittive dei media file collegati agli articoli

Vedi questa guida risorse_articoli_01_tr.csv

Politiche Prezzo

listini_02.csv

Rappresentano i listini di default associati alle singole schede anagrafiche. All'interno del tracciato sarà possibile definire il prezzo dei singoli prodotti ed associarlo a specifiche condizioni legate a Data di Acquisto e Quantità dei prodotti ordinati

Vedi questa guida listini_02.csv

listini_opzioni_aggiuntive.csv

Permette di aggiungere ulteriori campi al tracciato listini_02.csv come ad esempio un'ulteriore valuta

Vedi questa guida listini_opzioni_aggiuntive.csv

listini_personalizzati_01.csv

Concorre nell'attribuzione del prezzo offrendo la possibilità di generare una serie di eccezioni condizionate da specifici criteri

Vedi questa guida listini_personalizzati_01.csv

listini_netti.csv

Attraverso listini_netti.csv sarà possibile associare alla singola anagrafica un listino alternativo in grado di concorrere all'attribuzione del prezzo. I prodotti che non soddisfano le condizioni oppure non sono presenti all'interno del listino alterativo erediteranno il prezzo del listino di default.

Vedi questa guida listini_netti.csv

modalita_vendita.csv

Il tracciato modalita_vendita.csv permette di creare modalità di vendita alternative come ad esempio unità di misura differenti, vendite al pezzo, a cartone ecc. Il tracciato possiede un fattore di conversione per il calcolo del prezzo sulla base di unità di misura differenti

Vedi questa guida modalita_vendita.csv

Politiche Sconto

sconti.csv

Il tracciato sconti.csv permette di attribuire sconti associati a prodotti, gruppi di prodotti, singole anagrafiche o gruppi di anagrafiche. All'interno del tracciato sono presenti una serie di campi per permettere di condizionare il calcolo dello sconto sulla base di specifici criteri oppure di generare degli sconti composti.

Vedi questa guida sconti.csv

sconti_dimensioni_varianti.csv

Lo scopo del tracciato è quello di attribuire degli sconti a specifiche righe o colonne della griglia contenente le varianti associate al singolo prodotto

Vedi questa guida sconti_dimensioni_varianti.csv

sconti_testata.csv

permette di attribuire degli sconti aggiuntivi a fine ordine in base a delle opzioni selezionate nel tab dati aggiuntivi

Vedi questa guida sconti_testata.csv

Ordini esterni e info aggiuntive

Tracciati da utilizzare per inserimento in Zotsell dello storico ordini proveniente da gestionale , aggiornare gli stati ordine in base agli stati interni del gestionale o aggiungere info alla scheda ordine.

ordini.csv

Permette di associare a ciascun ordine presente nel DB zotsell , un codice esterno (codice ordine del gestionale ) uno stato ordine esterno (stato ordine in gestionale)
a partire dal codice ordine Zotsell . E' un tracciato obsoleto in fase di sostituzione con il tracciato ordini_opzioni_aggiuntive.csv

Vedi questa guida ordini.csv

ordini_esterni.csv

Permette di popolare il DB Ordini in server Zotsell con ordini provenienti dal gestionale

Vedi questa guida ordini_esterni.csv

ordini_esterni_01.csv

Permette a differenza del tracciato ordini_esterni.csv di popolare il DB Ordini in server Zotsell con ordini provenienti dal gestionale senza tener conto di nome e descrizione articoli presenti nel DB zotsell ma utilizzano nome e descrizione storici

Vedi questa guida ordini_esterni_01.csv

ordini_opzioni_aggiuntive.csv

Permette di associare dati di corredo relativi ai documenti vendita (ordini) presenti nel sistema Zotsell.
Se questo tracciato è presente il sistema di import ignora ordini.csv (orders.csv).

Vedi questa guida ordini_opzioni_aggiuntive.csv

ordini_opzioni_aggiuntive_01.csv

Permette tramite apposito tracciato di associare info (Solitamente file) aggiuntive ad una scheda ordine tramite l'utilizzo di identificativi convenzionati come ad esempio un tracking url , file delle conferme ordine, file DDT,Fatture,Resi

Vedi questa guida ordini_opzioni_aggiuntive_01.csv

Tracciati Speciali

persone.csv

All’interno di anagrafica.csv è possibile censire indirizzi ed informazioni relative alle aziende messe a disposizione del singolo agente.

Poiché all’interno di ogni azienda operano diverse figure con le quali l’agente può mettersi in contatto, è stato predisposto un tracciato chiamato persone.csv in grado di ospitare i dati anagrafici di singoli contatti associati alle relative aziende.

Vedi questa guida persone.csv

persone_opzioni_aggiuntive.csv

Come per anagrafiche_opzioni_aggiuntive.csv , è stato predisposto un ulteriore tracciato in grado di permette al gestore di aggiungere campi personalizzati da associare ai contatti censiti.

Vedi questa guida persone_opzioni_aggiuntive.csv

articoli_agente.csv

Il tracciato articoli_agente permette di limitare gli articoli visualizzabili da un agente. Per alimentare l'area e sufficiente specificare all'interno del tracciato il codice_agente ed il codice_articolo che si intende associare al specifico agente.

Vedi questa guida articoli_agente.csv

risorse_articoli.csv

Il tracciato risorse_articoli.csv permette di associare dei file allegati alla scheda articolo

Vedi questa guida risorse_articoli.csv

risorse_articoli_01.csv

Il tracciato risorse_articoli_01.csv permette di associare dei file allegati alla scheda articolo. E' un evoluzione del tracciato base risorse_articoli.csv e permette in più di definire un icona personalizzata per l'allegato tramite il campo icona (Ultimo campo)

Vedi questa guida risorse_articoli_01.csv

collegamenti_articoli.csv

Permette di visualizzare in scheda articolo nel Tab "Correlati" una lista di schede articolo

Vedi questa guida collegamenti_articoli.csv

custom_search.csv

Il tracciato speciale cusotm_search.csv serve per dotare gli articoli di taggature supplementari rispetto a quanto transato nel tracciato articoli.csv

Vedi questa guida custom_search.csv

prospetti.csv

Permette di caricare dei prospetti in app

Vedi questa guida prospetti.csv

cancellazione_risorse.csv

Obsoleto Il tracciato cancellazione_risorse.csv permette di automatizzare la procedura di cancellazione dei file obsoleti, il funzionamento del tracciato è molto semplice, ogni riga del tracciato contiene il nome del file che il sistema deve cancellare. Nel caso il file da cancellare non sia presente all’interno dell’area deposito il sistema passa al record successivo. Il sistema non verifica se il file cancellazione_risorse.csv è cambiato o meno dalla precedente elaborazione e quindi viene sempre eseguito il processo sulla lista presente nel tracciato.

risorse_deposito.csv

Obsoleto - Non più funzionante
Il tracciato risorse_deposito.csv contiene l’elenco di tutte le risorse presenti all’interno dell’area deposito. In fase di attivazione si può richiedere che il file venga registrato anche all’interno del proprio spazio FTP oppure renderlo scaricabile direttamente da App Server attraverso un link presenti nel riquadro di destra dell’area deposito.

customers_rounds.csv

Permette di definire dei girovisita

Vedi questa guida customers_rounds.csv

Tracciati in uscita

Nuovo Ordine

In caso sia necessario dati su tracciato per importare gli ordini in gestionale vedi questa guida:
Tracciato Nuovo Ordine

In questa guida trovate il flusso dell'ordine a partire dal device:
Flusso dell'ordine

Nuovo Cliente

In caso sia necessario gestire ordini su nuovi clienti vedi queste guide :
- Configurazione applicazione per Attivazione trattamento Nuovo Cliente
- Esportazione dati su tracciato Tracciato Nuovo Cliente

Nuova Destinazione

In caso sia necessario gestire nuove destinazioni in fase ordine vedi queste guide :
- Configurazione applicazione per Attivazione trattamento Nuova Destinazione
- Esportazione dati su tracciato Tracciato Nuova Destinazione

Api Syncro

All'interno di App server è presente uno specifico Tool mediante il quale effettuare l'importazione massiva di tutti i dati da una base dati esterna.
Per accede al tool di importazione occorre posizionarsi all'interno del menù "impostazioni" rappresentato dal simbolo di un ingranaggio e cliccare il corrispondenza della voce "ApiSyncro".

Modulo - API Syncro Elaborazione Tracciati (Elaborazione tracciati su FTP)-

Api Sychro offre la possibilità di avviare l'importazione dei file presenti all'interno del percorso FTP /from_cliente/repository e dei vari tracciati presenti all'interno di /from_cliente/tracciati.

Per avviare l'importazione dei file a corredo è necessario cliccare in corrispondenza della voce ( Syncro ).

La finestra di riepilogo posta al centro della pagina mostrerà lo stato di avanzamento del processo segnalando eventuali Warning od Errori.

La differenza sostanziale fra Warning ed Errore consiste nel fatto che il Warning rappresenta una semplice segnalazione che non interrompe l'importazione dei dati, mentre l'Errore interrompe il processo a causa di una anomalia che rende impossibile proseguire con la procedura di importazione.
I pulsanti Log, posti nella parte superiore della schermata permettono di visualizzare un registro contenente Warning, segnalazioni e dati relativi alle precedenti sincronizzazioni.

ATTENZIONE
Caratteri speciali : Evitare di utilizzare caratteri speciali come backslash soprattutto se posto davanti a simboli come apice o doppio apice. Questo potrebbe confondere l'algoritmo di importazione una serie di errori bloccanti.

Formato tracciati : i singoli campi trasmessi verranno distinti tra loro attraverso l'inserimento di uno specifico separatore tipo ";" - "," - "|" - "tab" ed usare una codifica caratteri unicode UTF8 .

NOTE
La frequenza di aggiornamento può esser controllata da remoto tramite una chiamata ad un api che lancia il processo di elaborazione

Api Syncro processa soltanto i tracciati che presentano delle variazioni rispetto ai tracciati importati nel corso dell'ultima sincronizzazione.

La stessa cosa avviene per quel che riguarda immagini ed elementi a corredo in cui il tool confronta la data dei singoli file presenti.

Il lancio dell'elaborazione server comporta SEMPRE l'avviso in App di una sincronizzazione necessaria. Per evitare queste situazioni è consigliato avviare l'elaborazione server solo quando necessario . In caso è preferibile utilizzare le api server anziché operazioni pianificate all'interno del server Zotsell

Per syncronizzazione app vedi questa manualistica