Consulta de CNPJ na homologação de fornecedores
Homologar um fornecedor começa por saber se a empresa existe, está ativa e faz o que diz fazer. O ProCNPJ entrega esses pontos em uma consulta por API, pronta para entrar no seu fluxo de compras.
O cadastro está em piloto, por convite: para participar, fale com a gente.
A consulta no seu fluxo, em três momentos
No cadastro do fornecedor
O fornecedor informa o CNPJ e seu sistema cria a consulta com uma referência sua, como o id do processo de homologação.
Na análise
O resultado mostra situação cadastral, data de abertura, natureza jurídica, atividade principal e secundárias, capital social e endereço.
Na decisão
Sua política define o que aprova, o que pede revisão e o que recusa. Guarde o id da consulta junto do processo.
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
- Barra CNPJ que passa na conta dos dígitos verificadores mas não existe no cadastro.
- Mostra fornecedor com situação baixada, suspensa, inapta ou nula antes do contrato.
- Traz a data de abertura, para a sua regra de tempo mínimo de empresa.
- Traz atividade principal e secundárias (CNAE), para conferir se a empresa pode prestar o que está vendendo.
- Mostra se o estabelecimento é matriz ou filial e qual é o endereço cadastrado.
O que não resolve
- Não devolve o quadro de sócios e administradores.
- Não emite certidões e não informa débitos, protestos, processos nem score de crédito.
- Não acompanha o fornecedor depois da homologação: para rever a situação, seu sistema faz uma nova consulta.
- Não substitui a análise de documentos, de capacidade técnica e de conformidade da sua política de compras.
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
O que a consulta de CNPJ mostra sobre um fornecedor?
A consulta traz certidões negativas ou os sócios do fornecedor?
Como rever a situação dos fornecedores já homologados?
Dá para testar os cenários sem gastar consulta?
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 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.