>

NFS-e Brasil 2026: o guia completo de emissão, RPS, padrão nacional e integração via API

Atualizado em maio de 2026. Este guia cobre o cenário pós-implantação do padrão nacional ABRASF, as obrigações de prestadores de serviço em diferentes municípios, e os erros mais frequentes que custam multas e dor de cabeça.

O que é NFS-e e por que ela é diferente da NF-e

A NFS-e (Nota Fiscal de Serviços Eletrônica) é o documento fiscal obrigatório para a prestação de serviços no Brasil. Diferente da NF-e (modelo 55, para circulação de mercadorias, gerida pela SEFAZ estadual), a NFS-e é de competência municipal — ou seja, cada uma das mais de 5.500 prefeituras do país, em tese, pode ter seu próprio sistema, layout e regras. Esse fato é a origem de praticamente todos os problemas operacionais que envolvem nota fiscal de serviço no Brasil.

O imposto principal incidente sobre a NFS-e é o ISS (Imposto Sobre Serviços), com alíquotas entre 2% e 5% dependendo do município e da atividade. Diferente do ICMS (que é estadual e está no cerne da Reforma Tributária), o ISS continuará existindo durante a transição da CBS/IBS, e só será extinto definitivamente em 2033 — o que significa que NFS-e ainda é assunto crítico para os próximos sete anos no mínimo.

O padrão nacional NFS-e e o papel da ABRASF

Até alguns anos atrás, cada município operava sua própria solução de NFS-e com leiautes XML diferentes, regras de validação diferentes e até webservices com nomes diferentes para os mesmos campos. O caos era tamanho que prestadores que atuavam em mais de um município precisavam manter integrações paralelas, e contadores eram obrigados a aprender o sistema de São Paulo, do Rio, de Belo Horizonte e de Curitiba como se fossem ferramentas distintas.

A ABRASF (Associação Brasileira das Secretarias de Finanças das Capitais) publicou, há mais de uma década, uma especificação técnica de referência para uniformizar pelo menos a estrutura básica dos XMLs e dos webservices municipais. A maioria das capitais aderiu a alguma versão da ABRASF (1.0, 2.0, 2.01, 2.02 e 2.03 são as mais comuns), mas a adesão sempre foi imperfeita: municípios fazem "puxadinhos" — campos próprios, validações extras, fluxos diferentes para cancelamento.

Em 2022 a Receita Federal e o Confaz começaram, juntamente com a Receita Federal do Brasil e o Comitê Gestor da NFS-e, a implantar o padrão nacional NFS-e — uma especificação federal única que substitui (ou complementa, dependendo do município) os sistemas municipais. A adesão municipal foi escalonada por porte e tipo de prestador, e em 2026 já cobre a maioria dos municípios brasileiros para MEIs e parte do Simples Nacional. O endpoint nacional é gerido pelo SERPRO e oferece API REST com autenticação por certificado digital A1 ou A3, o que simplifica radicalmente a vida de quem precisa emitir em múltiplos municípios.

Status da adesão em 2026

Em maio de 2026, o padrão nacional NFS-e:

Há municípios — principalmente capitais grandes como São Paulo e Rio de Janeiro — que mantêm sistema municipal próprio em paralelo ao nacional, e o prestador pode escolher (em alguns casos) qual usar. Outras cidades já desativaram o sistema antigo e exigem o nacional. A primeira coisa a verificar antes de configurar emissão é qual é o status do seu município no portal nfse.gov.br.

RPS: o que é e quando ainda se usa

O RPS (Recibo Provisório de Serviços) é um documento que o prestador emite no momento da prestação quando, por algum motivo, não consegue gerar a NFS-e imediatamente — por exemplo, sem internet, ou em modo offline. O RPS tem validade fiscal limitada e precisa ser convertido em NFS-e em prazo definido pela legislação municipal (geralmente 5 a 10 dias úteis, mas varia).

No padrão nacional, o RPS continua existindo, embora seu uso seja desencorajado: a recomendação é emitir NFS-e direto sempre que possível. O RPS ainda é útil em três cenários:

  1. Emissão offline real — prestadores que atendem em campo sem conectividade (eletricista, fotógrafo de evento, técnico de manutenção em zona rural).
  2. Falha temporária do webservice — quando o servidor da prefeitura ou do nacional está fora do ar e o cliente precisa do comprovante na hora.
  3. Volume alto com transmissão em lote — prestadores que emitem centenas de notas por dia e fazem batch noturno.

Aplicativos como o InvoiceFlow, com sua arquitetura offline-first, conseguem gerar o RPS local mesmo sem conexão, com numeração própria, e disparar a transmissão para NFS-e tão logo a rede volte — preservando a numeração correta e respeitando o prazo de conversão.

Estrutura do XML da NFS-e padrão nacional

O XML da NFS-e nacional segue uma estrutura hierárquica com os seguintes blocos principais:

A chave de acesso da NFS-e nacional tem 50 dígitos e contém código do município, ano-mês, número sequencial, tipo de emissor, e dígito verificador. É essa chave que o destinatário usa para consultar a nota no portal nacional.

Integração via API: o que esperar em 2026

O portal nacional NFS-e expõe API REST sobre HTTPS com autenticação mTLS (certificado digital instalado no cliente). Os principais endpoints:

O retorno padrão é JSON com a NFS-e em XML embutido e o link de download do PDF (DANFSE — Documento Auxiliar). Para integrações de aplicativos móveis, a recomendação é usar o backend do app como proxy autenticado para a API nacional — colocar o certificado digital direto no dispositivo do usuário é tecnicamente possível, mas inseguro e operacionalmente difícil de manter.

