Fluxo de autorização

Esta página descreve o fluxo completo de autorização da NFS-e quando o NFS-e Messenger é utilizado como camada de mensageria fiscal.

Visão geral do fluxo

O fluxo de autorização da NFS-e envolve três componentes principais:

  1. Sistema emissor

  2. NFS-e Messenger

  3. Portal Nacional da NFS-e

O NFS-e Messenger centraliza toda a complexidade técnica e fiscal da mensageria.


Etapa 1 — Geração dos dados no sistema emissor

O processo se inicia quando o sistema emissor:

  • Gera os dados da NFS-e

  • Define prestador, tomador, valores e demais informações

  • Solicita a emissão ou um evento fiscal (ex: cancelamento)

Nesta etapa, os dados ainda estão em formato interno do sistema emissor.


Etapa 2 — Recepção da solicitação pelo NFS-e Messenger

O sistema emissor encaminha a solicitação ao NFS-e Messenger.

A partir desse ponto:

  • O controle da mensageria fiscal passa a ser do serviço

  • O sistema emissor não precisa conhecer detalhes técnicos do governo


Etapa 3 — Mapeamento de dados

O NFS-e Messenger realiza o mapeamento entre os dados de origem e a estrutura exigida pelo XML oficial da SEFAZ.

Essa etapa garante que:

  • Campos internos sejam convertidos corretamente

  • A estrutura atenda ao layout fiscal esperado

  • O XML seja compatível com o processamento governamental


Etapa 4 — Geração e assinatura do XML

Após o mapeamento:

  • O XML fiscal é gerado conforme o padrão exigido

  • O arquivo é assinado digitalmente utilizando certificado digital A1

A assinatura garante:

  • Autenticidade do emissor

  • Integridade do documento

  • Validade jurídica da operação


Etapa 5 — Preparação da mensagem fiscal

Antes do envio ao governo, o NFS-e Messenger executa:

  • Compactação do XML (ZIP)

  • Codificação da mensagem (Base64)

Esse processo segue os padrões definidos para comunicação com os serviços governamentais.


Etapa 6 — Envio seguro ao Portal Nacional

O NFS-e Messenger realiza o envio da mensagem fiscal ao Portal Nacional:

  • Utilizando comunicação segura

  • Com requisição assinada via certificado digital A1

  • Conforme os protocolos exigidos pelo ambiente governamental

O envio pode ocorrer de forma síncrona ou assíncrona, dependendo do cenário.


Etapa 7 — Processamento pelo Portal Nacional

O Portal Nacional realiza o processamento da solicitação, aplicando:

  • Regras fiscais

  • Validações cadastrais

  • Análises de consistência

O processamento pode resultar em autorização imediata ou processamento assíncrono.


Etapa 8 — Retorno e acompanhamento do status

Após o processamento:

  • O Portal Nacional retorna o status da NFS-e ou do evento

  • O NFS-e Messenger registra o retorno

  • O status é disponibilizado ao sistema emissor

Os principais estados incluem:

  • Autorizada

  • Rejeitada

  • Em processamento


Suporte a eventos fiscais

Além da emissão da NFS-e, o NFS-e Messenger também dá suporte à mensageria de eventos fiscais, como:

  • Cancelamento de NFS-e

  • Outros eventos previstos pelo modelo fiscal

Esses eventos seguem o mesmo fluxo de mensageria, incluindo:

  • Mapeamento

  • Geração de XML

  • Assinatura digital

  • Envio seguro

  • Acompanhamento do retorno


Fluxo resumido

De forma simplificada:

  1. O sistema emissor envia os dados

  2. O NFS-e Messenger mapeia e prepara o XML

  3. O documento é assinado, compactado e codificado

  4. A mensagem é enviada de forma segura

  5. O governo processa e retorna o resultado

Todo o processo ocorre de forma centralizada, rastreável e desacoplada.

Atualizado