Consulta API NFSe Nacional (gov.br) – intervalo ideal de job / boas práticas

Contribuinte API Nacional Produção
,
1

Pessoal,

Tenho uma aplicação interna que consome o web service do Portal Nacional de NFSe (gov.br) para consulta de documentos/eventos.

A integração é feita via jobs agendados, buscando NFSe novas ou alteradas desde a última consulta (controle por período incremental).

Gostaria de saber, na prática:

  • Qual intervalo de execução vocês utilizam em produção? (ex: 5, 10, 15 minutos, mais?)

  • Alguém já enfrentou bloqueio, lentidão ou erro por consulta muito frequente?

A documentação não deixa muito claro o limite ideal e queria ouvir experiências reais de quem já usa em produção.

Se puderem compartilhar como estruturaram o job qual é o intervalo de vocês eu agradeço.

Obrigado!

2

Salve amigo,

Para mim está funcionando com intervalos de 10 a 15 minutos para sincronização automática.

**Alguns problemas que passei:
**
O portal retorna 400 se você passar a chave de acesso incompleta. A chave NFS-e tem 50 dígitos (não 44 como NFe).

Não encontrei bloqueio hard, mas percebi lentidão quando fiz muitas requisições seguidas (tipo baixar 50 XMLs em sequência). Implementei um delay de 200 a 500ms entre downloads e resolveu.

Se você usa autenticação CNPJ/senha e não por certificado digital, a sessão expira rápido. Precisa re-autenticar a cada batch de operações.

HTTP 503, acontece esporadicamente, principalmente em horários de pico. Implementei retry com backoff exponencial (2s, 4s, 8s).

3

Se precisar fazer muitas consultas da pra coloca pra ser uma a cada 10 segundos ou 6 por minuto, acima disso muito provável que vai receber um bloqueio