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.