Skip to main content

NFS-e | Processo de integração

sgptsmx-petroleo.png


1. Introdução


Nota Fiscal de Serviços Eletrônica (NFSe) é um documento digital utilizado para formalizar a prestação de serviços, com emissão regulamentada pelas prefeituras. Aplica-se a operações sujeitas ao ISS (Imposto Sobre Serviços), abrangendo atividades como serviços técnicos, consultorias, desenvolvimento de software, manutenção, suporte e demais serviços previstos na legislação municipal.

No contexto do SGP, a emissão de NFSe exige configurações prévias e validações técnicas que variam conforme o município e o sistema emissor adotado pela prefeitura (Sistema Nacional ou Sistema Próprio). O processo de integração envolve a adequação ao layout exigido, definição de parâmetros fiscais, assinatura digital e comunicação com os webservices disponibilizados.

Todo o processo de integração entre o SGP e o sistema emissor da prefeitura é acompanhado pelas equipes de suporte, garantindo aderência às exigências técnicas e maior confiabilidade na emissão das notas.

É importante respeitar as etapas para o correto andamento do processo e, em caso de dúvidas ou ajustes, manter contato com o suporte.

2. Fluxo de integração


O processo de integração de NFSe no SGP segue um fluxo estruturado, envolvendo suporte e cliente. É importante que o provedor conheça as etapas para se orientar ao longo do processo e alinhar expectativas quanto às atividades e responsabilidades envolvidas.


Etapa Responsável Descrição
Solicitação inicial Cliente O cliente entra em contato com o suporte solicitando a integração com o sistema de NFSe da prefeitura; nesse momento é aberto um protocolo de atendimento que será utilizado como referência durante todo o processo.
Direcionamento de requisitos Suporte O suporte analisa o cenário da prefeitura (Sistema Nacional, Sistema Próprio já integrado ou Sistema Próprio não integrado) e orienta o cliente sobre os dados, acessos e documentos necessários para a triagem inicial.
Coleta das informações Cliente O cliente reúne as informações solicitadas (certificado, códigos, acessos, documentação, etc.) e retorna ao suporte informando o número do protocolo inicial junto com os dados necessários para continuidade.
Análise técnica Suporte O suporte valida os dados recebidos, verificando consistência, completude e aderência às exigências do provedor/prefeitura, garantindo o início da etapa técnica sem bloqueios.
Configuração e desenvolvimento Suporte Para Sistema Nacional e sistemas já integrados, o suporte realiza a configuração e testes. Para sistemas não integrados, o desenvolvimento é acionado para adaptação técnica antes da configuração.
Testes e homologação Suporte O suporte realiza testes de emissão e gera uma NFSe em ambiente de homologação, que deve ser validada pela contabilidade do cliente.
Validação pelo cliente/contabilidade Cliente e Contabilidade A contabilidade valida as informações da nota (tributação, códigos, valores e estrutura) e retorna ao suporte com aprovação ou ajustes necessários.
Conclusão da integração Suporte Após a validação, o suporte realiza ajustes finais, alinha particularidades com o cliente e configura a rotina automática de emissão no SGP.
Operação Cliente Com a integração concluída, o cliente passa a utilizar a emissão de NFSe no dia a dia, com o processo já estabilizado no sistema.

Objetivo: Este fluxo garante que a integração seja realizada de forma controlada, validada e aderente às exigências técnicas e fiscais de cada município. É fundamental manter alinhamento com a contabilidade, assegurando a correta definição e validação dos parâmetros fiscais conforme a legislação vigente.

3. Pré-requisitos de integração


Os pré-requisitos para integração de NFSe no SGP variam conforme o cenário adotado pelo município.


3.1. Sistema Nacional - Emissor Nacional (NFSe)


  • Certificado digital A1 (.pfx) + senha
  • XML de NFSe (exemplo) gerada na Plataforma Nacional

  • Código do Serviço Municipal + Código do Serviço Nacional + Código NBS
  • Código da atividade (XX.XX.XX, com desdobro do 3º bloco — padrão “01” ou conforme contábil)

  • IND.OP (padrão 100301, se não informado)

  • Inscrição Municipal (IM) da empresa

  • Cliente de teste cadastrado no SGP (utilizado para geração de fatura e emissão de NFSe em ambiente de teste)

  • Outras retenções (INSS, IR, CSLL, PIS, COFINS) → obrigatório informar CST + alíquota para cada

