Per gestire l’importazione di file da Mexal è prevista una configurazione di default così da poter importare i dati relativi ad anagrafica articoli, clienti, fornitori, e documenti. Per caricare tale configurazione è necessario aprire il Wizard grafico e nel campo Tipo DTS impostare Mexal.

Inserito un nome univoco per la trasformazione, è possibile aprire la finestra delle impostazioni di Mexal, selezionando il pulsante “Avanti”, così da impostare le seguenti opzioni:

Tipo centro di produzione – questo campo permette di associare un tipo centro di produzione, tra quelli previsti da Passepartout Retail, alle categorie articolo di Mexal. Questa associazione è necessaria poiché il Tipo Centro Produzione in Passepartout Retail risulta essere un campo obbligatorio per la configurazione delle proprie categorie articolo. In mancanza di questa informazione non verranno importate le categorie merceologiche di Mexal.

Abilita scarico magazzino – questa impostazione permette di attivare l’omonima opzione per tutti gli articoli che verranno esportati da Mexal ed importati in Retail. In caso questa opzione non venga impostata lo scarico del magazzino non verrà attivato. In ogni caso tale opzione è sempre modificabile agendo manualmente, in Anagrafica Articolo, nella scheda Magazzino.

Sigla azienda – stringa di tre caratteri riportante la sigla dell’azienda di Mexal da cui sono stati generati i file in formato csv.

Listino Mexal – Listino Retail – griglia che permette di effettuare l’associare tra listini Mexal e listini Retail.

Salva – conferma le impostazioni effettuate e chiudendo la finestra di Configurazione Import Mexal permette di passare alla fase di configurazione successiva, in cui è necessario selezionare la cartella in cui sono contenuti i file provenienti da Mexal.

Annulla – vengono annullate le impostazioni inserite e si ritorna alla finestra di configurazione avanzata Wizard.

Confermate le opzioni impostate si procede a selezionare la cartella che contiene i vari file di Mexal da importare. Tale finestra presenta le seguenti opzioni:

Cartella dei file da gestire – cartella in cui sono memorizzati i vari file di Mexal da importare.

Ok – conferma la cartella specificata e chiude la finestra Caricamento Cartella permettendo di accedere alla finestra di configurazione avanzata Wizard di tipo testuale. Alla conferma vengono automaticamente aggiornati tutti i percorsi previsti nelle varie fonti esterne.

Annulla – permette di annullare la modifica applicata sulla cartella inserita, ripristinando la cartella inizialmente prevista e ritornando alla finestra di configurazione avanzata Wizard.

Come mostrato in figura sotto, la finestra di configurazione avanzata Wizard presenta alcuni controlli disabilitati, quali il qualificatore di testo e la sezione della formattazione per la data. Rimane comunque abilita l’opzione per impostare il separatore di riga e di colonna, in base a quelli gestibili da Mexal.

Cliccando il pulsante “Avanti” si apre la finestra del tracciato delle relazioni, in cui verranno proposte tutte le fonti interne necessarie per importare tutti i dati previsti dai file di Mexal.

La configurazione, proposta di default, per l’importazione verte sulle seguenti informazioni:

