# Worker de emissão fiscal > Worker de emissão fiscal é um processo que roda em segundo plano, separado do sistema de vendas, responsável por retirar documentos de uma fila, montar e assinar o XML, enviar à SEFAZ ou prefeitura, aguardar a resposta e registrar o resultado, como autorização ou rejeição, sem travar o atendimento ao cliente. **Também conhecido como:** Worker fiscal, Processador de emissão fiscal, Consumidor da fila de emissão, Job de emissão fiscal, Tax document issuance worker **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** W ## O que é um worker de emissão fiscal? Worker, em inglês, significa trabalhador. Em tecnologia, é um programa que fica rodando nos bastidores executando tarefas que chegam por uma fila. No contexto fiscal, o worker é quem efetivamente faz o trabalho pesado de emitir notas: pega o pedido de emissão, transforma em documento fiscal válido e conversa com o órgão autorizador. Ele não interage com o usuário final. Enquanto o ERP, a loja virtual ou o marketplace registram a venda e seguem atendendo, o worker processa a nota em paralelo e avisa quando ela estiver pronta. ## Para que serve um worker de emissão fiscal? Serve para separar a emissão da venda. A comunicação com SEFAZ e prefeituras pode demorar, oscilar ou ficar indisponível. Se o sistema de vendas esperasse cada resposta, o cliente ficaria travado na tela. Com o worker, a venda é concluída e a nota segue seu caminho de forma assíncrona. Ele também permite lidar com volume. Em dias de pico, os pedidos se acumulam na fila e vários workers podem trabalhar ao mesmo tempo, processando os documentos de forma organizada, sem perder nenhum. ## Como funciona um worker de emissão fiscal? O ciclo típico é: o sistema envia o payload de emissão, que entra na fila; o worker retira o item, valida os dados, monta o XML no leiaute exigido, assina com o certificado digital e transmite ao autorizador. Depois, consulta ou recebe o retorno e grava o status: autorizada, rejeitada ou pendente. Quando há falha temporária, como timeout ou instabilidade do servidor público, o worker faz novas tentativas com intervalos crescentes (backoff exponencial). Para não emitir a mesma nota duas vezes, usa controles de idempotência. Ao final, notifica o sistema de origem, por webhook ou deixando o resultado disponível para consulta. ## Qual a diferença entre worker e fila de emissão fiscal? A fila é o lugar onde os pedidos esperam sua vez; o worker é quem os processa. Uma analogia simples: a fila é a pilha de pedidos na cozinha de um restaurante, e o worker é o cozinheiro que pega cada pedido e prepara o prato. Os dois trabalham juntos. Sem fila, o worker não teria como receber tarefas de forma ordenada; sem worker, a fila apenas acumularia pedidos sem que nenhuma nota fosse emitida. ## Preciso construir meus próprios workers de emissão? Depende da estratégia. Construir internamente exige lidar com certificados, leiautes que mudam por notas técnicas, regras de cada prefeitura, contingência, retentativas, monitoramento e escala. É um esforço contínuo de manutenção. Ao usar uma API fiscal como o Conota, essa camada de workers fica do lado do provedor. O sistema do cliente apenas envia a requisição e recebe XML, PDF e status automaticamente, concentrando-se na regra de negócio da venda. ## Exemplos de Worker de emissão fiscal - Um e-commerce registra 3 mil pedidos durante uma promoção; cada pedido gera uma tarefa na fila e os workers emitem as NFC-e ou NF-e em paralelo, enquanto o checkout continua rápido. - Uma plataforma de serviços envia uma NFS-e e a prefeitura está fora do ar; o worker reprograma novas tentativas automaticamente até conseguir a resposta ou registrar a falha. - Uma transportadora emite CT-e e, em seguida, o worker gera o MDF-e da viagem, atualizando o status de cada documento no sistema de gestão. - Um ERP recebe por webhook o aviso de que o worker obteve a autorização da NF-e, junto com o XML e o DANFE, e libera o faturamento do pedido. ## Perguntas frequentes ### O worker de emissão fiscal é um software separado? Geralmente sim. É um processo independente do sistema principal, que pode rodar em servidores ou contêineres próprios e ser multiplicado conforme a demanda, sem afetar a aplicação que atende os usuários. ### O que acontece se o worker falhar no meio da emissão? Em uma arquitetura bem feita, a tarefa volta para a fila e outro worker a retoma. Controles de idempotência e consulta de status evitam que a mesma nota seja emitida em duplicidade. ### Worker e processamento assíncrono são a mesma coisa? Não exatamente. Processamento assíncrono é o modelo em que a resposta não é imediata; o worker é o componente que executa esse processamento nos bastidores. ### Quem usa uma API fiscal precisa gerenciar workers? Normalmente não. O provedor da API mantém os workers, filas e retentativas. O sistema do cliente apenas envia os dados e acompanha o status ou recebe notificações. ## Termos relacionados - [Fila de emissão fiscal](https://conota.dev/glossario/fila-de-emissao-fiscal.md) - [Processamento assíncrono](https://conota.dev/glossario/processamento-assincrono.md) - [Fluxo assíncrono de emissão](https://conota.dev/glossario/fluxo-assincrono-de-emissao.md) - [Orquestração de emissão fiscal](https://conota.dev/glossario/orquestracao-de-emissao-fiscal.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) --- Fonte: [Worker de emissão fiscal](https://conota.dev/glossario/worker-de-emissao-fiscal/) · Atualizado em 2026-10-22