Pular para o conteúdo
Uso: Emissão de nota fiscal e validação fiscal

Consulta de CNPJ antes de emitir nota fiscal

Nota emitida para CNPJ baixado, com razão social desatualizada ou endereço errado vira rejeição, carta de correção e retrabalho. O ProCNPJ confere esses dados por API antes de o documento sair.

Criar conta Ver a documentação

O cadastro está em piloto, por convite: para participar, fale com a gente.

Como encaixar

A consulta no seu fluxo, em três momentos

No cadastro do cliente ou no pedido

Seu sistema de gestão ou de faturamento cria a consulta com o CNPJ do destinatário e uma referência sua, como o número do pedido.

Na conferência

O resultado traz situação cadastral, razão social, nome fantasia, endereço e atividade principal. Seu sistema compara com o cadastro que já tem.

Na emissão

Com a situação ativa e os dados atualizados, a nota segue. Se a situação for baixada, suspensa, inapta ou nula, a regra de segurar ou revisar é sua.

Sem exagero

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

  • Mostra a situação cadastral do CNPJ do destinatário antes da emissão.
  • Devolve razão social e endereço como estão no cadastro, para corrigir divergência antes de a nota sair.
  • Traz a atividade principal e as secundárias (CNAE), para conferir com a operação.
  • Encaixa em rotina automática: fila, webhook assinado e idempotência para repetir a chamada sem duplicar.

O que não resolve

  • Não consulta inscrição estadual nem a situação do contribuinte na fazenda estadual.
  • Não informa o regime tributário: a consulta ao Simples Nacional não faz parte do produto.
  • Não emite nem valida a nota fiscal: o ProCNPJ entrega o dado cadastral, e a emissão continua no seu sistema.
  • Não faz consulta em lote: cada chamada consulta um CNPJ.
Na prática

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.
cURLPOST /v1/consultations
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", ...}, ...
 }
}
Perguntas frequentes

Dúvidas sobre este uso

Por que consultar o CNPJ antes de emitir a nota fiscal?
Porque a conta dos dígitos verificadores só mostra que o número é bem formado. A consulta mostra se o CNPJ existe, qual é a situação cadastral e quais são a razão social e o endereço no cadastro, que são os dados do destinatário da nota.
A consulta devolve a inscrição estadual ou o regime tributário?
Não. O ProCNPJ não consulta inscrição estadual nem Simples Nacional. O resultado traz razão social, nome fantasia, situação cadastral, datas, natureza jurídica, atividades, capital social e endereço.
Dá para atualizar o cadastro de clientes com a consulta?
Sim, um CNPJ por chamada. Seu sistema cria uma consulta para cada cliente, recebe o aviso por webhook e grava os dados atualizados. Não há consulta em lote em uma única chamada.
O que fazer quando a situação cadastral não é ativa?
A situação vem no resultado e a regra é do seu processo fiscal. O ProCNPJ informa se o CNPJ está ativo, baixado, suspenso, inapto ou nulo, e a data dessa situação.
Outros usos

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 uso

Homologação de fornecedores

Situação cadastral, tempo de empresa, atividade e endereço do fornecedor antes de fechar o contrato.

Ver este uso

Autopreenchimento de cadastro

O cliente digita o CNPJ e o formulário recebe razão social, nome fantasia, endereço e atividade.

Ver este uso

API 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 uso

Teste 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.

Criar conta Falar com a gente