# Localização brasileira, cadastros básicos

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

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

- Módulo `l10n_br_base`
- Origem: OCA
- Localização brasileira
- Licença AGPL-3
- Odoo 16.0, 17.0, 18.0

Adapta os cadastros de parceiros, empresas e endereços ao padrão brasileiro. Acrescenta CNPJ e CPF com formatação 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 carrega 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 qualquer base que cadastre empresas, clientes ou fornecedores brasileiros, como ponto de partida da localização brasileira.
- Para impedir o cadastro de CNPJ, CPF ou inscrição estadual inválidos e evitar parceiros duplicados com o mesmo documento.
- Para registrar endereços no formato brasileiro, com escolha do município a partir da tabela oficial.
- Para cadastrar contas bancárias com agência, dígitos e chaves PIX de parceiros e da própria empresa.

## 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, decida se permite 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 se quiser preencher o endereço a partir do CEP; essa opção instala um módulo adicional.
4. No cadastro do parceiro, preencha CNPJ ou CPF, IE e o endereço; inscrição municipal, Suframa e outras inscrições estaduais ficam na aba Fiscal.
5. Com o aplicativo Contatos instalado, 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 da empresa dependem de o país da empresa estar como Brasil. Configure a empresa antes de cadastrar parceiros.
- CNPJ ou CPF repetido bloqueia a gravação do parceiro. Para filiais com o mesmo CNPJ e inscrições estaduais diferentes, ative Múltiplos parceiros com mesmo CNPJ.
- Desabilitar validação de CPF e CNPJ ou Desabilitar validação de IE (Inscrição Estadual) vale para toda a base e permite gravar documentos inválidos. Use só em situações pontuais, como importação de dados antigos.
- A inscrição estadual só é validada em parceiros marcados como empresa e com estado informado. Os textos ISENTO ou ISENTA são aceitos sem validaçã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.

- [Cadastrar cliente contribuinte de ICMS](https://docs.kmee.com.br/odoo/enterprise/localizacoes/brasil/cadastros/cadastrar-cliente-contribuinte-de-icms/) (vídeo de 2 min)
- [Cadastrar consumidor final pessoa física](https://docs.kmee.com.br/odoo/enterprise/localizacoes/brasil/cadastros/cadastrar-consumidor-final-pessoa-fisica/) (vídeo de 1 min)
- [Cadastrar parceiro estrangeiro](https://docs.kmee.com.br/odoo/enterprise/localizacoes/brasil/cadastros/cadastrar-cliente-ou-fornecedor-estrangeiro/) (vídeo de 1 min)

## Módulos relacionados

- [Contatos](https://docs.kmee.com.br/odoo/enterprise/modulos/administracao/contacts/)
- [Motor fiscal brasileiro](https://docs.kmee.com.br/odoo/enterprise/modulos/localizacao-brasileira/l10n-br-fiscal/)
- [Faturas com documento fiscal brasileiro](https://docs.kmee.com.br/odoo/enterprise/modulos/localizacao-brasileira/l10n-br-account/)

## Código e fontes

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

Mais módulos em [Localização brasileira](https://docs.kmee.com.br/odoo/enterprise/modulos/localizacao-brasileira/) e na [referência de módulos](https://docs.kmee.com.br/odoo/enterprise/modulos/).