Visão geral
O que é o gateway, para quem ele serve, o caminho de uma nota até a prefeitura e os termos usados.
- O que é o Gateway de NFS-e
- Software houses, plataformas SaaS e PowerP
- Do seu sistema à prefeitura em três passos
- O que é conferido antes do envio
- Como o Financeiro do PowerP usa o gateway
- Termos usados na documentação
O que é o Gateway de NFS-e
O Gateway de NFS-e é o serviço da JR Sistemas que leva a nota fiscal de serviço do seu sistema até a prefeitura e traz o resultado de volta. Ele foi feito para software houses e plataformas SaaS que querem oferecer a emissão de NFS-e dentro do próprio produto, sem construir um módulo fiscal do zero.
A NFS-e (Nota Fiscal de Serviço eletrônica) é um documento municipal: quem autoriza a nota é a prefeitura do município do prestador, e cada município tem as suas regras. O gateway concentra essa parte. O seu sistema cuida da tela e dos dados do negócio; o gateway confere os dados, envia a nota no padrão do município, acompanha a resposta e devolve a nota pronta.
É o mesmo motor fiscal que o Financeiro do PowerP usa para emitir a nota de serviço ligada à mensalidade ou ao contrato, oferecido como serviço para outros sistemas.
Para quem é
- Software houses e plataformas SaaS: o seu cliente emite a nota na sua tela. O gateway trabalha em segundo plano, e o usuário final nem precisa saber que ele existe.
- Empresas que usam o PowerP: a emissão já está no Financeiro, ligada às faturas.
Para a software house, a emissão vira parte do produto. A JR ajuda a montar o modelo comercial (pacotes mensais de emissão, emissão incluída nos planos avançados ou cobrança pelo volume emitido) e o plano de integração alinhado ao seu cenário técnico. O primeiro passo é falar com o time pela página de contato do site.
Do seu sistema à prefeitura
- O seu cliente emite no seu sistema. Ele preenche a nota de serviço (tomador, serviço e valor) e pede a emissão. A tela é a sua.
- O gateway processa e valida. Os dados são conferidos contra as regras do município antes de sair, e cada etapa fica registrada.
- A prefeitura recebe e responde. A nota é enviada no padrão do município do prestador. Autorizada, ela volta ao seu sistema com número, código de verificação, PDF e XML.
Enquanto a prefeitura não responde, a nota fica Processando. Se a prefeitura recusar, a nota fica Rejeitada, com o motivo informado por ela, para que os dados sejam corrigidos e a nota seja emitida de novo. Todas as situações estão no assunto Situações da nota e cancelamento.
O que é conferido antes do envio
Antes de a nota sair para a prefeitura, o gateway confere:
- Cadastro do prestador: a empresa que presta o serviço e emite a nota.
- Documento do tomador: o CNPJ (ou outro documento) de quem contratou o serviço.
- Código de serviço do município: cada prefeitura tem a sua lista de serviços, e a nota precisa usar o código que ela reconhece.
- Alíquota do ISS: o percentual do imposto municipal sobre serviços aplicado à nota.
- Assinatura digital do XML: a nota é um arquivo XML assinado com certificado digital.
Conferir antes de enviar evita a ida e volta com a prefeitura por um erro de cadastro. Quando a recusa vem mesmo assim, o motivo chega com o código e a mensagem da própria prefeitura.
Como o PowerP usa o gateway
No PowerP, o Financeiro é um dos sistemas que emitem pelo gateway. Quando a fatura é emitida (ou quando o pagamento é confirmado, conforme o regime escolhido), o Financeiro envia os dados ao gateway e guarda o vínculo entre a fatura e a nota: número, situação, XML autorizado e PDF.
As telas de NFS-e ficam no menu Fiscal › NFSe:
- Tipos de Serviços da Unidade
- Configurações para emissão de NFSe
- Documentos para emissão de NFSe
O caminho completo da fatura, do cancelamento e da nota de crédito está na documentação do módulo Financeiro do PowerP.
Termos usados
| Termo | Significado |
|---|---|
| NFS-e | Nota Fiscal de Serviço eletrônica, autorizada pela prefeitura do município do prestador. |
| Prestador | A empresa que presta o serviço e emite a nota. |
| Tomador | Quem contratou o serviço e recebe a nota. |
| RPS | Recibo Provisório de Serviço: a identificação provisória da nota antes da autorização, com número e série próprios. |
| ISS | Imposto Sobre Serviços, o tributo municipal da nota de serviço. |
| Código de serviço do município | O código da lista de serviços da prefeitura que classifica o serviço prestado. |
| Código do município | O código oficial do IBGE, com sete dígitos, que identifica o município. |
| Código de verificação | O código que a prefeitura gera ao autorizar a nota e que, junto com o número, identifica a nota. |
| Competência | O mês de referência do serviço prestado. |