NFS-e | Processo de integração
1. Introdução
A 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.
É 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. |
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
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.
Assuntos relacionados
![]()