Autopreenchimento de cadastro a partir do CNPJ
Cada campo a mais no cadastro é uma chance de desistência e de erro de digitação. Com o ProCNPJ, a empresa informa o CNPJ e o seu sistema preenche o restante com os dados do cadastro.
O cadastro está em piloto, por convite: para participar, fale com a gente.
A consulta no seu fluxo, em três momentos
No formulário
A pessoa digita o CNPJ, com ou sem máscara. Seu servidor cria a consulta: a chave de API fica no servidor, nunca no navegador.
Enquanto a consulta roda
A consulta é assíncrona. Seu servidor espera o webhook ou consulta o id de tempos em tempos, e a tela mostra que os dados estão sendo buscados.
No preenchimento
Com o CNPJ encontrado, preencha razão social, nome fantasia, endereço e atividade, e deixe a pessoa revisar antes de salvar.
O que a consulta resolve e o que ela não resolve
A consulta de CNPJ é uma etapa de validação cadastral. Saber onde ela termina evita apoiar uma decisão em algo que ela não prova.
O que resolve
- Devolve razão social e nome fantasia, para o cadastro nascer com o nome certo.
- Devolve o endereço em campos separados: logradouro, número, complemento, bairro, cidade, estado e CEP.
- Traz atividade principal, natureza jurídica e data de abertura, para segmentar o cliente sem perguntar.
- Avisa na hora quando o CNPJ digitado tem dígitos verificadores errados, antes de a consulta entrar na fila.
- Aceita CNPJ numérico e alfanumérico no mesmo campo.
O que não resolve
- Não devolve e-mail nem telefone da empresa: os dados de contato continuam sendo informados por quem se cadastra.
- Não devolve o quadro de sócios e administradores.
- Não responde dentro da mesma chamada: a consulta é assíncrona, e o seu formulário precisa tratar o tempo de espera.
- Não prova que quem digitou o CNPJ representa a empresa.
Uma chamada para criar, dois desfechos possíveis
Você envia só o CNPJ. A consulta é assíncrona e o aviso chega por webhook assinado, sem dado cadastral no corpo.
- found
- CNPJ encontrado. O CNPJ existe no cadastro. O resultado vem completo, com a situação cadastral.
- not_found
- CNPJ não encontrado. O número passa na conta dos dígitos verificadores, mas não existe no cadastro.
curl -X POST https://api.procnpj.com.br/v1/consultations \
-H "Authorization: Bearer pcnpj_test_..." \
-H "Content-Type: application/json" \
-d '{"cnpj": "11.222.333/0006-96",
"external_reference": "cadastro-8841"}'
# Resultado, no sandbox (GET /v1/consultations/{id})
{"status": "done",
"outcome": "found",
"cnpj": "11.222.333/0006-96",
"result": {
"legal_name": "EMPRESA DE EXEMPLO LTDA",
"registration_status": "ativa",
"opening_date": "2010-05-03",
"main_activity": "62.01-5-01 - Desenvolvimento de programas...",
"address": {"city": "SAO PAULO", "state": "SP", ...}, ...
}
}Dúvidas sobre este uso
Quais campos do cadastro dá para preencher a partir do CNPJ?
Posso chamar a API direto do navegador?
A consulta trava a tela do cadastro?
O cadastro de um microempreendedor individual tem dado pessoal?
A mesma consulta em outros fluxos
Onboarding de pessoa jurídica (KYB)
A primeira pergunta do cadastro de uma empresa respondida por API: o CNPJ existe, está ativo e a razão social bate?
Ver este usoEmissão de nota fiscal e validação fiscal
Situação cadastral, razão social e endereço do cliente conferidos antes de a nota ser emitida.
Ver este usoHomologação de fornecedores
Situação cadastral, tempo de empresa, atividade e endereço do fornecedor antes de fechar o contrato.
Ver este usoAPI de CNPJ alfanumérico
CNPJ com letras e números aceito desde o primeiro dia, no mesmo campo e na mesma chamada do CNPJ numérico.
Ver este usoTeste este fluxo no sandbox
Crie a conta, gere uma chave de teste e simule cada cenário pelo décimo segundo caractere do CNPJ. Sem custo e sem consumir cota.