Fila de retentativas SEFAZ
O que é
Quando você emite uma nota, a SEFAZ nem sempre responde rápido. Às vezes:
- A SEFAZ está paralisada ou em manutenção
- Você bateu no limite de consultas (rate limit)
- A conexão caiu no meio do envio
Nesses casos a falha é transitória: não é erro seu, é só uma instabilidade temporária. O AutoBaze guarda a operação numa fila de retentativa e tenta de novo automaticamente, em intervalos crescentes, até conseguir.
Onde acompanhar
Vá em Configurações → Fiscal → Fila de Retry Fiscal.
A tela lista as operações que estão na fila com:
- Tipo: envio, consulta de recibo ou evento
- Serviço afetado
- Status
- Tentativas feitas e máximo permitido
- Próxima tentativa
- Último erro
Status possíveis
- Pendente: aguardando a próxima tentativa
- Processando: o sistema está tentando agora
- Sucesso: a operação foi concluída
- Falha final: esgotou as tentativas, precisa olhar
Como funciona o backoff
O sistema vai aumentando o tempo entre tentativas. Começa em segundos e vai crescendo. Se a SEFAZ continuar caindo, o intervalo aumenta pra não pressionar.
Se passar do máximo de tentativas sem sucesso, a entry vai pra Falha final e o sistema dispara um e-mail avisando.
Ações disponíveis
Pra cada entry você pode:
- Tentar agora: força uma tentativa imediata, sem esperar o intervalo
- Cancelar: marca como falha final manualmente, o sistema não tenta mais
Quando intervir
Na maioria dos casos você não precisa fazer nada, o sistema se vira sozinho. Olhe a fila quando:
- Aparecer notificação de falha final por e-mail
- Tiver muitas entries pendentes ao mesmo tempo (sinal de SEFAZ-UF caída)
- Uma nota específica não autorizou e você precisa entender por quê
Tipos de falha que NÃO entram na fila
A fila é só pra falhas transitórias. Erros definitivos (uso denegado, duplicidade, schema inválido) não entram em retentativa, porque retentar não muda nada. Esses vão direto pra Rejeitada e você precisa corrigir o cadastro.
Filtro
Você pode filtrar a lista por status (Pendente, Processando, Sucesso, Falha final) ou ver todos.
Conferindo o erro
Cada entry mostra o último erro retornado pela SEFAZ. Geralmente é uma mensagem curta com o motivo. Quando aparecer "Serviço paralisado" ou "Em manutenção", é a SEFAZ mesmo, não tem o que fazer além de esperar.
Resumo
A fila de retentativa funciona em background pra você não perder nota quando a SEFAZ instabilizar. Acompanhe só quando receber alerta ou perceber atraso em emissões.
