Planos e Limites

A FiscalAPI oferece quatro planos para atender desde desenvolvedores individuais até grandes empresas. Todos os planos incluem acesso à mesma API — a diferença está nos limites de uso e no nível de suporte.

Comparação de planos

Conta sem plano ativo pode ter até 2 chaves de API ativas.

O limite mensal é global — conta o total de chamadas a qualquer endpoint (IE, CNPJ, Simples Nacional, CND, Perfil Produtor, SIGEF, NF-e, NFS-e). Não há limites separados por endpoint. Algumas consultas contam como mais de uma: a NF-e com certificado conta como 3 consultas por nota nos planos Lite, Starter e Pro; no Enterprise, sai a R$ 0,025 por nota, dentro das 10.000 consultas do plano. O CNPJ ao vivo na Receita conta como 3 consultas.

A NF-e sem certificado conta como 3 consultas por nota nos planos Lite, Starter e Pro; no Enterprise, sai a R$ 0,05 por nota. Ela não entra nas consultas grátis do mês.

A NFS-e por chave tem o mesmo preço da NF-e sem certificado, mas só cobra a nota entregue (nota não encontrada não é cobrada). No painel, entra nas consultas grátis do mês (gasta 1 das 10).

NF-e e CNPJ ao vivo têm preço próprio na recarga, informado no painel.

Consultas grátis

Conta que nunca assinou plano, com e-mail confirmado e sem recarga, tem 10 consultas grátis por mês, só no painel. Pela API (chave X-API-Key), o MCP, os SDKs e o Postman, toda consulta pede plano ou recarga, a partir de R$ 19,99/mês. No painel, um só contador vale para qualquer consulta avulsa: IE em um estado, CNPJ (inclusive ao vivo), Simples Nacional, NFS-e, CND estadual de um estado, CND Federal, CNDT, CRF/FGTS, Perfil do Produtor, CNIR e SIGEF.

• Cada consulta entregue gasta 1 das 10, mesmo as que custam 3 num plano. Erro não gasta.
• Ficam fora: NF-e sem certificado, IE em todos os estados, CND de todos os estados, todas as certidões de uma vez e as consultas em lote (IE por planilha, NF-e em lote).
• À parte, 10 XML de NF-e com certificado por mês, também só no painel.
• As grátis renovam no dia 1º de cada mês. Acabam na primeira assinatura e não voltam depois de cancelar.

Monitoramento de uso

Acompanhe seu consumo em tempo real pelo Dashboard. A página de uso exibe:

• Quantidade de requisições realizadas por endpoint
• Percentual do limite mensal utilizado
• Histórico de consumo dos últimos 30 dias

Quando o limite é excedido

Quando a franquia do mês e a recarga não cobrem a consulta, a API retorna HTTP 402 Payment Required:

{
  "error": "LIMITE_ATINGIDO",
  "usage": 500,
  "limit": 500,
  "plan": "starter",
  "extra_credits": 0,
  "cost": 1,
  "consultas_restantes": 0,
  "message": "Seu saldo não cobre esta consulta. Faça uma recarga no painel ou mude de plano."
}

Upgrade de plano

Para aumentar seus limites:

1. Acesse o Dashboard
2. Navegue até Configurações > Assinatura
3. Escolha o novo plano e confirme

O upgrade é aplicado imediatamente e os novos limites entram em vigor na hora. Você só será cobrado proporcionalmente ao período restante do mês.

Perguntas frequentes

Os limites são por API Key ou por conta?

Os limites são por conta (usuário). Créditos, franquia do mês e rate limit são da conta: se você tiver várias API Keys, o uso de todas elas é somado. O Dashboard mostra quanto cada chave consumiu no mês.

Quantas API Keys posso ter?

Depende do plano: 2 em conta sem plano ativo e no Lite, 3 no Starter, 10 no Pro e 25 no Enterprise, contando só as chaves ativas. Chaves revogadas não contam. Ao atingir o limite, revogue uma chave que não usa mais ou mude de plano. Se você mudar para um plano com limite menor, as chaves que já existem continuam funcionando; só não dá para criar novas até ficar abaixo do limite. Veja Autenticação. Para testes, há também as chaves de homologação: veja Homologação.

Posso comprar mais consultas?

Sim. Assinantes Starter, Pro e Enterprise podem recarregar a quantidade de consultas que quiserem direto no Dashboard (Starter R$ 0,12 por consulta, Pro R$ 0,07, Enterprise R$ 0,02; NF-e e CNPJ ao vivo têm preço próprio, informado no painel). Escolha um dos pacotes prontos ou digite a quantidade, a partir do menor pacote do plano, em múltiplos de 100 e até 2 milhões por compra, pagando por PIX ou cartão. A recarga não expira e só é usada depois que a franquia do plano acaba. O plano Lite não tem recarga — o caminho é fazer upgrade. Para negociar preço em volumes maiores, entre em contato pelo email contato@fiscalapi.com.br.

O que acontece com consultas em cache?

Consultas respondidas pelo cache cobram o custo normal da consulta — 1 consulta na maioria dos endpoints; na NF-e com certificado, 3 consultas (Lite, Starter, Pro) ou R$ 0,025 por nota no Enterprise — pois toda resposta com dado útil conta no limite mensal (erros e consultas sem dado não são cobrados). O benefício do cache é a velocidade: a resposta vem em milissegundos, sem ida ao portal de origem. Você identifica uma resposta de cache pelo campo cached: true.

Planos e preços