E’ prevista una configurazione di default per gestire l’importazione di file da Mexal, anagrafica articoli, fornitori, clienti e documenti. Per caricare tale configurazione è necessario aprire il wizard grafico e durante la generazione di una nuova configurazione selezionare come tipologia Mexal.

Inserito un nome univoco alla trasformazione, è possibile aprire cliccando il pulsante “Avanti” la finestra delle impostazioni di Mexal nella quale possono essere impostate le seguenti opzioni:

Gruppo mastro clienti – è un codice di tre caratteri, che viene utilizzato quando un cliente esportato non presenta ancora alcun codice mexal impostato. All’atto dell’utilizzo al codice verrà aggiunto “00000”. Per una importazione rimane disabilitato.

Gruppo mastro fornitori – è un codice di tre caratteri, che viene utilizzato quando un fornitore esportato non presenta ancora alcun codice mexal impostato. All’atto dell’utilizzo al codice verrà aggiunto “00000”. Per una importazione rimane disabilitato.

Tipo centro di produzione – permette di selezionare un tipo di centro di produzione tra quelli previsti dal programma; tale valore verrà utilizzato solo in fase di import, quando si importa una categoria di un articolo e il campo obbligatorio relativo al tipo di centro di produzione non è valorizzato.

Abilita scarico magazzino da comanda – permette di valorizzare il campo “Abilita Magazzino” previsto nella tabella Articoli solo a fronte di importazione, trattando il valore come valore di default.

Sigla azienda – stringa di tre caratteri riportante la sigla dell’azienda di Mexal da gestire.

Listino Mexal – Listino Menu – griglia che permette di associare ad ogni listino gestito da Mexal un listino di quelli gestiti dal programma.

Salva – conferma le impostazione scelte dall’utente e passa alla fase di configurazione successiva, in cui si seleziona la cartella in cui saranno memorizzati i file di Mexal.

Annulla – annulla le impostazioni inserite e si ritorna alla finestra di configurazione wizard avanzata.

Confermate le opzioni impostate si procede a selezionare la cartella nella quale sono memorizzati 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 si accede alla finestra di configurazione di wizard avanzata di tipo testuale. In automatico all’atto della conferma vengono aggiornati tutti i percorsi previsti nelle varie fonti esterne.

Annulla – annulla la modifica applicata sulla cartella inserita, ripristinando la cartella inizialmente prevista e si ritorna alla finestra di configurazione wizard avanzata

La finestra di configurazione wizard avanzata, presenterà una parte dei controlli disabilitati, quali il qualificatore di testo e la sezione di formattazione della data. Rimane possibile selezionare 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 proposti tutte le fonti interne necessarie per importare tutti i dati previsti dai file di Mexal.

La configurazione di default proposta 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 – flag per valutare se l’anagrafica è pubblica o meno. Viene inizializzato con il valore previsto dalla configurazione di Import configurata al momento della generazione del tracciato;
• Sesso – sesso del cliente, inizialmente impostato a “_”;
• E’ attivo – flag 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 dell’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 previsto di Mexal tutti gli alias gestibili, generati da:
• 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: durante la fase di importazione, il file csv Alias.csv verrà cancellato durante la fase di inizializzazione dell’importazione se già presente nella directory di destinazione; con la prima relazione avente per fonte interna Alias verrà generato il file csv interno e popolato con 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.

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;
• Desrizione – descrizione dell’aliquota iva da importare, valorizzata con il valore dell’aliquota iva caricato dall’articolo.
• Articolo per listino (ArticoliListiniPrezzi.csv) – riporta per ogni articolo e per ogni listino gestito tra Mexal e Ristuty 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 specifico listino.

Questa relazione può comparire all’interno del tracciato, una o più volte, tante quanti sono i listini di Mexal che sono stati associati ad uno previsto in Ristuty. Infatti 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 l’utente cambia le impostazioni di Mexal, andando a modificare le associazioni tra i listini di Mexal con quelli di Ristuty, in automatico vengono riallineate le relazioni ArticoloXListino, perdendo eventuali modifiche manuali introdotte dall’utente e presentando quelle di default.

NOTA BENE: durante la fase di importazione, il file csv ArticoliListiniPrezzi.csv verrà cancellato durante la fase di inizializzazione dell’importazione se già presente nella directory di destinazione; con la prima relazione avente per fonte interna Articolo per Listino verrà generato il file csv interno e popolato con 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.

