Localização brasileira, cadastros básicos

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

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.
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.
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.
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.
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 (vídeo de 2 min)
Cadastrar consumidor final pessoa física (vídeo de 1 min)
Cadastrar parceiro estrangeiro (vídeo de 1 min)

Módulos relacionados

Código e fontes

Código-fonte: OCA/l10n-brazil
Documentação do módulo na OCA (16.0)

Mais módulos em Localização brasileira e na referência de módulos.