1. Home
  2. Documenti
  3. Manuali specifici
  4. Area51 – Dialogo con gestionale esterno

Area51 – Dialogo con gestionale esterno

Area51 è in grado di "dialogare" con sistemi di back office di terze parti in modo molto flessibile, sia in entrata che in uscita. E' quindi possibile realizzare il collegamento con un gestionale esterno per lo scambio dati.

In entrata in Area51 disponiamo di un interprete che è in grado di adattare l'importazione in base alla struttura del file di ingresso.

In uscita da Area51 vengono generati dei file di testo standard, contenenti la totalità delle informazioni disponibili, e che sarà cura del gestionale di raccolta andare a "raccogliere" importando quanto è necessario.

Area51 può perciò operare come software di gestione front-end (per la vendita al banco, ddt e fatturazione, gestione clienti fidelity, etc.), collegato dinamicamente ad un gestionale di magazzino o di back-office.
In questo caso, origine dei dati per la creazione degli archivi di Area51 sarà il gestionale esterno, che alimenta Area51 tramite dei semplici file di testo (formato .txt, .csv e simili) depositati in una cartella concordata.

La lista degli archivi importabili da Area51 tramite la procedura client TXT è elencata in questo documento, e comprende articoli, codici, listini, clienti, dati fidelity, giacenze, movimenti.
In direzione inversa, Area51 può esportare i dati di vendita da esso generati in appositi file di testo che distinguono corrispettivi, documenti (ddt e fatture), chiusure fiscali, e via dicendo.

Importazione in Area51 da Gestionali esterni

Informazioni tecniche

In Area51 si predispone un "interprete" dei file provenienti dal back-office esterno; questo interprete è a sua volta un semplice file, denominato [_tracciati_record.ini].
Questo file istruisce Area51 in merito all'importazione dei dati; in esso deve essere indicata la corrispondenza tra i campi di Area51 e i file provenienti dall'esterno; il file di configurazione è unico, ma può configurare l'importazione per i diversi archivi utilizzando differenti sezioni identificate da parentesi quadre: p.es. [articoli], [prezzi], [barcode], [movimenti], etc.
Il file _tracciati_record.ini deve essere collocato nella stessa cartella in cui il gestionale deposita i propri file di uscita.
NB: Non possono essere utilizzati file con estensione .dat

I campi importabili sono numerati ed ogni numero indica la posizione che il campo ha all’interno del file di scambio. Nella struttura sottoriportata sono indicate le  posizioni di default, che tuttavia possono essere modificate senza inficiare l'importazione, semplicemente indicando il numero corretto.

Il nome della sezione corrisponde al gruppo di informazioni da importare (p.es. [articoli], [codici], [movimenti], [offerte], etc.).
Il primo numero corrisponde alla posizione del campo in Area51 (non modificare questo valore);
La descrizione dopo il segno di uguale [= ] è descrittiva ma non è significativa;
Il numero dopo il secondo segno di uguale [= ] corrisponde alla posizione del campo all'interno del file esportato dal gestionale;
Se il file da importare è a lunghezza fissa,  la sintassi da utilizzare dopo il segno di uguale è la seguente: inizio-lunghezzatotale-decimali (p.es. 12=PrezzoIvato=13-8-2);
Si può inserire la chiave " nomefile=percorso " per indicare un percorso completo del file degli articoli come nell'esempio, diverso quindi dalla posizione di default.
Formato data: Il formato data predefinito di Area è GG/MM/AAAA (separato da barre). Se nei file il formato data è espresso come "AAAAMMGG", indicare convenzionalmente nel campo numero decimali = 90 (p.es. 19=datainizio=122-8-90 ).

Se nel file nella sezione [VARIE] c’è la voce NonCanc= -1 il programma non effettua la cancellazione del file importato.

