Brazilian Localization CNPJ Search
Módulo que adiciona um botão para preencher automaticamente os campos de um partner a partir do seu CNPJ. Seguem abaixo os campos que podem ser consultados de ambas as APIs utilizadas para conseguir informações a partir do CNPJ:
ReceitaWS
SERPRO
CPF.CNPJ (cpfcnpj.com.br)
Provedor comercial com dados em tempo real, vindos da Receita Federal no momento da consulta (D+0). O pacote 5 (CNPJ B) é a opção mais leve (cadastro e endereço, sem sócios e sem PDF), enquanto o pacote 6 (CNPJ D) traz o cadastro completo.
Do pacote 6, o módulo preenche no partner: razão social, nome fantasia, endereço completo, telefones, e-mail, natureza jurídica, capital social, CNAE principal e secundários, porte da empresa, situação cadastral (com data e motivo), data de abertura, matriz ou filial, data de opção pelo Simples Nacional e responsável perante a Receita (nome e qualificação). A partir do Simples Nacional, SIMEI e porte, o módulo também alimenta o tax_framework (regime tributário) do partner, campo que os demais provedores não preenchem hoje.
Cada sócio do Quadro de Sócios e Administradores vira um contato filho e o Cartão CNPJ em PDF da Receita Federal fica anexado ao parceiro; as opções “CPF.CNPJ: do not import partners (QSA)” e “CPF.CNPJ: do not attach the CNPJ card PDF” desligam cada um desses passos. A opção “CPF.CNPJ: fetch state registration (package 16)” (desligada por padrão) faz uma consulta ao pacote 16 (CNPJ H) para trazer a Inscrição Estadual da UF do endereço.
O provedor mantém as certificações ISO/IEC 27001, ISO/IEC 27701 e ISO 37301. A documentação da API está disponível em https://www.cpfcnpj.com.br/dev/.
Table of contents
Installation
Configuration
Esta busca de informações a partir do cnpj é realizada com base no provedor configurado na aba de configurações, vale ressaltar que o provedor receitaws permite a realização de três consultas por minuto, enquanto que o SERPRO é pago e permite consultas ilimitadas em seus planos.
O provedor cpfcnpj.com.br é comercial, com dados em tempo real (D+0), sem o limite de três consultas por minuto do receitaws. Os dados vêm diretamente da Receita Federal no momento da consulta. Para utilizá-lo, selecione “CPF.CNPJ” no campo provedor e informe o token de acesso e o pacote desejado. O pacote 5 (CNPJ B) é a opção mais leve (cadastro e endereço, sem sócios e sem PDF), enquanto o pacote 6 (CNPJ D) é o cadastro completo (porte, situação cadastral, Simples Nacional, Quadro de Sócios e Administradores e Cartão CNPJ em PDF). O token é gravado em ir.config_parameter e nunca fica no código. Com o pacote 6, o módulo também preenche o regime tributário (tax_framework) do partner.
Ao selecionar o provedor CPF.CNPJ, ficam visíveis em Configurações > Contatos as opções a seguir:
“CPF.CNPJ: do not import partners (QSA)” (padrão desligado): por padrão cada sócio do Quadro de Sócios e Administradores vira um contato filho, com nome, qualificação e CPF/CNPJ. Marque esta opção para pular esse passo.
“CPF.CNPJ: do not attach the CNPJ card PDF” (padrão desligado): por padrão o Cartão CNPJ em PDF emitido pela Receita Federal, retornado pela API no mesmo request, é anexado ao parceiro. Marque esta opção para não anexar.
“CPF.CNPJ: fetch state registration (package 16)” (padrão desligado): faz uma segunda consulta ao pacote 16 (CNPJ H) para preencher a Inscrição Estadual da UF do endereço. O pacote 16 tem custo próprio por consulta, por isso a opção vem desligada.
O provedor é auditado sob as normas ISO/IEC 27001, ISO/IEC 27701 e ISO 37301. Consulte a documentação da API, os pacotes disponíveis e as credenciais em https://www.cpfcnpj.com.br/dev/.
Usage
Acesse Configurações
Escolha um provedor para a busca
Acesse Configurações > Usuários e Empresas > Empresas > Criar ou acesse Contatos > Criar
Preencha os campos obrigatórios, insira no campo de CNPJ o CNPJ que deseja buscar e clique na lupa ao lado do campo para buscar
O mesmo procedimento pode ser feito editando alguma empresa.
Com o provedor CPF.CNPJ, o botão de busca no parceiro (a lupa ao lado do campo de CNPJ) abre um wizard que exibe os campos retornados. Ao confirmar, o módulo grava os dados no parceiro, cria um contato filho por sócio do Quadro de Sócios e Administradores (opção QSA) e anexa o Cartão CNPJ em PDF na aba “Anexos”.
Known issues / Roadmap
Changelog
18.0.1.3.0
Adiciona o provedor de consulta cpfcnpj.com.br (dados em tempo real, D+0), com token e pacote (5 ou 6) configuráveis.
Preenche o regime tributário (tax_framework) do partner a partir do Simples Nacional, SIMEI e porte retornados no pacote 6.
Amplia o pacote 6 (CNPJ D): preenche porte da empresa, situação cadastral (com data e motivo), data de abertura, matriz ou filial, data de opção pelo Simples Nacional e responsável perante a Receita (nome e qualificação).
Cada sócio do Quadro de Sócios e Administradores vira um contato filho, com nome, qualificação e CPF/CNPJ. A opção “CPF.CNPJ: do not import partners (QSA)” desliga esse passo.
O Cartão CNPJ em PDF emitido pela Receita Federal é anexado ao parceiro. A opção “CPF.CNPJ: do not attach the CNPJ card PDF” desliga esse passo.
Nova opção “CPF.CNPJ: fetch state registration (package 16)” (padrão desligado): consulta o pacote 16 (CNPJ H) para preencher a Inscrição Estadual da UF do endereço. O pacote 16 tem custo próprio por consulta.
Bug Tracker
Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.
Do not contact contributors directly about support or help with technical issues.
Credits
Contributors
KMEE:
Breno Oliveira Dias <breno.dias@kmee.com.br>
-
Alisson Linneker <hi@alas.technology>
Maintainers
This module is maintained by the OCA.
OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.
This module is part of the OCA/l10n-brazil project on GitHub.
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
1 maintainer
Metadata
1 maintainer
Release files for odoo-addon-l10n-br-cnpj-search 18.0.1.4.0.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| odoo_addon_l10n_br_cnpj_search-18.0.1.4.0.3-py3-none-any.whl | Python 3 | none | any | Details for odoo_addon_l10n_br_cnpj_search-18.0.1.4.0.3-py3-none-any.whl |
Release files / odoo_addon_l10n_br_cnpj_search-18.0.1.4.0.3-py3-none-any.whl
| Download URL | odoo_addon_l10n_br_cnpj_search-18.0.1.4.0.3-py3-none-any.whl |
|---|---|
| Size | 328.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fc0b7be677a2e528950f7005007c40f16212d4fcbf264640b4280f67e63e295b
|
|
BLAKE2b-256 checksum How to use checksums |
53b7b3eacb1f337eb60b9ddf1a36bca74f84d85266147be1ae376b4b17ff268e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.4
|
Security for odoo-addon-l10n-br-cnpj-search 18.0.1.4.0.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
