Consulta de status

A consulta de status permite acompanhar o andamento e o resultado de uma NFS-e ou evento fiscal enviado por meio do NFS-e Messenger.

Essa funcionalidade é essencial para garantir visibilidade operacional sobre o processamento governamental.

Objetivo da consulta de status

A consulta de status permite ao sistema emissor:

  • Verificar se a NFS-e foi processada

  • Identificar o estado atual da nota

  • Obter o resultado final do processamento

  • Acompanhar mensagens retornadas pelo governo

O status reflete exatamente a situação informada pelo órgão governamental.


Quando consultar o status

A consulta de status deve ser utilizada quando:

  • O envio da NFS-e não retorna resultado imediato

  • A nota encontra-se Em processamento

  • É necessário confirmar a autorização ou rejeição

  • O processo envolve eventos fiscais (ex: cancelamento)

Em fluxos assíncronos, a consulta é parte fundamental da operação.


Estados retornados

A consulta pode retornar estados como:

  • Enviada

  • Em processamento

  • Autorizada

  • Rejeitada

  • Cancelada

Cada estado indica um momento específico do ciclo de vida da nota ou evento.


Mensagens de retorno

Além do estado, a consulta pode disponibilizar:

  • Mensagens informativas

  • Códigos de rejeição

  • Detalhes retornados pelo Portal Nacional

Essas mensagens auxiliam na tomada de decisão e correção de dados, quando necessário.


Frequência de consulta

A frequência de consulta depende do cenário operacional:

  • Em processamentos rápidos, poucas consultas são suficientes

  • Em cenários assíncronos, pode ser necessário consultar até a conclusão

O NFS-e Messenger gerencia o acompanhamento sem exigir intervenção manual no portal governamental.


Importante sobre a consulta

  • A consulta não altera o estado da NFS-e

  • Ela apenas recupera a situação atual

  • O resultado depende exclusivamente do processamento governamental


Em resumo

  • A consulta de status permite acompanhar o ciclo da NFS-e

  • Ela é fundamental em fluxos assíncronos

  • Os estados refletem o retorno oficial do governo

  • O histórico permanece centralizado no NFS-e Messenger

Atualizado