Workflow de emissão fiscal

O que é um workflow de emissão fiscal?

Workflow significa fluxo de trabalho. Na emissão fiscal, é o caminho padronizado que todo documento percorre para se tornar válido: os dados saem do sistema que fez a venda, são conferidos, transformados no formato exigido, assinados digitalmente, enviados à SEFAZ ou à prefeitura e, por fim, autorizados ou rejeitados.

Pensar a emissão como um workflow ajuda a enxergar que emitir uma nota não é um único clique, mas uma série de passos que podem dar certo ou errado de forma independente. Cada passo tem entradas, saídas e possíveis falhas que precisam ser tratadas.

Quais são as etapas de um workflow de emissão fiscal?

De forma simplificada, as etapas costumam ser: coleta dos dados da operação (emitente, destinatário, itens, impostos); validação das regras fiscais e do esquema XML; montagem do documento; assinatura digital com o certificado da empresa; transmissão ao órgão autorizador; recebimento do protocolo de autorização ou do motivo de rejeição; e geração dos arquivos finais, como o XML e o DANFE.

Depois da autorização, o workflow pode continuar com eventos posteriores, como cancelamento, carta de correção ou, no caso do MDF-e, o encerramento. Também entram aqui a guarda dos documentos e o registro de cada etapa para auditoria.

Por que o workflow costuma ser assíncrono?

Os órgãos autorizadores nem sempre respondem na hora. Algumas prefeituras e serviços processam documentos em lote e devolvem o resultado depois, e instabilidades podem atrasar a resposta. Por isso, muitos workflows usam processamento assíncrono: o sistema envia o pedido, recebe uma confirmação de que ele entrou na fila e é avisado depois sobre o resultado.

Esse aviso pode chegar por webhook, quando o emissor notifica o sistema automaticamente, ou por polling, quando o próprio sistema consulta o status de tempos em tempos. Assim, a venda não fica travada esperando a resposta do governo.

Como o workflow lida com erros e rejeições?

Um bom workflow distingue dois tipos de problema. Erros temporários, como timeout ou indisponibilidade do órgão, podem ser resolvidos com novas tentativas automáticas, muitas vezes usando backoff exponencial. Já rejeições fiscais, como CFOP incompatível ou dados do destinatário inválidos, exigem correção dos dados antes de reenviar.

Para evitar notas duplicadas durante essas novas tentativas, usa-se idempotência: cada pedido recebe um identificador único, e o emissor reconhece quando a mesma solicitação chega mais de uma vez.

Quem executa o workflow: o sistema da empresa ou uma API fiscal?

Uma empresa pode construir todo o workflow dentro do próprio ERP ou plataforma, mas isso exige lidar com leiautes diferentes por documento e por município, certificados, filas, reprocessamento e mudanças trazidas por notas técnicas.

A alternativa é delegar parte do fluxo a uma API fiscal. No Conota, por exemplo, o sistema do cliente continua cuidando da venda e envia os dados por API; a infraestrutura assume a assinatura, a transmissão, o acompanhamento até a autorização e devolve XML, PDF e status automaticamente. Rejeições e certificados ficam visíveis em um Console, e agentes de IA podem consultar documentos via MCP com permissões controladas.

Qual a diferença entre workflow e orquestração de emissão fiscal?

O workflow é o desenho das etapas: o que acontece e em que ordem. A orquestração é o mecanismo que coordena essas etapas na prática, decidindo quando enviar, quando tentar novamente, para qual fila mandar cada documento e como registrar o resultado. Em resumo, o workflow é o roteiro e a orquestração é quem garante que ele seja seguido.

Exemplos de Workflow de emissão fiscal

• Um e-commerce conclui uma venda, envia os dados do pedido por API e recebe um webhook minutos depois com a NF-e autorizada, o XML e o DANFE para anexar ao e-mail do cliente.
• Uma software house de gestão para clínicas monta um workflow em que cada consulta paga gera automaticamente uma NFS-e; quando a prefeitura rejeita por código de serviço incorreto, o sistema alerta o usuário para corrigir e reenviar.
• Uma transportadora integra ao seu sistema um workflow que emite o CT-e de cada frete, depois o MDF-e da viagem e, ao final da entrega, registra o evento de encerramento do manifesto.
• Um PDV de varejo emite NFC-e em fluxo rápido e, quando a SEFAZ está instável, aciona tentativas automáticas sem duplicar a nota graças à chave de idempotência.