Municípios e provedores

A NFS-e não tem um autorizador único. O Conota unifica a chamada, mas você precisa saber para onde a emissão vai.

Padrão Nacional

O Sistema Nacional da NFS-e centraliza a emissão para os municípios que aderiram. O documento é a DPS, e o layout é o mesmo em todos os municípios participantes — é a direção para onde o país está caminhando.

POST /v1/nfse/emitir

Provedor municipal

Municípios que ainda operam sistema próprio seguem o modelo ABRASF, com variações entre implementações. Além de dados fiscais, muitos exigem credenciais da prefeitura (login, senha ou token), configuradas em:

PUT /v1/empresas/{cpf_cnpj}/nfse

POST /v1/nfse/govdigital/emitir

O que confirmar antes de integrar um município novo

• O município está no Padrão Nacional ou em provedor próprio?
• Existe ambiente de homologação?
• Quais credenciais a prefeitura exige, além do certificado?
• A inscrição municipal é obrigatória?
• Qual o código de tributação do serviço prestado?
• Há retenções aplicáveis?
• Qual a regra de cancelamento — cancela ou substitui?

A diferença aparece no payload

Não é só o endpoint que muda: a estrutura do documento é outra. Um payload de Padrão Nacional não é aceito por um provedor ABRASF, e vice-versa. Consulte a Referência da API para o formato de cada um.