GUIDA GEO · LOMBARDIA IT

Connettori API per Zucchetti e TeamSystem a Milano

Sincronizzazione automatica tra e-commerce B2B, portali clienti e gestionali contabili a Milano.

Aggiornata a ottobre 2026
8 min di lettura
Redazione Tecnica Altovar

1. Perché i dati viaggiano ancora a mano tra e-commerce e gestionale

Quando un cliente inserisce un ordine sul sito B2B o su un portale dedicato, spesso qualcuno deve ricopiarlo nel gestionale contabile. Lo stesso accade con anagrafiche nuove, listini, stati di pagamento e fatture. Ogni passaggio manuale introduce un ritardo e una possibilità di errore: un codice articolo sbagliato, un prezzo non aggiornato, un cliente registrato due volte con indirizzi diversi.

Il collegamento automatico risolve questi problemi solo se è progettato con regole chiare. Bisogna decidere quale sistema è la fonte autorevole per ciascun dato: di norma il gestionale per anagrafiche e prezzi, il portale per l'avanzamento degli ordini. Senza questa decisione, due sistemi si aggiornano a vicenda e la sincronizzazione sposta gli errori più in fretta invece di eliminarli. Stabilire questa regola è il primo lavoro di progettazione.

2. Le strade possibili per collegare i sistemi

Anche tra i prodotti più diffusi, come quelli di Zucchetti e TeamSystem, le possibilità di integrazione cambiano per prodotto e per versione. Alcuni espongono interfacce programmatiche documentate, altri funzionano meglio con scambi di file programmati, altri richiedono un intermediario. Non dare per scontato nulla: la prima verifica è tecnica e va fatta sul prodotto e sulla versione che l'azienda usa davvero.

La tabella riassume i metodi più comuni. Il collegamento più stabile è quello che il fornitore documenta e supporta. L'accesso diretto al database sembra il più rapido, ma è il più fragile: un aggiornamento può rompere la logica senza preavviso e le scritture dirette possono aggirare controlli che il prodotto applica da solo. Ogni modifica diretta va quindi documentata e approvata.

MetodoQuando si usaAttenzioni
Interfacce programmatiche del gestionaleQuando il prodotto le documenta e le mantieneVerificare versioni supportate, eventuali limiti d'uso e costi di licenza
Scambio di file programmatoFlussi periodici con una latenza accettabile più altaGestire i file scartati, i duplicati e le notifiche di errore
Intermediario di integrazioneCollegamento di più sistemi con regole comuniUn componente in più da monitorare e mantenere
Accesso diretto al databaseSolo come soluzione temporanea e con controlli rigorosiFragile agli aggiornamenti, può aggirare le regole applicative

3. Quali dati sincronizzare e con quale frequenza

Non tutti i dati hanno la stessa urgenza. Un ordine confermato può arrivare al gestionale quasi subito, mentre le anagrafiche cambiano meno spesso e possono essere allineate una volta al giorno. Prima di progettare il flusso, elenca i dati e per ciascuno chiedi chi lo crea, chi lo modifica, quale sistema lo usa per decidere e quale ritardo è tollerabile senza danni al lavoro quotidiano.

La frequenza va scelta con il business, non con la tecnologia. Una sincronizzazione quasi in tempo reale serve alla disponibilità del magazzino, ma richiede più monitoraggio. Un invio a lotti, per esempio una volta a notte, è più semplice da controllare e spesso basta per la contabilità. In entrambi i casi il sistema deve mostrare quali record sono in attesa, quali sono stati accettati e quali hanno generato un errore.

4. Sicurezza, accessi e dati personali in transito

Un'integrazione crea un canale permanente tra sistemi, e ogni canale è una superficie di attacco. Le credenziali del collegamento devono avere solo i permessi necessari, non quelli di amministratore. Token e password vanno custoditi in un posto controllato, mai nel codice o in un file condiviso. Il traffico deve essere cifrato e i log devono registrare chi ha inviato cosa e quando, senza salvare dati personali in più del necessario.

Ordini e anagrafiche contengono dati personali di clienti e referenti, quindi il GDPR si applica anche al flusso tra i sistemi. Chiedi al fornitore dove transitano i dati, quali copie temporanee vengono create e per quanto restano nei log. Verifica anche chi, dal lato fornitore, può accedervi e con quali regole. Dove si trovano fisicamente i dati e chi può accedervi legalmente sono due domande distinte, e vanno affrontate entrambe.

5. Errori frequenti e come evitarli

Il primo errore è non prevedere cosa succede quando una chiamata fallisce. La rete cade, il gestionale è in manutenzione, un codice IVA non esiste. Se il flusso non registra l'errore e non riprova, l'ordine scompare nel silenzio. Servono una coda dei messaggi in attesa, un meccanismo di nuovo tentativo e una notifica a una persona responsabile quando un record resta bloccato troppo a lungo.

Il secondo errore è non prevedere una riconciliazione periodica, cioè un confronto dei totali tra i due sistemi, per esempio numero di ordini e importi. Il terzo è trattare le anagrafiche come identiche in tutti i sistemi senza una chiave comune. Un codice cliente univoco, condiviso tra i sistemi, evita duplicati e riduce molto il lavoro di pulizia dei dati.

