Definição
Provedor municipal de NFS-e é o sistema usado por uma prefeitura para receber, validar, autorizar e armazenar as notas fiscais de serviço eletrônicas dos prestadores da cidade. Ele pode ser desenvolvido pelo próprio município ou por uma empresa de tecnologia contratada, e cada provedor tem regras, layouts e formas de integração próprias.
Também conhecido como: Municipal NFS-e provider, Provedor de NFS-e, Sistema municipal de NFS-e, Padrão municipal de NFS-e, Webservice municipal de NFS-e
O que faz um provedor municipal de NFS-e?
Na NF-e, a nota de produtos, quem autoriza o documento é a SEFAZ de cada estado, seguindo um padrão nacional único. Na NFS-e, a nota de serviços, a responsabilidade é do município, porque o principal imposto envolvido, o ISSQN, é municipal. Para cumprir essa função, cada prefeitura usa um sistema: o provedor municipal de NFS-e.
Esse sistema recebe os dados da nota enviados pelo prestador, confere se estão corretos (inscrição municipal, código do serviço, alíquota, tomador etc.), gera o número da nota, registra o documento e disponibiliza consulta, cancelamento e o documento auxiliar para impressão. Em resumo, ele é a porta de entrada da nota de serviço na prefeitura.
Por que cada prefeitura tem um provedor diferente?
Durante muito tempo não houve um sistema obrigatório e único para a NFS-e no país. Cada município decidiu sozinho como implantar a nota eletrônica: alguns criaram sistemas próprios e muitos contrataram empresas de software especializadas em gestão tributária municipal.
O resultado é um cenário fragmentado. Mesmo quando dois provedores seguem um modelo de referência parecido, como o padrão proposto pela ABRASF, cada um costuma ter versões, campos obrigatórios, códigos de serviço e mensagens de erro diferentes. Uma empresa que presta serviços em várias cidades pode precisar lidar com vários provedores ao mesmo tempo.
Como o provedor afeta a integração por API?
Para um ERP, plataforma de vendas ou marketplace que emite NFS-e, o provedor define quase tudo na comunicação técnica: o formato do XML, o tipo de serviço web (SOAP ou REST), a forma de autenticação (certificado digital, usuário e senha ou token), se a emissão é síncrona ou em lote e como as rejeições são devolvidas.
Por isso, integrar diretamente com cada prefeitura exige desenvolver e manter um conector para cada provedor, acompanhando mudanças de versão e instabilidades. Uma API fiscal como a do Conota funciona como camada intermediária: o sistema do cliente envia os dados em um formato único, e a API se encarrega de traduzi-los para o provedor do município, acompanhar o processamento e devolver XML, PDF e status. A cobertura depende de quais municípios e provedores estão suportados.
Qual a diferença entre provedor municipal e o padrão nacional da NFS-e?
O padrão nacional da NFS-e é uma iniciativa para unificar a emissão de notas de serviço em um modelo comum, com leiaute nacional e um ambiente centralizado. Nele, o prestador envia a DPS (Declaração de Prestação de Serviço) e a nota é gerada a partir dela.
Os municípios podem aderir ao padrão nacional de formas diferentes: alguns usam diretamente o emissor nacional, outros mantêm seu provedor próprio e compartilham os dados com o ambiente nacional. Na prática, durante a transição, provedores municipais e padrão nacional convivem, e o integrador precisa saber qual caminho cada cidade adota.
Como saber qual é o provedor do meu município?
A informação costuma estar no site da prefeitura, na área de nota fiscal eletrônica ou de tributos, e muitas vezes aparece no próprio endereço do portal de emissão. O contador da empresa e a secretaria de finanças do município também podem informar.
Quem emite por uma API fiscal normalmente não precisa descobrir isso manualmente: basta informar o município do prestador, e a plataforma identifica o provedor correspondente e as regras que se aplicam.
Exemplos de Provedor municipal de NFS-e
- Uma software house de gestão para clínicas atende clientes em cinco cidades e descobre que cada prefeitura usa um provedor municipal de NFS-e diferente, com campos e autenticação distintos.
- Uma agência de marketing muda de sede para outro município e precisa refazer o cadastro e os testes de emissão, porque o novo provedor exige outro código de serviço e outro formato de envio.
- Um marketplace de serviços usa uma API fiscal para emitir NFS-e em nome dos parceiros, sem precisar desenvolver uma integração para cada provedor municipal.
- Uma nota de serviço é rejeitada porque o provedor municipal não aceita a alíquota de ISSQN informada para aquele item da lista de serviços.
Perguntas frequentes
O provedor municipal de NFS-e é a própria prefeitura?
Não necessariamente. A prefeitura é a responsável pela NFS-e, mas o sistema que processa as notas pode ser desenvolvido por ela mesma ou por uma empresa de tecnologia contratada. Em ambos os casos, as regras fiscais são definidas pelo município.
Preciso de certificado digital para emitir NFS-e?
Depende do provedor. Muitos exigem certificado digital para assinar o XML ou autenticar a comunicação, enquanto outros aceitam usuário e senha ou token. O padrão nacional também tem requisitos próprios de autenticação.
Se o município trocar de provedor, minha integração para de funcionar?
Pode parar, já que endereços, layouts e regras mudam. Quem integra diretamente precisa adaptar o sistema. Quem usa uma API fiscal intermediária geralmente depende apenas da atualização feita pela plataforma, mantendo o mesmo formato de envio.
Todo município tem provedor de NFS-e?
A maioria dos municípios já adota alguma forma de NFS-e, seja por provedor próprio, por empresa contratada ou pelo emissor do padrão nacional. A forma de emissão varia de cidade para cidade.
Atualizado em · Como produzimos este glossário