Maschera di configurazione in Area51 (previa attivazione del modulo Import/Export):
In Archivi > Parametri e Opzioni > scheda I/O (input/output), configurare i percorsi di lavoro della configurazione Client_TXT in importazione e in esportazione.
Per maggiori informazioni, contattare l’assistenza tecnica.

Esempio:

[Articoli]
nomefile=C:\txvar\articoli.csv
1=CodiceArticolo=1
2=Barcode1=16
3=Barcode2=0
4=Barcode3=0
5=DescrizioneArticolo=2
6=CodCategoria=8
7=CodMarca=0
8=CodFornitore=0
9=PrezzoAcquisto=13
10=Iva=12
11=Imponibile=0
12=PrezzoIvato=14
13=ScontoVendita=0
14=FlagPrezzoFisso=0

Tracciati Record

CAMPI (posizione/descrizione) DESCRIZIONE
[ARTICOLI] Articoli di Magazzino
Giacenza= 1: scrittura giacenza e blocco saldi articolo
2: riscrittura movimento giacenza iniziale.
Questo campo non indica dove recuperare il valore, ma che utilizzo farne.
PrefissoRecord Campo opzionale: valorizzare se il file contiene righe con ID testata
Nomefile=xxx Da valorizzare se il nome è diverso da Articoli.txt
1=Codice Codice articolo
2=BarCode Barcode (EAN13, EAN8, UPC, etc.)
3=Barcode2 Codice aggiuntivo (EAN o altro)
4= -
5=Descrizione Articolo Descrizione Articolo
6=CodCat3 Codice Categoria 3° livello
7=CodMarca Codice Marca
8=CodFornitore Codice Anagrafico Fornitore
9=PrezzoAcquisto Prezzo Acquisto Netto imponibile
40=CodiceIva Codice Iva
10=PercIva Valore Iva (espresso in forma intera, non percentuale)
OBBLIGATORIO
11=PrezzoVendImponibile Prezzo di Vendita Imponibile
12=PrezzoVendIvato Prezzo di Vendita Ivato
13=ScVend Sconto di Vendita
14=PrezzoFisso Prezzo Fisso (vero/falso)
15=Giacenza Giacenza
16=Desc_Cassa Descrizione breve articolo
17=Data_Agg Data aggiornamento
18=CodOfferta Codice Offerta [uso futuro]
20=PuntiFidelity Punti Fidelity articolo [uso futuro]
21=Listino1 Prezzo di vendita ivato Listino 1
23=PuntiJolly Punti Jolly articolo [uso futuro]
26=CodMix Codice Mix Match (relazionato con analogo campo in DETOFF.txt)
27=Settore Codice Settore [uso futuro]
28=Peso Peso articolo
29=UniMis Unità di misura
30=Clas1 Codice Classificazione 1
31=Clas2 Codice Classificazione 2
32=Clas3 Codice Classificazione 3
33=Taglia Codice Taglia
34=Colore Codice Colore
35=Perc_Immagine Percorso file immagine [uso futuro]
36=ArticoloBil Articolo bilancia (vero/falso, vale solo per Check-out)
37=Eliminato Eliminato (valori: -1 / A =Eliminato/Arch | 0=Ok)
38=CategoriaUnoTxt Codice Categoria 1° Livello
45=CodMatriceTaglia
46=Sistemataglie
39=CategoriaDueTxt Codice Categoria 2° Livello
52=Status Stato Articolo
47=PzxCollo Confezione minima (pezzi per collo)
50=Tipo_articolo PRES = Presidio Sanitario
51=WEB_SELE 0 Articolo non web, 1 articolo web

Qualora fosse necessario effettuare l'importazione di campi aggiuntivi relativi alla sezione [articoli], ma presenti in altro file o in altri campi, è possibile replicare il ciclo di importazione creando una sezione [prezzi] all'interno di _tracciati_record.ini; numerazione e posizione dei campi sono analoghi ad [articoli].