• Cliente (Clienti.csv) – importa le anagrafiche dei clienti previsti in Mexal. Perché l’anagrafica caricata sia di un cliente viene applicato un filtro per “Tipo”: se questo campo è valorizzato con “C” allora l’anagrafica in esame riguarda un cliente altrimenti viene scartata e se ne considera la successiva. I campi importati per un cliente sono:
• Ragione Sociale – ragione sociale del cliente;
• Partita iva – partita iva del cliente;
• Codice fiscale – codice fiscale del cliente;
• Tipo anagrafica;
• Nome – nome del cliente;
• Cognome – cognome del cliente;
• Indirizzo – indirizzo del cliente;
• Citta – città di residenza del cliente;
• Cap – cap previsto per il cliente;
• Provincia – provincia;
• Nazione – nazione;
• Telefono – recapito telefonico;
• Fax – numero di fax;
• Email – indirizzo e-mail;
• Data di nascita – data di nascita del cliente;
• Numero CC – numero di conto corrente;
• E’ anagrafica pubblica – opzione per discriminare se l’anagrafica è pubblica o meno. Viene inizializzato con il valore impostato nella configurazione di Import al momento della generazione del tracciato;
• Sesso – sesso del cliente, inizialmente impostato a “_”;
• E’ attivo – opzione per discriminare se l’anagrafica è attiva o meno all’interno del programma;
• Codice mexal – codice mexal previsto per l’anagrafica;
• Nazionalità – nazionalità;
• Confermato – viene impostato per default a vero;
• Selettore – viene impostato per default a “MetaCliente”.
• Luogo di nascita – riferimento al luogo di nascita prevista dall’anagrafica.
• Categoria cliente – riferimento alla categoria cliente (letta dall’attributo categoria statistica).
• Categoria cliente (CategoriaCliente.csv) – importa tutte le categorie cliente che sono state estratte dalle righe del file csv di Mexal rubr_SiglaAzienda.csv relativo alle sole anagrafiche cliente. I campi importati per un cliente sono:
• Nome – nome della categoria valorizzata con il codice della categoria statistica;
• 
  Fornitore (Fornitori.csv) – importa le anagrafiche dei fornitori previsti in Mexal. Perché l’anagrafica caricata sia di un fornitore viene applicato un filtro per “Tipo”: se questo campo è valorizzato con “F” allora l’anagrafica in esame riguarda un fornitore altrimenti viene scartata e se ne considera la successiva. I campi valorizzati sono gli stessi dell’anagrafica clienti eccetto per gli ultimi due, “Confermato” e “Selettore”.
• Alias (Alias.csv) – importa per ogni articolo di Mexal tutti gli alias gestibili, generati con le seguenti regole:
• Concatenando il codice articolo con la descrizione aggiuntiva, se valorizzato;
• Concatenando il codice articolo con il codice articolo del fornitore 1, campo Mexal _ARCOF(1) se valorizzato;
• Concatenando il codice articolo con il codice articolo del fornitore 2, campo Mexal _ARCOF(2) se valorizzato;
• Concatenando il codice articolo con il codice articolo del fornitore 3, campo Mexal _ARCOF(3) se valorizzato;
• Dal file alia_SiglaAzienda.csv.

NOTA BENE: se, durante la fase di inizializzazione dell’importazione, il file Alias.csv è già presente nella cartella di destinazione questo verrà cancellato; con la prima relazione, avente per fonte interna Alias, verrà generato il file csv interno e popolato con l’intestazione e gli opportuni valori importati; le successive relazioni andranno ad aggiungere al file le ulteriori informazioni generate, senza creare un’ulteriore intestazione e senza cancellare i dati precedentemente inseriti.

I campi valorizzati sono:

• Nome – codice dell’articolo;
• Codice – codice alias, generato come sopra descritto;
• Tipo – impostato di default a “Generico”;
• Descrizione (solo per il file alia_SiglaAzienda.csv) – salvato come concatenazione dei tre campi del file Mexal “DESCRIZ”, “NOTE1” e “NOTE2”;
• Aliquota iva (AliquotaIVA.csv) – importa tutte le aliquote iva applicate sui vari articoli da importare da Mexal. I campi valorizzati sono:
• Nome – codice dell’aliquota iva da importare, valorizzata con il valore dell’aliquota iva caricato dall’articolo;
• Percentuale – percentuale da importare, valorizzata con il valore dell’aliquota iva caricato dall’articolo;
• Descrizione – descrizione dell’aliquota iva da importare, valorizzata con il valore dell’aliquota iva caricato dall’articolo.
• Articolo per listino (ArticoliListiniPrezzi.csv) – per ogni articolo e per ogni listino gestito tra Mexal e Retail riporta il prezzo stimato. I campi valorizzati sono:
• Articolo – codice dell’articolo;
• Listino – nome del listino a cui si fa riferimento per il prezzo;
• Prezzo – prezzo previsto per l’articolo in quel listino specifico;

