Skip to main content
Cada município emite NFS-e por um provedor: o sistema da prefeitura ou o Emissor Nacional. O provedor define quais campos a nota precisa ter e em que formato. Escolha o município para ver as configurações do provedor e um exemplo de corpo para Criar NFS-e. Para consultar os mesmos dados pela API, use Configurações de emissão por município (GET /v1/service-invoices/cities/{cityCode}/settings): ela devolve os provedores do município, os regimes tributários que emitem por cada um, o método de emissão a configurar na empresa, as configurações de cada provedor e o exemplo de requisição. Para listar os municípios, use Cidades integradas.

Sobre o exemplo de requisição

O exemplo traz códigos fiscais de uma nota autorizada pelo mesmo provedor, no formato que ele aceita. Use-o como ponto de partida: os códigos e valores do seu serviço são os da sua empresa.
  • Nos municípios que adotaram o Emissor Nacional para parte dos regimes tributários, há mais de um provedor, e alguns provedores dispõem também de um canal alternativo. Selecione o provedor correspondente ao regime tributário da empresa emissora e configure, na empresa, o método de emissão indicado (serviceInvoice.issueType) por meio de Alterar configurações. As configurações e o exemplo exibidos correspondem ao provedor selecionado.
  • Um campo que não aparece no exemplo pode ser enviado normalmente: ele é aceito e não tem efeito naquele município.
O exemplo é material de apoio: não valida nem bloqueia a emissão, e a responsabilidade pela informação fiscal declarada continua sendo de quem emite.