--- title: Emissão de NFS-e via NotaGateway (NGW) description: Emissão de NFS-e via NotaGateway --- [Pular para o conteúdo](https://ajuda.invoisys.com.br/emissão-de-nfs-e-via-notagateway-ngw#main-content) Português - Brasil Mostrar submenu para traduções [Portal do cliente](https://ajuda.invoisys.com.br/chamados?hsLang=pt-br) [![logo-topo-1 (1)](https://ajuda.invoisys.com.br/hs-fs/hubfs/logo-topo-1%20(1).png?width=160&height=58&name=logo-topo-1%20(1).png)](https://ajuda.invoisys.com.br?hsLang=pt-br) - [Portal de Conhecimento InvoiSys: Aprenda, Explore e Inove](https://ajuda.invoisys.com.br/) - [Ir para invoisys.com.br](https://invoisys.com.br) Abrir navegação principal Fechar navegação principal - [Portal de Conhecimento InvoiSys: Aprenda, Explore e Inove](https://ajuda.invoisys.com.br/) - [Ir para invoisys.com.br](https://invoisys.com.br) - Português - Brasil Mostrar submenu para traduções - [Portal do cliente](https://ajuda.invoisys.com.br/chamados) Olá. Como podemos ajudá-lo? - Não há sugestões porque o campo de pesquisa está em branco. 1. [Portal de Conhecimento InvoiSys: Aprenda, Explore e Inove](https://ajuda.invoisys.com.br/?hsLang=pt-br) 2. [Suporte](https://ajuda.invoisys.com.br/suporte?hsLang=pt-br) # Emissão de NFS-e via NotaGateway (NGW) ## O foco deste tópico é apresentar o funcionamento da integração utilizada internamente para emissão de NFS-e via NotaGateway (NGW), explicando em quais municípios esse fluxo é utilizado, os motivos de sua utilização e os principais pontos de atenção durante uma análise. **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:  ![](https://ajuda.invoisys.com.br/hs-fs/hubfs/image%20(1)-png.png?width=330&height=341&name=image%20(1)-png.png)   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:  ![](https://ajuda.invoisys.com.br/hs-fs/hubfs/image%20(2)-png.png?width=454&height=199&name=image%20(2)-png.png)   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 é:    ![](https://ajuda.invoisys.com.br/hs-fs/hubfs/image%20(3)-png-1.png?width=438&height=93&name=image%20(3)-png-1.png)   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. - [Perguntas frequentes](https://ajuda.invoisys.com.br/perguntas-frequentes?hsLang=pt-br) - [Portal Invoisys 2.0](https://ajuda.invoisys.com.br/portal-invoisys-2-0?hsLang=pt-br#main-content) - [Conhecendo o Portal invoiSys](https://ajuda.invoisys.com.br/portal-invoisys-2-0?hsLang=pt-br#conhecendo-o-portal-invoisys) - [Atualizações da versão 1.5.0](https://ajuda.invoisys.com.br/portal-invoisys-2-0?hsLang=pt-br#atualiza%C3%A7%C3%B5es-da-vers%C3%A3o-1-5-0) - [Atualizações da versão 2.0](https://ajuda.invoisys.com.br/portal-invoisys-2-0?hsLang=pt-br#atualiza%C3%A7%C3%B5es-da-vers%C3%A3o-2-0) - [Compra de Frete](https://ajuda.invoisys.com.br/portal-invoisys-2-0?hsLang=pt-br#compra-de-frete) - [Rejeições - Como corrigir](https://ajuda.invoisys.com.br/rejei%C3%A7%C3%B5es-como-corrigir?hsLang=pt-br#main-content) - [NFC-e](https://ajuda.invoisys.com.br/rejei%C3%A7%C3%B5es-como-corrigir?hsLang=pt-br#nfc-e) - [NF-e/NFC-e](https://ajuda.invoisys.com.br/rejei%C3%A7%C3%B5es-como-corrigir?hsLang=pt-br#nf-e-nfc-e) - [Como Corrigir (Emissor invoiSys 1.0/ Legado)](https://ajuda.invoisys.com.br/rejei%C3%A7%C3%B5es-como-corrigir?hsLang=pt-br#como-corrigir-emissor-invoisys-1-0-legado) - [MDF-e](https://ajuda.invoisys.com.br/rejei%C3%A7%C3%B5es-como-corrigir?hsLang=pt-br#mdf-e) - [NFS-e](https://ajuda.invoisys.com.br/rejei%C3%A7%C3%B5es-como-corrigir?hsLang=pt-br#nfs-e) - [CT-e](https://ajuda.invoisys.com.br/rejei%C3%A7%C3%B5es-como-corrigir?hsLang=pt-br#ct-e) - [Suporte](https://ajuda.invoisys.com.br/suporte?hsLang=pt-br) - [Portal 1.0. - (Taxaudit)](https://ajuda.invoisys.com.br/portal-1-0-taxaudit?hsLang=pt-br#main-content) - [FAQ Legado](https://ajuda.invoisys.com.br/portal-1-0-taxaudit?hsLang=pt-br#faq-legado) - [Primeiros passos](https://ajuda.invoisys.com.br/portal-1-0-taxaudit?hsLang=pt-br#primeiros-passos) - [Base de conhecimento interna](https://ajuda.invoisys.com.br/base-de-conhecimento-interna?hsLang=pt-br#main-content) - [FAQ](https://ajuda.invoisys.com.br/base-de-conhecimento-interna?hsLang=pt-br#faq) - [NFC-e](https://ajuda.invoisys.com.br/base-de-conhecimento-interna?hsLang=pt-br#nfc-e) - [FAQ – Perguntas Frequentes](https://ajuda.invoisys.com.br/faq-perguntas-frequentes?hsLang=pt-br) [![logo invoisys](https://ajuda.invoisys.com.br/hs-fs/hubfs/logo-1.png?width=100&height=36&name=logo-1.png "logo invoisys")](http://invoisys.com.br) Feito com 💚 pela invoiSys Copyright © 2025, invoiSys