CNPJAPI

Consultar CNPJ no Make (Integromat)

Este guia mostra como consultar CNPJ no Make (ex-Integromat) sem programar, para automatizar o enriquecimento: quando chega um lead, uma linha nova numa planilha ou um registro no CRM, o cenário consulta o CNPJ pela API da CNPJAPI e devolve Razão Social, situação cadastral e atividade principal para o próximo passo.

O guia começa do zero: criar a conta e gerar a sua API key.

Antes de começar: crie a conta e gere a API key

Para consultar pela API você precisa de uma API key (uma chave que identifica a sua conta). É de graça para começar.

  1. Acesse https://app.cnpjapi.com.br e crie sua conta no plano gratuito (não pede cartão).
  2. Confirme o seu e-mail e faça login no portal.
  3. Já dentro do portal, gere a sua API key. Ela começa com cnpj_ (por exemplo, cnpj_a1b2c3...). Copie e guarde num lugar seguro - a chave é mostrada uma vez.
  4. Essa chave vai no cabeçalho Authorization, no formato Bearer cnpj_sua_chave, em cada requisição.

Detalhes em Autenticação. Trate a chave como uma senha: quem tem a chave consome a sua cota.

Como funciona no Make

O Make não tem um conector oficial da CNPJAPI. Você usa o módulo genérico HTTP > Make a request, que consegue mandar o cabeçalho Authorization que a API exige - é isso que faz a integração funcionar sem código.

Passo a passo

  1. No seu cenário, adicione o módulo HTTP > Make a request.
  2. Configure:
    • URL: https://api.cnpjapi.com.br/{{cnpj}} - onde {{cnpj}} é o CNPJ (apenas os 14 dígitos) vindo do módulo anterior. Para testar, use um fixo: https://api.cnpjapi.com.br/00776574000156.
    • Method: GET.
    • Headers: adicione um cabeçalho - Name: Authorization, Value: Bearer cnpj_sua_chave.
    • Parse response: Yes (o Make já entrega o JSON como estrutura navegável).
  3. Rode uma vez (Run once). Na saída do módulo aparecem os campos da empresa. Os principais:
    • RazaoSocial - razão social;
    • SituacaoCadastral: Descricao - "Ativa", "Baixada", etc.;
    • AtividadePrincipal: Descricao - CNAE principal por extenso.
  4. Ligue o próximo módulo (Google Sheets, CRM, e-mail, banco...) e mapeie esses campos onde quiser gravar.

Tratar "não encontrado" e limite sem parar o cenário

A API responde:

  • 404 quando o CNPJ não existe na base pública;
  • 429 quando você excede o limite por minuto ou a cota mensal (com o cabeçalho Retry-After, em segundos).

Por padrão o Make trata respostas 4xx/5xx como erro e para o cenário. Para seguir em frente (por exemplo, marcar a linha como "não encontrado" e continuar), clique com o botão direito no módulo HTTP, Add error handler, e use Resume (ou Ignore). Assim um CNPJ ruim não derruba o lote inteiro.

Limite de requisições (e quando fazer upgrade)

Um cenário do Make pode disparar muitas operações em sequência. No plano gratuito da CNPJAPI, a API aceita um número limitado de consultas por minuto; ao estourar, ela responde 429. Para volumes maiores:

  • Reduza o ritmo (agende o cenário em blocos, ou use um módulo de espera); ou
  • Faça upgrade para um plano com limite maior e cota mensal folgada.

Veja os limites por plano. Se você automatiza enriquecimento com frequência, um plano pago compensa rápido.

Observações

  • Não há conector/app oficial da CNPJAPI no Make - é o módulo HTTP genérico.
  • Guarde a API key com cuidado: prefira uma variável do cenário ou um data store a deixá-la fixa em cenários compartilhados.

Próximos passos

Crie sua conta gratuita em https://app.cnpjapi.com.br e monte seu primeiro cenário em minutos.