Migrazione a Odoo 20 da Odoo 16, 17, 18 e 19: la guida per le aziende italiane

La migrazione a Odoo 20 è il passaggio di un database Odoo esistente, con tutti i suoi dati, le configurazioni e le personalizzazioni, da una versione precedente (16, 17, 18 o 19) alla versione principale più recente. Nel linguaggio di Odoo si chiama upgrade e va distinto dall'update, che è il semplice aggiornamento dei file di una stessa versione: un update si fa in pochi minuti e non cambia nulla per chi lavora, un upgrade è un progetto, perché la struttura dei dati, i moduli e le interfacce cambiano da una versione all'altra.

Se ne parla adesso per due motivi che si sommano. Il primo: Odoo 20 è stato presentato a settembre 2026 e le sue note di rilascio elencano novità su intelligenza artificiale, contabilità, logistica e app mobile che molte aziende vogliono avere (ne abbiamo parlato nell'articolo su novità, prezzi e utenti light di Odoo 20). Il secondo, meno visibile ma più importante: secondo la pagina ufficiale sulle versioni supportate, Odoo mantiene con correzioni e aggiornamenti di sicurezza solo le tre versioni principali più recenti. Con l'arrivo della 20, le versioni coperte sono 18, 19 e 20: chi lavora ancora su Odoo 17, o su una versione più vecchia, usa un gestionale che non riceve più correzioni.

AscenSys, società IT italiana e Ready Partner Odoo, segue le aziende italiane nei progetti Odoo dall'implementazione iniziale alla migrazione fra versioni. In questa guida spieghiamo come si svolge davvero un progetto di migrazione a Odoo 20, dove si nascondono i problemi, come cambia il percorso a seconda di dove è ospitato il database e quando conviene partire.

Quasi tutte le aziende che ci chiedono di aggiornare Odoo arrivano con la stessa frase: "funziona, abbiamo paura di romperlo". È una paura fondata, perché i problemi di una migrazione non stanno nei dati standard, che Odoo sa spostare da solo, ma in tutto quello che l'azienda ha costruito attorno al gestionale negli anni. In particolare:

• I moduli personalizzati: campi aggiunti, flussi modificati, stampe su misura, automazioni scritte per una versione precisa. A ogni nuova versione Odoo cambia parti del proprio codice e dell'interfaccia, e un modulo scritto per la 16 o la 17 può non caricarsi sulla 20 senza un adeguamento.
• I moduli di terze parti: estensioni prese dal marketplace o dalla community (per l'Italia, tipicamente la localizzazione fiscale e la fatturazione elettronica). Nei primi mesi dopo l'uscita di una versione non tutti sono già disponibili per quella versione, e un'azienda non può migrare finché manca un modulo che usa ogni giorno.
• Le integrazioni: e-commerce, magazzino automatico, software del commercialista, portali di logistica, connettori scritti su misura. Parlano con Odoo attraverso le sue API e vanno riprovate una per una, perché un campo rinominato basta a bloccare uno scambio dati.
• I dati accumulati: anagrafiche doppie, prodotti mai usati, listini vecchi, allegati di dieci anni. Non impediscono la migrazione, ma la rallentano e portano nella nuova versione un disordine che era meglio lasciare indietro.
• Le versioni saltate: chi è fermo alla 16 e passa alla 20 attraversa quattro versioni in un colpo solo. Il salto è possibile, ma ogni versione saltata aggiunge cambiamenti da verificare, e quasi sempre qualche funzione che le persone usavano è stata spostata o ridisegnata.

A questi si aggiunge un problema di tempistica. La piattaforma ufficiale di aggiornamento di Odoo (upgrade.odoo.com), consultata il 23 ottobre 2026, accetta oggi come versioni di destinazione la 17, la 18 e la 19: per i database esistenti Odoo ha comunicato ai partner che l'aggiornamento alla 20 è atteso entro la fine di novembre 2026, con una modalità di test disponibile prima. Chi aspetta quel giorno per iniziare a ragionare parte in ritardo: il lavoro di analisi, pulizia e adeguamento dei moduli si può e si deve fare prima.

Infine c'è chi rimanda per anni. Il gestionale continua a funzionare, ma senza correzioni di sicurezza, con moduli che nessuno aggiorna più e con un debito che cresce: più tempo passa, più la migrazione diventa grande e costosa. È il caso più frequente che incontriamo nelle aziende italiane ancora su Odoo 15 o 16.

Un progetto di migrazione ben fatto non è un salto nel buio: è una sequenza di passaggi in cui ogni fase riduce il rischio della successiva, e in cui l'azienda continua a lavorare sul vecchio sistema fino al giorno del passaggio. Questo è il metodo che AscenSys applica ai progetti di implementazione e migrazione Odoo per le aziende italiane:

1. Analisi iniziale: censiamo versione attuale, tipo di hosting (Odoo Online, Odoo.sh o server proprio), moduli installati, personalizzazioni, moduli di terze parti, integrazioni esterne e utenti. Da qui esce la mappa di quello che migra da solo, di quello che va adeguato e di quello che si può abbandonare.
2. Pulizia e decisioni: insieme all'azienda decidiamo cosa portare nella nuova versione e cosa no. Molte personalizzazioni nate anni fa sono oggi funzioni standard di Odoo 20: eliminarle semplifica la migrazione e il futuro.
3. Aggiornamento di prova su una copia: il database viene aggiornato in modalità test attraverso la piattaforma ufficiale di Odoo, che restituisce una copia nella nuova versione. Su quella copia si lavora senza alcun rischio per la produzione.
4. Adeguamento di moduli e integrazioni: i moduli personalizzati vengono portati alla nuova versione, quelli di terze parti sostituiti con la versione compatibile, le integrazioni riprovate e corrette. Si ripete il test di aggiornamento finché tutto carica pulito.
5. Collaudo con le persone che lavorano: gli utenti chiave eseguono sulla copia i loro scenari reali, dall'ordine alla fattura, dall'arrivo merce alla chiusura contabile. È il passaggio che scopre i problemi che nessun tecnico vede, perché sono nei processi e non nel codice.
6. Passaggio in produzione e presidio: il giorno del passaggio si rifà l'aggiornamento sui dati aggiornati, in una finestra concordata (tipicamente un fine settimana), con un piano di ritorno indietro se qualcosa non torna. Odoo stesso raccomanda di eseguire l'aggiornamento di produzione entro tre giorni da un test riuscito, così che i dati e le condizioni siano gli stessi. Nei giorni successivi restiamo accanto agli utenti.

Due regole che non trattiamo: non si migra mai direttamente la produzione senza aver prima fatto almeno un ciclo completo di test su copia, e non si aggiorna un sistema che non abbiamo prima capito. Il resto, tempi compresi, dipende da quanto l'azienda ha costruito attorno a Odoo, e per questo lo stimiamo dopo l'analisi iniziale, non prima.

Non tutte le migrazioni a Odoo 20 sono uguali: il percorso dipende da dove gira il database e dal tipo di edizione.

Migrazione a Odoo 20 su Odoo Online

È il caso più semplice. Chi usa Odoo Online (il servizio in cloud gestito da Odoo) non può installare moduli personalizzati, quindi il lavoro è quasi tutto di verifica: si richiede l'aggiornamento di prova dal proprio abbonamento, si controlla la copia, si avverte Odoo quando si è pronti per la produzione. Le integrazioni esterne via API vanno comunque riprovate.

Migrazione a Odoo 20 su Odoo.sh

Odoo.sh è la piattaforma di hosting gestito di Odoo per chi ha moduli personalizzati. Il passaggio di versione parte da un ramo di prova con un aggiornamento di test, i moduli personalizzati si adeguano e si pubblicano con un nuovo commit, e solo alla fine si aggiorna il ramo di produzione. È il percorso che seguiamo più spesso con le PMI italiane, perché unisce la libertà di personalizzare alla piattaforma ufficiale di aggiornamento.

Migrazione a Odoo 20 su server proprio (on-premise)

Con un'installazione su server proprio e abbonamento Enterprise, l'aggiornamento di prova si richiede alla piattaforma ufficiale inviando una copia del database e si riceve indietro la copia aggiornata; i moduli personalizzati e il server stesso (versione di Python, di PostgreSQL, dipendenze) sono responsabilità di chi lo amministra, ed è qui che una verifica preventiva evita sorprese. Spesso la migrazione è l'occasione per spostarsi su Odoo.sh o per rinnovare il server.

Migrazione di Odoo Community

Chi usa l'edizione Community, gratuita e senza abbonamento, non ha accesso alla piattaforma ufficiale di aggiornamento: il passaggio di versione si fa con strumenti della community, versione per versione, e richiede più lavoro tecnico. Per molte aziende la migrazione è anche il momento in cui si valuta se passare all'edizione Enterprise, confrontando il costo dell'abbonamento con quello del lavoro tecnico che Community richiede a ogni versione.

Quando conviene migrare a Odoo 20

Chi è su Odoo 17 o versioni precedenti dovrebbe iniziare adesso l'analisi, perché è già fuori dal supporto standard: la migrazione va fatta appena la piattaforma accetta la versione 20, e nel frattempo si prepara tutto il resto. Chi è su Odoo 18 o 19 ha tempo, ma conviene pianificare la migrazione nel 2027, scegliendo un periodo di attività bassa e prima che l'azienda accumuli nuove personalizzazioni da portarsi dietro. Chi invece non usa ancora Odoo non ha nulla da migrare: parte direttamente dalla versione 20.