---
updatedAt: 2026-09-14T18:34:24.000Z
agentTools:
  projectIndex: https://doc.focusnfe.com.br/llms.txt
---

# Cuidado com o Rate-Limit

A API da Focus NF-e possui um *rate limit* padrão de **100 requisições por minuto por token**, volume suficiente para a maioria das aplicações.

 Projetos de alto volume de emissão podem solicitar a ampliação desse limite junto ao suporte técnico.

Para otimizar a integração e evitar o bloqueio de requisições (**HTTP 429 Too Many Requests**), siga as boas práticas abaixo:

* **Utilize Webhooks:** Elimine a necessidade de consultas periódicas (polling). Nossa API notifica a sua aplicação via callback assim que o processamento do documento for finalizado pela SEFAZ ou prefeitura.
* **Adote Backoff Progressivo: **Caso o uso de webhooks não seja possível, evite consultas em loop contínuo. Autorizações assíncronas podem levar de alguns segundos a vários minutos. Configure um tempo de espera inicial antes da primeira consulta e aumente gradativamente o intervalo entre as tentativas subsequentes.
* **Armazene os Retornos Localmente:** Salve no seu banco de dados as respostas de processamento, chaves de acesso e links de XML/PDF. Evite reconsultar a API para buscar dados que seu sistema já recebeu.
* **Trate Erros e Interrompa Retentativas Invalidadas:** Interprete os códigos de erro retornados pela API (como falhas de validação de schema ou rejeições da SEFAZ). Não reenvie a mesma requisição repetidamente sem antes corrigir os dados do payload.