CNPJAPI

Consultar CNPJ no Power Automate

Este guia mostra como consultar CNPJ no Power Automate sem programar, para automatizar o enriquecimento dentro do ecossistema Microsoft: quando chega um lead, uma linha no Excel/SharePoint ou um registro no Dataverse, o fluxo 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 Power Automate

O Power Automate não tem um conector oficial da CNPJAPI. Você usa a ação genérica HTTP, que manda o cabeçalho Authorization exigido pela API.

Atenção: a ação HTTP é um recurso premium do Power Automate (exige um plano pago ou trial premium). É a via para mandar o cabeçalho Authorization; sem ela, os conectores padrão não enviam o header.

Passo a passo

  1. No seu fluxo, adicione a ação HTTP (Premium).
  2. Configure:
    • Method: GET.
    • URI: https://api.cnpjapi.com.br/@{variables('cnpj')} - onde cnpj são os 14 dígitos vindos do gatilho. Para testar, use um fixo: https://api.cnpjapi.com.br/00776574000156.
    • Headers: chave Authorization, valor Bearer cnpj_sua_chave.
  3. Adicione a ação Parse JSON logo depois:
    • Content: o corpo (Body) da ação HTTP;
    • Schema: cole o schema mínimo abaixo (cobre os campos usados; os demais campos da resposta são ignorados).
{
  "type": "object",
  "properties": {
    "RazaoSocial": { "type": "string" },
    "SituacaoCadastral": {
      "type": "object",
      "properties": { "Descricao": { "type": "string" } }
    },
    "AtividadePrincipal": {
      "type": "object",
      "properties": { "Descricao": { "type": "string" } }
    }
  }
}
  1. Nos passos seguintes, use os campos do Parse JSON: RazaoSocial, SituacaoCadastral Descricao, AtividadePrincipal Descricao - grave onde quiser (Excel, SharePoint, Dataverse, e-mail...).

Tratar "não encontrado" e limite

A API responde 404 quando o CNPJ não existe na base, e 429 quando você excede o limite por minuto ou a cota mensal (com o cabeçalho Retry-After, em segundos).

Por padrão, um 4xx/5xx faz a ação HTTP falhar e para o fluxo. Para tratar sem parar: na próxima ação, use Configure run after (executar mesmo se a HTTP falhar) e uma Condição sobre statusCode (por exemplo, outputs('HTTP')?['statusCode']) para ramificar 200 / 404 / 429.

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

Um fluxo aplicado a muitas linhas dispara muitas chamadas. No plano gratuito da CNPJAPI, a API aceita um número limitado de consultas por minuto; ao estourar, responde 429. Para volumes maiores:

  • Reduza o ritmo (limite de concorrência no Apply to each, ou um Delay); 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 Power Automate - é a ação HTTP genérica (premium).
  • Guarde a API key com cuidado: prefira uma variável de ambiente (environment variable) do Power Platform a deixá-la fixa no fluxo.

Próximos passos

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