Fila de emissão e falhas

Ao final deste capítulo, você saberá acompanhar uma nota desde a entrada na fila até a conclusão, distinguir uma espera de uma falha e decidir quando usar Reprocessar.

Entenda o que entra na fila

Abra Fila para acompanhar emissões assíncronas criadas por:

• uma emissão avulsa enviada pela tela;
• cada linha válida de um lote CSV;
• uma execução de cobrança recorrente;
• uma emissão enviada pela API;
• um job com erro enviado novamente por Reprocessar.

A tabela mostra ID, Status, Tentativas, número da NFS-e, criação e conclusão. Enquanto houver trabalho pendente ou em processamento, Atualizar automaticamente consulta o estado a cada 2,5 segundos. Você também pode clicar em Atualizar.

Acompanhe as etapas da emissão

Durante o processamento, a linha pode mostrar estas etapas, com os rótulos literais da tela:

• Enfileirada: o pedido foi registrado e aguarda uma tentativa;
• Transmitindo: a DPS está sendo enviada à prefeitura;
• Persistindo: o sistema está registrando a resposta e os dados da nota;
• Concluída: o processamento terminou com sucesso;
• Falha: o limite de tentativas acabou ou ocorreu uma falha definitiva.

Entenda os estados do job

Os cartões e a coluna Status usam quatro estados:

• Pendente: o job aguarda a primeira tentativa ou uma retentativa já agendada;
• Processando: o sistema assumiu o job e está executando as etapas;
• Concluído: a emissão terminou e a linha apresenta o número da NFS-e quando disponível;
• Erro: o job não será tentado novamente de forma automática e pode exibir Reprocessar.

Cada job começa com no máximo 3 tentativas. Depois de uma falha temporária, a próxima tentativa é agendada com espera crescente: 2 minutos depois da primeira e 4 minutos depois da segunda. Ao chegar à terceira falha, o estado passa para Erro. Uma emissão presa em Processando por mais de 15 minutos volta automaticamente para Pendente. O bloqueio por falta de plano ou teste expirado é definitivo e não aguarda as demais tentativas.

Existe ainda uma proteção específica para conflito de numeração E0014: dentro de uma tentativa do job, o sistema pode gerar e testar até 5 números de DPS antes de devolver a falha. Esse mecanismo não altera o contador de 3 tentativas mostrado na fila.

Saiba como o sistema evita uma nota duplicada

Antes de repetir uma transmissão que ficou sem resposta, o sistema verifica se aquele mesmo pedido já produziu uma nota ou consulta a DPS anterior na prefeitura. Se a nota já estiver autorizada, ele aproveita o resultado e conclui DANFSe, boleto e e-mail sem transmitir outra vez; o Histórico registra um evento de reconciliação. Se a consulta estiver indisponível, a tentativa é adiada para evitar duplicidade. Somente quando a prefeitura confirma que a DPS anterior não foi localizada o sistema prepara uma nova DPS.

Reprocesse manualmente somente depois de corrigir a causa

1. Localize um job com Erro e abra a mensagem apresentada.

2. Consulte a nota e seus eventos em Histórico para entender a causa.

3. Corrija o cadastro, a configuração ou o dado indicado.

4. Volte à Fila e clique em Reprocessar. O botão existe somente para jobs com Erro e assinatura ativa.

5. O job volta a Pendente, limpa o erro anterior e reinicia o contador em 0/3. Acompanhe-o com Atualizar automaticamente ou Atualizar.

Não reprocese uma rejeição fiscal sem corrigir antes o campo ou cadastro apontado. Também não crie outra emissão enquanto a tentativa original estiver Pendente ou Processando, especialmente após uma resposta incerta da prefeitura: a reconciliação automática precisa terminar primeiro.

Encontre o resultado

Quando o job for Concluído, a NFS-e aparece em Histórico com seus eventos, DANFSe e demais resultados disponíveis. O e-mail é preparado após a autorização; a seção E-mails aguardando envio da própria Fila mostra eventos de Nota fiscal e boleto ou Somente nota fiscal que ainda estejam pendentes ou com erro. O destinatário recebe os documentos quando esse envio termina.

Se algo der errado

• Se um job permanecer em Processando, use Atualizar. Depois de 15 minutos, a recuperação automática deve devolvê-lo a Pendente.

• Se o erro continuar após as tentativas, não repita a ação várias vezes. Leia o evento no Histórico, corrija a causa e só então use Reprocessar.

• Consulte Mensagens de erro e o que fazer para localizar a mensagem e a ação recomendada. Nos eventos de erro da nota, use Perguntar à SKAIA para receber uma explicação contextual.

Se a falha apontar um dado fiscal, peça ao contador do cliente o valor correto e altere somente o campo indicado. A plataforma não decide a regra tributária aplicável.

Consulte também Mensagens de erro e o que fazer.