Reprocessamento

O reprocessamento permite reenviar uma NFS-e ou evento fiscal após falhas, rejeições ou indisponibilidades temporárias, sem necessidade de recriar o documento no sistema emissor.

O NFS-e Messenger oferece múltiplas formas de reprocessamento, garantindo flexibilidade e resiliência operacional.

Quando o reprocessamento é utilizado

O reprocessamento é indicado quando:

  • Uma NFS-e foi rejeitada e os dados foram corrigidos

  • O processamento foi interrompido por indisponibilidade governamental

  • O envio não obteve retorno conclusivo

  • É necessário repetir o envio do mesmo documento


Formas de reprocessamento

O NFS-e Messenger suporta três formas principais de reprocessamento.


Reprocessamento manual

Disponível por meio de ação manual na interface, representada por um botão de reprocessamento.

Essa opção é indicada para:

  • Correções pontuais

  • Ações operacionais assistidas

  • Casos isolados

O operador decide explicitamente quando reenviar o documento.


Reprocessamento automático (resiliência)

O serviço também oferece reprocessamento automático, executado por processos internos em segundo plano.

Esse mecanismo é utilizado quando:

  • Há falhas temporárias de comunicação

  • O Portal Nacional está indisponível

  • O retorno governamental não é conclusivo

O reenvio ocorre conforme regras de resiliência, sem intervenção manual.


Reenvio via integração

O sistema emissor pode reenviar o mesmo documento por meio da integração, utilizando o mesmo identificador externo.

Esse identificador é conhecido como:

  • external_id

Desde que o external_id seja mantido:

  • O documento não é duplicado

  • O NFS-e Messenger reconhece o reenvio como reprocessamento

  • O histórico e o estado são preservados

Essa abordagem é ideal para integrações automatizadas.


Importante sobre o external_id

O external_id é a chave de controle de idempotência do processo.

Boas práticas:

  • Gerar um identificador único por documento fiscal

  • Manter o mesmo external_id em reenvios

  • Não reutilizar o identificador para documentos diferentes

Isso garante consistência e evita duplicidade de processamento.


Limites do reprocessamento

O reprocessamento:

  • Não altera dados fiscais automaticamente

  • Não ignora regras governamentais

  • Não garante autorização se houver erro de conteúdo

Ele apenas repete o fluxo de mensageria com os dados fornecidos.


Em resumo

  • Reprocessamento permite reenviar documentos com segurança

  • Pode ser manual, automático ou via integração

  • O external_id garante que não haja duplicidade

  • O resultado final depende do processamento governamental

Atualizado