• Categoria articolo (CategorieArticoli.csv) – importa per ogni articolo la categoria associata, rappresentata dal gruppo merceologico allegato all’articolo. I campi valorizzati risultano:
• Nome – gruppo merceologico previsto dall’articolo;
• Tipo centro di produzione – tipo di centro di produzione previsto. Viene impostato come default quello configurato all’interno delle impostazioni di Mexal (vedi sopra).
• Categoria statistica articolo (CategoriaStatisticaArticolo.csv) – importa per ogni articolo la categoria statistica, ottenuta come concatenazione dei due campi relativi alla categoria statistica numerica “_ARSTN” e quella alfanumerica “_ARSTA”. L’unico campo valorizzato risulta:
• Codice – codice della categoria statistica.
• UDM (UnitaDiMisura.csv) – importa le unità di misura, sia primarie che secondarie, previste all’interno dell’anagrafica degli articoli. Infatti 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 quella secondaria (campo Mexal “_ARUM2”). I campi valorizzati sono:
• Nome – nome dell’unità di misura (stringa minuscola);
• Descrizione – descrizione dell’unità di misura.

NOTA BENE: durante la fase di importazione, il file csv UnitaDiMisura.csv verrà cancellato durante la fase di inizializzazione dell’importazione se già presente nella directory di destinazione; con la prima relazione avente per fonte interna Udm verrà generato il file csv interno e popolato con 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: durante la fase di importazione, il file csv ArticoloXFornitore.csv verrà cancellato durante la fase di inizializzazione dell’importazione se già presente nella directory di destinazione; con la prima relazione avente per fonte interna Articolo per fornitore verrà generato il file csv interno e popolato con 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 Ristuty che sono stati associati con uno dei nove potenziali di Mexal. Risulta infatti possibile (come nel caso della relazione su ArticoloXListino) avere nel tracciato una o più relazioni, una per ogni associazione tra i listini Mexal – Ristuty. L’unico campo valorizzato è:
• Nome – nome del listino da importare, valorizzato attraverso il valore di default inizializzato con il nome di un listino Ristuty selezionato.

NOTA BENE: durante la fase di importazione, il file csv Listino.csv verrà cancellato durante la fase di inizializzazione dell’importazione se già presente nella directory di destinazione; con la prima relazione avente per fonte interna Listino verrà generato il file csv interno e popolato con 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) – importa per ogni articolo 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 secondaria e la primaria.
• 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 inizializzato con quello impostato nella configurazione Mexal (vedi sopra);
• 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 – flag per valutare se l’anagrafica risulta pubblica o meno. Viene inizializzato con 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 che le varie categorie articolo che verranno poi importate non vengano scartate per assenza nel database del tipo di centro di produzione. I campi valorizzati sono:
• Nome – nome del tipo centro di produzione da importare;
• Causale di magazzino (Causale.csv) – importa per ogni documento valido per l’Import la causale di magazzino prevista. Sono previste nel tracciato due relazione sulla medesima fonte interna, in quanto esistono due file Mexal per i documenti mote_SiglaAzienda.csv e orte_SiglaAzienda.csv. Pertanto verranno importante da ciascuno tutte le causali distinte. I campi valorizzati risultano gli stessi per entrambi i file Mexal e sono:
• Codice – codice della causale di magazzino, corrispondente alla descrizione presente nei file Mexal.
• Descrizione – descrizione della causale di magazzino.
• Codice mexal – se la descrizione della causale di magazzino è valorizzata, viene importato il codice della causale di magazzino, in caso contrario viene non valorizzato.
• Magazzino (Articolo) (Magazzino.csv) – importa per ogni articolo gestito in un magazzino (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 validi da importare. I campi valorizzati sono:
• Nome – se il codice pagamento è valorizzato allora viene presa la descrizione del tipo di pagamento, altrimenti viene lasciata vuota;
• Categoria – se il codice pagamento è valorizzato allora viene impostato come valore costante “Varie1”, altrimenti viene lasciata vuota;
• Codice mexal – viene valorizzato con il codice pagamento se non nullo, altrimenti viene lasciato vuoto.
• 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 sono validi e quindi importati, 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 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 Menu 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 Menu 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 – flag inizializzato con il valore previsto dalla configurazione di Import configurata 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 Menu 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.