Migração para o Odoo: método, dados e arranque

Uma migração Odoo raramente falha por causa do software. Falha quando se subestima o trabalho sobre os dados, quando ninguém ensaia o arranque ou quando não existe caminho de regresso. Quem decide passar para o Odoo a partir de folhas de Excel, de um programa de contabilidade ou de um ERP antigo, e quem tem de mudar de versão, enfrenta o mesmo desafio: levar para o novo sistema apenas o que é fiável e fazê-lo sem parar a faturação.

Esta página explica como se prepara uma migração para o Odoo em Portugal: o que migrar, como importar, como testar, como arrancar e o que evitar. Para a visão global do projeto, consulte também o guia de mise en place do Odoo e o guia geral de migração de ERP.

Dois tipos de migração, dois problemas diferentes

Quando se fala em migração Odoo, a expressão cobre situações muito distintas. Convém separá-las desde o início, porque o método, os riscos e os intervenientes mudam.

Nos três primeiros casos, o objetivo é construir uma base limpa. No último, o objetivo é preservar o que já funciona e validar que continua a funcionar.

Passar para o Odoo a partir de Excel ou de um programa de contabilidade

Quem vem do Excel tem uma vantagem: não há sistema anterior a respeitar. E uma desvantagem: os dados raramente foram concebidos para serem importados. O mesmo cliente aparece com três grafias, o artigo tem códigos diferentes consoante a folha, e o NIF falta ou está mal escrito.

Quem vem de um programa de contabilidade ou de faturação tem dados mais estruturados, mas enfrenta outra questão: o novo sistema passa a ligar vendas, compras, stock e contabilidade. O que antes estava separado precisa de ser reconciliado. O seu contabilista certificado deve participar desde o início, porque é ele quem valida os saldos de abertura e o plano de contas.

O que a ferramenta de importação permite

O Odoo importa ficheiros CSV e Excel (.xlsx) e disponibiliza modelos pré-configurados para contactos, produtos, extratos bancários, lançamentos contabilísticos e encomendas. Dois pontos merecem atenção:

• os identificadores externos evitam duplicados e permitem reconstituir as relações vindas do sistema anterior (por exemplo, a ligação entre um cliente e as suas moradas de entrega);
• as importações são definitivas e não podem ser anuladas. Uma importação errada numa base de produção obriga a corrigir à mão, ou a repor uma cópia de segurança.

Na prática, a importação nunca se faz pela primeira vez em produção. Ensaia-se numa base de teste, repete-se tantas vezes quantas as necessárias e só se executa a versão final quando o resultado é reprodutível.

O que migrar e o que deixar para trás

A tentação é migrar tudo. A boa prática é o contrário: migrar o mínimo necessário para trabalhar bem no primeiro dia, e manter o resto consultável.

Dados mestres

São o coração da migração e os que mais beneficiam de limpeza:

• clientes e fornecedores, com NIF validado, moradas e condições de pagamento;
• artigos, com códigos, famílias, unidades e taxas de IVA corretas;
• plano de contas e diários;
• tabelas de preços, listas de materiais e rotas, se houver produção.

Dados em aberto

São os que vivem: encomendas de clientes por entregar, encomendas a fornecedores em curso, faturas por receber e por pagar, stock por localização. Estes dados exigem uma data de corte clara. Tudo o que está aberto nessa data entra no Odoo; o que está fechado fica para trás.

Histórico

O histórico completo de vendas ou de movimentos de stock é útil para análise, mas custa caro a migrar e raramente é indispensável. Três perguntas ajudam a decidir:

• A lei ou o contabilista exige que o documento seja consultável no Odoo, ou basta conservá-lo?
• A equipa comercial precisa de ver a evolução de um cliente ao longo dos anos?
• O histórico tem qualidade suficiente para ser fiável depois de importado?

Se a resposta for não, mantenha o sistema antigo em modo de leitura e migre apenas os totais ou os saldos. Pode ainda importar o histórico de forma resumida, para alimentar relatórios sem reconstruir cada documento.

Limpeza e mapeamento: o trabalho que ninguém vê

A limpeza dos dados consome habitualmente mais tempo do que a própria importação. Inclui eliminar duplicados, uniformizar nomes, completar NIF e moradas, rever artigos inativos e acertar unidades de medida.

O mapeamento é o documento que liga cada campo de origem a um campo do Odoo. Deve indicar, para cada campo, a regra de transformação e o responsável pela validação. Sem este documento, cada pessoa interpreta os dados à sua maneira e os erros só aparecem em produção.

Atenção especial ao contexto português:

• séries e numeração de documentos: a continuidade das séries de faturação deve ser tratada com o integrador e o contabilista certificado, para que o arranque não crie ruturas;
• ATCUD e código QR: confirme com o integrador como estes elementos são tratados na localização portuguesa em uso, e leia o guia sobre software de faturação certificado pela AT;
• SAF-T (PT): o ficheiro que exporta a contabilidade e a faturação deve ser testado antes da bascule. Veja o guia sobre SAF-T (PT) e ERP;
• saldos de abertura: devem ser reconciliados com o balancete do sistema anterior e validados pelo contabilista certificado.

Para o enquadramento local do produto, consulte a página Odoo em Portugal e, para a parte financeira, a de contabilidade e finanças no Odoo.

Estratégia de arranque: bascule total ou progressiva

Existem duas grandes abordagens, e a escolha depende da dimensão da empresa e da tolerância ao risco.

Uma bascule progressiva faz sentido quando a empresa tem várias áreas independentes. A bascule total é frequente em PME mais pequenas, onde manter dois sistemas em paralelo é mais penoso do que concentrar o esforço num único fim de semana.