Questa relazione può comparire all’interno del tracciato, tante volte quante sono le associazioni tra i Listini Mexal ed i Listini Retail impostate nella finestra Configurazione Import Mexal. Ciascuna relazione di questo tipo presenta due diversità: il nome del listino a cui fa riferimento, che viene impostato in automatico all’atto della creazione del tracciato e memorizzato nel valore di default del campo “Listino”; il campo “Prezzo” che viene valorizzato con uno dei campi “_ARPRZ(x)”, dove la x cambierà in funzione del listino Mexal correlato.

NOTA BENE: ogni volta che vengono modificate le associazioni tra i listini di Mexal e quelli di Retail, in automatico vengono riallineate le relazioni ArticoloXListino, perdendo eventuali modifiche manuali introdotte dall’utente e presentando quelle predefinite.

NOTA BENE: se, durante la fase di inizializzazione dell’importazione, il file ArticoliListiniPrezzi.csv è già presente nella cartella di destinazione questo verrà cancellato; con la prima relazione avente per fonte interna Articolo per Listino verrà generato il file csv interno e popolato con la relativa intestazione e gli opportuni valori importati; ; le successive relazioni andranno ad aggiungere al file le ulteriori informazioni generate, senza creare un’ulteriore intestazione e senza cancellare i dati precedentemente inseriti.

• Categoria articolo (CategorieArticoli.csv) – per ogni articolo importa la categoria associata, rappresentata dal gruppo merceologico allegato all’articolo. I campi valorizzati sono:
• Nome – gruppo merceologico previsto dall’articolo.
• Tipo centro di produzione – tipo di centro di produzione previsto. Viene impostato come predefinito quello configurato all’interno della finestra Configurazione Import Mexal.
• Categoria statistica articolo (CategoriaStatisticaArticolo.csv) – per ogni articolo importa la categoria statistica, ottenuta come concatenazione dei due campi relativi alla categoria statistica numerica “_ARSTN” e quella alfanumerica “_ARSTA”. L’unico campo valorizzato risulta essere:
• Codice – codice della categoria statistica.
• 
  UDM (UnitaDiMisura.csv) – importa le unità di misura, primarie e secondarie, previste all’interno dell’anagrafica degli articoli. Sono previste due relazioni per gestire le unità di misura: la prima importa i riferimenti alle varie unità di misura primarie (campo Mexal “_ARUM1”) mentre la seconda importa i riferimenti alle varie unità di misura secondarie (campo Mexal “_ARUM2”).

I campi valorizzati sono:

• Nome – nome dell’unità di misura (stringa minuscola).
• Descrizione – descrizione dell’unità di misura.

NOTA BENE: se, durante la fase di inizializzazione dell’importazione, il file UnitaDiMisura.csv è già presente nella cartella di destinazione questo verrà cancellato; con la prima relazione avente per fonte interna Udm verrà generato il file csv interno popolato con la relativa intestazione e gli opportuni valori importati; le successive relazioni andranno ad aggiungere al file le ulteriori informazioni generate, senza creare alcun altra intestazione e senza cancellare i dati precedentemente inseriti.

• Articolo per fornitore (ArticoloXFornitore.csv) – importa per ogni articolo la modalità di approvvigionamento relativa ad ogni fornitore a cui è associato. I campi valorizzati sono:
• Articolo – codice dell’articolo;
• Fornitore – anagrafica minima del fornitori di riferimento, basata su ragione sociale, codice fiscale e partita iva;
• Lotto di riordino – lotto di riordino previsto per l’articolo;
• Giorni di riordino – giorni di riordino necessari previsti per l’articolo;
• Prezzo – prezzo di acquisto previsto per l’approvvigionamento dell’articolo.

Nel tracciato sono previste tre relazioni sulla stessa medesima fonte interna Articolo per fornitore, ciascuna che gestisce un singolo fornitore dei tre previsti da Mexal. Qualora uno dei tre non sia valorizzato, la relazione associata risulterà inattiva, in quanto non è in grado di creare una riga ammissibile da salvare per la mancanza della ragione sociale del fornitore che risulta obbligatoria.

