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
- A documentação da API está disponível em
https://www.cpfcnpj.com.br/dev/.
auto_awesome What this module does
AI-generated from the code · Odoo 19.0Adds a search button on contacts and companies that looks up a Brazilian CNPJ in an external service (ReceitaWS, SERPRO or CPF.CNPJ) and fills in the company's registration, address, phone, email, tax and partner data automatically.
This module lets users fill a contact or company record from its Brazilian CNPJ instead of typing everything by hand. A small search button appears next to the CNPJ field on the contact and company forms; clicking it opens a wizard that queries an external CNPJ service and shows the data found before anything is saved.
- The wizard fills legal name, trade name, full address, phone, email, legal nature, share capital, main and secondary economic activities (CNAE), company size, registration status with date and reason, opening date, head office or branch, Simples Nacional option date and the legal responsible person.
- With the CPF.CNPJ provider it can also set the tax regime (MEI, Simples Nacional or Normal), create the company's partners (QSA) as child contacts, and attach the CNPJ card PDF to the contact.
- Pressing the update button writes the values onto the contact and closes the wizard; empty values are not written.
In Settings, a new section lets administrators choose the provider (ReceitaWS, SERPRO or CPF.CNPJ) and enter the SERPRO token, trial mode and schema, or the CPF.CNPJ token, package and options to skip partners, skip the PDF card or fetch the state registration.
The button refuses to run if the contact has no CNPJ or if CNPJ validation is disabled in the Brazilian base settings. It touches contacts (res.partner), companies (res.company) and the fiscal data models for CNAE and legal nature.
Depends on
Required by other modules
Models and fields (5)
- res.company · extends an existing modelcompany_type, equity_capital, company_currency_id (Company Currency)
- res.config.settings · extends an existing modelserpro_token (SERPRO Token), serpro_trial (Use SERPRO Trial), cnpj_provider (CNPJ Search Provider), cpfcnpj_token (CPF.CNPJ Token), serpro_schema (SERPRO Schema), cpfcnpj_package (CPF.CNPJ Package), cpfcnpj_fetch_ie (CPF.CNPJ: fetch state registration (package 16)), cpfcnpj_skip_card (CPF.CNPJ: do not attach the CNPJ card PDF), cpfcnpj_skip_partners (CPF.CNPJ: do not import partners (QSA))
- partner.search.wizard · new modelvat (CNPJ), zip, name, email, phone, city_id, street2, district, state_id, child_ids, country_id, legal_name, partner_id, cnpj_status, currency_id, street_name, cnae_main_id, company_size, opening_date, cnpj_card_pdf, provider_name, street_number, tax_framework, equity_capital, l10n_br_ie_code, legal_nature_id, cnpj_branch_type, cnpj_status_date, cnae_secondary_ids, cnpj_status_reason
- l10n_br_base.party.mixin · extends an existing modelcnpj_status (CNPJ Status), cnae_main_id, company_size, opening_date, br_currency_id (BR Company Currency), equity_capital, legal_nature_id (Legal Nature), cnpj_branch_type (Head Office / Branch), cnpj_status_date (CNPJ Status Date), cnpj_status_reason (CNPJ Status Reason), simples_option_date (Simples Nacional Option Date), legal_responsible_name (Legal Responsible), legal_responsible_function
- l10n_br_cnpj_search.webservice.abstract · new model
Text generated by AI (DeepSeek) from reading the Odoo 19.0 code on GitHub; it may contain mistakes, so check the code before deciding. The module is very large and only part of the code was read. View the code on GitHub
Availability by version
Reviewed: 2026-11-03Confirmation status: 6 confirmed, 3 with no information of 9 versions.
Sources · Odoo 19.0
Confirmed on 2026-11-03 in branch 19.0 of OCA/l10n-brazil.
terminal Installation and usage
OCA documentation · Odoo 19.0Configuration
Source · Odoo 19.0Esta 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
- Consulte a documentação da API, os pacotes disponíveis e as
credenciais em https://www.cpfcnpj.com.br/dev/.
Usage
Source · Odoo 19.0- 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".
No verified information in OCA: Installation.
Installation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.
Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.