3.2. Sistema Próprio da prefeitura (Já integrado)


  • Certificado digital A1 (.pfx) + senha
  • Acesso ao sistema da prefeitura: link + login + senha
  • XML de NFSe (exemplo) gerada na Plataforma da prefeitura
  • Código do Serviço Municipal + Código do Serviço Nacional + Código NBS
  • Código da atividade (XX.XX.XX, com desdobro do 3º bloco — padrão “01” ou conforme contábil)
  • ND.OP (padrão 100301, se não informado)
  • Inscrição Municipal (IM) da empresa
  • Cliente de teste cadastrado no SGP (utilizado para geração de fatura e emissão de NFSe em ambiente de teste)
  • Outras retenções (INSS, IR, CSLL, PIS, COFINS) → obrigatório informar CST + alíquota para cada
Sistemas de NFSe Integrados ao SGP

Abaixo estão os sistemas emissores de NFSe atualmente integrados ao SGP.

Sistema
ÁGILIBlue
Arrecadanet
Aspec
Asten
Ativ
Betha
Directa
DMISS
DSF
EBM
E-Cidade (Sistema Gratuito)
Elmar
Elotech
E-Receita
Ginfes
Gestão ISS
Giss
GPI (antigo EL)
GOVBR ISS Digital
Governa
GRP
IPM
ISSNet
ISSWeb
Link3
Memory
MGA
NFISS
Nota Manaus
PGISS
Portal Fácil
Portal Tributário
Pública (Siasp)
Saatri
SIGISS
Simpliss
Sistema Nacional
SmartAPD
SPE
SpeedGov
Susesu
Tecnos
Tinus
Tiplan
TributUS
WebISS
XTR Online
Sistema Próprio (Barueri)
Sistema Próprio (Curitiba)
Sistema Próprio (Fortaleza)
Sistema Próprio (Goiânia)
Sistema Próprio (João Pessoa)
Sistema Próprio (Nova Iguaçu)
Sistema Próprio (Recife)
Sistema Próprio (São Paulo)
Sistema Próprio (Vitória)

3.3. Sistema Próprio da prefeitura (Não integrado)


  • Certificado digital A1 (.pfx) + senha
  • Acesso ao sistema da prefeitura: link + login + senha
  • Documentação técnica: manual da NFSe + XML de exemplo (homologação/produção)
  • Integração: URLs/endpoints + WSDL (quando aplicável) + autenticação
  • XML de NFSe (exemplo) gerada na Plataforma da prefeitura
  • Código do Serviço Municipal + Código do Serviço Nacional + Código NBS
  • Código da atividade (XX.XX.XX, com desdobro do 3º bloco — padrão “01” ou conforme contábil)
  • ND.OP (padrão 100301, se não informado)
  • Inscrição Municipal (IM) da empresa
  • Cliente de teste cadastrado no SGP (utilizado para geração de fatura e emissão de NFSe em ambiente de teste)
  • Outras retenções (INSS, IR, CSLL, PIS, COFINS) → obrigatório informar CST + alíquota para cada

Aviso: O levantamento completo dessas informações é uma etapa fundamental e de responsabilidade do cliente, sendo essencial para garantir a correta implementação da integração e reduzir inconsistências durante a emissão das NFSe.

4. Diretrizes para atendimento


Esta documentação pode ser utilizada como referência para compreensão do processo de integração, permitindo ao provedor conhecer as etapas envolvidas e se orientar ao longo de toda a execução.

Para iniciar o processo de integração, basta entrar em contato com o suporte e solicitar a abertura de um atendimento para integração com o sistema da prefeitura correspondente.

Dica: Caso seja necessário acionar o suporte durante o processo de integração, informe sempre o número do protocolo inicial. Isso garante acesso imediato ao histórico do atendimento e permite dar continuidade ao processo com mais agilidade e assertividade, evitando retrabalho e perda de contexto.

Assuntos relacionados

tsmx-petroleo.png