Limites e Cota

Requisições por minuto e NFS-e de produção por mês.

​

Requisições por minuto

Cada Conta tem um limite de requisições por minuto, somando todas as suas Chaves e a sessão do painel. Ao estourar:

HTTP/1.1 429 Too Many Requests
Retry-After: 2

{"erro": {"codigo": "limite_de_requisicoes", "mensagem": "Muitas requisições; tente de novo em instantes."}}

Espere os segundos de Retry-After e repita. Para acompanhar Notas, consulte a cada poucos segundos em vez de em laço contínuo.

​

Cota mensal

A Cota é o número de NFS-e de produção que a Conta pode emitir no mês (horário de Brasília). Homologação não conta.

curl $NOTASX/v1/cota -H "Authorization: Bearer $CHAVE"

{"mes": "2026-11-01", "limite": 100, "usadas": 12, "pendentes": 3}

• usadas: NFS-e emitidas em produção no mês. Cada NFS-e desconta da Conta que criou a Nota.
• pendentes: Notas de produção ainda sem resultado. Elas contam contra o limite na hora de criar Notas novas, para você não passar da Cota com muitas Notas na fila.
• Rejeição e Falha não consomem Cota.

Quando usadas + pendentes chega ao limite, criar Nota em produção responde 429 cota_esgotada, com Retry-After em segundos até o início do próximo mês.