Limites e quotas

O ambiente de produção do padrão nacional tem limite de 60 requisições por minuto por CNPJ emitente. Para emissões em volume, use o endpoint de lote. O ambiente de homologação tem o mesmo limite e é totalmente funcional — incluindo geração de DANFSE — mas as notas emitidas em homologação não têm valor fiscal.

Cancelamento e substituição

Uma NFS-e pode ser cancelada em prazo definido pela legislação municipal — em geral até o quinto dia útil do mês seguinte à emissão, mas alguns municípios estendem para 90 dias e outros restringem para 24 horas. Após o prazo, o cancelamento exige processo administrativo presencial na prefeitura, com justificativa documental.

A substituição é um cancelamento + nova emissão atômicos: substitui-se uma nota errada por outra correta, com a vinculação registrada no XML. Não está disponível em todos os municípios — verifique antes.

Erro frequente: tentar cancelar uma nota cuja competência (data de emissão) já foi declarada na DASN-Simples ou na DEFIS. O cancelamento depois da declaração exige retificação da própria declaração, o que é uma dor de cabeça contábil. Regra prática: cancele dentro do mesmo mês de emissão.

Retenções na fonte: o ponto mais errado de todos

Quando o tomador é pessoa jurídica e o serviço se enquadra em determinadas naturezas (intermediação, locação de mão de obra, limpeza, vigilância, manutenção, entre outros), há retenção obrigatória na fonte de:

O prestador emite a NFS-e com o valor bruto, indica as retenções no campo apropriado, e o tomador deposita só o líquido. O erro clássico é o prestador emitir nota sem retenção, receber o líquido (o tomador retém de qualquer jeito), e depois o cliente receber autuação por ter retido sem que a nota mostrasse. O contador chora, o relacionamento sofre. Configure as predefinições do seu app de faturamento com a tabela correta de retenções por natureza de serviço.

Erros mais frequentes na emissão

1. Código de tributação municipal errado. Cada município tem sua própria lista de itens de serviço — e errar o código pode gerar alíquota errada de ISS. Confira sempre com o contador.

2. CNAE divergente do contrato social. A NFS-e exige CNAE coerente com o objeto social do CNPJ. Quem mudou de atividade e não atualizou o cadastro municipal sofre.

3. Descrição genérica do serviço. "Prestação de serviços" não é descrição. Use detalhamento: "Consultoria estratégica em marketing digital, abril/2026, 20h trabalhadas conforme contrato 2026-007".

4. Tomador sem inscrição municipal quando exigido. Alguns municípios exigem que o tomador PJ esteja inscrito no CCM local — caso contrário a nota é rejeitada.

5. Numeração de RPS fora de sequência. O padrão nacional aceita gaps numéricos em alguns casos, mas o sistema municipal antigo de muitas cidades é rigoroso e rejeita sequências quebradas.

6. Data de competência diferente da data de emissão. A competência é o mês fiscal a que o serviço se refere — não a data em que a nota foi emitida. Confundir os dois é causa frequente de DAS calculado errado.

Boas práticas para autônomos e pequenas empresas

Use um app que oferece predefinições por cliente e por tipo de serviço. Ter que digitar CNAE, código de tributação, alíquota e descrição padrão a cada emissão é fonte garantida de erros. No InvoiceFlow, predefinições com juros de mora, retenções e descrição padrão ficam salvas por cliente e por categoria de serviço.

Emita imediatamente após a prestação. Notas emitidas "no fim do mês" acumulam erros, perdem detalhe e às vezes cruzam a competência errada.

Mantenha backup do XML, não só do PDF. O DANFSE em PDF é resumo visual; o documento fiscal é o XML. Em caso de auditoria, é o XML que vale. Configure o app para exportar XMLs automaticamente para nuvem (Google Drive, Dropbox) ou backup local.

Reconcilie mensalmente com o contador. Notas emitidas no mês precisam bater com o que entra na contabilidade. Diferenças encontradas tarde viram retificação obrigatória de DEFIS ou DASN.

Quando você opera em múltiplos municípios

Prestador estabelecido em São Paulo que atende cliente em Curitiba enfrenta a clássica questão do ISS — onde recolher. A regra geral da LC 116/2003 é que o ISS é devido no município do estabelecimento prestador. Mas há 22 exceções (construção civil, limpeza, vigilância, transporte municipal, entre outras) em que o ISS vai para o município do tomador. Nessas exceções, frequentemente há retenção de ISS na fonte pelo tomador, e o prestador emite a nota com indicação de "ISS retido — município destinatário".

Aplicativos modernos permitem configurar múltiplos perfis isolados — um por município de atuação — para que a numeração, predefinições e regras de cada local não se contaminem. Isso é especialmente útil para consultores itinerantes e fotógrafos de eventos.

Conclusão: NFS-e não vai sumir tão cedo

A Reforma Tributária Brasileira começa a vigorar progressivamente em 2026, mas o ISS — e portanto a NFS-e — continuará existindo até 2033. O caminho até lá vai exigir convivência simultânea entre NFS-e tradicional, NFS-e padrão nacional, e os novos documentos vinculados ao IBS (que, no atacado, devem ter formato semelhante ao da NF-e atual). Quem investir em ferramentas que abstraem essa complexidade hoje — predefinições limpas, emissão offline-first, backup automático de XMLs, integração multi-município — vai sofrer muito menos na transição.

Leituras relacionadas