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:
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
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/.
- 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”.
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.