Pular para o conteúdo
KMEEEntrar

Localização brasileira, cadastros básicos

  • Módulo l10n_br_base
  • Origem: OCA
  • Localização brasileira
  • Licença AGPL-3
  • Odoo 18.0

Adapta os cadastros de contatos, empresas e endereços ao padrão brasileiro. Acrescenta CNPJ e CPF com máscara e validação, inscrição estadual validada conforme o estado, razão social, inscrição municipal, Suframa e endereço com número, bairro e município. Também traz as tabelas de municípios, estados com código IBGE e bancos brasileiros, além das chaves PIX nas contas bancárias.

Quando usar

  • Em toda base que cadastre empresas, clientes ou fornecedores brasileiros, como ponto de partida da localização brasileira.
  • Para barrar CNPJ, CPF ou inscrição estadual inválidos e evitar contatos duplicados com o mesmo documento.
  • Para registrar endereços no formato brasileiro, escolhendo o município na tabela oficial.
  • Para cadastrar contas bancárias de contatos e da própria empresa, com agência, dígitos e chaves PIX.
  • Para cadastrar CNPJ com letras e números, no formato novo, com máscara aplicada ao salvar.

Como configurar

  1. Abra Definições > Usuários e Empresas > Empresas e preencha o país Brasil, o endereço, a Razão Social, o CNPJ e a inscrição estadual da empresa.
  2. Em Definições > Configurações gerais, na seção Localização Brasileira, escolha se aceita Múltiplos parceiros com mesmo CNPJ e se desliga alguma validação de documento.
  3. Na mesma seção, marque Utilizar API de consulta de CEP dos Correios para preencher o endereço a partir do CEP; a opção instala um complemento.
  4. No Contatos, clique em Novo, marque Empresa ou Individual e preencha Razão Social ou Nome Completo, CNPJ/CPF, IE, Estado e Cidade.
  5. Na aba Fiscal do contato, informe a inscrição municipal, o Suframa e as inscrições estaduais de outros estados.
  6. Cadastre contas bancárias e chaves PIX em Contatos > Configuração > Contas bancárias > Contas bancárias.

Cuidados

  • O formulário de endereço brasileiro e os campos de documento aparecem quando o país da empresa é o Brasil. Configure a empresa antes de cadastrar contatos.
  • CNPJ ou CPF repetido impede gravar o contato. Para filiais com o mesmo CNPJ e inscrições estaduais diferentes, ative Múltiplos parceiros com mesmo CNPJ.
  • As opções Desabilitar validação de CPF e CNPJ e Desabilitar validação de IE valem para toda a base e permitem gravar documentos inválidos. Use em situações pontuais, como a carga de dados antigos.
  • A inscrição estadual é validada nos contatos marcados como empresa, com o estado informado. Os textos ISENTO ou ISENTA são aceitos.
  • Quando o documento é recusado, o Odoo mostra um aviso ao salvar e o contato só é salvo depois da correção.

Veja na prática

Cenários do manual que usam este módulo, do começo ao fim, com exemplo calculado, passo a passo e vídeo curto com legendas.

Módulos relacionados

Código e fontes