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 CNPJ lookup button on companies and contacts that fetches Brazilian company data from ReceitaWS, SERPRO or CPF.CNPJ and fills the partner record automatically.
This module lets users fill a company or contact record in Odoo from its Brazilian CNPJ (company tax number) instead of typing everything by hand.
Where it appears: - A search button next to the CNPJ field on the company form and on the contact/partner form. - A settings screen where an administrator chooses the data provider (ReceitaWS, SERPRO or CPF.CNPJ) and enters the tokens, trial mode, SERPRO schema and CPF.CNPJ package.
What happens when the button is clicked: - Odoo checks that a CNPJ is filled in and that CNPJ validation is enabled, then opens a wizard showing the data returned by the provider. - The user reviews the values and confirms; the partner is then updated with legal name, trade name, full address, phone, email, legal nature, share capital, main and secondary CNAE activity codes, company size, registration status with date and reason, opening date, head office or branch, Simples Nacional option date and the legal responsible. - With the CPF.CNPJ provider, the fiscal tax framework is also derived (MEI, Simples Nacional or Normal), company partners (QSA) can be created as child contacts, and the CNPJ card PDF can be attached to the contact. - Empty values are not written, so existing data is not erased.
Settings options let users skip importing partners, skip the PDF card, or also fetch the state registration. The module touches res.partner, res.company and the fiscal partner fields.
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 15.0
Confirmed on 2026-11-03 in branch 15.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.