# Queue de emissão fiscal

> Queue de emissão fiscal é a fila em que um sistema organiza os pedidos de emissão de documentos fiscais, como NF-e, NFS-e e NFC-e, para processá-los em ordem e de forma assíncrona. Ela evita perda de solicitações quando a SEFAZ ou a prefeitura demora a responder e permite reenvios controlados sem travar a venda.

**Também conhecido como:** Fila de emissão fiscal, Fila de emissão de notas, Fila de processamento fiscal, Queue fiscal, Fiscal issuance queue

**Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** Q

## O que significa queue de emissão fiscal?

Queue é a palavra em inglês para fila. Na emissão fiscal, ela funciona como uma fila de atendimento: cada pedido para emitir uma nota entra no fim da fila e é atendido assim que houver capacidade para enviá-lo ao órgão autorizador, seja a SEFAZ, no caso de NF-e, NFC-e, CT-e e MDF-e, ou a prefeitura, no caso da NFS-e.

Em vez de o sistema de vendas esperar parado até a nota ser autorizada, ele apenas registra o pedido na fila e segue trabalhando. Quem cuida do envio, da espera e da resposta é o processo que consome essa fila.

## Para que serve uma fila na emissão de notas?

A principal função é dar estabilidade. Os serviços dos órgãos fiscais podem ficar lentos, instáveis ou fora do ar por algum tempo. Sem fila, cada lentidão vira erro na tela do vendedor ou do cliente. Com fila, o pedido fica guardado e é processado quando possível.

Ela também ajuda a lidar com picos de demanda. Em datas de grande movimento, um e-commerce ou marketplace pode gerar milhares de notas em poucos minutos. A fila distribui esse volume ao longo do tempo, respeitando limites de requisições e evitando sobrecarga.

## Como funciona uma queue de emissão fiscal na prática?

O fluxo costuma seguir quatro etapas. Primeiro, o sistema do cliente envia os dados da nota por API. Segundo, o pedido é validado e colocado na fila, e o sistema recebe uma confirmação de recebimento com um identificador. Terceiro, um processo interno retira o pedido da fila, monta e assina o XML e o transmite ao órgão autorizador. Quarto, a resposta, seja autorização ou rejeição, é registrada.

O resultado chega ao sistema de origem por webhook, que avisa automaticamente quando o status muda, ou por polling, quando o próprio sistema consulta o status de tempos em tempos. Esse modelo é chamado de fluxo assíncrono de emissão.

## Qual a diferença entre queue e lote de documentos fiscais?

A fila é o mecanismo de organização e espera: define a ordem e o momento em que cada pedido será processado. O lote é um agrupamento de vários documentos enviados juntos em uma única transmissão, prática prevista em alguns leiautes fiscais.

Os dois conceitos podem coexistir. Uma fila pode receber notas uma a uma e, em determinado momento, agrupá-las em um lote para envio. Mas ter fila não significa necessariamente enviar em lote, e vice-versa.

## O que acontece quando um item da fila dá erro?

Depende do tipo de erro. Falhas temporárias, como timeout ou indisponibilidade do órgão autorizador, geralmente levam a novas tentativas automáticas, muitas vezes com backoff exponencial, que aumenta o intervalo entre uma tentativa e outra.

Já rejeições fiscais, como CFOP incompatível ou dados do destinatário inválidos, não se resolvem tentando de novo. Nesses casos, o pedido sai da fila com o motivo da rejeição, e o sistema de origem precisa corrigir os dados e enviar um novo pedido. Uma boa fila também usa idempotência para impedir que a mesma venda gere duas notas.

## Quem precisa se preocupar com a fila de emissão?

Empresas que desenvolvem ERPs, plataformas de venda, marketplaces e softwares de gestão precisam de alguma estratégia de fila sempre que emitem notas em volume. Construir isso internamente envolve controlar reenvios, ordem, falhas, logs e monitoramento.

Quando a emissão é feita por uma API fiscal como a do Conota, a fila e o acompanhamento até a autorização ficam a cargo da infraestrutura de emissão. O sistema do cliente apenas envia o pedido e recebe de volta o status, o XML e o PDF.

## Exemplos de Queue de emissão fiscal

- Um e-commerce recebe 3 mil pedidos durante uma promoção. Cada pedido aprovado gera uma solicitação de NF-e que entra na fila e é transmitida à SEFAZ gradualmente, sem travar o checkout.
- Uma plataforma de serviços envia pedidos de NFS-e enquanto o sistema da prefeitura está instável. As solicitações ficam na fila e são reenviadas automaticamente quando o serviço volta a responder.
- Um ERP envia uma NF-e e recebe imediatamente um identificador do pedido. Minutos depois, um webhook informa que a nota foi autorizada e disponibiliza o XML e o DANFE.
- Uma transportadora gera CT-e e MDF-e para várias viagens ao mesmo tempo. A fila garante que o MDF-e só seja processado após a autorização dos CT-e vinculados.

## Perguntas frequentes

### Queue de emissão fiscal e fila de emissão fiscal são a mesma coisa?

Sim. Queue é apenas o termo em inglês para fila. Ambos descrevem o mecanismo que organiza e processa, em ordem e de forma assíncrona, os pedidos de emissão de documentos fiscais.

### A fila deixa a emissão da nota mais lenta?

Normalmente não. Em condições normais, o pedido é processado em segundos. A fila apenas evita que o sistema de vendas fique esperando e garante que nenhum pedido se perca quando o órgão autorizador estiver lento ou indisponível.

### Como sei que a nota saiu da fila e foi autorizada?

Pelo status do documento, informado por webhook ou consultado por polling na API. Quando autorizada, a nota passa a ter protocolo de autorização, e o XML e o PDF ficam disponíveis para download.

### Uma nota rejeitada volta sozinha para a fila?

Não. Rejeições por erro nos dados exigem correção. O sistema de origem deve ajustar as informações indicadas no motivo da rejeição e enviar um novo pedido de emissão.

## Termos relacionados

- [Fila de emissão fiscal](https://conota.dev/glossario/fila-de-emissao-fiscal.md)
- [Fluxo assíncrono de emissão](https://conota.dev/glossario/fluxo-assincrono-de-emissao.md)
- [Processamento assíncrono](https://conota.dev/glossario/processamento-assincrono.md)
- [Retry na integração fiscal](https://conota.dev/glossario/retry-na-integracao-fiscal.md)
- [Idempotência na emissão fiscal](https://conota.dev/glossario/idempotencia-na-emissao-fiscal.md)
- [Lote de documentos fiscais](https://conota.dev/glossario/lote-de-documentos-fiscais.md)

---

Fonte: [Queue de emissão fiscal](https://conota.dev/glossario/queue-de-emissao-fiscal/) · Atualizado em 2026-10-22
