# Consulta de CNPJ na Receita

> Preenche o cadastro de um cliente, fornecedor ou da própria empresa a partir do CNPJ. Módulo l10n_br_cnpj_search no Odoo 18.

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

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

Preenche o cadastro de um cliente, fornecedor ou da própria empresa a partir do CNPJ. Basta digitar o número e clicar na lupa ao lado do campo: razão social, nome fantasia, endereço, telefones, e-mail, atividades econômicas e situação cadastral vêm do provedor de consulta escolhido.

## Quando usar

- Cadastrar clientes e fornecedores sem digitar o endereço e os dados da Receita.
- Conferir a situação cadastral de um CNPJ, com data e motivo, antes de vender ou comprar.
- Atualizar o cadastro de um parceiro cujos dados mudaram na Receita.
- Trazer o quadro de sócios e o cartão CNPJ em PDF, com o provedor comercial de pacote completo.

## Como configurar

1. Abra Definições -> Configurações gerais e, na seção Localização Brasileira, em API de Serviço do CNPJ Brasileiro, escolha o Provedor de Pesquisa de CNPJ: ReceitaWS, SERPRO ou CPF.CNPJ.
2. Para o SERPRO, informe o Token SERPRO e o Esquema SERPRO. Para o CPF.CNPJ, informe o Token CPF.CNPJ e o Pacote CPF.CNPJ.
3. Com o CPF.CNPJ, marque as opções para pular a importação dos sócios, pular o anexo do cartão CNPJ ou buscar a inscrição estadual, conforme a necessidade.
4. Abra Contatos, clique em Novo, marque Empresa, digite o CNPJ/CPF e clique na lupa sob o rótulo do campo.
5. Confira os dados exibidos na janela de consulta e confirme para gravar no cadastro.
6. O mesmo botão existe no cadastro da empresa, em Definições -> Usuários e Empresas -> Empresas.

## Cuidados

- O provedor ReceitaWS aceita três consultas por minuto. O SERPRO é pago e atende a volumes maiores. O CPF.CNPJ é comercial, com dados em tempo real.
- As opções de provedor aparecem nas configurações enquanto a validação de CPF e CNPJ está ligada. A lupa aparece com o cadastro em edição.
- A chave de acesso de cada provedor fica nas configurações gerais e deve ser guardada pelo administrador.
- Com o CPF.CNPJ, cada sócio vira um contato filho e o cartão CNPJ fica na aba Anexos do cadastro.

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

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

## Módulos relacionados

- [Localização brasileira, cadastros básicos](https://docs.kmee.com.br/odoo/18.0/modulos/localizacao-brasileira/l10n-br-base/)
- [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/)

## 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_cnpj_search)