Fila de emissão fiscal

O que é uma fila de emissão fiscal?

Pense numa fila de banco: as pessoas chegam, pegam uma senha e são atendidas uma a uma, sem que ninguém precise ficar empurrando no balcão. A fila de emissão fiscal funciona do mesmo jeito, só que com pedidos de notas fiscais no lugar das pessoas.

Quando um ERP, uma loja virtual ou um marketplace pede a emissão de uma nota, esse pedido não vai direto para o órgão autorizador. Ele entra numa fila, recebe uma identificação e aguarda a sua vez de ser validado, assinado e transmitido.

Para que serve a fila de emissão fiscal?

A principal função é dar estabilidade. Órgãos autorizadores, como a SEFAZ e os sistemas das prefeituras, podem ficar lentos, instáveis ou fora do ar. Sem fila, cada lentidão travaria a venda ou faria o pedido se perder.

Com a fila, o sistema que vende não precisa esperar a autorização para seguir trabalhando. Ele entrega o pedido, recebe a confirmação de que foi aceito para processamento e continua atendendo outros clientes. A fila também ajuda a absorver picos, como uma promoção que gera centenas de vendas em poucos minutos.

Como funciona a fila na prática?

O fluxo costuma ter quatro etapas: o sistema envia os dados da nota por API; a plataforma valida o conteúdo e coloca o pedido na fila; processadores retiram os pedidos em ordem, montam o XML, assinam e transmitem ao órgão; por fim, o resultado é registrado como autorizado, rejeitado ou pendente.

Esse modelo é chamado de processamento assíncrono, porque a resposta final não chega no mesmo instante do pedido. O sistema do cliente descobre o resultado consultando o status ou recebendo um aviso automático, geralmente por webhook. Em uma plataforma como o Conota, esse acompanhamento é feito até a autorização, com devolução do XML, do PDF e do status.

O que acontece quando a emissão falha dentro da fila?

Depende do tipo de falha. Se o problema é temporário, como uma instabilidade no órgão autorizador ou um tempo de resposta esgotado, a fila pode tentar de novo depois de alguns instantes, muitas vezes aumentando o intervalo entre as tentativas para não sobrecarregar o serviço.

Se o problema está nos dados, como um CFOP incorreto ou um destinatário inválido, tentar de novo não resolve. Nesse caso o documento é marcado como rejeitado, com o motivo informado, e precisa ser corrigido antes de voltar para a fila.

Qual a diferença entre fila de emissão e lote de documentos?

A fila é o mecanismo que organiza a ordem e o ritmo de processamento. O lote é um agrupamento de documentos enviados juntos em uma única transmissão. Uma fila pode processar documentos um a um ou agrupá-los em lotes, conforme o que o órgão autorizador aceita.

Em resumo: a fila responde à pergunta quando cada documento será processado, e o lote responde à pergunta quantos documentos vão na mesma remessa.

Exemplos de Fila de emissão fiscal

• Uma loja virtual recebe 500 pedidos durante uma campanha relâmpago. Cada pedido gera uma solicitação de NF-e que entra na fila, e as notas são autorizadas em sequência sem travar o checkout.
• Um software de gestão de clínicas envia NFS-e de vários prestadores. Quando o sistema de uma prefeitura fica fora do ar, os pedidos daquele município permanecem na fila e são reenviados automaticamente quando o serviço volta.
• Uma transportadora integra seu sistema para emitir CT-e e MDF-e. O operador envia o pedido, a fila processa a emissão e o sistema recebe por webhook o aviso de documento autorizado, junto com o XML e o PDF.
• Um ERP envia por engano a mesma nota duas vezes. Graças à chave de idempotência, a fila reconhece o pedido repetido e não gera um documento duplicado.