Arquitetura da mensageria

Esta página descreve a arquitetura conceitual do NFS-e Messenger, explicando como o serviço organiza, processa e controla a mensageria fiscal de forma segura e desacoplada.

O foco aqui é entender o papel de cada camada, não detalhes de implementação.

Visão geral da arquitetura

O NFS-e Messenger foi projetado como um serviço intermediário especializado, posicionado entre:

• O sistema emissor (ERP, billing ou aplicação própria)

• O Portal Nacional da NFS-e

Toda a complexidade da comunicação fiscal é concentrada nessa camada intermediária.

---

Princípios da arquitetura

A arquitetura do NFS-e Messenger segue alguns princípios fundamentais:

• Desacoplamento

• Responsabilidades bem definidas

• Rastreabilidade completa

• Segurança por padrão

Esses princípios garantem previsibilidade e escalabilidade operacional.

---

Camada de entrada (recepção)

Nesta camada, o NFS-e Messenger:

• Recebe solicitações de emissão ou eventos fiscais

• Valida a estrutura básica dos dados recebidos

• Registra a solicitação para acompanhamento

O sistema emissor não precisa aguardar o processamento completo para continuar sua operação.

---

Camada de transformação (mensageria)

Após a recepção, o serviço executa a mensageria fiscal propriamente dita:

• Mapeamento dos dados de origem

• Geração do XML fiscal conforme o layout exigido

• Assinatura digital do documento

• Preparação da mensagem para envio

Essa camada isola o sistema emissor de qualquer variação técnica ou fiscal.

---

Camada de comunicação governamental

Nesta etapa, o NFS-e Messenger:

• Envia a mensagem ao ambiente governamental

• Utiliza comunicação segura e autenticada

• Controla tentativas, respostas e tempos de processamento

Toda a comunicação com o governo ocorre exclusivamente por essa camada.

---

Camada de acompanhamento e retorno

Após o envio:

• O serviço acompanha o processamento da nota ou evento

• Registra os retornos do Portal Nacional

• Disponibiliza o status ao sistema emissor

Essa camada garante visibilidade e controle sobre o ciclo completo da NFS-e.

---

Suporte a eventos fiscais

A mesma arquitetura é utilizada para:

• Emissão de NFS-e

• Cancelamento de NFS-e

• Demais eventos fiscais suportados

Todos seguem o mesmo fluxo arquitetural, garantindo consistência.

---

Benefícios da arquitetura

Essa arquitetura permite:

• Evoluir integrações governamentais sem impactar o emissor

• Centralizar regras de mensageria

• Reduzir complexidade nos sistemas de origem

• Garantir rastreabilidade e segurança

---

Em resumo

• O sistema emissor envia dados

• O NFS-e Messenger processa e controla a mensageria

• O governo recebe, processa e responde

Cada camada tem papel claro e isolado.