Em ambos os casos, escolha uma data de arranque compatível com a atividade. Evite fechos de IVA, inventários e picos sazonais. A data de corte contabilístico faz-se de preferência no início de um período, para simplificar os saldos de abertura.

Testes: o que validar antes de arrancar

O arranque só é seguro se tiver sido ensaiado. Um ensaio completo inclui uma migração integral numa base de teste, com os dados reais, seguida de verificações feitas pelos futuros utilizadores e não apenas pelo integrador.

• Reconciliação: os totais de clientes, fornecedores, stock e contabilidade batem com o sistema de origem.
• Circuitos completos: do orçamento à fatura, da encomenda ao pagamento, da receção ao stock.
• Documentos legais: emissão de faturas, séries, impressões e exportação do SAF-T (PT).
• Integrações: ligações a banco, loja online, transportadores ou outras aplicações, como descrito em integrações do Odoo.
• Desempenho: tempos de resposta com o volume real de dados e de utilizadores.
• Direitos de acesso: cada perfil vê o que deve ver, e apenas isso.

A aceitação deve ser formal: uma lista de cenários, um responsável por cenário e um critério claro de aprovação. É este registo que sustenta a decisão de avançar ou adiar.

Plano de retorno: preparar o regresso antes de avançar

Um plano de regresso não é pessimismo, é gestão de risco. Deve existir por escrito antes do arranque e conter:

• o ponto de não retorno: a partir de que momento voltar atrás deixa de ser viável;
• os critérios de decisão: que falhas justificam suspender o arranque;
• a conservação do sistema antigo intacto, acessível e com cópia de segurança;
• o procedimento para recuperar os documentos criados durante o período de teste, se existirem;
• as pessoas responsáveis pela decisão, e a forma de contactar o integrador.

Se o projeto já arrancou e se encontra em dificuldade, uma auditoria e recuperação de projeto Odoo ajuda a perceber se se corrige, se se reorienta ou se se recomeça a migração.

Migrar entre versões do Odoo

Quem já usa o Odoo também faz migrações, e com menos margem para improvisar. O Odoo lança versões principais e, no Odoo Online, versões intermédiárias («SaaS») a cada dois a três meses; estas últimas só existem no Odoo Online e não dão direito a suporte alargado.

Segundo a página das versões suportadas, o Odoo 17.0 saiu em novembro de 2023 e o suporte standard terminou em setembro de 2026; o Odoo 18.0 saiu em outubro de 2024 (suporte standard até setembro de 2027) e o Odoo 19.0 em setembro de 2025 (até setembro de 2028). O Odoo 20.0 estava anunciado para setembro de 2026, com suporte standard até setembro de 2029. Consulte sempre a página oficial para confirmar o estado atual.

O que isto implica na prática:

• cada versão principal beneficia de três anos de suporte standard, mais dois anos para efetuar as mudanças necessárias antes de perder todo o suporte;
• os correctivos de segurança só são fornecidos durante o suporte standard; no suporte alargado, a assistência e as correções continuam possíveis apenas quando tecnicamente viável;
• o suporte alargado, pago, só existe no Odoo.sh (para versões limitadas) e em instalação própria;
• no Odoo Online e no Odoo.sh, a mudança para uma versão principal é obrigatória a cada dois anos, com aviso prévio, e as versões intermédias devem ser migradas nas semanas seguintes à versão seguinte.

Antes da produção, o procedimento prevê a obtenção de uma base de teste migrada para validar a nova versão. Alguns serviços ficam fora do âmbito do acordo de nível de serviço da migração, em particular os desenvolvimentos específicos. Quanto mais personalizações existirem, mais a mudança de versão se parece com um mini-projeto, com testes, correções e formação. As versões e edições do Odoo e a página de personalização ajudam a avaliar esse impacto, e o alojamento cloud condiciona o calendário das mudanças.

A edição também conta: a licença do Odoo 19 Community é LGPLv3, e a do Enterprise exige uma subscrição válida para o número correto de utilizadores. Uma migração de Community para Enterprise, ou entre modos de alojamento, tem implicações de custos que o artigo sobre preços do Odoo detalha.

Erros a evitar numa migração Odoo

• Importar dados sujos «para limpar depois»: depois, ninguém limpa.
• Fazer a primeira importação em produção: sem ensaio, não há margem de erro.
• Migrar todo o histórico por reflexo: custa tempo e traz pouco valor.
• Deixar a contabilidade para o fim: o contabilista certificado deve validar os saldos desde o primeiro ensaio.
• Ignorar os utilizadores: quem não participou nos testes e não foi formado trava o arranque. A formação no Odoo deve preceder a bascule.
• Esquecer o plano de regresso: sem critérios de decisão, a pressão do prazo empurra para um arranque mal preparado.
• Escolher a data sem olhar para o calendário fiscal: um arranque coincidente com um fecho complica tudo.

Como escolher quem conduz a migração

A migração é a fase em que a experiência do integrador mais se nota: método de mapeamento, ferramentas de importação, ensaios repetidos e acompanhamento no dia do arranque. Peça referências verificáveis de projetos semelhantes ao seu, pergunte como é tratado o plano de regresso e quem fica responsável pelos dados após a bascule. Na página escolher um parceiro Odoo encontra critérios de avaliação.

A Integrador ERP não faz a migração: o nosso serviço é gratuito e consiste em pô-lo em contacto com um integrador adaptado ao seu projeto, que depois conduz a migração. Veja como funciona a mise en relação e descreva a sua situação, indicando de onde parte e com que volume de dados trabalha.

Os nomes de software mencionados são marcas dos respetivos editores, citadas a título meramente informativo. Este site é independente e não é afiliado a nenhum editor.