NOTA BENE: se, durante la fase di inizializzazione dell’importazione, il file ArticoloXFornitore.csv è già presente nella cartella di destinazione questo verrà cancellato; con la prima relazione avente per fonte interna Articolo per fornitore verrà generato il file csv interno e popolato con la relativa intestazione e gli opportuni valori importati; le successive relazioni andranno ad aggiungere al file le ulteriori informazioni generate, senza creare alcun altra intestazione e senza cancellare i dati precedentemente inseriti.

• Listino (Listini.csv) – importa tutti i listini di Mexal associati ad un listino di Passepartout Retail tramite le impostazioni della finestra Configurazione import Mexal. Come nel caso della relazione su ArticoloXListino, nel tracciato del listino vengono impostate tante relazioni quante sono le associazione codificate tra i listini di Mexal e quelli di Retail. L’unico campo valorizzato è:
• Nome – nome del listino da importare, valorizzato attraverso il valore di default inizializzato con il nome di un listino Retail selezionato.

NOTA BENE: se, durante la fase di inizializzazione dell’importazione, il file Listini.csv è già presente nella cartella di destinazione questo verrà cancellato; con la prima relazione avente per fonte interna Listino verrà generato il file csv interno e popolato con la relativa intestazione e gli opportuni valori importati; le successive relazioni andranno ad aggiungere al file le ulteriori informazioni generate, senza creare alcun altra intestazione e senza cancellare i dati precedentemente inseriti.

