Migração TOTVS Protheus para Odoo: o que muda na compliance fiscal
Migrar do TOTVS Protheus para Odoo sem quebrar a compliance fiscal exige plano. Veja como preservar XMLs, manter SPED em dia e o prazo realista do projeto.
Luis Felipe Miléo
A pergunta que mais recebemos sobre migração de Protheus para Odoo não é se dá certo — é o que acontece com as obrigações fiscais durante e depois da virada. Faz sentido: a empresa não pode perder competência fiscal por ter trocado de ERP, e qualquer falha em SPED ou NF-e tem consequência imediata.
Este post resume o que muda na prática quando você sai de TOTVS Protheus para Odoo+OCA, em quais pontos a localização da OCA tem vantagens estruturais e quais cuidados a migração precisa ter.
O ponto de partida: o que o Protheus realmente faz no fiscal
O Protheus tem o módulo SIGAFIS (e variantes) cobrindo emissão de NF-e, NFS-e, recepção, escrituração de ICMS/IPI, EFD Contribuições, ECD, ECF, Reinf, eSocial. É um conjunto extenso, vendido em pacotes, com customizações específicas por cliente acumuladas em ADVPL — a linguagem proprietária da TOTVS — ao longo dos anos.
Os pontos de atrito que mais aparecem em projetos de migração:
- Customizações em ADVPL acumuladas ao longo dos anos, frequentemente sem documentação atualizada.
- Atualizações de pacote dependentes do ciclo de release da TOTVS, que nem sempre acompanha o ritmo da Receita (ver EFD ICMS/IPI layout 20 sobre os ciclos curtos de atualização).
- Custo de licença por usuário e módulo — em empresas que cresceram, a fatura mensal do Protheus virou item de revisão orçamentária.
- Integrações que viraram caixa-preta — folha, fiscal, financeiro tudo amarrado, difícil isolar e migrar por etapas.
O que o Odoo+OCA cobre, equivalente por equivalente
A localização brasileira da OCA — onde a KMEE contribui há mais de 14 anos, ao lado de outras consultorias da comunidade — cobre o conjunto fiscal completo:
- NF-e (modelo 55) e NF-e Consumidor (modelo 65) com Focus NFe ou outros providers, emissão e recepção.
- NFS-e com integração ABRASF e providers para municípios fora do padrão (ver NFS-e: por que cada município tem padrão próprio).
- CT-e e MDF-e para empresas de transporte e logística.
- EFD ICMS/IPI com layouts atualizados em ciclo aberto (PRs públicos).
- EFD Contribuições (PIS/COFINS) — o módulo
l10n_br_sped_efd_pis_cofinssubstitui a planilha do contador (ver EFD Contribuições no Odoo+OCA). - ECD e ECF geradas a partir do plano de contas referencial e da contabilidade do exercício.
- eSocial e Reinf via módulos OCA específicos. A KMEE construiu folha de pagamento completa para a ABGF, que roda Odoo 8.0 em produção até hoje, justamente porque a complexidade fiscal brasileira exige profundidade — não dá para “amarrar com fita crepe”.
- DCTF, DIRF, DASN, DEFIS dependendo do regime — cobertura modular.
O que muda na prática
Modelo de dados unificado
No Protheus, NF-e tem uma tabela, escrituração tem outra, financeiro tem outra, contabilidade tem outra. Há ligação, mas é via chaves de aplicação, não relacional puro. No Odoo, a nota fiscal é o documento contábil — account.move é a base. Isso simplifica tudo: cancelamento de nota baixa o lançamento contábil automaticamente, ajuste de nota propaga para a EFD, etc.
Atualização contínua sem licença adicional
Layout 20 da EFD ICMS/IPI? PR aberto na OCA. NT 2025/001 da NF-e (Reforma Tributária)? Em desenvolvimento na comunidade. Você acompanha o trabalho, roda o branch de homologação meses antes da virada, e sobe pra produção quando estiver maduro. Sem aguardar pacote, sem licença extra.
Customizações em Python, não em ADVPL
Toda a comunidade de desenvolvedores Python ativa pode trabalhar no seu Odoo. ADVPL tem nicho restrito à TOTVS — quando o desenvolvedor sai, sua customização vira risco. Em Python, o pool de talento é praticamente todo o mercado de TI brasileiro.
O cuidado com os XMLs antigos
Aqui está o ponto técnico mais importante de qualquer migração: os XMLs de NF-e emitidos pelo Protheus precisam ser preservados. A guarda fiscal é de cinco anos a contar do exercício seguinte, e você vai precisar deles em fiscalização.
Recomendamos:
- Exportar todos os XMLs (autorizados, cancelados, denegados) do Protheus antes do desligamento, em estrutura de pastas por CNPJ/ano/mês.
- Importar como anexos na base Odoo, vinculados ao
account.movecorrespondente — mesmo que o lançamento contábil esteja apenas como saldo de abertura, o XML fica acessível. - Manter o histórico de eventos (cancelamento, carta de correção, manifestação do destinatário) — eles fazem parte do dossiê fiscal.
- Documentar a transição — em qual data a emissão passou do Protheus para o Odoo, quais séries foram fechadas no antigo e quais começaram no novo.
Prazo realista
Para uma empresa de porte médio (R$ 50-300M de faturamento, Lucro Real, multi-CNPJ moderado, operação industrial ou distribuidora), nossa recomendação:
- 3 meses de levantamento — mapear customizações ativas, identificar quais são essenciais, quais são lixo acumulado, quais viram OCA, quais viram custom.
- 6 meses de implementação — base Odoo configurada, dados mestres migrados, paralelo fiscal rodando.
- 3 meses de paralelo real — emissão real em Odoo, conferência mensal contra Protheus, ajustes finos.
- Cutover em virada de exercício — janeiro é ideal porque fecha exercício no antigo e abre no novo.
Total: 12 meses do “vamos migrar” até o “não usamos mais Protheus”. Quem promete em 4 meses está cortando coisa que vai aparecer depois — frequentemente em fiscalização.
Veja Odoo vs TOTVS para a comparação estrutural completa, e fale com nosso time pela página de contato se quer revisar a viabilidade de migração da sua empresa.
Sobre o autor
Luis Felipe Miléo
Desenvolvedor Odoo · KMEE
Desenvolvedor especializado em localização fiscal e projetos open source no ecossistema Odoo/OCA, com foco em integrações para o mercado latino-americano.
Ver perfil no LinkedInArtigos relacionados
Open Finance regulado vs APIs proprietárias: qual usar para cada caso
7 de jul. de 2026
Gestão EmpresarialDDA no Odoo: contas a pagar 100% automatizadas
30 de jun. de 2026
Gestão EmpresarialTOTVS está descontinuando sua API bancária — Odoo é a alternativa neutra
9 de jun. de 2026