[CODICI] Codici alternativi articoli e/o barcode
PrefissoRecord Campo opzionale: valorizzare se il file contiene righe con ID testata
1=CodiceArt Codice Primario articolo
2=BarCode Codice alternativo (EAN13, EAN8, UPC, etc.)
5=TAGEAN Identificatore codici particolari (opzionale)21=Codbil pezzo, 22=codbil peso, 23=codbil prezzo
6=QtVen Quantità di vendita legata al codice alternativo (opzionale)
7=PrVen Prezzo di vendita legato al codice alternativo (opzionale)
11=EAN1
12=EAN2
13=EAN3
14=EAN4
15=EAN5

 

[LISTINI] Listini
NonCanc=-1
Nomefile= Nome del file completo di estensione (p.es. LISTINI.csv)
1=CODICEARTICOLO Codice prodotto
2=LISTINO_IMPONIBILE1
3=LISTINO_IVATO_1
4=LISTINO_SCONTO_1
5=LISTINO_IMPONIBILE_2
6=LISTINO_IVATO_2
7=LISTINO_SCONTO_2
8=LISTINOIMPONIBILE_3
9=LISTINO_IVATO_3
10=LISTINO_SCONTO_3
11=LISTINO_IMPONIBILE_4
12=LISTINO_IVATO_4
13=LISTINO_SCONTO_4
14=LISTINO_IMPONIBILE_5
15=LISTINO_IVATO_5
16=LISTINO_SCONTO_5
17=LISTINO_IMPONIBILE_6
18=LISTINO_IVATO_6
19=LISTINO_SCONTO_6
20=LISTINO_IMPONIBILE_7
21=LISTINO_IVATO_7
22=LISTINO_SCONTO_7
23=LISTINO_IMPONIBILE_8
24=LISTINO_IVATO_8
25=LISTINO_SCONTO_8

 

[GIACENZE_DEPOSITI] NON ATTIVO
Importazione giacenze depositi (VPN)
Nomefile= Nome del file completo di estensione (p.es. giacenze.csv)
1=CodArticolo Codice articolo
11=Giacenza_DEP01
12=Giacenza_DEP02
13=Giacenza_DEP03
14=Giacenza_DEP04
15=Giacenza_DEP05
16=Giacenza_DEP06
17=Giacenza_DEP07
18=Giacenza_DEP08
19=Giacenza_DEP09
20=Giacenza_DEP10

 

[FORNITORI] Anagrafica Fornitori
NonCanc=-1
Nomefile= Nome del file completo di estensione (p.es. FORN.csv)
1=CodFor Codice fornitore
2=RAG_SOCIALE Ragione Sociale
3=P_IVA Partita IVA
4=ELIMINATO Flag eliminato (vero =-1/falso=0)
5=INDIRIZZO Indirizzo
6=COMUNE Comune
7=PROVINCIA Provincia
8=CAP CAP
9=NAZIONE_ISO Nazione
11=TELEFONO Numero di telefono
12=CELLULARE Cellulare
13=EMAIL Indirizzo email
14=INTERNET Indirizzo sito internet
15=CODICE_FISCALE Codice fiscale

 

[CAT3] Codici e descrizioni categorie 3° livello
Noncanc=-1
NomeFile= Nome del file (p.es. MERCATI.DAT)
1=CODICE Codice della categoria 3 livello
2=DESCRIZIONE Descrizione della categoria
3=CATEGORIA2LIV Codice categoria 2 livello associata

 

[CAT2] Codici e descrizioni categorie 2° livello
Noncanc=-1
NomeFile= Nome del file (p.es. MERCATI.DAT)
1=CODICE Codice della categoria 2 livello
2=DESCRIZIONE Descrizione della categoria
3=CODCATEGORIA1LIV Codice categoria 1 livello associata

 

[CAT1] Codici e descrizioni categorie 1° livello
Noncanc=-1
NomeFile= Nome del file (p.es. MERCATI.DAT)
1=CODICE Codice della categoria 1 livello
2=DESCRIZIONE Descrizione della categoria

 