• Udm per articolo (UDMXArticolo.csv) – per ogni articolo importa l’unità di misura secondaria e il corrispondente fattore di conversione. I campi valorizzati sono:
• Articolo – codice dell’articolo;
• Udm –unità di misura secondaria da importare;
• Fattore di conversione – fattore di conversione previsto tra l’unità di misura primaria e la secondaria e.
• Articolo (Articolo.csv) – importa le anagrafiche degli articoli. Tutti gli articoli ammessi per l’importazione sono di tipo ”A”; nel caso in cui il tipo fosse diverso da “A” l’anagrafica verrebbe scartata e si passerebbe alla successiva. I campi valorizzati sono:
• Nome – codice dell’articolo;
• Descrizione – descrizione dell’articolo;
• Tipo articolo – valore costante impostato a “Semplice”;
• Abilita magazzino – abilita o meno la gestione del magazzino. Viene valorizzato attraverso il valore di default impostato nella finestra Configurazione Import Mexal;
• Categoria articolo – gruppo merceologico previsto per l’articolo;
• Aliquota iva – aliquota iva prevista per l’articolo;
• Udm primario – nome dell’unità di misura primaria prevista per l’articolo;
• E’ anagrafica pubblica – opzione per discriminare se l’anagrafica risulta pubblica o meno. Viene impostato il valore previsto dalla configurazione di Import configurata al momento della generazione del tracciato;
• Categoria statistica – categoria statistica dell’articolo, ottenuta concatenando le due categorie statistiche previste in Mexal: quella alfanumerica (“_ARSTA”) e quella numerica (“_ARSTN”) se valorizzate;
• Contropartita costo – valore relativo alla contropartita Costo;
• Contropartita ricavo – valore relativo alla contropartita Ricavo;
• Descrizione secondaria – descrizione secondaria aggiuntiva dell’articolo.
• Selettore – impostato per default a “MetaElemento”.
• Tipo centro di produzione (TipoCentroProduzione.csv) – importa il tipo di centro di produzione. Risulta infatti necessario importare tale informazione, che riguarda una ed una sola riga, per permettere poi l’importazione delle categorie articolo, in mancanza di questo dato nel database vengono scartate. I campi valorizzati sono:
• Nome – nome del tipo centro di produzione da importare;
• Causale di magazzino (Causale.csv) – per ogni documento valido importa la causale di magazzino prevista. Nel tracciato sono previste due relazione sulla medesima fonte interna, in quanto esistono due file Mexal per i documenti: mote_SiglaAzienda.csv per importare le causali relative ai movimenti di magazzino generati a fronte dei documenti di tipo IN, BD, RC, RF, CL, SL, BC, BF, DL, BS, NC, RI, CO, FC e FT, orte_SiglaAzienda.csv per importare le causali dei documenti relativi ai documenti di magazzino di tipo Ordine e Preventivi quindi di tipo OC, OF, PR e PF. Pertanto da ciascun file verranno importante tutte le causali distinte. I campi valorizzati risultano gli stessi per entrambi i file Mexal e sono:
• Codice, Descrizione – in Retail rappresentano rispettivamente il codice e la descrizione della causale di magazzino e vengono valorizzati con la descrizione della causale presente in Mexal;
• Codice Mexal – codice Mexal della causale di magazzino che si vuole importare.
• Magazzino (Articolo) (Magazzino.csv) – per ogni articolo gestito in un magazzino viene importato dal file Mexal anpr_SiglaAzienda.csv il nome del magazzino previsto. L’unico campo valorizzato è:
• Nome – nome del magazzino previsto in Mexal.
• Magazzini (Documenti) (Magazzini.csv) – viene generato allo stesso modo del precedente (Magazzino).
• Tipo pagamento (TipoPagamento.csv) – importa le varie tipologie di pagamento gestite in Mexal e reperibili nelle varie intestazioni dei documenti da importare. I campi valorizzati sono:
• Nome – Viene importata la descrizione configurata in Mexal per il tipo di pagamento;
• Categoria –viene impostato come valore costante = “Varie1”;
• Codice Mexal – viene valorizzato con il codice Mexal del relativo pagamento:
• Documento (DocumentiTestate.csv) – importa le varie intestazioni dei documenti. I campi valorizzati risultano i seguenti:
• Tipo – tipo di documento gestito;
• Serie – numero di serie del documento;
• Numero – numero del documento;
• Data – data di registrazione del documento;
• Causale – causale di magazzino del documento;
• Abbuono – importo di abbuono previsto dal documento;
• Pagato – importo pagato previsto dal documento;
• Note (solo per orte_SiglaAzienda.csv) – campo informativo aggiuntivo relativo al documento;
• Tipo pagamento – tipo di pagamento avvenuto;
• Cliente – anagrafica ridotta del cliente, se il documento lo prevede, basato su ragione sociale, partita iva e codice fiscale;
• Fornitore – anagrafica ridotta del fornitore, se il documento lo prevede, basato su ragione sociale, partita iva e codice fiscale;
• Trasporto – tipologia di trasporto applicato;
• Vettore – vettore previsto nel documento;
• Porto – tipologia di porto applicato al documento: franco (F), addebito (D) e assegnato (A);
• Descrizione del porto – descrizione del porto applicato;
• Colli – totale colli del documento;
• Peso merce – peso totale della merce prevista dal documento;
• Data inizio trasporto – data di inizio del trasporto della merce.
• Spese di trasporto – spese di trasporto configurate in Mexal per il documento.
• Aliquota iva spese di trasporto – aliquota iva applicata alle spese di trasporto.
• Spese banca – spese banca previste per il documento.
• Spese bolli – spese bolli previste per il documento.
• Aliquota iva spese bolli – aliquota iva applicata alle spese bolli.

NOTA BENE: durante la fase di importazione i documenti ritenuti validi dal programma risultano i seguenti: dal file degli ordini e preventivi, orte_SiglaAzienda.csv, tutti i documenti di tipo OC, OF, PR e PF, mentre per i movimenti di magazzino, mote_SiglaAzienda.csv, tutti quelli di tipo IN, BD, RC, RF, CL, SL, BC, BF, DL, BS, NC, RI, CO, FC e FT.

