1. Perché la sincronizzazione manuale costa più di quanto sembri
Quando il portale clienti, l'e-commerce o il sito per le prenotazioni non dialogano con il gestionale, qualcuno copia i dati a mano: anagrafiche, ordini, documenti di trasporto (DDT), fatture. Ogni copia manuale è un punto di errore. Codici cliente sbagliati, prezzi non aggiornati e ordini inseriti due volte sono problemi che sembrano piccoli, finché non producono reclami e ore di riconciliazione.
Il problema cresce con il volume. Un errore isolato si corregge in pochi minuti, ma un flusso che sbaglia ogni giorno genera riconciliazioni lunghe e discussioni con i clienti. Prima di scegliere una tecnologia, definisci quale processo vuoi eliminare, quante persone lo svolgono oggi e quali errori produce. Questa analisi decide il perimetro dell'integrazione più di qualsiasi scelta tecnica.
2. Le strade possibili per collegare il gestionale
Esistono quattro approcci principali. L'interfaccia applicativa (API) del gestionale, quando è disponibile per la tua versione e la tua licenza, è la soluzione più pulita perché rispetta le regole di business del prodotto. Lo scambio di file tracciati, con formati concordati e import ed export programmati, è più datato ma spesso affidabile e facile da verificare. L'accesso diretto al database è possibile ma è la strada più rischiosa, perché aggira la logica del prodotto e rende fragili gli aggiornamenti.
Un middleware o una piattaforma di integrazione può fare da intermediario tra più sistemi e centralizzare log ed errori. Ha senso quando i collegamenti sono molti, ma aggiunge un componente da gestire e da pagare. Chiedi a TeamSystem o al tuo rivenditore quali interfacce sono previste per la versione che usi, Polyedro o Alyante, e a quali condizioni contrattuali. Non dare per scontato che un'interfaccia esista solo perché esiste un portale.
| Approccio | Vantaggi | Limiti | Quando ha senso |
|---|---|---|---|
| API del gestionale | Regole di business rispettate dal prodotto | Disponibilità e costi dipendono da versione e contratto | Flussi frequenti e bidirezionali |
| Scambio di file tracciati | Semplice da verificare e da riprendere | Ritardo tra un invio e l'altro, errori gestiti a mano | Flussi periodici e grandi volumi |
| Accesso diretto al database | Massima flessibilità tecnica | Aggira la logica del prodotto, fragile agli aggiornamenti | Quasi mai consigliato per flussi produttivi |
| Middleware di integrazione | Un punto unico di controllo e di log | Un componente in più da gestire e pagare | Più sistemi collegati tra loro |
3. Quali dati sincronizzare e chi ne è il proprietario
Ogni dato deve avere un solo proprietario, cioè il sistema che ha l'ultima parola quando c'è un dubbio. Le anagrafiche clienti e il piano dei prezzi di solito nascono nel gestionale. Gli ordini possono nascere sul portale e poi essere letti dal gestionale. Lo stato di spedizione può arrivare dal magazzino. Scrivi questa mappa in una tabella prima di costruire qualsiasi flusso, e fanne parte anche chi usa i dati ogni giorno.
La sincronizzazione in tempo reale non è sempre necessaria. Per le anagrafiche può bastare un aggiornamento periodico; per gli ordini serve più rapidità. Per ciascun flusso decidi frequenza, direzione e regola di conflitto, ad esempio quale valore prevale quando entrambi i sistemi sono cambiati. Per fatture elettroniche e documenti fiscali verifica con il commercialista quale sia il flusso ufficiale: un'integrazione non deve creare un canale parallelo di emissione non tracciato nel sistema contabile.
4. Sicurezza, accessi e tracciabilità
L'integrazione apre un canale permanente tra due sistemi, e va protetta come un accesso amministrativo. Usa un'utenza tecnica dedicata, con privilegi minimi, cioè solo le operazioni necessarie al flusso. Le credenziali vanno conservate in un gestore di segreti e non nel codice, e vanno ruotate con una procedura definita. Il trasporto dei dati deve essere cifrato, e l'accesso deve essere limitato alla rete o ai servizi che ne hanno davvero bisogno.
Registra ogni chiamata con data, sistema, esito e identificativo del record. Senza log non puoi dimostrare cosa è successo durante una contestazione con un cliente o durante un controllo. Prevedi una coda degli errori: un record fallito deve essere visibile, riprovabile e mai perso. I dati personali che passano dal portale al gestionale ricadono nel GDPR, quindi verifica quali campi servono davvero, dove vengono conservati i log e chi vi può accedere.
5. Checklist per il fornitore e per l'integratore
Prima di iniziare lo sviluppo, chiedi per iscritto le informazioni che determinano se il progetto è fattibile e quanto costerà mantenerlo nel tempo. Le risposte mancanti sono il primo segnale di rischio: un'integrazione senza documentazione dei campi diventa dipendente da una sola persona. Chiedi anche chi firma per l'integratore la documentazione dei campi, e in quale formato la riceverai alla fine del progetto. Senza questo passaggio il know-how resta in una sola persona.
Usa questa lista sia con il fornitore del gestionale sia con l'integratore che svilupperà il flusso. Le risposte devono coincidere: se il rivenditore dice una cosa e lo sviluppatore ne dice un'altra, il problema va chiarito prima di scrivere il codice. Se il rivenditore e lo sviluppatore danno risposte diverse, la differenza va risolta per iscritto prima di avviare il lavoro, altrimenti la responsabilità resta sospesa tra due parti.
- Versione esatta del gestionale e licenza che include le interfacce necessarie.
- Elenco dei campi scambiati, con formato, obbligatorietà e codici di riferimento.
- Regola di idempotenza: un invio ripetuto non crea un duplicato.
- Gestione degli errori e coda di riprova con notifica a una persona responsabile.
- Ambiente di test separato, con dati non reali.
- Log consultabili e conservati per un periodo concordato.
- Piano di rientro: come tornare al processo manuale se il flusso si ferma.
6. Errori comuni nei progetti di integrazione
Il primo errore è partire dal codice senza mappare i processi. Si costruisce un flusso tecnicamente perfetto che non risolve il problema reale, per esempio perché il codice cliente non è unico tra filiali o perché due reparti usano lo stesso campo con significati diversi. Il secondo è ignorare gli aggiornamenti del gestionale: un cambio di versione può modificare un campo o una regola, e il flusso si rompe in silenzio.
Il terzo è non testare i casi limite: ordini con righe a zero, clienti con più sedi, resi, note di credito, prezzi con più listini. Sono gli scenari che emergono nel lavoro quotidiano e che i test standard non coprono. Il quarto è affidare tutto a un unico sviluppatore senza documentazione. Quando cambia incarico, nessuno sa più come funziona il flusso e ogni intervento diventa un'emergenza.
7. Come iniziare: un flusso pilota
Scegli un solo flusso a basso rischio e alto fastidio, di solito le anagrafiche clienti o la pubblicazione del catalogo prezzi. Documenta i campi, la frequenza e il proprietario di ogni dato. Questo primo flusso ti insegna i problemi reali, come i codici mancanti o le differenze di formato, prima di toccare ordini o fatture, dove un errore ha conseguenze più pesanti.
Il primo passo concreto è una riunione breve con chi usa il gestionale ogni giorno, chi gestisce il portale e chi si occupa di amministrazione. Portate la lista dei processi manuali e una stima degli errori che generano. Con questa lista chiedi al fornitore una proposta per il flusso pilota, con interfacce previste, piano di test, responsabilità e criteri per dichiarare il flusso in produzione.
Domande frequenti
Posso collegare il portale al gestionale senza il supporto di TeamSystem?
Dipende da quali interfacce sono disponibili per la tua versione e da cosa prevede il contratto di licenza. Alcune integrazioni si realizzano con strumenti standard del gestionale, altre richiedono il supporto del produttore o di un partner. Prima di sviluppare, chiedi per iscritto quali strade sono consentite. L'accesso diretto al database è in genere la strada più fragile: verifica le condizioni contrattuali prima di adottarla.
Quanto tempo richiede un'integrazione?
Varia molto in base al numero di flussi, alla qualità dei dati di partenza e alla disponibilità di interfacce. Un flusso singolo e ben definito si chiude in tempi contenuti; un progetto con più sistemi e regole di conflitto richiede fasi, test e un periodo di affiancamento. Diffida di chi promette tempi senza aver prima analizzato i processi e i dati.
Le fatture elettroniche possono partire dal portale?
Di norma le fatture devono essere generate dal gestionale e trasmesse al Sistema di Interscambio secondo il flusso previsto. Un portale può alimentare i dati di partenza, ma non deve creare documenti fiscali fuori dal controllo del gestionale. Verifica con il commercialista chi emette, chi archivia e dove resta la traccia di ogni documento.
Come evito i duplicati quando un invio fallisce?
Ogni record deve avere un identificativo univoco lato sorgente, e il ricevente deve riconoscere un invio già elaborato. Così una riprova non crea un secondo ordine. Chiedi al fornitore come gestisce questo caso e fai un test in cui forzi un errore a metà flusso, verificando che il risultato finale resti corretto.
Chi si occupa della manutenzione dopo il progetto?
Servono tre elementi: un responsabile interno che riceva le notifiche di errore, un contratto di manutenzione con il fornitore dell'integrazione e una procedura di test per gli aggiornamenti del gestionale prima del rilascio. Senza questi tre elementi il flusso funziona fino al primo cambiamento di versione, e poi nessuno sa cosa è successo.