Consulta de CNPJ na Serasa ou por API de dados cadastrais

Quem busca "Serasa CNPJ" quase sempre quer um score de crédito ou uma restrição financeira. Uma API de dados cadastrais responde a outra pergunta: quem é a empresa e qual é a sua situação no registro. Aqui está a diferença, sem rodeios.

Duas perguntas diferentes

Um bureau de crédito, como a Serasa, reúne informações de pagamento, protestos, restrições e modelos de risco para estimar a chance de uma empresa honrar uma dívida. A Receita Federal, por sua vez, mantém o cadastro: o CNPJ, a razão social, a natureza jurídica, a atividade e a situação cadastral (ativa, suspensa, inapta, baixada). São dados de natureza diferente e servem a decisões diferentes.

A Prometiam entrega o segundo tipo. Ela não calcula score, não informa pendências financeiras, não mostra protestos e não faz recomendação de limite de crédito. Se a sua decisão é conceder prazo de pagamento a um cliente, você vai precisar de um bureau; se a decisão é saber se a empresa existe, está ativa e é a que consta no contrato, o cadastro responde.

Quando cada um é a ferramenta certa

NecessidadeCadastro (API de CNPJ)Bureau de crédito
A empresa existe e está ativa?Sim, pela situação cadastralEm geral também mostra
Razão social e natureza jurídicaSimSim
Score e limite de créditoNãoSim
Protestos e restrições financeirasNãoSim
Alertas de mudança de situação cadastralSim, por webhookDepende do produto
Mesmo formato para outros paísesSim, 27 paísesDepende do fornecedor

Como combinar os dois

Um fluxo comum de crédito comercial começa pelo cadastro, porque ele é rápido e barato: se o CNPJ é inválido, se a empresa está baixada ou inapta, ou se a razão social não confere, a análise para ali. Só as propostas que passam por essa primeira triagem seguem para a consulta de crédito, que é mais cara. Assim, você paga o bureau apenas pelas empresas que valem a análise.

curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=BR&company_number=33.000.167/0001-01' \
  -H 'Authorization: Bearer rk_live_...'

A resposta traz status, local_status, legal_form, o endereço e o activity_code em CNAE 2.3. Você grava esses campos no cadastro do cliente e assina o monitoramento com POST /monitor para ser avisado quando a situação mudar.

O que a Prometiam não entrega, de propósito

  • Nenhum score, rating ou limite de crédito.
  • Nenhuma informação de protesto, restrição financeira ou histórico de pagamento.
  • Só pessoas jurídicas: o empresário individual, o MEI e as demais pessoas físicas nunca são servidos. A EIRELI é servida.
  • Sem quadro societário (QSA), sem sócios e sem administradores, e sem telefone nem e-mail de contato.
  • Sem número de IVA: o Brasil não tem um número de IVA ligado ao CNPJ, e uma busca com vat= é recusada.
  • Sem avisos de insolvência: o Brasil não é um dos doze mercados de insolvência. Recuperação judicial, falência e liquidação aparecem na situação especial e no status.
  • A atividade é a CNAE 2.3 (BR-CNAE-2.3), não a NACE, e nenhum código NACE é derivado dela.
  • Uma empresa por raiz de CNPJ, com o CNPJ da matriz; filiais, entidades sem fins lucrativos, órgãos públicos e sucursais de empresas estrangeiras não são servidos.

Os dados vêm dos arquivos de dados abertos da Receita Federal, que publica um arquivo completo por mês: a atualização é mensal, não uma consulta ao vivo.

Preços

O teste gratuito dura 14 dias e inclui 500 créditos; é preciso informar um cartão, mas nada é cobrado durante o teste. Depois, o plano Starter custa € 9,99 por mês com 1.000 créditos, o Professional € 29,99 com 10.000 e o Scale € 99,99 com 50.000; o Enterprise tem preço sob consulta. Consultar um registro de empresa custa 1 crédito, cerca de € 0,01 no Starter e a partir de € 0,002 no Scale. Os preços são públicos e o plano anual dá dois meses grátis.

Contains data from the Cadastro Nacional da Pessoa Jurídica (CNPJ), Receita Federal do Brasil, published as open data (CC BY). Adapted by Prometiam.

Páginas relacionadas

Começar o teste gratuito de 14 dias · Documentação da API

O teste dura 14 dias e inclui 500 créditos. É necessário informar um cartão; nada é cobrado durante o teste e, depois, vale o plano Starter (€ 9,99 por mês), salvo cancelamento.

Frequently asked questions

A Prometiam substitui a consulta à Serasa?
Não. Ela entrega dados cadastrais da Receita, sem score nem restrições financeiras. Os dois serviços se complementam.
A situação cadastral indica se a empresa paga em dia?
Não. Uma empresa ativa no cadastro pode ter dívidas, e uma empresa inapta não deve ser tratada como inadimplente só por isso. A situação cadastral diz respeito às obrigações perante a Receita.
Posso usar a API para filtrar antes de pagar uma consulta de crédito?
Sim, é um uso típico: a triagem cadastral descarta CNPJs inválidos, baixados ou diferentes do contrato, e só o restante segue para a análise de crédito.
A API mostra os sócios da empresa?
Não. Não há quadro societário, administradores nem dados de contato.