Che cos'è un'integrazione ERP e come si distingue dall'installazione di un ERP?
Un'integrazione ERP è il collegamento che consente ai dati di circolare tra l'ERP aziendale e un altro software secondo regole definite, in modo tracciabile e resistente alle interruzioni. Qui affrontiamo questo scenario: l'ERP continua a gestire contabilità, scorte e fatture; gli si affianca un portale rivenditori, un'app sul campo o una schermata operativa che deve rappresentare gli stessi dati corretti dell'ERP.
Installare o sostituire un ERP è invece un altro progetto: selezionare, adattare e attivare l'ERP stesso. In genere se ne occupa il produttore o un suo partner. Nell'integrazione l'ERP non cambia: si progetta il collegamento.
Una premessa: se usi una piattaforma e-commerce pronta all'uso o il modulo B2B del tuo ERP soddisfa l'esigenza, valuta prima il collegamento offerto dal produttore; spesso è la strada più rapida ed economica. Un'integrazione su misura ha senso quando il processo non è standard, occorre collegare più sistemi o le regole del connettore pronto non sono adatte. Le funzionalità attese dal portale sono trattate nell'articolo «Che cos'è un portale B2B?».
Prima di iniziare: inventario e responsabili
Il piano parte da un inventario. Quale ERP e quale versione vengono usati? Funziona in sede o nel cloud? Quali altri sistemi sono già collegati all'ERP: e-Fatura tramite integratore specializzato, banca, software di magazzino, e-commerce? Anche due aziende che utilizzano lo stesso prodotto, come Logo, Mikro o SAP, possono avere possibilità diverse per versione, licenza e personalizzazioni accumulate negli anni. Il nome del prodotto non basta: bisogna verificare cosa sia possibile nella tua installazione.
La seconda domanda riguarda le persone: chi è responsabile lato ERP? Il reparto IT interno o il partner che lo ha installato? Se non è chiaro chi attiverà l'utenza di servizio, preparerà l'ambiente di test e spiegherà il significato dei campi, il calendario dell'integrazione non è sotto il tuo controllo.
Domande per il responsabile ERP
- Quale prodotto e versione sono in uso? È previsto un aggiornamento a breve?
- L'ERP offre web service o API? Servono licenze o moduli aggiuntivi?
- Esiste un ambiente di test separato con dati realistici?
- Prezzi, sconti e promozioni vengono calcolati nell'ERP o altrove?
- Quando si svolgono manutenzioni, processi notturni e chiusura mensile?
- Chi crea l'utente d'integrazione e chi risponde alle richieste di modifica, in quanto tempo?
Responsabilità sui dati principali: dove nasce ogni dato?
Al centro del piano c'è la scelta di un'unica fonte autorevole per ogni tipo di dato: per prezzo, scorte, fido o stato dell'ordine deve esserci una sola risposta a «qual è il valore corretto?». Un campo modificabile in entrambi i sistemi finirà prima o poi per avere due valori diversi.
La tabella seguente è uno scenario di esempio, non un caso cliente reale né un elenco di funzionalità disponibili in ogni ERP. Fonte principale, direzione del trasferimento, condizioni di aggiornamento e responsabile degli errori vanno definiti insieme. La richiesta d'ordine nasce nel portale; l'ERP conserva l'ordine definitivo.
| Dato | Sistema principale e direzione | Aggiornamento | Errore e responsabile |
|---|---|---|---|
| Prodotto, unità, aliquota IVA | ERP come fonte principale; ERP → portale | Notifica delle modifiche o trasferimento massivo pianificato | Viene mostrato l'ultimo catalogo; il responsabile prodotto corregge i codici senza corrispondenza. |
| Prezzo e sconto | ERP come fonte principale; ERP → portale | Alla modifica; nuova verifica alla conferma del carrello | Se il prezzo non è verificabile, non si crea un ordine definitivo; il responsabile commerciale esamina la richiesta. |
| Scorte | ERP come fonte principale; ERP → portale | Si definisce l'anzianità accettabile del dato; la prenotazione viene verificata separatamente | È visibile l'ora di aggiornamento. Non si promette la consegna con scorte obsolete; il responsabile del magazzino esamina la differenza. |
| Cliente e indirizzo di consegna | ERP come fonte principale; portale → richiesta di modifica → ERP → portale | Quando la persona autorizzata approva la modifica | La scheda esistente non viene sovrascritta; il responsabile dell'anagrafica cliente decide sulla richiesta. |
| Conto cliente, fido, saldo | ERP come fonte principale; ERP → portale | Aggiornamento pianificato; verifica del fido attuale al momento dell'ordine | Se la verifica non risponde, la richiesta attende; il responsabile finanziario autorizzato valuta l'eccezione al fido. |
| Ordine | Bozza nel portale; registrazione definitiva nell'ERP. Portale → ERP → risposta sullo stato | All'accettazione della richiesta; si mantiene lo stesso identificativo aziendale | Se la risposta si perde, si interroga lo stato. Se ripetere non è sicuro, non si crea una nuova registrazione; il responsabile dell'integrazione effettua la riconciliazione. |
| e-Fatura, e-İrsaliye | ERP / integratore come fonte principale; documento e stato → portale | Quando il documento viene creato o cambia stato | Un documento assente non viene mostrato come definitivo; lo segue il responsabile contabile o dell'integratore. |
| Utenti e ruoli dei rivenditori | Portale come fonte principale; non serve copiare gli utenti nell'ERP | Quando l'amministratore autorizzato effettua una modifica | L'operazione non viene eseguita se le autorizzazioni non sono verificabili; l'amministratore del portale esamina l'accesso. |
e-Fatura e e-İrsaliye richiedono particolare attenzione: questi documenti fiscali vengono emessi tramite uno dei metodi definiti dalla Gelir İdaresi Başkanlığı, l'amministrazione tributaria turca: integrazione diretta, integratore specializzato o portale GİB. Per il tipo di documento previsto si verificano i metodi e le guide tecniche aggiornate della GİB (verifica: 11 ottobre 2026). Se il portale non deve emettere il documento, ne legge numero, ETTN e stato dall'ERP o dall'integratore e ne mostra la copia al rivenditore.
In tempo reale o periodicamente?
Non tutti i dati devono circolare in tempo reale. Il criterio è: quale decisione diventa errata se il dato invecchia? Aggiornare con un giorno di ritardo la descrizione di un prodotto può non causare danni; scorte vecchie di alcune ore su un prodotto ad alta rotazione possono invece far accettare ordini non evadibili. Collegare ogni schermata a una query in tempo reale verso l'ERP è a sua volta rischioso: rallentamenti o arresti dell'ERP colpiscono il portale. Spesso un buon equilibrio è copiare periodicamente i dati nel portale e interrogare l'ERP solo nei momenti critici, per esempio per prezzi e fido alla conferma del carrello.
I ruoli in tabella sono esemplificativi: associa ciascuno a una persona o funzione nella tua organizzazione. Chi segue il trasferimento tecnico non deve necessariamente decidere su modifiche a prezzi, fido o indirizzi. Anche l'intervallo di aggiornamento va scelto in base al rischio aziendale del dato obsoleto, non a intuito.
Pulizia e mappatura dei dati principali
Nelle integrazioni, molte sorprese arrivano dai dati stessi: prodotti duplicati con vecchio e nuovo codice, articoli gestiti a pezzi nell'ERP ma venduti a cartoni senza conversione, più anagrafiche contabili per le filiali dello stesso rivenditore. Queste corrispondenze non devono restare regole nascoste nel codice d'integrazione: vanno conservate in tabelle di mappatura separate, ciascuna con un responsabile.
Metodi di integrazione: quale scegliere e quando?
Il metodo dipende da ciò che l'ERP offre nella tua installazione e dalla natura dei dati; in un progetto se ne possono combinare diversi.
| Metodo | Quando è adatto? | Aspetti da considerare |
|---|---|---|
| Servizi / API dell'ERP | Se la versione ERP offre web service; generalmente la prima scelta | Possono servire licenze aggiuntive e possono esserci limiti alle richieste; i servizi possono cambiare con gli aggiornamenti |
| Livello intermedio e coda (middleware, iPaaS) | Se occorre collegare più sistemi o se l'ERP è lento o soggetto a interruzioni | Componenti e costi operativi aggiuntivi; deve essere chiaro chi monitora |
| Vista del database (sola lettura) | Se non ci sono servizi e i dati devono essere soltanto letti | La struttura delle tabelle può cambiare con gli aggiornamenti e non rientrare nell'assistenza del produttore |
| Trasferimento file, EDI | Per dati massivi e periodici, quando la controparte accetta solo file | Ritardi, accordo sul formato e file incompleti |
| Basato su eventi (webhook, messaggi) | Se l'ERP può notificare le modifiche alle registrazioni | Serve una riconciliazione periodica per le notifiche perse |
Scrivere direttamente nel database ERP sembra una scorciatoia, ma aggira le regole di scarico scorte, saldo cliente e numerazione documenti. Gli ordini vanno sempre inseriti tramite i servizi o i metodi d'importazione dell'ERP. Se l'ERP è obsoleto e non offre servizi, può servire prima un piccolo livello di servizio; questo lavoro può essere pianificato come primo passo di modernizzazione software.
Il percorso di un ordine tra portale rivenditori ed ERP
Esempio ipotetico: il rivenditore preme due volte Invia per lo stesso ordine; l'ERP crea la prima registrazione, ma la risposta si perde sulla connessione. Se il portale mostra «errore» e reinvia con un nuovo identificativo, possono nascere due ordini. Un errore a schermo non dimostra che il sistema remoto non abbia eseguito l'operazione.
- Bozza e verifica. Si controllano autorizzazioni del rivenditore, validità del prezzo, scorte e fido. Se con dati obsoleti si può solo raccogliere una richiesta, va dichiarato chiaramente: non si afferma che la merce sia riservata o il prezzo confermato.
- Un solo identificativo aziendale. All'ordine viene assegnato un identificativo persistente, mantenuto in tutti i tentativi dello stesso invio. Conservarlo nell'ERP non basta: occorre verificare con test che creazione e controllo dei duplicati funzionino in sicurezza insieme.
- Se l'esito è incerto. L'operazione viene classificata come «stato in verifica». Si cerca lo stato con lo stesso identificativo secondo le capacità di interrogazione e ripetizione sicura dell'ERP. Se non si ottiene un esito affidabile, serve la verifica del responsabile anziché creare un nuovo ordine.
- Conferma e riconciliazione. Numero ERP e stato definitivo ritornano al portale. Le operazioni in attesa e rifiutate sono elencate separatamente; si confrontano non solo il numero degli ordini, ma anche righe, quantità e importi.
Mostrare il catalogo nel portale quando l'ERP è spento non equivale a far funzionare l'app sul telefono senza Internet. Per stabilire quali registrazioni conservare sul dispositivo e come risolvere i conflitti, definisci il perimetro dell'app mobile offline separatamente. L'approccio tecnico che limita gli effetti collaterali dei tentativi ripetuti è descritto nella guida alla ripetizione sicura di AWS Builders’ Library (verifica: 13 ottobre 2026).
Anche aggiornare un ordine esistente richiede un controllo distinto. Per esempio, l'API di aggiornamento ordini di Business Central non applica l'aggiornamento se il tag di versione inviato non corrisponde alla registrazione corrente. Questo evita di sovrascrivere modifiche concorrenti, ma non sostituisce il controllo dei duplicati nella creazione di nuovi ordini. Verifica entrambi i controlli nell'ERP utilizzato (verifica: 13 ottobre 2026).
Errori, monitoraggio e sicurezza
La vera prova dell'integrazione arriva quando l'ERP è in manutenzione, la connessione cade o una registrazione viene rifiutata. Il piano deve rispondere ai seguenti aspetti:
- Coda. Quando l'ERP non è raggiungibile, si mostra al rivenditore «ricevuto, in attesa di trasferimento» solo dopo che la richiesta è stata scritta correttamente in una coda persistente. Se anche la scrittura in coda fallisce, non si conferma l'accettazione. La conferma definitiva dell'ordine nell'ERP viene seguita separatamente.
- Nuovi tentativi. Per gli errori temporanei il trasferimento viene ritentato a intervalli crescenti, con un massimo di tentativi e un limite di durata complessiva. Raggiunto il limite, la registrazione passa a una verifica umana; non si crea un ciclo senza fine. Gli errori permanenti, come un conto cliente chiuso, non vengono ritentati continuamente, ma entrano nell'elenco di lavoro di una persona.
- Prevenzione dei duplicati. Si testano tentativi simultanei e ritardati con lo stesso identificativo aziendale. Se ERP o livello intermedio non possono garantire il controllo, le operazioni incerte non vengono ricreate automaticamente: si ricorre a riconciliazione e verifica autorizzata.
- Monitoraggio e avvisi. Si controllano il numero di registrazioni in coda e l'attesa della più vecchia; al superamento della soglia, l'avviso raggiunge una persona identificata.
- Riconciliazione. Gli ordini di portale ed ERP vengono confrontati con la frequenza concordata per identificativo, stato, righe, quantità e importi. Lo stesso totale può nascondere errori su registrazioni diverse; le differenze non spiegate passano al responsabile dell'attività.
Per la sicurezza si crea un'utenza di servizio separata per l'integrazione, autorizzata soltanto alle operazioni necessarie; non si usa la password ERP di un dipendente. L'ERP interno non viene esposto a Internet: il collegamento usa VPN, restrizioni IP o un livello intermedio che si connette dall'interno verso l'esterno. Ogni richiesta viene registrata senza aggiungere dati personali superflui ai log. Ai fini della KVKK, documenta quali dati personali vengono copiati in quali sistemi e non trasferire campi non necessari; l'anagrafica di un rivenditore individuale può contenere nome e numero d'identità turco.
Test, messa in produzione e piano di ripristino
Un flusso perfetto su dati di esempio può fallire con prezzi reali ed eccezioni accumulate negli anni. I test vanno quindi eseguiti su una copia aggiornata nell'ambiente di test ERP, con dati personali mascherati, elencando prima i casi limite: scorte zero, cliente oltre fido, promozione scaduta, prodotto venduto con più unità, ERP riavviato durante il trasferimento, ordine inviato due volte e indirizzi con caratteri turchi (İ, ş, ğ).
Scegli la finestra di passaggio evitando chiusura mensile, periodi di fatturazione e avvio delle promozioni. Prima carica i dati principali e confrontali con l'ERP; poi parti con un piccolo gruppo pilota di rivenditori, mantenendo aperti telefono ed e-mail durante il periodo.
Checklist per la messa in produzione
- Tabella delle responsabilità sui dati principali e tabelle di mappatura approvate.
- Casi limite provati in ambiente di test con dati realistici.
- Coda, tentativi e avvisi testati; destinatario degli avvisi identificato.
- Caricamento iniziale eseguito e risultati confrontati con l'ERP.
- Finestra di passaggio scelta insieme al responsabile ERP.
- Gruppo pilota e canali da mantenere aperti durante il passaggio definiti.
- Piano di ripristino scritto: in quali condizioni e su decisione di chi si torna indietro? Come vengono trasferiti nell'ERP gli ordini in attesa nel portale?
Due preventivi di integrazione ERP comprendono la stessa consegna?
Prima di confrontarli, allinea flussi dei dati ed evidenze di accettazione. La dicitura «integrazione scorte e ordini» non indica quale deposito verrà letto, chi esaminerà un ordine dall'esito incerto o chi curerà la manutenzione quando cambia la versione ERP. Chiedi a entrambi i fornitori di descrivere il risultato da consegnare sugli stessi dati di esempio.
| Aspetto da chiarire nel preventivo | Evidenza da richiedere a entrambi | Se resta fuori dal perimetro |
|---|---|---|
| SKU, deposito e unità di vendita | Elenco di mappature approvato; risultato atteso per pezzi/cartoni e SKU non trovato | Si pianificano separatamente il responsabile della mappatura e la correzione degli errori. |
| Ordine con risposta persa | Confronto di registrazione e stato ERP con lo stesso identificativo aziendale dopo un'interruzione controllata | Si specificano tempo e responsabile della verifica manuale dei casi incerti; la ripetizione automatica non è considerata sicura a priori. |
| Trasferimento iniziale e riconciliazione | Trasferimento di prova; confronto delle differenze di registrazioni, righe, quantità e importi | Pulizia e migrazione dei dati preesistenti sono valutate come attività separate. |
| Carico di elaborazione e limiti del servizio | Test con il volume di dati concordato; ritardo della coda, limite dei tentativi e condizione di arresto | Si stabilisce chi sostiene licenze API, quote dei servizi e costi di hosting. |
| Manutenzione e consegna | Test al cambio di versione, responsabile degli avvisi, manuale operativo e trasferimento degli accessi | Correzione degli errori, nuove funzionalità e adattamenti a modifiche del produttore vengono quotati separatamente. |
Scenario di esempio: Supponiamo che il preventivo A includa solo il trasferimento riuscito di scorte e ordini, mentre B includa anche l'esame delle operazioni incerte e il passaggio della manutenzione. I totali non stanno quindi quotando lo stesso lavoro. Prima di confrontarli, includi le voci mancanti o escludile esplicitamente dal perimetro. Non è un preventivo reale né un risultato cliente e non contiene ipotesi su prezzi o tempi.
Completamento dei test e accettazione del responsabile aziendale sono passaggi distinti. Anche la guida Microsoft alle tipologie di test distingue test end-to-end e test di accettazione utente (verifica: 18 ottobre 2026). Definisci fin dall'inizio chi accetterà il risultato e quale evidenza verrà mostrata; non archiviare casi irrisolti solo perché «l'API ha risposto correttamente». Per proprietà e manutenzione complessiva del software puoi consultare la guida al confronto dei preventivi di software su misura.
Da cosa dipendono i tempi e quando ha senso un collegamento manuale temporaneo?
I tempi di integrazione ERP non dipendono dal nome del prodotto. Incidono soprattutto disponibilità di servizi documentati, pulizia dei dati principali, ambiente di test, numero di flussi e reperibilità del responsabile ERP. Una discovery di 1–2 settimane e una prima versione di 6–12 settimane sono intervalli esemplificativi valutabili per attività circoscritte con accessi pronti. Vincoli ERP o preparazione dei dati possono richiedere un piano diverso; i tempi vengono definiti dopo l'analisi tecnica.
Non tutte le prime versioni devono aspettare l'integrazione completa. Nell'esempio ipotetico del portale rivenditori, finché gli ordini sono pochi, prezzi e scorte possono essere aggiornati alcune volte al giorno tramite un file dall'ERP; il team operativo può trasferire nell'ERP gli ordini ricevuti dal portale. Così si può capire se i rivenditori adottano il portale prima di completare l'integrazione. Quando i volumi aumentano, le scorte cambiano rapidamente o il rischio sul fido è alto, il collegamento manuale diventa una fonte d'errore: allora l'integrazione completa è il passo successivo. Questa decisione è approfondita nell'articolo «Come definire il perimetro di un MVP?».
Descriviamo come affrontiamo un portale collegato all'ERP nella pagina Sviluppo di portali B2B. Prova prodotti, fido e approvazione del responsabile nella demo ordini rivenditori. Il flusso immaginario X Dağıtım funziona nel browser, senza connessione ERP reale né invio di ordini. L'approvazione nella demo e l'accettazione dell'ordine da parte dell'ERP reale sono operazioni diverse.
Con l'inventario del tuo ERP possiamo preparare insieme una prima bozza del piano in un incontro di 30 minuti.