SEFAZ ainda não permite nova consulta

code: nfe.consulta_bloqueada · HTTP 409

Quando ocorre

Depois de "nenhum documento" (cStat 137), de consumo indevido (656) ou de alcançar o último NSU, a SEFAZ exige 1 hora antes da próxima consulta; consultar antes geraria o 656 e reiniciaria a espera. proximaConsultaEm traz o horário liberado.

Como resolver

1. Aguarde os segundos do cabeçalho Retry-After antes de pedir de novo.
2. Não é preciso antecipar: a rotina automática consulta a cada 5 minutos respeitando a regra.

Na resposta

O erro chega em application/problem+json (RFC 9457) com "code": "nfe.consulta_bloqueada" e "type": "https://nf.digla.io/api/erros/nfe.consulta_bloqueada". Decida pelo code; title e detail são texto para pessoas e podem mudar. Guarde o requestId ao falar com o suporte.