Como funciona a localização brasileira do Odoo?
O Odoo é uma plataforma internacional. Para ser utilizado por uma empresa brasileira, ele precisa incorporar cadastros, regras fiscais, documentos eletrônicos, relatórios e particularidades que não existem da mesma forma em outros países.
Esse conjunto de adaptações é conhecido como localização brasileira do Odoo.
Atualmente, existem diferentes arquiteturas para atender essa necessidade. A Odoo mantém sua própria localização fiscal brasileira, com recursos oficiais e integração com a Avalara. Paralelamente, a Odoo Community Association mantém o projeto aberto OCA/l10n-brazil, formado por diversos módulos comunitários.
Essas abordagens não devem ser tratadas como se fossem o mesmo pacote. Cada uma possui componentes, dependências, modelos de manutenção, custos e níveis de cobertura próprios.
Resposta direta: o que é a localização brasileira?
A localização brasileira é uma camada de módulos que adapta o Odoo às necessidades cadastrais, fiscais, contábeis, financeiras e documentais das empresas que operam no país.
Ela pode incluir:
CNPJ e CPF, inscrições estaduais e municipais, endereços brasileiros, plano de contas, tributos, posições fiscais, classificações de produtos e serviços, documentos eletrônicos, certificados digitais, cobrança bancária, pagamentos, SPED e relatórios.
Instalar um módulo chamado l10n_br é o início da configuração. Não é a confirmação de que toda a operação brasileira está pronta.
A cobertura efetiva depende da edição do Odoo, da versão, dos módulos selecionados, dos serviços integrados e dos processos que a empresa precisa executar.
O que significa l10n_br?
Na nomenclatura utilizada pelo Odoo, l10n é uma abreviação de localization, ou localização. O sufixo br identifica o Brasil.
Por isso, módulos brasileiros costumam utilizar nomes técnicos iniciados por l10n_br.
Entretanto, o mesmo prefixo aparece em componentes de ecossistemas diferentes. Existe o módulo principal da localização mantida pela Odoo e existem diversos módulos no projeto OCA/l10n-brazil.
O nome técnico, sozinho, não informa toda a arquitetura.
Por que o Odoo precisa de uma localização para cada país?
O núcleo do Odoo oferece recursos genéricos para vendas, compras, estoque, financeiro, projetos e outras áreas.
Mas cada país possui regras próprias para:
Plano de contas, identificação de empresas, tributos, declarações, relatórios, documentos eletrônicos, formas de pagamento e obrigações legais.
A localização fiscal instala ou disponibiliza estruturas específicas para o país da empresa.
No Odoo, o pacote principal pode ser selecionado com base no país cadastrado. Em ambientes multiempresa, cada empresa pode utilizar uma localização fiscal diferente, enquanto filiais seguem a localização da empresa principal.
A escolha precisa ser feita antes de contabilizar lançamentos, porque alterar a localização depois que a operação começou pode exigir ajustes complexos.
Quais são os dois principais caminhos no Brasil?
| Abordagem | Características | Modelo de manutenção |
|---|---|---|
| Localização mantida pela Odoo | Módulos oficiais, plano de contas, impostos, relatórios e integração fiscal documentada com a Avalara | Evolução pela Odoo e pelos serviços integrados, conforme edição e plano contratado |
| Localização OCA/l10n-brazil | Ecossistema comunitário com módulos para base, fiscal, contabilidade, vendas, compras, estoque, documentos eletrônicos e integrações | Desenvolvimento aberto e colaborativo por empresas e profissionais da comunidade |
| Arquitetura combinada | Uso de componentes compatíveis de diferentes origens, integrações externas e módulos próprios | Exige análise técnica de modelos, dependências, licenças e responsabilidades |
A arquitetura combinada não significa instalar todos os pacotes simultaneamente.
Componentes diferentes podem representar conceitos fiscais de maneiras distintas. Por isso, compatibilidade precisa ser comprovada por versão e processo.
Como funciona a localização mantida pela Odoo?
Na versão atual, a documentação oficial apresenta o módulo principal l10n_br como o pacote fiscal brasileiro.
Ele inclui estruturas como:
Plano de contas brasileiro, impostos, relatório fiscal, posições fiscais, tipos de documentos e tipos de identificação.
Existem também módulos adicionais para relatórios, vendas, estoque, ponto de venda, e-commerce e documentos eletrônicos.
Para cálculo de impostos e processamento de documentos como NF-e e NFS-e, a solução oficial utiliza a integração AvaTax Brasil, da Avalara.
Essa integração utiliza créditos de compras dentro do aplicativo para ações de cálculo e processamento de documentos.
Na arquitetura oficial, a localização do Odoo organiza o processo empresarial e a Avalara participa do cálculo tributário e da comunicação fiscal.
O que a localização oficial configura?
Plano de contas
O pacote disponibiliza uma estrutura contábil baseada no plano de contas do SPED, que serve como ponto de partida para a configuração da empresa.
Isso não dispensa a revisão da contabilidade. Contas, grupos, diários e relatórios precisam estar alinhados ao modelo contábil utilizado pela organização.
Impostos
Impostos são criados com a instalação da localização e podem ser utilizados pela integração AvaTax.
A configuração precisa respeitar regime tributário, tipo de contribuinte, produtos, serviços e operações.
Posições fiscais
Posições fiscais ajudam a selecionar ou mapear regras tributárias e contas conforme características da transação.
Na integração oficial brasileira, elas também participam da identificação das operações que utilizarão o AvaTax.
Cadastros brasileiros
Empresas e contatos precisam conter dados como CNPJ ou CPF, inscrições, endereços, município, estado, regime fiscal e tipo de contribuinte.
Produtos e serviços
Podem ser necessários NCM, CEST, origem da mercadoria, tipo fiscal do produto, finalidade de uso, códigos de serviço e outras classificações.
Documentos eletrônicos
Módulos de EDI conectam faturas, vendas, estoque, ponto de venda e e-commerce ao processamento dos documentos fiscais suportados.
Qual é o papel da Avalara?
A Avalara é o serviço fiscal integrado à localização oficial atual do Odoo para o Brasil.
Ela pode participar de:
Cálculo de tributos sobre mercadorias e serviços, processamento de NF-e e NFS-e, validações fiscais e comunicação com os ambientes autorizadores.
Para utilizar a integração, normalmente são necessários:
Conta configurada, certificado digital A1, dados cadastrais completos, posição fiscal, mapeamento de impostos e classificação dos produtos ou serviços.
As ações consomem créditos do serviço. Por isso, o custo por transação e o volume esperado precisam entrar no cálculo do custo total da solução.
Como funciona a localização da OCA?
O projeto OCA/l10n-brazil é um conjunto aberto de módulos mantido por empresas e profissionais da comunidade.
Na versão 18.0, o repositório reúne componentes para áreas como:
Cadastros brasileiros, motor fiscal, certificados A1, contabilidade, contas a pagar e receber, ordens de pagamento, CRM, vendas, compras, estoque, NF-e, NFS-e, distribuição de documentos fiscais, SPED, recursos humanos e relatórios.
Os módulos são separados por responsabilidade. Uma implantação pode utilizar apenas o conjunto necessário ao seu escopo.
Essa modularidade oferece flexibilidade, mas também exige controle sobre dependências, versões e manutenção.
O projeto OCA não é um módulo único de localização. É uma arquitetura formada por diferentes componentes que precisam ser selecionados e configurados.
Principais camadas do OCA/l10n-brazil
| Camada | Exemplos de módulos | Objetivo |
|---|---|---|
| Base cadastral | l10n_br_base, l10n_br_zip, buscas de CNPJ e IE | Adicionar informações e estruturas utilizadas por empresas brasileiras |
| Motor fiscal | l10n_br_fiscal | Representar operações, impostos, regras e documentos fiscais |
| Certificados e EDI | l10n_br_fiscal_certificate, l10n_br_fiscal_edi | Gerenciar certificado A1 e recursos comuns de documentos eletrônicos |
| Contabilidade e financeiro | l10n_br_account, planos de contas, ordens de pagamento | Adaptar lançamentos, contas, pagamentos e relatórios |
| Vendas e compras | l10n_br_sale, l10n_br_purchase | Levar informações fiscais aos processos comerciais e de aquisição |
| Estoque | l10n_br_stock, l10n_br_stock_account | Relacionar documentos, remessas, entregas e movimentações |
| NF-e | l10n_br_nfe e módulos de especificação | Gerar, transmitir, importar e processar a Nota Fiscal Eletrônica |
| NFS-e | l10n_br_nfse e transmissores específicos | Representar a nota de serviços e integrar com o provedor escolhido |
| Documentos recebidos | l10n_br_fiscal_dfe | Consultar e tratar a distribuição de documentos fiscais eletrônicos |
| SPED e relatórios | l10n_br_sped_base, l10n_br_mis_report | Fornecer bases e relatórios para necessidades brasileiras |
A disponibilidade dos módulos muda entre versões. Um componente presente na versão 18 pode ainda estar em migração para a versão seguinte.
Antes de escolher uma versão do Odoo, é necessário verificar se os módulos críticos já estão disponíveis e maduros.
Motor fiscal: por que ele é importante?
O Brasil possui tributos e classificações que dependem de produto, parceiro, origem, destino, regime, finalidade e tipo de operação.
Um motor fiscal organiza essas condições para selecionar regras aplicáveis às linhas de venda, compra e documentos.
No ecossistema OCA, o módulo fiscal estrutura conceitos como:
Operações fiscais, linhas de operação, impostos, enquadramentos, classificações e documentos fiscais.
A parametrização precisa transformar as regras definidas pela empresa e por seus responsáveis fiscais em critérios reproduzíveis pelo sistema.
Documentos eletrônicos fazem parte da localização?
Sim, mas cada documento exige componentes e homologações próprios.
NF-e
Documenta operações com mercadorias e depende de regras, certificado, XML, assinatura, SEFAZ, eventos e DANFE.
NFS-e
Documenta serviços e pode depender de município, padrão nacional, provedor, códigos de serviço, ISS e retenções.
CT-e e MDF-e
Possuem modelos e layouts próprios relacionados ao transporte. A existência de componentes de especificação não significa automaticamente que um fluxo completo de emissão esteja disponível para qualquer operação.
Documentos recebidos
A localização também pode tratar consulta, manifestação, importação e vínculo de documentos emitidos por fornecedores.
A cobertura fiscal precisa ser validada documento por documento, evento por evento e versão por versão.
Localização brasileira é apenas fiscal?
Não.
Embora o fiscal seja a parte mais visível, a localização também pode adaptar:
Cadastros, endereços, calendários, recursos humanos, CRM, contratos, pagamentos, cobrança, estoque, relatórios e portais.
Um endereço brasileiro, por exemplo, precisa representar corretamente CEP, município, estado, bairro e códigos utilizados em integrações.
O cadastro de uma empresa precisa diferenciar CNPJ, CPF, inscrições e regimes.
Essas informações alimentam processos fiscais, bancários, logísticos e comerciais.
Community ou Enterprise muda a localização?
Sim.
Na edição Enterprise, a empresa pode utilizar a localização mantida pela Odoo e os serviços oficiais associados.
Em projetos Community, é comum utilizar o ecossistema OCA/l10n-brazil, além de integrações e módulos próprios.
Projetos Enterprise também podem utilizar componentes da OCA quando houver compatibilidade técnica e de licenciamento.
A decisão deve considerar:
Cobertura funcional, custo recorrente, autonomia, maturidade dos módulos, suporte, hospedagem, atualizações e capacidade da equipe responsável.
É possível misturar localização oficial e OCA?
Em alguns cenários, componentes podem coexistir ou utilizar módulos de compatibilidade.
Entretanto, isso não deve ser decidido apenas pela instalação de dependências.
As duas arquiteturas podem representar cadastros, impostos e documentos de formas diferentes. Uma combinação precisa avaliar:
Modelos de dados, campos, dependências, licenças, eventos fiscais, integrações, manutenção e estratégia de migração.
Uma prova de conceito pode ser necessária quando o projeto depende de componentes de ambos os ecossistemas.
Compatibilidade técnica não é apenas conseguir instalar. É garantir que o processo completo continue coerente e sustentável.
O que a localização não resolve automaticamente?
Definição tributária
O sistema não substitui a análise contábil e fiscal sobre a operação da empresa.
Cadastros inconsistentes
Produtos sem NCM, parceiros sem inscrição ou serviços sem classificação continuam gerando problemas.
Processos não mapeados
Devoluções, remessas, industrialização, triangulação, retenções e operações especiais precisam ser analisadas.
Homologação
Módulos instalados ainda precisam ser configurados e testados com os cenários reais.
Manutenção futura
Notas técnicas, schemas, legislação, APIs e regras mudam. Alguém precisa acompanhar essa evolução.
Obrigações não cobertas
Nem toda obrigação acessória ou particularidade está pronta em todas as versões e arquiteturas.
Como implantar a localização brasileira?
Uma implantação segura pode seguir as seguintes etapas:
1. Mapear as operações
Identificar vendas, compras, serviços, transportes, devoluções, remessas, importações e outros cenários.
2. Definir os documentos
Listar NF-e, NFS-e, NFC-e, CT-e, MDF-e e documentos recebidos que fazem parte do escopo.
3. Avaliar a arquitetura
Comparar localização oficial, OCA, provedores externos e desenvolvimentos necessários.
4. Preparar cadastros
Sanear empresas, contatos, produtos, serviços, classificações, certificados e dados bancários.
5. Configurar regras
Implementar posições fiscais, operações, impostos, contas, sequências e parâmetros.
6. Homologar cenários
Executar operações reais em ambiente de teste e conferir documentos, estoque, financeiro e contabilidade.
7. Planejar o go-live
Definir certificado, séries, numeração, saldos, responsabilidades e plano de contingência.
8. Manter e evoluir
Acompanhar mudanças legais, atualizações dos módulos, integrações e novas versões do Odoo.
O que verificar antes de contratar?
| Pergunta | Por que importa |
|---|---|
| Qual localização será utilizada? | Define arquitetura, custos, dependências e manutenção |
| Quais módulos fazem parte do escopo? | Evita a promessa genérica de “localização completa” |
| Quais documentos estão cobertos? | NF-e, NFS-e, CT-e e MDF-e possuem caminhos diferentes |
| Quais municípios e estados foram avaliados? | Existem particularidades de serviços e operações regionais |
| Existe custo por transação? | Provedores e serviços fiscais podem cobrar pelo consumo |
| Quem define a tributação? | A responsabilidade fiscal precisa envolver a empresa e seus especialistas |
| Como será a homologação? | Os cenários precisam ser testados antes do go-live |
| Quem manterá a solução? | A legislação e os componentes continuarão mudando |
O impacto da reforma tributária
A reforma tributária amplia a importância de uma localização bem estruturada.
Novos tributos, classificações, campos, documentos e períodos de transição precisam chegar a diferentes camadas do ERP.
As mudanças podem afetar:
Cadastros, motor fiscal, pedidos, faturas, documentos eletrônicos, contabilidade, relatórios, integrações e migração de dados.
Uma arquitetura excessivamente fechada ou composta por customizações sem testes pode dificultar a adaptação.
Por isso, a empresa deve avaliar quem acompanhará a legislação, quem desenvolverá os componentes e como as alterações serão homologadas.
A reforma tributária não será resolvida por um único campo novo. Ela exigirá evolução coordenada de processos e software.
A abordagem da Escodoo
A Escodoo atua de forma independente no ecossistema Odoo, com forte orientação ao Odoo Community e aos módulos da OCA.
Nossa equipe participa tecnicamente do projeto OCA/l10n-brazil, contribuindo com módulos, migrações, correções e discussões relacionadas à localização brasileira.
Nos projetos, avaliamos:
Versão do Odoo, edição, maturidade dos módulos, documentos necessários, municípios, estados, regras fiscais, integrações, infraestrutura e estratégia de manutenção.
Quando o cenário exige, também analisamos a combinação com componentes Enterprise ou serviços fiscais externos, desde que exista compatibilidade e benefício para a operação.
Perguntas frequentes
Odoo já vem pronto para o Brasil?
O Odoo possui pacotes e módulos brasileiros, mas eles precisam ser selecionados, configurados e homologados conforme a empresa.
Instalar l10n_br permite emitir nota fiscal?
Não automaticamente. A emissão depende de módulos de documentos eletrônicos, integração fiscal, certificado, dados completos e regras configuradas.
A localização brasileira funciona no Community?
Sim. Projetos Community podem utilizar os módulos do OCA/l10n-brazil e integrações compatíveis.
A localização da Odoo e a OCA são iguais?
Não. São arquiteturas diferentes, mantidas por organizações diferentes e com componentes próprios.
Posso usar OCA no Enterprise?
Em muitos cenários, sim, desde que os módulos sejam compatíveis com a versão, as dependências e as licenças utilizadas.
A localização inclui NF-e e NFS-e?
Existem soluções para esses documentos nos dois ecossistemas, mas a cobertura precisa ser validada conforme arquitetura, versão, operação e município.
A localização calcula automaticamente todos os impostos?
Ela fornece estruturas e mecanismos, mas as regras precisam ser corretamente definidas, configuradas e validadas.
A localização contempla toda obrigação brasileira?
Não se deve presumir cobertura integral. Cada obrigação, documento e processo precisa fazer parte explícita do escopo.
Quem deve validar as regras fiscais?
A empresa e seus responsáveis contábeis ou fiscais devem definir e validar as regras. A equipe de implantação configura e desenvolve a solução técnica.
Conclusão: localização brasileira é uma arquitetura, não uma caixa de seleção
A localização brasileira permite transformar o Odoo em uma plataforma adequada aos cadastros, tributos, documentos e processos do país.
Entretanto, não existe uma única instalação que resolva automaticamente todos os cenários.
A localização mantida pela Odoo oferece uma arquitetura oficial integrada à Avalara. A OCA mantém um ecossistema aberto e modular, com ampla cobertura de componentes brasileiros.
A melhor escolha depende da edição, dos documentos, das operações, do custo, da autonomia e da capacidade de manutenção.
Antes de iniciar o projeto, a empresa deve exigir uma definição clara dos módulos, serviços, limitações, responsabilidades e cenários de homologação.
Precisa implantar a localização brasileira no Odoo?
A Escodoo atua na análise, implantação, desenvolvimento e manutenção de projetos Odoo no Brasil.
Combinamos módulos da OCA, motor fiscal, documentos eletrônicos, integrações, desenvolvimento em Python e governança técnica para atender às necessidades da sua operação.
Fale com nossa equipe e apresente os documentos, estados, municípios e processos que precisam ser atendidos.
Avaliar minha localização OdooComo funciona a localização brasileira do Odoo?
O Odoo é uma plataforma internacional. Para ser utilizado por uma empresa brasileira, ele precisa incorporar cadastros, regras fiscais, documentos eletrônicos, relatórios e particularidades que não existem da mesma forma em outros países.
Esse conjunto de adaptações é conhecido como localização brasileira do Odoo.
Atualmente, existem diferentes arquiteturas para atender essa necessidade. A Odoo mantém sua própria localização fiscal brasileira, com recursos oficiais e integração com a Avalara. Paralelamente, a Odoo Community Association mantém o projeto aberto OCA/l10n-brazil, formado por diversos módulos comunitários.
Essas abordagens não devem ser tratadas como se fossem o mesmo pacote. Cada uma possui componentes, dependências, modelos de manutenção, custos e níveis de cobertura próprios.
Resposta direta: o que é a localização brasileira?
A localização brasileira é uma camada de módulos que adapta o Odoo às necessidades cadastrais, fiscais, contábeis, financeiras e documentais das empresas que operam no país.
Ela pode incluir:
CNPJ e CPF, inscrições estaduais e municipais, endereços brasileiros, plano de contas, tributos, posições fiscais, classificações de produtos e serviços, documentos eletrônicos, certificados digitais, cobrança bancária, pagamentos, SPED e relatórios.
Instalar um módulo chamado l10n_br é o início da configuração. Não é a confirmação de que toda a operação brasileira está pronta.
A cobertura efetiva depende da edição do Odoo, da versão, dos módulos selecionados, dos serviços integrados e dos processos que a empresa precisa executar.
O que significa l10n_br?
Na nomenclatura utilizada pelo Odoo, l10n é uma abreviação de localization, ou localização. O sufixo br identifica o Brasil.
Por isso, módulos brasileiros costumam utilizar nomes técnicos iniciados por l10n_br.
Entretanto, o mesmo prefixo aparece em componentes de ecossistemas diferentes. Existe o módulo principal da localização mantida pela Odoo e existem diversos módulos no projeto OCA/l10n-brazil.
O nome técnico, sozinho, não informa toda a arquitetura.
Por que o Odoo precisa de uma localização para cada país?
O núcleo do Odoo oferece recursos genéricos para vendas, compras, estoque, financeiro, projetos e outras áreas.
Mas cada país possui regras próprias para:
Plano de contas, identificação de empresas, tributos, declarações, relatórios, documentos eletrônicos, formas de pagamento e obrigações legais.
A localização fiscal instala ou disponibiliza estruturas específicas para o país da empresa.
No Odoo, o pacote principal pode ser selecionado com base no país cadastrado. Em ambientes multiempresa, cada empresa pode utilizar uma localização fiscal diferente, enquanto filiais seguem a localização da empresa principal.
A escolha precisa ser feita antes de contabilizar lançamentos, porque alterar a localização depois que a operação começou pode exigir ajustes complexos.
Quais são os dois principais caminhos no Brasil?
| Abordagem | Características | Modelo de manutenção |
|---|---|---|
| Localização mantida pela Odoo | Módulos oficiais, plano de contas, impostos, relatórios e integração fiscal documentada com a Avalara | Evolução pela Odoo e pelos serviços integrados, conforme edição e plano contratado |
| Localização OCA/l10n-brazil | Ecossistema comunitário com módulos para base, fiscal, contabilidade, vendas, compras, estoque, documentos eletrônicos e integrações | Desenvolvimento aberto e colaborativo por empresas e profissionais da comunidade |
| Arquitetura combinada | Uso de componentes compatíveis de diferentes origens, integrações externas e módulos próprios | Exige análise técnica de modelos, dependências, licenças e responsabilidades |
A arquitetura combinada não significa instalar todos os pacotes simultaneamente.
Componentes diferentes podem representar conceitos fiscais de maneiras distintas. Por isso, compatibilidade precisa ser comprovada por versão e processo.
Como funciona a localização mantida pela Odoo?
Na versão atual, a documentação oficial apresenta o módulo principal l10n_br como o pacote fiscal brasileiro.
Ele inclui estruturas como:
Plano de contas brasileiro, impostos, relatório fiscal, posições fiscais, tipos de documentos e tipos de identificação.
Existem também módulos adicionais para relatórios, vendas, estoque, ponto de venda, e-commerce e documentos eletrônicos.
Para cálculo de impostos e processamento de documentos como NF-e e NFS-e, a solução oficial utiliza a integração AvaTax Brasil, da Avalara.
Essa integração utiliza créditos de compras dentro do aplicativo para ações de cálculo e processamento de documentos.
Na arquitetura oficial, a localização do Odoo organiza o processo empresarial e a Avalara participa do cálculo tributário e da comunicação fiscal.
O que a localização oficial configura?
Plano de contas
O pacote disponibiliza uma estrutura contábil baseada no plano de contas do SPED, que serve como ponto de partida para a configuração da empresa.
Isso não dispensa a revisão da contabilidade. Contas, grupos, diários e relatórios precisam estar alinhados ao modelo contábil utilizado pela organização.
Impostos
Impostos são criados com a instalação da localização e podem ser utilizados pela integração AvaTax.
A configuração precisa respeitar regime tributário, tipo de contribuinte, produtos, serviços e operações.
Posições fiscais
Posições fiscais ajudam a selecionar ou mapear regras tributárias e contas conforme características da transação.
Na integração oficial brasileira, elas também participam da identificação das operações que utilizarão o AvaTax.
Cadastros brasileiros
Empresas e contatos precisam conter dados como CNPJ ou CPF, inscrições, endereços, município, estado, regime fiscal e tipo de contribuinte.
Produtos e serviços
Podem ser necessários NCM, CEST, origem da mercadoria, tipo fiscal do produto, finalidade de uso, códigos de serviço e outras classificações.
Documentos eletrônicos
Módulos de EDI conectam faturas, vendas, estoque, ponto de venda e e-commerce ao processamento dos documentos fiscais suportados.
Qual é o papel da Avalara?
A Avalara é o serviço fiscal integrado à localização oficial atual do Odoo para o Brasil.
Ela pode participar de:
Cálculo de tributos sobre mercadorias e serviços, processamento de NF-e e NFS-e, validações fiscais e comunicação com os ambientes autorizadores.
Para utilizar a integração, normalmente são necessários:
Conta configurada, certificado digital A1, dados cadastrais completos, posição fiscal, mapeamento de impostos e classificação dos produtos ou serviços.
As ações consomem créditos do serviço. Por isso, o custo por transação e o volume esperado precisam entrar no cálculo do custo total da solução.
Como funciona a localização da OCA?
O projeto OCA/l10n-brazil é um conjunto aberto de módulos mantido por empresas e profissionais da comunidade.
Na versão 18.0, o repositório reúne componentes para áreas como:
Cadastros brasileiros, motor fiscal, certificados A1, contabilidade, contas a pagar e receber, ordens de pagamento, CRM, vendas, compras, estoque, NF-e, NFS-e, distribuição de documentos fiscais, SPED, recursos humanos e relatórios.
Os módulos são separados por responsabilidade. Uma implantação pode utilizar apenas o conjunto necessário ao seu escopo.
Essa modularidade oferece flexibilidade, mas também exige controle sobre dependências, versões e manutenção.
O projeto OCA não é um módulo único de localização. É uma arquitetura formada por diferentes componentes que precisam ser selecionados e configurados.
Principais camadas do OCA/l10n-brazil
| Camada | Exemplos de módulos | Objetivo |
|---|---|---|
| Base cadastral | l10n_br_base, l10n_br_zip, buscas de CNPJ e IE | Adicionar informações e estruturas utilizadas por empresas brasileiras |
| Motor fiscal | l10n_br_fiscal | Representar operações, impostos, regras e documentos fiscais |
| Certificados e EDI | l10n_br_fiscal_certificate, l10n_br_fiscal_edi | Gerenciar certificado A1 e recursos comuns de documentos eletrônicos |
| Contabilidade e financeiro | l10n_br_account, planos de contas, ordens de pagamento | Adaptar lançamentos, contas, pagamentos e relatórios |
| Vendas e compras | l10n_br_sale, l10n_br_purchase | Levar informações fiscais aos processos comerciais e de aquisição |
| Estoque | l10n_br_stock, l10n_br_stock_account | Relacionar documentos, remessas, entregas e movimentações |
| NF-e | l10n_br_nfe e módulos de especificação | Gerar, transmitir, importar e processar a Nota Fiscal Eletrônica |
| NFS-e | l10n_br_nfse e transmissores específicos | Representar a nota de serviços e integrar com o provedor escolhido |
| Documentos recebidos | l10n_br_fiscal_dfe | Consultar e tratar a distribuição de documentos fiscais eletrônicos |
| SPED e relatórios | l10n_br_sped_base, l10n_br_mis_report | Fornecer bases e relatórios para necessidades brasileiras |
A disponibilidade dos módulos muda entre versões. Um componente presente na versão 18 pode ainda estar em migração para a versão seguinte.
Antes de escolher uma versão do Odoo, é necessário verificar se os módulos críticos já estão disponíveis e maduros.
Motor fiscal: por que ele é importante?
O Brasil possui tributos e classificações que dependem de produto, parceiro, origem, destino, regime, finalidade e tipo de operação.
Um motor fiscal organiza essas condições para selecionar regras aplicáveis às linhas de venda, compra e documentos.
No ecossistema OCA, o módulo fiscal estrutura conceitos como:
Operações fiscais, linhas de operação, impostos, enquadramentos, classificações e documentos fiscais.
A parametrização precisa transformar as regras definidas pela empresa e por seus responsáveis fiscais em critérios reproduzíveis pelo sistema.
Documentos eletrônicos fazem parte da localização?
Sim, mas cada documento exige componentes e homologações próprios.
NF-e
Documenta operações com mercadorias e depende de regras, certificado, XML, assinatura, SEFAZ, eventos e DANFE.
NFS-e
Documenta serviços e pode depender de município, padrão nacional, provedor, códigos de serviço, ISS e retenções.
CT-e e MDF-e
Possuem modelos e layouts próprios relacionados ao transporte. A existência de componentes de especificação não significa automaticamente que um fluxo completo de emissão esteja disponível para qualquer operação.
Documentos recebidos
A localização também pode tratar consulta, manifestação, importação e vínculo de documentos emitidos por fornecedores.
A cobertura fiscal precisa ser validada documento por documento, evento por evento e versão por versão.
Localização brasileira é apenas fiscal?
Não.
Embora o fiscal seja a parte mais visível, a localização também pode adaptar:
Cadastros, endereços, calendários, recursos humanos, CRM, contratos, pagamentos, cobrança, estoque, relatórios e portais.
Um endereço brasileiro, por exemplo, precisa representar corretamente CEP, município, estado, bairro e códigos utilizados em integrações.
O cadastro de uma empresa precisa diferenciar CNPJ, CPF, inscrições e regimes.
Essas informações alimentam processos fiscais, bancários, logísticos e comerciais.
Community ou Enterprise muda a localização?
Sim.
Na edição Enterprise, a empresa pode utilizar a localização mantida pela Odoo e os serviços oficiais associados.
Em projetos Community, é comum utilizar o ecossistema OCA/l10n-brazil, além de integrações e módulos próprios.
Projetos Enterprise também podem utilizar componentes da OCA quando houver compatibilidade técnica e de licenciamento.
A decisão deve considerar:
Cobertura funcional, custo recorrente, autonomia, maturidade dos módulos, suporte, hospedagem, atualizações e capacidade da equipe responsável.
É possível misturar localização oficial e OCA?
Em alguns cenários, componentes podem coexistir ou utilizar módulos de compatibilidade.
Entretanto, isso não deve ser decidido apenas pela instalação de dependências.
As duas arquiteturas podem representar cadastros, impostos e documentos de formas diferentes. Uma combinação precisa avaliar:
Modelos de dados, campos, dependências, licenças, eventos fiscais, integrações, manutenção e estratégia de migração.
Uma prova de conceito pode ser necessária quando o projeto depende de componentes de ambos os ecossistemas.
Compatibilidade técnica não é apenas conseguir instalar. É garantir que o processo completo continue coerente e sustentável.
O que a localização não resolve automaticamente?
Definição tributária
O sistema não substitui a análise contábil e fiscal sobre a operação da empresa.
Cadastros inconsistentes
Produtos sem NCM, parceiros sem inscrição ou serviços sem classificação continuam gerando problemas.
Processos não mapeados
Devoluções, remessas, industrialização, triangulação, retenções e operações especiais precisam ser analisadas.
Homologação
Módulos instalados ainda precisam ser configurados e testados com os cenários reais.
Manutenção futura
Notas técnicas, schemas, legislação, APIs e regras mudam. Alguém precisa acompanhar essa evolução.
Obrigações não cobertas
Nem toda obrigação acessória ou particularidade está pronta em todas as versões e arquiteturas.
Como implantar a localização brasileira?
Uma implantação segura pode seguir as seguintes etapas:
1. Mapear as operações
Identificar vendas, compras, serviços, transportes, devoluções, remessas, importações e outros cenários.
2. Definir os documentos
Listar NF-e, NFS-e, NFC-e, CT-e, MDF-e e documentos recebidos que fazem parte do escopo.
3. Avaliar a arquitetura
Comparar localização oficial, OCA, provedores externos e desenvolvimentos necessários.
4. Preparar cadastros
Sanear empresas, contatos, produtos, serviços, classificações, certificados e dados bancários.
5. Configurar regras
Implementar posições fiscais, operações, impostos, contas, sequências e parâmetros.
6. Homologar cenários
Executar operações reais em ambiente de teste e conferir documentos, estoque, financeiro e contabilidade.
7. Planejar o go-live
Definir certificado, séries, numeração, saldos, responsabilidades e plano de contingência.
8. Manter e evoluir
Acompanhar mudanças legais, atualizações dos módulos, integrações e novas versões do Odoo.
O que verificar antes de contratar?
| Pergunta | Por que importa |
|---|---|
| Qual localização será utilizada? | Define arquitetura, custos, dependências e manutenção |
| Quais módulos fazem parte do escopo? | Evita a promessa genérica de “localização completa” |
| Quais documentos estão cobertos? | NF-e, NFS-e, CT-e e MDF-e possuem caminhos diferentes |
| Quais municípios e estados foram avaliados? | Existem particularidades de serviços e operações regionais |
| Existe custo por transação? | Provedores e serviços fiscais podem cobrar pelo consumo |
| Quem define a tributação? | A responsabilidade fiscal precisa envolver a empresa e seus especialistas |
| Como será a homologação? | Os cenários precisam ser testados antes do go-live |
| Quem manterá a solução? | A legislação e os componentes continuarão mudando |
O impacto da reforma tributária
A reforma tributária amplia a importância de uma localização bem estruturada.
Novos tributos, classificações, campos, documentos e períodos de transição precisam chegar a diferentes camadas do ERP.
As mudanças podem afetar:
Cadastros, motor fiscal, pedidos, faturas, documentos eletrônicos, contabilidade, relatórios, integrações e migração de dados.
Uma arquitetura excessivamente fechada ou composta por customizações sem testes pode dificultar a adaptação.
Por isso, a empresa deve avaliar quem acompanhará a legislação, quem desenvolverá os componentes e como as alterações serão homologadas.
A reforma tributária não será resolvida por um único campo novo. Ela exigirá evolução coordenada de processos e software.
A abordagem da Escodoo
A Escodoo atua de forma independente no ecossistema Odoo, com forte orientação ao Odoo Community e aos módulos da OCA.
Nossa equipe participa tecnicamente do projeto OCA/l10n-brazil, contribuindo com módulos, migrações, correções e discussões relacionadas à localização brasileira.
Nos projetos, avaliamos:
Versão do Odoo, edição, maturidade dos módulos, documentos necessários, municípios, estados, regras fiscais, integrações, infraestrutura e estratégia de manutenção.
Quando o cenário exige, também analisamos a combinação com componentes Enterprise ou serviços fiscais externos, desde que exista compatibilidade e benefício para a operação.
Perguntas frequentes
Odoo já vem pronto para o Brasil?
O Odoo possui pacotes e módulos brasileiros, mas eles precisam ser selecionados, configurados e homologados conforme a empresa.
Instalar l10n_br permite emitir nota fiscal?
Não automaticamente. A emissão depende de módulos de documentos eletrônicos, integração fiscal, certificado, dados completos e regras configuradas.
A localização brasileira funciona no Community?
Sim. Projetos Community podem utilizar os módulos do OCA/l10n-brazil e integrações compatíveis.
A localização da Odoo e a OCA são iguais?
Não. São arquiteturas diferentes, mantidas por organizações diferentes e com componentes próprios.
Posso usar OCA no Enterprise?
Em muitos cenários, sim, desde que os módulos sejam compatíveis com a versão, as dependências e as licenças utilizadas.
A localização inclui NF-e e NFS-e?
Existem soluções para esses documentos nos dois ecossistemas, mas a cobertura precisa ser validada conforme arquitetura, versão, operação e município.
A localização calcula automaticamente todos os impostos?
Ela fornece estruturas e mecanismos, mas as regras precisam ser corretamente definidas, configuradas e validadas.
A localização contempla toda obrigação brasileira?
Não se deve presumir cobertura integral. Cada obrigação, documento e processo precisa fazer parte explícita do escopo.
Quem deve validar as regras fiscais?
A empresa e seus responsáveis contábeis ou fiscais devem definir e validar as regras. A equipe de implantação configura e desenvolve a solução técnica.
Conclusão: localização brasileira é uma arquitetura, não uma caixa de seleção
A localização brasileira permite transformar o Odoo em uma plataforma adequada aos cadastros, tributos, documentos e processos do país.
Entretanto, não existe uma única instalação que resolva automaticamente todos os cenários.
A localização mantida pela Odoo oferece uma arquitetura oficial integrada à Avalara. A OCA mantém um ecossistema aberto e modular, com ampla cobertura de componentes brasileiros.
A melhor escolha depende da edição, dos documentos, das operações, do custo, da autonomia e da capacidade de manutenção.
Antes de iniciar o projeto, a empresa deve exigir uma definição clara dos módulos, serviços, limitações, responsabilidades e cenários de homologação.
Precisa implantar a localização brasileira no Odoo?
A Escodoo atua na análise, implantação, desenvolvimento e manutenção de projetos Odoo no Brasil.
Combinamos módulos da OCA, motor fiscal, documentos eletrônicos, integrações, desenvolvimento em Python e governança técnica para atender às necessidades da sua operação.
Fale com nossa equipe e apresente os documentos, estados, municípios e processos que precisam ser atendidos.
Avaliar minha localização Odoo