Pular para conteúdo
FiscalAPI

API fiscal para desenvolvedores: IE, CND, certidões e NF-e em JSON

Inscrição Estadual nos 27 estados, CNPJ, Simples Nacional, certidões, XML de NF-e e imóveis rurais numa API REST. Você envia o documento e recebe JSON, com cURL ou com o SDK em Python, Node ou PHP.

Criar conta grátisGuia da primeira chamada

10 consultas grátis por mês para conta nova: IE em um estado e CNPJ da base mensal, no painel e pela API.

Depois, planos a partir de R$ 19,99/mês. Quase toda consulta gasta 1 crédito.

Atualizado em

Primeira chamada (exemplo com dados fictícios)

curl "https://api.fiscalapi.com.br/api/consultar-cnpj?cnpj=12345678000195" \
  -H "X-API-Key: SUA_CHAVE_API"

Resposta, resumida

{
  "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "cnpj": "12345678000195",
  "cached": false,
  "source_status": { "status": "success" },
  "result": {
    "razao_social": "EMPRESA EXEMPLO LTDA",
    "situacao_cadastral": "ATIVA",
    "matriz_filial": "MATRIZ",
    "opcao_pelo_simples": true
  }
}

SDKs e n8n

Bibliotecas oficiais e de código aberto. Os SDKs de Python, Node e PHP esperam e tentam de novo sozinhos quando recebem 429.

  • Python

    pip install fiscalapi-br

    GitHubPyPI

  • Node.js e TypeScript

    npm i fiscalapi-br

    GitHubnpm

  • PHP

    composer require fiscalapi-br/fiscalapi-php

    GitHubPackagist

  • n8n

    n8n-nodes-fiscalapi

    Nó da comunidade: instale pelo nome do pacote.

    GitHubnpm

Cobrem IE, CNPJ, certidões, XML da NF-e com certificado, SIGEF, CNIR e perfil do produtor. NF-e sem certificado, Simples Nacional e saldo, por enquanto, pela API direto.

Limites por plano

Requisições por minuto, créditos por mês e preço de cada plano
PlanoPor minutoCréditos/mêsPreço
Grátis (conta nova)510 de IE (um estado) e CNPJR$ 0
Lite530R$ 19,99/mês
Starter20500R$ 50/mês
Pro602.000R$ 130/mês
Enterprise12010.000a partir de R$ 250/mês
  • O limite é por conta: as requisições de todas as chaves somam.
  • IE, CNPJ, CND, certidões e perfil do produtor devolvem X-RateLimit-Limit, -Remaining e -Reset. Todo 429 traz Retry-After, em segundos.
  • NF-e: uma chave de acesso por chamada. Sem certificado: até 30 por minuto no Pro e no Enterprise (no Lite e no Starter, o limite do plano) e 2 ao mesmo tempo por conta, somando painel e API.

Limites na documentaçãoDisponibilidade por produto agora

O que é grátis

  • 10 consultas por mês de IE (um estado) e CNPJ, no painel e pela API

    Para conta nova, com e-mail confirmado, que nunca assinou plano nem comprou recarga. Vale /api/consultar e o CNPJ da base mensal (/api/consultar-cnpj, sem force_fresh), com a mesma chave. Planilha, IE nos 27 estados e CNPJ ao vivo ficam fora.

  • 10 XML de NF-e com certificado por mês, só no painel

    Na mesma conta nova, à parte das consultas de IE e CNPJ. O XML sem certificado não entra.

  • Saldo, status da SEFAZ e rejeições: sempre sem custo

    GET /api/saldo, /api/v1/sefaz/status e /api/v1/rejeicoes.

  • Pede plano ou saldo

    Certidões, XML de NF-e (com e sem certificado), IE nos 27 estados, Simples Nacional, CNPJ ao vivo, perfil do produtor, SIGEF e CNIR. Sem plano ou saldo, a resposta é 402.

Erros que você vai ver

Códigos de erro da API, o que significam e o que fazer
StatusCódigoO que significaO que fazer
400PARAMETRO_AUSENTE · DOCUMENTO_INVALIDO · CHAVE_INVALIDAFaltou o documento, ou o CPF, CNPJ, IE ou a chave de acesso está fora do formato.Corrija antes de repetir. Não é cobrado.
402LIMITE_ATINGIDOAcabaram as consultas do mês e não há saldo. A resposta traz o custo da chamada e o uso do plano.Assine ou troque de plano, ou compre recarga (a partir do Starter).
403API_KEY_ERRORChave ausente, inválida ou revogada no header X-API-Key.Confira a chave em Chave API, no painel.
422—Corpo ou parâmetro fora do formato esperado (ex.: POST da NF-e sem o campo chave).Confira os campos na documentação do endpoint.
429RATE_LIMIT_EXCEEDED · CONSULTAS_SIMULTANEASPassou do limite por minuto do plano, ou de 2 consultas ao mesmo tempo no XML sem certificado.Espere os segundos do header Retry-After e repita.

Em CNPJ, CND e certidões, documento inválido pode voltar 200 com source_status.error_code (CNPJ_INVALIDO, CPF_INVALIDO): confira sempre o source_status. Erro 5xx não é cobrado: tente de novo com espera.

Todos os erros na documentação

Na documentação

Servidor MCP para Claude, Cursor e VS Code: github.com/fiscalapi-br/fiscalapi-mcp

Perguntas frequentes

Tem SDK em Python?

Sim: pip install fiscalapi-br. Também há SDK para Node.js e TypeScript (npm i fiscalapi-br), para PHP (composer require fiscalapi-br/fiscalapi-php) e um nó para o n8n (n8n-nodes-fiscalapi). Em outras linguagens, a API é REST com JSON e funciona com qualquer cliente HTTP.

Quanto custa uma consulta?

A maioria gasta 1 crédito: de R$ 0,67 no Lite a R$ 0,025 no Enterprise, e R$ 0,02 na recarga do Enterprise. XML de NF-e e CNPJ ao vivo gastam 3 créditos; no Enterprise, a NF-e com certificado sai a R$ 0,025 e a sem certificado a R$ 0,05. Consulta que dá erro não é cobrada. Veja os planos.

Qual o limite por minuto?

Depende do plano: Lite 5, Starter 20, Pro 60 e Enterprise 120 requisições por minuto, somando todas as chaves da conta. Passou do limite, a API devolve 429 com o header Retry-After.

Tem teste grátis pela API?

Tem. Conta nova, com e-mail confirmado, que nunca assinou plano nem comprou recarga, faz 10 consultas por mês de Inscrição Estadual em um estado e de CNPJ da base mensal, no painel ou pela API, com a mesma chave. Planilha, IE nos 27 estados, CNPJ ao vivo, certidões, NF-e e as demais consultas pedem plano ou saldo.

Como faço a primeira chamada?

Crie a conta, copie a chave em Chave API, no painel, e envie no header X-API-Key, como no exemplo do topo. O passo a passo, com exemplos em JavaScript, Python e PHP, está na Primeira consulta da documentação.

Gere a chave e faça a primeira chamada.

10 consultas grátis por mês para conta nova: IE em um estado e CNPJ da base mensal, no painel e pela API.

Criar conta grátisGuia da primeira chamada