Consulta de CNPJ no onboarding de pessoa jurídica (KYB)
Antes de analisar contrato social, sócios ou crédito, o cadastro de uma empresa precisa de uma resposta simples: este CNPJ existe, está ativo e pertence a quem diz ser? O ProCNPJ responde por API, de forma assíncrona, sem travar o seu fluxo.
O cadastro está em piloto, por convite: para participar, fale com a gente.
A consulta no seu fluxo, em três momentos
Primeira etapa do cadastro
Crie a consulta assim que a empresa informa o CNPJ, com a sua referência e um Idempotency-Key para repetir a chamada sem criar outra consulta.
Resultado no seu fluxo
O webhook assinado avisa o fim da consulta, sem dado cadastral no corpo. Seu serviço busca o resultado por uma chamada autenticada e segue para a próxima etapa.
Regra e registro
Compare a razão social com a informada, avalie situação cadastral, data de abertura, natureza jurídica e atividade, e guarde o id da consulta no dossiê do cadastro.
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
- Confirma que o CNPJ existe e mostra a situação cadastral: ativa, baixada, suspensa, inapta ou nula.
- Devolve razão social e nome fantasia, para comparar com o que a empresa informou.
- Traz data de abertura, natureza jurídica, atividade principal e secundárias, capital social e se o estabelecimento é matriz ou filial.
- Devolve o endereço do estabelecimento, para conferir com o endereço declarado.
- Aceita CNPJ numérico e alfanumérico no mesmo campo, sem mudança na integração.
O que não resolve
- Não devolve o quadro de sócios e administradores: a identificação de sócios e de beneficiário final é outra etapa do seu processo.
- Não prova que quem está se cadastrando representa a empresa. Para isso, combine com a conferência de poderes e de documentos.
- Não é análise de crédito: não informa score, restrições, protestos nem dívidas.
- Não cobre sozinha as exigências regulatórias do seu setor: é uma etapa do cadastro, não o processo inteiro.
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
Onde a consulta de CNPJ entra no onboarding de pessoa jurídica?
A consulta devolve os sócios da empresa?
A consulta é síncrona ou assíncrona?
O que acontece se a consulta falhar?
A mesma consulta em outros fluxos
Emissã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 usoAutopreenchimento de cadastro
O cliente digita o CNPJ e o formulário recebe razão social, nome fantasia, endereço e atividade.
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.