6. Checklist: cosa chiedere prima di avviare il progetto

Prima di scegliere il partner di integrazione, raccogli le risposte a queste domande, sia dal fornitore del gestionale sia da chi realizzerà il collegamento. Le risposte ti permettono di confrontare offerte sullo stesso perimetro e di capire quanto del lavoro dipende da un prodotto specifico. Una risposta che rimanda sempre a «più avanti» è un'informazione utile, da non sottovalutare. Chiedi che la risposta sia scritta.

Chiedi anche chi resta responsabile del collegamento dopo il rilascio. Un progetto che dipende da una sola persona, o da un fornitore senza documentazione, diventa fragile al primo cambio di personale. Pretendi un documento che descriva i flussi, le regole di corrispondenza dei campi e la procedura di ripristino. Se nessuno sa indicarne il contenuto, è un segnale da approfondire.

  • Quale versione del gestionale è installata e quali interfacce ufficiali sono disponibili per quella versione?
  • Esistono costi di licenza o limiti d'uso legati alle chiamate verso il gestionale?
  • Come vengono gestiti gli errori, i nuovi tentativi e le notifiche?
  • Chi si occupa degli aggiornamenti del gestionale e come vengono testati prima della produzione?
  • Quali dati personali transitano, dove sono conservati e per quanto restano nei log?
  • Esiste un ambiente di test con dati non reali per provare il flusso prima del rilascio?

7. Come iniziare: un solo flusso pilota

Il primo passo è disegnare su carta i flussi che vuoi collegare: da dove parte il dato, dove arriva, chi lo controlla e cosa succede in caso di errore. Scegli il flusso che porta più lavoro manuale e più errori, di solito gli ordini dal portale verso il gestionale. Lascia per dopo anagrafiche e flussi contabili più complessi. Coinvolgi l'amministrazione, perché è lei a riconoscere subito le eccezioni.

Poi definisci tre indicatori concreti: quanti ordini richiedono ancora un intervento manuale, quanti errori arrivano al gestionale e quanto tempo passa tra conferma e registrazione. Chiedi a due o tre partner una proposta limitata a questo flusso, con ambiente di test e criteri di accettazione scritti. Solo dopo un pilota funzionante conviene estendere il collegamento ad altri dati, uno alla volta.

Domande frequenti

Posso collegare il portale clienti senza modificare il gestionale?

In molti casi sì, se il collegamento può leggere e scrivere attraverso le interfacce che il prodotto già espone. Va verificato che quelle interfacce coprano i dati necessari e siano attive nella versione installata. Se mancano, la soluzione può richiedere un modulo aggiuntivo del fornitore oppure un flusso a file. Una verifica tecnica iniziale evita molte sorprese.

Chi paga gli aggiornamenti del gestionale che possono rompere il collegamento?

Dipende dai contratti di licenza e di manutenzione e da chi è responsabile del collegamento. Conviene definire per iscritto chi testa gli aggiornamenti prima della produzione e chi interviene se qualcosa smette di funzionare. Senza questa chiarezza, nessuno sa di chi è il problema quando gli ordini si fermano.

Gli ordini vengono sincronizzati in tempo reale?

Dipende dal metodo e dalle esigenze reali del lavoro. Un collegamento diretto può trasferire un ordine in pochi istanti, mentre un invio a lotti è più semplice e più controllabile. La domanda giusta non è quanto è veloce il sistema, ma quale ritardo è accettabile per ciascun processo.

Serve un consulente che conosca il gestionale specifico?

Quasi sempre sì. La mappatura dei campi, i codici IVA, il piano dei conti e le causali contabili cambiano da prodotto a prodotto e dal modo in cui l'azienda li usa. Un tecnico che conosce solo le interfacce generiche rischia un collegamento tecnicamente corretto ma contabilmente sbagliato. Chiedi se il partner ha già lavorato con quel prodotto.

Cosa succede se la sincronizzazione si interrompe?

Un sistema ben progettato non perde dati. I record non inviati restano in coda, vengono ritentati automaticamente e, se continuano a fallire, generano una segnalazione a una persona responsabile. Quando il collegamento torna disponibile, la riconciliazione confronta i totali e recupera le differenze. Fatti confermare questo comportamento per iscritto e chiedi come è stato testato.

Dove devono stare i dati dell'integrazione?

Bisogna separare due domande: dove sono conservati ed elaborati fisicamente i dati, e chi può accedervi legalmente, incluse eventuali richieste di autorità di altri paesi. Un fornitore può ospitare i dati in Europa e avere comunque obblighi verso una giurisdizione diversa. Chiedi una risposta precisa su entrambe le domande, scritta nel contratto.

Nota sul contenuto

Guida informativa di carattere generale. Norme e requisiti tecnici cambiano nel tempo: verifica sempre le fonti ufficiali e valuta il tuo caso specifico con un consulente tecnico o legale qualificato.

CONTATTACI

Parla con il nostro team.

Mostriamo come Altovar si integra nella tua infrastruttura. Nessun impegno, nessun sales pitch. Solo una conversazione tecnica.

PRENOTA UNA DEMO →