Worker de emissão fiscal

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.