# Manuale Utente

# Aggiornamenti

Aggiornato il **22/12/2025**

Versioni di riferimento:

<div align="left" dir="ltr" id="bkmrk-connettore-vte-mexal"><table border="1" style="width: 34.1667%; border-collapse: collapse;"><colgroup><col style="width: 69.9685%;" width="198"></col><col width="85"></col></colgroup><tbody><tr><td>Connettore VTE-Mexal

</td><td>2.14.0

</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Integrazione lato Mexal

</td><td style="height: 29.7969px;">1.7.1

</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Integrazione lato VTE

</td><td style="height: 29.7969px;">1.4.13

</td></tr></tbody></table>

</div><p class="callout info">Per istruzioni sulla configurazione, si veda il [manuale tecnico](https://docs.google.com/document/d/1Zb1OEkkSA1-J6TAe16kJMJDBsgSrGOVezN9tJG7y5h8).</p>

# Concetti di base

Il connettore VTE-Mexal facilita lo scambio bidirezionale di dati tra il sistema di gestione delle relazioni con i clienti (CRM) VTE e il software gestionale Mexal. Grazie a questo strumento, le informazioni possono essere trasferite in modo efficiente dal CRM VTE a Mexal e viceversa, assicurando una perfetta integrazione tra le due piattaforme. Il connettore permette di sincronizzare i dati in tempo reale, migliorando la gestione delle attività aziendali e la comunicazione interna. Inoltre, semplifica l'automazione dei processi aziendali e riduce gli errori manuali, garantendo una maggiore precisione nelle operazioni quotidiane. Questo porta a una gestione più fluida e ottimizzata delle risorse aziendali, migliorando la produttività complessiva.

# Requisiti

In questa lista sono riportati solo alcuni dei requisiti del connettore VTE-Mexal, quelli di interesse più generale. Per la lista completa e dettagliata dei requisiti si veda la sezione dedicata del manuale tecnico.  
● **Generali**  
\- Il servizio principale del connettore deve essere installato su un sistema Windows, da qui in poi chiamato host del connettore; questo significa che se Mexal è live (in cloud presso Passepartout) è comunque necessario disporre di un computer Windows (preferibilmente un serve) dove installare il connettore  
● **VTE**  
\- Per configurare l’integrazione lato VTE è necessario poter accedere al server di VTE; se VTE è in cloud presso VTENEXT questo può essere fatto tramite i tecnici di VTENEXT stessa  
\- Se su VTE sono attive le Business Unit devono essere configurate come indicato nell’appendice apposito  
● **Mexal**  
\- La licenza deve includere MDS  
\- Se sull’host del connettore non ci sono già altri servizi che accedono a Mexal via Shaker allora il connettore avrà bisogno di uno “slot” di licenza del livello di gestione dell’utente utilizzato per accedere a Mexal (è sufficiente il livello Solution)  
\- Potrebbe non essere possibile utilizzare il connettore VTE-Mexal se la versione di Mexal è molto datata: si consiglia aggiornare Mexal almeno una volta ogni pochi mesi  
\- Per poter visualizzare le scadenze degli incassi in VTE, in Mexal deve essere attivo lo scadenzario a partite

# Trasferimento dati

Visti i diversi ambiti e finalità delle due applicazioni, la direzione e le modalità di trasferimento varia a seconda dell’elemento.

<p class="callout info">*Per il dettaglio dei campi trasferiti per ciascun modulo e archivio si veda l’<span style="text-decoration: underline;">[appendice](https://docs.google.com/document/d/1fxAB5Bp1Wv3y17h3MsH7bSSTeH5vsIhp/edit#heading=h.2jxsxqh)</span>.*</p>

# Da VTE a Mexal

Segue un elenco dei moduli di VTE per i quali è gestito il trasferimento in Mexal, con informazioni dettagliate sulle modalità del trasferimento.

<div align="left" dir="ltr" id="bkmrk-modulo-in-vte-archiv"><table><colgroup><col width="120"></col><col width="249"></col><col width="617"></col></colgroup><thead><tr><th scope="col">*Modulo in VTE*

</th><th scope="col">*Archivio corrisp. in Mexal*

</th><th scope="col">*Modalità di trasferimento*

</th></tr></thead><tbody><tr><td>Ordini di vendita

</td><td>Documenti di magazzino di tipo OC

</td><td>L’ordine di vendita viene trasferito in Mexal su esplicita richiesta dell’utente. Ogni ordine di vendita può essere trasferito in Mexal una sola volta.

</td></tr><tr><td>Ordine di acquisto

</td><td>Documenti di magazzino di tipo OF

</td><td>L’ordine di acquisto viene trasferito in Mexal su esplicita richiesta dell’utente. Ogni ordine di acquisto può essere trasferito in Mexal una sola volta.

</td></tr><tr><td>Preventivo

</td><td>Documento di magazzino di tipo PC/PR

</td><td>Il preventivo viene trasferito in Mexal su esplicita richiesta dell’utente. Ogni preventivo può essere trasferito in Mexal una sola volta.

</td></tr><tr><td>Aziende

</td><td>Piano dei conti (clienti)

</td><td>Si può scegliere tra due modalità:

1. L’azienda viene trasferita in Mexal all’inserimento e aggiornata ad ogni modifica
2. L’azienda viene trasferita in Mexal su esplicita richiesta dell’utente, dopodiché viene aggiornata ad ogni modifica.

Durante l’aggiornamento eventuali valori vuoti non sostituiscono i valori presenti in Mexal.

</td></tr><tr><td>Fornitori

</td><td>Piano dei conti (fornitori)

</td><td>Il trasferimento di un fornitore in Mexal avviene solo all’interno del trasferimento di un ordine di acquisto ad esso intestato.

Durante l’aggiornamento eventuali valori vuoti non sostituiscono i valori presenti in Mexal.

</td></tr><tr><td>Contatti

</td><td>Referenti

</td><td>Se l’azienda è presente in Mexal i contatti con una posizione vengono trasferiti automaticamente all’inserimento e aggiornati ad ogni modifica.

Durante l’aggiornamento eventuali valori vuoti non sostituiscono i valori presenti in Mexal.

</td></tr><tr><td>Prodotti

</td><td>Articoli

</td><td>Il trasferimento di un prodotto in Mexal avviene solo all’interno del trasferimento di un ordine di vendita o di acquisto che lo contiene, se il prodotto non esiste in Mexal come articolo.

</td></tr><tr><td>Servizi

</td><td>Articoli

</td><td>Il trasferimento di un servizio in Mexal avviene solo all’interno del trasferimento di un ordine di vendita o di acquisto che lo contiene, se il servizio non esiste in Mexal come articolo.

</td></tr></tbody></table>

</div>All’eliminazione di un record in VTE l’elemento corrispondente in Mexal non viene mai eliminato automaticamente.

# Da Mexal a VTE

Segue un elenco degli archivi di Mexal per i quali è gestito il trasferimento in VTE, con informazioni dettagliate sulle modalità del trasferimento.

<div align="left" dir="ltr" id="bkmrk-archivio-di-mexal-mo"><table><colgroup><col width="228"></col><col width="248"></col><col width="406"></col><col width="125"></col></colgroup><thead><tr><th scope="col">*Archivio di Mexal*

</th><th scope="col">*Modulo corrisp. in VTE*

</th><th scope="col">*Modalità di trasferimento*

</th><th scope="col">*Eliminazione*

</th></tr></thead><tbody><tr><td>Piano dei conti (clienti)

</td><td>Aziende

</td><td rowspan="2">Il conto viene trasferito in VTE all’inserimento e aggiornato a ogni modifica. Se il conto è annullato nessun dato viene trasferito in VTE. Alcuni dati inoltre vengono aggiornati periodicamente.

</td><td rowspan="9">No <span style="color: rgb(197, 29, 52);">\[A\]</span>

</td></tr><tr><td>Piano dei conti (fornitori)

</td><td>Fornitori

</td></tr><tr><td>Referenti

</td><td>Contatti

</td><td>Il referente viene trasferito in VTE all’inserimento e aggiornato a ogni modifica.

</td></tr><tr><td>Articoli

</td><td>Prodotti / Servizi

</td><td>Si può scegliere tra due modalità:

1. Tutti gli articoli diventano prodotti
2. Gli articoli di tipo Merce diventano prodotti, gli altri diventano servizi

In entrambi i casi l’articolo viene trasferito in VTE all’inserimento e aggiornato a ogni modifica. I dati vengono trasferiti in VTE anche se l’articolo è stato cancellato.

</td></tr><tr><td>Indirizzi di spedizione

</td><td>Indirizzi di spedizione

</td><td>L’indirizzo di spedizione viene trasferito in VTE all’inserimento e aggiornato a ogni modifica.

</td></tr><tr><td>Documenti di magazzino di tipo OC

</td><td>Ordini di vendita

</td><td rowspan="3">Il documento viene trasferito in VTE all’inserimento e aggiornato a ogni modifica.

</td></tr><tr><td>Documenti di magazzino di tipo OF

</td><td>Ordini di acquisto

</td></tr><tr><td>Documenti di magazzino di tipo FT/NC

</td><td>Fatture di vendita

</td></tr><tr><td>Documenti di magazzino di tipo PC/PR (solo se intestati)

</td><td>Preventivi

</td><td>Il documento viene trasferito in VTE all’inserimento.

</td></tr><tr><td>Pagamenti

</td><td>Pagamenti

</td><td rowspan="10">I dati dell’intero modulo vengono aggiornati periodicamente nell’operazione definita “allineamento dati”.

</td><td rowspan="9">Sì <span style="color: rgb(3, 192, 60);">\[B\]</span>

</td></tr><tr><td>Categorie statistiche clienti/fornitori

</td><td>Categorie statistiche aziende/fornitori

</td></tr><tr><td>Categorie statistiche articoli

</td><td>Categorie statistiche prodotti/servizi

</td></tr><tr><td>Nature

</td><td>Nature prodotti/servizi

</td></tr><tr><td>Scadenzario

</td><td>Scadenze incassi

</td></tr><tr><td>Magazzini

</td><td>Magazzini

</td></tr><tr><td>Causali di magazzino

</td><td>Causali di magazzino

</td></tr><tr><td>Condizioni agenti

</td><td>Condizioni agenti

</td></tr><tr><td>Aree\*

</td><td>Aree CDG

</td></tr><tr><td>Commesse\*

</td><td>Commesse CDG

</td><td>  
</td></tr></tbody></table>

</div><span style="color: rgb(197, 29, 52);">\[A\] </span>All’eliminazione in Mexal di elementi di questo tipo il record corrispondente in VTE non viene mai eliminato.

<span style="color: rgb(3, 192, 60);">\[B\]</span> All’eliminazione in Mexal di elementi di questo tipo il record corrispondente in VTE viene eliminato, durante l’allineamento periodico dei dati.

\*Note relative alla Contabilità Analitica/Gestione commesse/Controllo di Gestione (CDG) Mexal:

\- Se in Mexal è installato il modulo opzionale Controllo di Gestione (CDG), vengono trasferite da Mexal a VTE anche le tabelle Aree e Commesse, limitatamente ai dati anagrafici di base (Codice e Descrizione elemento in Mexal)

\- Tutte le elaborazioni CDG vengono svolte in Mexal, se il modulo è attivo, si attiva la possibilità di inserire i riferimenti CDG (Area e Commessa) nei documenti creati in VTE (Preventivi e Ordini) che verranno poi trasferiti a Mexal