# Localização brasileira, cadastros básicos

> Adapta os cadastros de contatos, empresas e endereços ao padrão brasileiro. Módulo l10n_br_base no Odoo 18: quando usar, como configurar e cuidados.

Fonte: https://docs.kmee.com.br/odoo/18.0/modulos/localizacao-brasileira/l10n-br-base/

- 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.

- [Importar cadastros em lote](https://docs.kmee.com.br/odoo/18.0/localizacoes/brasil/administracao/importar-clientes-e-fornecedores-em-lote/) Vídeo de 1 min
- [Importar clientes e fornecedores com ID externo e atualizá-los na virada](https://docs.kmee.com.br/odoo/18.0/localizacoes/brasil/implantacao/importar-e-atualizar-cadastros-por-id-externo/) Vídeo de 2 min
- [Cadastrar cliente contribuinte de ICMS](https://docs.kmee.com.br/odoo/18.0/localizacoes/brasil/cadastros/cadastrar-cliente-contribuinte-de-icms/) Vídeo de 2 min
- [Cadastrar cliente não contribuinte ou isento](https://docs.kmee.com.br/odoo/18.0/localizacoes/brasil/cadastros/cadastrar-cliente-nao-contribuinte-ou-isento/) Vídeo de 2 min
- [Cadastrar consumidor final pessoa física](https://docs.kmee.com.br/odoo/18.0/localizacoes/brasil/cadastros/cadastrar-consumidor-final-pessoa-fisica/) Vídeo de 2 min
- [Cadastrar órgão público ou ente estatal](https://docs.kmee.com.br/odoo/18.0/localizacoes/brasil/cadastros/cadastrar-orgao-publico/) Vídeo de 2 min
- [Consultar e validar CNPJ e inscrição estadual](https://docs.kmee.com.br/odoo/18.0/localizacoes/brasil/cadastros/consultar-cnpj-e-inscricao-estadual/) Vídeo de 2 min
- [Cadastrar parceiro com CNPJ alfanumérico](https://docs.kmee.com.br/odoo/18.0/localizacoes/brasil/cadastros/cadastrar-parceiro-com-cnpj-alfanumerico/) Vídeo de 2 min
- [Registrar um lead e convertê-lo em oportunidade e cliente](https://docs.kmee.com.br/odoo/18.0/localizacoes/brasil/crm/registrar-lead-e-converter-em-oportunidade/) Vídeo de 3 min

## Módulos relacionados

- [Consulta de CNPJ na Receita](https://docs.kmee.com.br/odoo/18.0/modulos/localizacao-brasileira/l10n-br-cnpj-search/)
- [Consulta de inscrição estadual](https://docs.kmee.com.br/odoo/18.0/modulos/localizacao-brasileira/l10n-br-ie-search/)
- [Motor fiscal brasileiro](https://docs.kmee.com.br/odoo/18.0/modulos/localizacao-brasileira/l10n-br-fiscal/)
- [Faturas com documento fiscal brasileiro](https://docs.kmee.com.br/odoo/18.0/modulos/localizacao-brasileira/l10n-br-account/)
- [Importação de planilhas](https://docs.kmee.com.br/odoo/18.0/modulos/administracao/base-import/)

## Código e fontes

- Código-fonte: [OCA/l10n-brazil](https://github.com/OCA/l10n-brazil)
- [Documentação do módulo na OCA (18.0)](https://github.com/OCA/l10n-brazil/tree/18.0/l10n_br_base)