--- title: "Particularidades das prefeituras na emissão de NFS-e" description: "Consulte como a prefeitura do seu município recebe a NFS-e — provedor, autenticação, layout, código de serviço, RPS, forma de comunicação e PDF — e o que isso muda na sua emissão." source_url: https://nfe.io/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/ product: documentacao last_updated: 2026-10-29 tags: ["referencia", "nfse", "emissao", "autenticacao"] integration: ["api", "painel"] --- # Particularidades das prefeituras na emissão de NFS-e Não existe um padrão único de NFS-e no Brasil. Cada prefeitura escolhe como recebe a nota: pelo Ambiente Nacional ou pelo sistema de um provedor contratado por ela. Essa escolha define o que a sua empresa precisa cadastrar, o formato do código de serviço, quanto tempo a nota leva para ser autorizada e de onde vem o PDF. A NFE.io conversa com cada prefeitura do jeito que ela exige. Esta página mostra, município por município, o que muda para você. ## Como esta página ajuda Consulte o seu município antes de começar a emitir e sempre que a nota for recusada. Com essas informações você consegue: - **Cadastrar a empresa certo da primeira vez**, sabendo se a prefeitura exige usuário e senha ou token de integração no webservice. - **Informar o código de serviço no formato esperado**, evitando rejeição por código inválido. - **Entender o tempo de resposta**, porque prefeituras assíncronas devolvem o resultado minutos depois do envio. - **Manter a numeração de RPS correta** nas prefeituras que exigem sequência contínua. - **Saber qual PDF o seu cliente vai receber**: o modelo nacional, o modelo padrão da NFE.io ou o documento original da prefeitura. ## Consulte o seu município Escolha o estado e, depois, o município. As informações aparecem no cartão do município, logo abaixo do seletor. O endereço da página guarda a seleção, então você pode copiar o link e compartilhar. ## Consulte por estado Prefere ver todas as prefeituras de um estado de uma vez? Cada estado tem uma página com o resumo e as tabelas das suas prefeituras. O [índice por estado](/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/por-estado/) traz também os totais do país e os provedores mais presentes. [Acre (AC)](/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/por-estado/ac/) · [Alagoas (AL)](/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/por-estado/al/) · [Amapá (AP)](/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/por-estado/ap/) · [Amazonas (AM)](/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/por-estado/am/) · [Bahia (BA)](/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/por-estado/ba/) · [Ceará (CE)](/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/por-estado/ce/) · [Distrito Federal (DF)](/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/por-estado/df/) · [Espírito Santo (ES)](/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/por-estado/es/) · [Goiás (GO)](/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/por-estado/go/) · [Maranhão (MA)](/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/por-estado/ma/) · [Mato Grosso (MT)](/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/por-estado/mt/) · [Mato Grosso do Sul (MS)](/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/por-estado/ms/) · [Minas Gerais (MG)](/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/por-estado/mg/) · [Pará (PA)](/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/por-estado/pa/) · [Paraíba (PB)](/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/por-estado/pb/) · [Paraná (PR)](/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/por-estado/pr/) · [Pernambuco (PE)](/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/por-estado/pe/) · [Piauí (PI)](/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/por-estado/pi/) · [Rio de Janeiro (RJ)](/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/por-estado/rj/) · [Rio Grande do Norte (RN)](/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/por-estado/rn/) · [Rio Grande do Sul (RS)](/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/por-estado/rs/) · [Rondônia (RO)](/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/por-estado/ro/) · [Roraima (RR)](/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/por-estado/rr/) · [Santa Catarina (SC)](/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/por-estado/sc/) · [São Paulo (SP)](/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/por-estado/sp/) · [Sergipe (SE)](/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/por-estado/se/) · [Tocantins (TO)](/docs/documentacao/nota-fiscal-servico-eletronica/particularidades-das-prefeituras/por-estado/to/) ## O que significa cada informação Cada informação do cartão aparece abaixo com todos os valores possíveis. Siga só a linha do valor que aparece para o seu município. ### Provedor Quem opera o sistema que recebe a nota. *Ambiente Nacional* é o Sistema Nacional NFS-e, mantido pela Receita Federal. Os demais são empresas contratadas pela prefeitura ou sistemas próprios dela. Não exige ação: a NFE.io já se conecta ao provedor certo. ### Layout | Valor | O que significa | |---|---| | **Nacional (DPS)** | Padrão do Ambiente Nacional. | | **Nacional (DPS) via provedor** | O mesmo padrão nacional, recebido pelo sistema do provedor municipal. | | **ABRASF** | Modelo da Associação Brasileira das Secretarias de Finanças, com a versão quando conhecida (por exemplo, ABRASF 2.03). | | **Próprio do provedor** | Formato específico do provedor ou da prefeitura. | Não exige ação. Ajuda a entender mensagens de rejeição, que costumam citar campos do layout. ### Comunicação | Valor | O que significa | O que fazer | |---|---|---| | **Síncrona** | A prefeitura devolve o resultado na mesma chamada. | Nada. | | **Assíncrona** | A nota fica em processamento até a prefeitura devolver o resultado, o que pode levar alguns minutos. | Acompanhe o status pelo webhook ou consultando a nota. | ### RPS sequencial | Valor | O que significa | O que fazer | |---|---|---| | **Sim** | A prefeitura exige numeração de RPS contínua, sem saltos. | Mantenha o número de RPS da empresa (`rpsNumber` na API) contínuo e alinhado com o da prefeitura. | | **Não** | A prefeitura não exige sequência contínua. | Nada. | ### Usuário e senha | Valor | O que significa | O que fazer | |---|---|---| | **Sim** | A prefeitura exige usuário e senha de acesso ao webservice. | Cadastre em **Dados Fiscais** da empresa ou nos campos `loginName` e `loginPassword` da API. Veja [Campos de autorização NFSe](../duvidas/campos-de-autorizacao-nfse.md). | | **Não** | A prefeitura autentica pelo certificado digital. | Nada além do certificado. | | **Não identificado** | A configuração não indica como a prefeitura autentica. | Se a emissão for recusada por autenticação, confira no portal da prefeitura se ela pede usuário e senha. | ### Token | Valor | O que significa | O que fazer | |---|---|---| | **Sim** | A prefeitura exige um token de integração em toda emissão. | Gere o token no portal da prefeitura e cadastre no campo `authIssueValue` da empresa. | | **Não** | A prefeitura não usa token. | Nada. | | **Não identificado** | A configuração não indica se a prefeitura usa token. | Se a emissão for recusada por autenticação, confira no portal da prefeitura. | ### Código de serviço O formato do código de serviço que a prefeitura aceita. Veja como informar cada formato na tabela abaixo. ### PDF | Valor | O que significa | |---|---| | **Template nacional** | A NFE.io gera o PDF no modelo do DANFSe nacional. | | **Template padrão NFE.io** | A NFE.io gera o PDF no seu modelo padrão, o mesmo para todos os municípios. | | **PDF original da prefeitura** | A NFE.io baixa o PDF gerado pela própria prefeitura, no portal ou no webservice dela. Em alguns provedores, se a prefeitura não entregar o documento, a NFE.io gera o PDF pelo template. | | **Não identificado** | A configuração não indica a origem do PDF. | Não exige ação: o PDF fica disponível na nota da mesma forma. ### Formatos de código de serviço | Formato | Como informar | |---|---| | **Nacional (cTribNac)** | Código de Tributação Nacional: `federalServiceCode` com 6 dígitos (por exemplo `050801`) ou `cityServiceCode` no formato `050801.050`, com o código municipal de 3 dígitos depois do ponto. As alíquotas por código estão na [consulta de alíquotas municipais](https://ferramentas.nfe.io/aliquotas-municipais/consulta/). | | **Código municipal** | O código da lista de serviços da prefeitura, em `cityServiceCode`, no formato que ela publica. | | **Código municipal curto** | O código da lista da prefeitura em versão reduzida, sem o desdobramento completo. | | **Item LC 116 com 6 dígitos** | Item da lista da LC 116/2003 com subitem e desdobro, sem pontos (por exemplo `010501`). | | **Item LC 116 com ponto (01.05)** | Item da lista da LC 116/2003 com ponto entre item e subitem. | | **+ cód. tributação municipal**, **+ CNAE**, **+ cód. de atividade**, **+ código NBS** | Junto com o código de serviço, a prefeitura pede o código de tributação do município, o CNAE, o código de atividade ou o código NBS (Nomenclatura Brasileira de Serviços). | ### Exemplo enviado Para as prefeituras com notas autorizadas na última coleta, o seletor e as páginas por estado mostram um exemplo real de `cityServiceCode` e `federalServiceCode`: a combinação dos dois campos enviada com mais frequência nas notas que a prefeitura autorizou. Um traço, ou um campo que não aparece no seletor, indica que ele não foi enviado nessa combinação. O exemplo mostra o **formato** em uso (com ou sem ponto, quantos dígitos, com desdobramento), não o código do seu serviço. O código certo sai da lista de serviços da prefeitura ou, no Ambiente Nacional, da tabela de códigos de tributação nacional. ## De onde vêm essas informações Os dados saem da configuração de integração que a NFE.io mantém para cada prefeitura, a mesma usada na emissão. A data da última atualização aparece abaixo do seletor. A prefeitura pode mudar de provedor ou migrar para o Ambiente Nacional. Se algo aqui não bater com o que você vê na emissão, fale com o nosso suporte. Para saber como emitir em uma cidade específica, veja também [Prefeituras integradas](/docs/prefeituras-integradas/).