[MARCHE] Codici e descrizioni Marche
Noncanc=-1
NomeFile= Nome del file (p.es. Tabmarche.csv)
1=CODICE Codice della Marca
2=DESCRIZIONE Descrizione della marca

 

[MOVIMENTI] Carico movimenti di magazzino
NomeFile= P.es. CARICO.txt (impostare CAR se si vogliono elaborare TUTTI i file che iniziano per la stringa impostata).
PrefissoRecord Campo opzionale: valorizzare se il file contiene righe con ID testata
Anteprima_Movimenti=-1 Visualizza l'anteprima dell'importazione - OBBLIGATORIO
Fornitore_Anteprima= Inserire il codice fornitore da associare al carico merce
(importante, controllare che il codice sia esistente)
EliminaFile=-1 Se impostato, il file non viene cancellato dopo l'elaborazione
1=CodiceArticolo
2=DescrizioneArticolo
3=PrezzoAcquisto
4=PrezzoVenditaIvato
5=AliquotaIVA
6=DataMov
7=PrezzovenditaImponibile
8=VenditaIvatoTotale
10=RifDoc
12=CodCliente
14=CodFornitore
16=CausaleMov L'aggancio può avvenire con il campo ID (solo numerico) o con il campo "ETICHETTA", alfanumerico.
18=QtMov
20=CodAnagrafico
22=ScontoAcquisto1
26=ScontoAcquisto2
28=Costo
30=ScontoVendita1
32=NumDoc
34=NumDocRiga
36=CodDeposito Area51 gestisce codici deposito a 6 cifre, per eventuali alineamenti con codici diversi, usare il campo ID IMPORT della tabella Depositi
41=Giorno
42=Mese
43=Anno
BIL_PREZZO_CONVERTI Campo Opzionale: valorizzare =-1 se risulta necessario gestire il ricalcolo della quantità nel caso si stiano importando dei codici bilancia (contattare il servizio tecnico per maggiori informazioni). Di default è disattivato (=0)
51=ID_RIGA Campi da gestire in sequenza per generazione ID riga univoco
52=ID_RIGA / LOTTO ACQUISTO Lotto di acquisto
53=ID_RIGA
54=ID_RIGA
55=ID_RIGA
56=ID_RIGA

 

CLIENTI.txt Anagrafica Clienti
1=Codice Codice Cliente
2=RagioneSociale Ragione Sociale
3=Cognome Cognome
4=Nome Nome
5=Indirizzo Via e n. civico
6=Comune Comune
7=Cap CAP
8=SiglaProv Sigla Provincia
9=PartitaIva Partita Iva
10=CodiceFiscale Codice Fiscale
11=Telefono Telefono
12=Email Indirizzo e-mail
13=AbiCab Abi Cab banca cliente [uso futuro]
14=Pagamento Codice di pagamento
15=CodCategoria Codice categoria fidelity
16=SaldoPa Punti Fidelity accumulati
17=SaldoPS Punti Fidelity spesi
18=eliminato Eliminato (vero =-1/falso=0)
19=DataNascita Data di nascita
20=Sesso Sesso
21=Fax Fax
22=Cellulare Cellulare
23=Profilo fidelity Profilo fidelity
24=Doctitolare Gestione Presidi= ENTE
25=Titolare Gestione Presidi = Destinazione (agricola / commerciale)
27=Clas_TXT1
28=Clas_TXT2
29=Clas_TXT3 Gestione Presidi: Numero Autorizzazione
30=DATA_UNO
31=DATA_DUE Gestione presidi: DATA Autorizzazione
32=IDSDI Codice univoco per fatturazione elettronica
34=Testo1 Campo testo1
35=Data ingresso Data ingresso del cliente
36=Consenso Privacy Spunta consenso privacy
37=Consenso mail Consenso all'invio di mail
38=Consenso sms Consenso all'invio di sms

 

