Emissão de NFS-e via NotaGateway (NGW)

Importante: A NotaGateway é uma informação exclusivamente interna. Para o cliente, todo o processo de emissão e integração é de responsabilidade da InvoiSys. O nome NotaGateway ou NGW nunca deve ser mencionado em comunicações externas. 

O que é a NotaGateway (NGW)?

A NotaGateway (NGW) é uma integração utilizada internamente pela InvoiSys para viabilizar a emissão de NFS-e em determinados municípios.

Atualmente, esse fluxo é utilizado principalmente para municípios que não estão no Ambiente Nacional de NFS-e e nos quais:

• A InvoiSys ainda não possuía uma integração própria de emissão implementada; ou
• As regras necessárias para adequação à Reforma Tributária (IBS/CBS) apresentavam maior complexidade e ainda não estavam implementadas diretamente em nossa integração.

Nesses cenários, utilizamos a integração da NotaGateway, que já possui atendimento para essas regras e municípios.

Para o cliente, entretanto, essa arquitetura é transparente: independentemente da integração utilizada internamente, o serviço é prestado pela InvoiSys.

Municípios com emissão via NotaGateway

Atualmente, os seguintes municípios possuem emissão de NFS-e realizada por meio da integração com a NotaGateway:

Existem outros municípios cuja integração é realizada diretamente pela InvoiSys, portanto é importante consultar o mapeamento interno antes de direcionar uma análise. 

Como funciona o fluxo de emissão?

O cliente envia normalmente a requisição de emissão de NFS-e para a API da InvoiSys.

Nos municípios configurados para utilização da NGW, a InvoiSys realiza internamente o tratamento necessário e utiliza a integração da NotaGateway para prosseguir com o processo de emissão junto ao município.

De forma simplificada, o fluxo ocorre da seguinte maneira:

Cliente/ERP → InvoiSys → Integração NGW → Prefeitura

Essa arquitetura não altera a responsabilidade da InvoiSys sobre o processo. A NotaGateway é apenas uma integração utilizada internamente para comunicação com determinados municípios.

Identificação de erros relacionados ao fluxo

Durante a análise de uma NFS-e de município integrado via NGW, São José dos Campos (SP), alguns retornos podem indicar falha durante o processamento dessa integração.

 Um dos retornos identificados em São José dos Campos foi: 

Nesse cenário, a requisição pode ser recebida normalmente pela InvoiSys e o documento chegar a ser criado no portal, porém apresentar erro posteriormente durante o processamento.

Por exemplo, o documento pode permanecer com status "ERRO" e registrar o erro no evento de Erro no Envio de RPS.

Esse tipo de ocorrência deve ser analisado internamente, principalmente quando o payload enviado pelo cliente está correto e outros documentos com estrutura semelhante foram processados anteriormente.

Outro retorno que pode ser identificado nos eventos é: 

A identificação de EX_NGW no retorno é um indicativo interno importante de que a falha ocorreu durante uma operação relacionada à integração da NotaGateway.

Nesses casos, além da análise do payload originalmente enviado, deve-se verificar o processamento interno e as configurações relacionadas ao emitente e ao município.

Como atuar durante a análise

Ao identificar problema de emissão em um dos municípios atendidos pela NotaGateway, recomenda-se:

1. Confirmar se o município está configurado para emissão via NGW.
2. Validar o request/payload enviado pelo cliente.
3. Verificar se os campos obrigatórios para emissão foram enviados corretamente.
4. Consultar os Eventos do documento no Portal InvoiSys.
5. Verificar se existem mensagens como EX_NGW, idExterno é obrigatório ou outro retorno relacionado ao processamento.
6. Comparar, quando possível, com uma emissão anterior autorizada para o mesmo estabelecimento e município.
7. Caso o payload esteja correto e a falha esteja no processamento interno, direcionar o caso para análise da equipe responsável.

É importante validar cada etapa desse fluxo para garantir que o processamento ocorra corretamente, identificando com precisão a origem de possíveis inconsistências antes de direcionar a tratativa.

Conclusão

A NotaGateway é utilizada pela InvoiSys para viabilizar a emissão de NFS-e em municípios fora do Ambiente Nacional ou com regras mais complexas, incluindo cenários relacionados à Reforma Tributária (IBS/CBS).

Esse fluxo é utilizado internamente para apoiar a análise e o direcionamento de erros, mas deve permanecer transparente para o cliente. Em toda comunicação externa, a InvoiSys deve ser apresentada como responsável pelo processo de emissão.