Pular para o conteúdo

Carregando Gateway de NFS-e

Documentação do Gateway de NFS-e

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

  1. 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.
  2. O gateway processa e valida. Os dados são conferidos contra as regras do município antes de sair, e cada etapa fica registrada.
  3. 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

TermoSignificado
NFS-eNota Fiscal de Serviço eletrônica, autorizada pela prefeitura do município do prestador.
PrestadorA empresa que presta o serviço e emite a nota.
TomadorQuem contratou o serviço e recebe a nota.
RPSRecibo Provisório de Serviço: a identificação provisória da nota antes da autorização, com número e série próprios.
ISSImposto Sobre Serviços, o tributo municipal da nota de serviço.
Código de serviço do municípioO código da lista de serviços da prefeitura que classifica o serviço prestado.
Código do municípioO código oficial do IBGE, com sete dígitos, que identifica o município.
Código de verificaçãoO código que a prefeitura gera ao autorizar a nota e que, junto com o número, identifica a nota.
CompetênciaO mês de referência do serviço prestado.