PUNTI.TXT Punti fidelity clienti
1=Codice Codice cliente (codice tessera)
2=Punti punti accumulati
3=ImportoSpesa importo totale scontrino
4=DataSpesa data scontrino
5=Deposito codice filiale in cui è stata fatta la vendita
6=numero numero scontrino
7=CodCatFid codice categoria fidelity

 

PREMI.txt Premi fidelity clienti
1=Codice Codice cliente
2=Punti Punti scaricati
3=Cod_articolo Codice articolo
4=Nome_articolo Descrizione articolo
5=Importo Importo ivato articolo
6=data Data premio
7=Deposito Filiale
8=id identificativo univoco
9=CodCatFid Codice Categoria Fidelity

 

FIDEL.txt Categorie Fidelity
1=codice Codice profilo fidelity
2=importo Soglia punti inferiore
3=punti Punti accumulati al raggiungimento della soglia
4=eliminato Eliminato (vero =-1/falso=0)
5=descrizione Descrizione profilo fidelity
6=listino Codice Listino applicato
7=sogliaUno Passo €
8=PuntiSogliaUno Punti accumulati in base al passo

 

[OPERATORI] Operatori Area51
1=Codice Codice Operatore
2=Descrizione Nome
3=Livello Livello (0 - 9)
4=Eliminato Eliminato (vero =-1/falso=0)
5=Pass password

 

25=TitoloOffertaNome convenzionale dell'offerta

[OFFERTE] Offerte
NomeFile= nome del file (i.d. DETOFF.txt)
PrefissoRecord= TAG che indica il tipo di riga (p.es. OFF)
1=CodArt Codice Articolo
2=Importo [uso futuro]
3=Ivato Prezzo Offerta Ivato
4=Sconto Sconto % Offerta
5=DataIni Data inizio offerta (formato gg/mm/aaaa)
6=DataFine Data fine offerta (formato gg/mm/aaaa)
7=CodFid Codice Profilo Fidelity
8=jolly Punti Jolly
9=MN Offerta MxN (es. 3x2, 4x3, 4x, 5+)
10=MixMatch Codice Mix Match
11=Eliminato Eliminato (vero =-1/falso=0)
PROMO.txt Messaggi promozionali su scontrino
1=Stampa Flag vero/falso
2=Testo Testo da stampare
3=Codice Codice univoco
4=Rota Contatore
5=Giorno Data creazione
6=CatFid Codice categoria fidelity
7=Eiminato Eliminato (vero =-1/falso=0)
FATTURE.txt Fatture
NomeFile= Nome del file - Se il file ha nome variabile, è possibile indicare solo la parte iniziale del nome (p.es. FT)
1=Documento Codice del tipo documento
2=Codice_Cliente
3=Cod_Conto
4=Rag_Sociale
5=P_Iva
6=Indirizzo
7=Comune
8=Cap
9=SiglaProv
10=CodiceFiscale
11=ID_Documento
12=Data_Documento
13=Numero_Documento
14=Imponibile_Documento
15=Imposta_Documento
16=Totale_Documento
17=Spese_Trasporto
18=Spese_Incasso
19=Spese_Varie
20=Spese_Esenti
21=Diversa_Destinazione
22=Data_Partenza
23=Numero_Colli
24=Aspetto
25=Peso_Merce
26=ID_Pagamento
27=Des_Pagamento
28=Tag1Pag
29=Tag2Pag
30=ScontoExtra
31=IMPONIBILE_20 Imponibile del riepilogo IVA 20%; idem per le righe seguenti, fanno tutte riferimento al riepilogo IVA.
32=IVA_20
33=IVATO_20
34=IMPONIBILE_10
35=IVA_10
36=IVATO_10
37=IMPONIBILE_4
38=IVA_4
39=IVATO_4
40=IMPONIBILE_0
41=IVA_0
42=IVATO_0
43=IMPONIBILE_21
44=IVA_21
45=IVATO_21
46=ID_Riga da qui in avanti si fa riferimento solo a campi relativi alle singole righe
47=Codice_Articolo
48=Descrizione_Articolo
49=Qt
50=Confezioni
51=Pezzi X Confezione
52=ImponibileEuro
53=IvaEuro
54=IvatoEuro
55=Iva_aliquota
56=Iva_Codice
57=SC_1
58=SC_2
59=SC_3
60=SC_4
61=SC_5
62=Unita_Misura
63=TotaleIvato