• Righe documento (DocumentiRighe.csv) – importa tutte le righe dei documenti presenti nei file mori_SiglaAzienda.csv e orri_SiglaAzienda.csv validi importati. I campi valorizzati sono:
• Tipo documento – tipo di documento di appartenenza;
• Serie – numero di serie del documento;
• Numero – numero di registrazione del documento;
• Data (solo per mori_SiglaAzienda.csv) – data di registrazione del documento;
• Cliente – anagrafica ridotta del cliente, se il documento lo prevede, basato su ragione sociale, partita iva e codice fiscale;
• Fornitore – anagrafica ridotta del fornitore, se il documento lo prevede, basato su ragione sociale, partita iva e codice fiscale;
• Codice articolo – codice dell’articolo previsto dalla riga;
• Quantità – quantità gestita;
• Unità di misura – unità di misura considerata;
• Prezzo unitario – prezzo unitario dell’articolo;
• Aliquota iva – aliquota iva applicata;
• Magazzino di partenza (solo per mori_SiglaAzienda.csv) – nome del magazzino di partenza;
• Magazzino di destinazione – nome del magazzino di destinazione;
• Stato (solo per orri_SiglaAzienda.csv) – stato della riga dell’ordine: annullato (N), bloccato (B), evadibile o sospeso;
• Descrizione sconto di riga – descrizione dello sconto applicato alla riga;

La procedura di importazione dati da Mexal prevede di prendere il valore di sconto e di formattarlo in maniera che Passepartout Retail sia in grado di leggerlo e inserirlo nella riga. I valori gestiti da Mexal di sconto di riga sono minori di 100% che verranno importati tali e quali, sconti concatenati (es. 10+20), lo sconto del 100,00% che in Mexal è codificato con “SC.MERCE” viene tradotto con 100 e poi importato; analoga procedura per lo sconto del 110 definito “ABBUONO” e 120 “ABBUONO.”. I restanti valori superiori a 100 gestiti da Mexal al momento non sono gestiti da Passepartout Retail seppure opportunamente codificati.

ATTENZIONE: per permettere una corretta conversione e importazione dei valori di sconto, si assume che in Mexal gli sconti presenti la stessa dicitura sopra citata (es. SC.MERCE). E’ pertanto utile verificare prima di avviare una importazione controllare le impostazioni previste in “Magazzino – Tabelle aziendali – Descrizione tabelle – Omaggi/abbuonio/garanzie”.

• E’ anagrafica pubblica – opzione impostata con il valore previsto dalle impostazioni di configurazione di Import al momento della generazione del tracciato.
• Magazzino – nome del magazzino di riferimento, valorizzato se il documento in oggetto è un MC, MS, RS, RF o IN.
• Codice articolo riga (informativo) – riportante il codice dell’articolo configurato all’interno della riga: se la riga è informativa (tipo riga Nota), allora conterrà la stringa descrittiva, preceduta o dal punto o dalla virgola, lasciando non valorizzato il suddetto attributo “Codice articolo”.
• Tipo di riga – definisce il tipo di riga configurata: Standard se riguarda un articolo configurato in Passepartout Retail e per il quale è stata impostata quantità, prezzo e le altre suddette informazioni correlate; Nota se invece la riga è solo informativa, contente solo una stringa descrittiva (tale stringa sarà preceduta da un punto o da una virgola).
• Percentuale su padre (PercentualeSuPadre.csv) – relazione introdotta col solo scopo di generare il file csv interno senza popolarlo di alcun valore (esigenza obbligatoria nel contesto del Master, opzionale altrimenti).
• 
  Progressivi articoli (ProgressivoArticolo.csv) – relazione introdotta per l’importazione dei progressivi di magazzino delle anagrafiche articoli per i vari magazzini configurati. I campi valorizzati sono:
• Articolo – codice dell’articolo;
• Magazzino – magazzino su cui aggiornare i progressivi di magazzino;
• Da – inizio periodo della movimentazione;
• A – fine periodo della movimentazione;
• Inventario articolo per magazzino (quantità) – riportante la quantità di inventario dell’articolo;
• Inventario valore articolo per magazzino (valore) – riportante il valore di inventario;
• Carico articolo per magazzino (quantità) – riportante la quantità di carico dell’articolo;
• Carico valore articolo per magazzino (valore) – riportante il valore di carico;
• Scarico articolo per magazzino (quantità) – riportante la quantità di scarico dell’articolo;
• Scarico valore articolo per magazzino (valore) – riportante il valore di scarico;
• Data movimento carico – data di ultima movimentazione di carico;
• Data movimento scarico – data di ultima movimentazione di scarico;
• Ordinato fornitore articolo per magazzino – quantità dell’ordinato fornitore.