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

O limite mensal é global — conta o total de chamadas a qualquer endpoint (IE, CNPJ, CND, Perfil Produtor, SIGEF). Não há limites separados por endpoint. Consultas de maior custo debitam mais créditos por chamada: a NF-e completa por chave custa 3 créditos por nota (valores em R$/nota na tabela acima, pela franquia de cada plano).

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

Ao atingir o limite mensal (e esgotar eventuais créditos extras), a API retorna HTTP 402 Payment Required com detalhes do uso:

{
  "error": "LIMITE_ATINGIDO",
  "usage": 500,
  "limit": 500,
  "plan": "starter"
}

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). Se você tiver múltiplas API Keys, o uso de todas elas é somado.

Posso comprar consultas extras?

Sim. Assinantes Starter, Pro e Enterprise podem comprar pacotes de consultas extras direto no Dashboard (Starter R$ 0,12/consulta, Pro R$ 0,07, Enterprise R$ 0,02). Os créditos extras não expiram e só são debitados depois que a cota mensal do plano acaba. O plano Lite não tem pacotes — o caminho é fazer upgrade. Para 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 crédito na maioria dos endpoints, 3 créditos na NF-e completa — pois toda resposta com dado útil conta no limite mensal (erros e consultas sem dado não cobram). 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.