[LOTTI] Lotti di acquisto
NomeFile
Separatore=,
1=CodiceArticolo
2=Lotto

Esportazione da Area51 verso Gestionali esterni

Il dialogo con il gestionale esterno avviene anche per i movimenti/documenti generati da Area51, che possono essere agevolmente esportati in formato ASCII, quindi importati a cura del gestionale di arrivo.

La configurazione delle modalità di esportazione avviene da Archivi > Parametri e Opzioni > I/O e riguarda:

La tipologia di esportazione (ASCII standard, ASCII estesa, Custom XML, Custom diverse);
L'intervallo di esportazione (Giornaliero, Mensile, per documento);
La cartella di destinazione;
La modalità di esecuzione (Manuale, per ogni aggiornamento PLU Cassa, per singola transazione);
Altri parametri: Decimali Valuta, Decimali quantità, Separatore decimale.
Per conoscere la struttura dei file di esportazione, abilitare il flag "Export Tracciati", che aggiunge nella cartella di destinazione un file per ogni tipologia di export, con estensione   ".tracciati" che riporta il tracciato record dei file medesimi.
Sono esportati i file:
Corrispettivi, CorrispettiviTOT (chiusure fiscali), DdtTeste, DdtRighe, FattureTeste, FattureRighe, Movimenti, CausaliMagazzino, TabellaIva.
Il primo rigo di OPZIONI consente di precisare l'esportazione escludendo la generazione di alcuni file (vedi legenda nel programma stesso).

Ulteriori opzioni di esportazione sono:

Export Tracciati = Esporta per ogni tipologia un file con estensione .tracciati per conoscere il formato dei file;
Export Articoli = Abilita l'esportazione degli articoli con ulteriori, possibili parametrizzazioni indicate nel pannello OPZIONI.

Esecuzione dell'esportazione

Manuale
Da Vendite > STORE > Manager Casse > Procedure Import/Export > Esportazione file vendite.

Automatico
Tramite lo schedulatore operazioni. Per informazioni leggere il manuale relativo o contattare l'assistenza tecnica

In tempo reale
Le Impostazioni ASCII Documento / Sezionale Documento determinano la creazione di un file per ogni transazione. Per gli scontrini l'evento è la stampa, per i documenti è la registrazione.

La struttura del file è MovimentiDoc:
1 = RifDoc
2 = DataDoc
3 = PreDoc
4 = NumeroDoc
5 = SufDoc
6 = Expr1005
7 = ImponibileDoc
8 = IvaDoc
9 = TotaleDoc
10 = CodAnagrafico
11 = CodCLi
12 = CodFor
13 = CodPN
14 = RagioneSociale
15 = PartitaIva
16 = CodiceFiscale
17 = indirizzo
18 = cap
19 = sigla prov
20 = Comune
21 = telefono
22 = email
23 = ID_NET
24 = CodArt
25 = DescArt
26 = PrAq
27 = PrVen
28 = AlIva
29 = DataMov
30 = CausaleMov
31 = QT
32 = CodDeposito
33 = D_Agg
34 = PrMag
35 = EanMov
36 = Filiale
37 = Doc
38 = IdDoc
39 = PosRiga

Configurazioni esportazioni personalizzate
La struttura tecnica di Vulcano Software è in grado di personalizzare l'esportazione in formati diversi dagli standard.