Erros da NFS-e: como identificar o padrão e resolver cada rejeição

Antes do erro: o código do serviço

Boa parte da recusa não é regra de validação — é o código do serviço errado. A NFS-e Nacional identifica o serviço pelo código de tributação nacional (cTribNac), que desdobra os subitens da LC 116 em 338 códigos com descrição própria, cada um com a regra de em qual município o ISS é devido. Conferir o desdobro antes de emitir evita a ida e volta.

Visão geral da família — códigos, erros dos dois padrões e a correlação com NBS e LC 116 — em NFS-e Nacional.

Emitir nota fiscal de serviço no Brasil é conversar com dois mundos diferentes — e a primeira causa de sofrimento com rejeição é não saber em qual deles você está. O código E2 que a prefeitura devolveu não está na mesma tabela do E0008 que travou a nota do MEI; um é ABRASF, o outro é NFS-e Nacional, e cada um tem catálogo, causa e solução próprios.

Este guia organiza os dois padrões, mostra como ler cada família de erro e onde encontrar a solução oficial — que, no caso da ABRASF, é publicada pela própria associação e está, código a código, na tabela de erros da NFS-e do site.

Os dois padrões de NFS-e (e como identificar o seu)

A regra prática: olhe o formato do código. Curto = ABRASF, procure a tabela da versão 2.04; 4 dígitos = Nacional, procure as regras de negócio da DPS. Os dois catálogos estão na mesma consulta, cada código com página própria.

Um terceiro formato existe: códigos começados em L são locais — criados pelo provedor do município fora do padrão ABRASF. Pra esses, só a documentação da prefeitura resolve.

Erros ABRASF: mensagem, motivo e solução oficiais

O diferencial do padrão ABRASF é que a planilha oficial da versão 2.04 publica, pra cada código, três colunas: a mensagem, o motivo e a solução — não é interpretação de fórum, é a própria associação dizendo o que fazer. Exemplos reais do catálogo:

• E2 — “Data de competência superior a de emissão do RPS”: a competência informada está no futuro em relação à emissão; corrija o campo e reenvie;
• E4 — “Esse RPS não foi encontrado em nossa base de dados”: consulta a um RPS que ainda não foi processado ou teve numeração divergente.

As categorias que mais aparecem na rotina, pela nossa organização do catálogo: RPS (numeração, série, datas), ISS e tributação (alíquota divergente da legislação municipal, exigibilidade, local de incidência), dados do tomador (CPF/CNPJ, inscrição municipal), cancelamento e substituição, e assinatura e certificado digital.

O fluxo de correção é sempre o mesmo:

1. Anote o código exato devolvido pelo webservice;
2. Abra a ficha dele na tabela — mensagem, motivo e solução oficiais;
3. Ou pule a etapa: cole o arquivo no validador de XML da NFS-e e ele aponta os campos com problema antes de você transmitir, já com o código do erro que seria devolvido;
4. Corrija o campo apontado no sistema emissor (a maioria dos erros é de dado, não de sistema);
5. Reenvie o RPS — e, se o erro persistir com dado correto, o problema costuma ser cadastro desatualizado na prefeitura (inscrição, regime, alíquota), resolvido no portal do município.

Erro ≠ alerta: códigos A (alerta) não impedem a geração da nota — são avisos de inconsistência que merecem verificação, mas a NFS-e sai.

NFS-e Nacional: as regras de negócio da DPS

No padrão do gov.br o vocabulário muda: o emissor transmite uma DPS, o ADN (Ambiente de Dados Nacional) a recepciona, e as validações devolvem códigos de 4 dígitos. O catálogo oficial tem 441 regras — parte na recepção no ADN, parte na validação do documento — e cada rejeição vem amarrada à regra de negócio que dispara e ao campo do XML envolvido. Exemplos:

• E0004 — o identificador da DPS não bate com a concatenação dos campos que o compõem;
• E0008 — data/hora de emissão da DPS posterior ao processamento pelo Sistema Nacional.

Como o MEI emite obrigatoriamente pelo emissor nacional, esse catálogo virou o dia a dia de milhões de emissores pequenos — e a lógica de correção é idêntica: ficha do código, campo apontado, correção, reenvio.

A exceção é a classe de esquema, com o E1235 à frente: ali o arquivo é recusado antes de qualquer regra, e a mensagem não aponta campo nenhum. O guia de falha no schema XML mostra como ler o texto longo do validador e chegar ao campo.

Quando o erro é de tributação, o problema costuma ser o enquadramento

Uma família inteira de rejeições — nos dois padrões — nasce antes do XML: no enquadramento do serviço. Vale a conferência tripla:

1. Item da lista da LC 116 — existe, está vigente, é o item certo pro serviço da nota? O guia da LC 116 explica o enquadramento;
2. Alíquota municipal — dentro da moldura de 2% a 5% e igual à da legislação do município competente;
3. Retenção — o tomador é responsável pelo recolhimento? (13 subitens têm retenção obrigatória federal, e municípios ampliam a lista.)

Desde 2026 há ainda o eixo da reforma: a NFS-e passou a carregar o grupo IBS/CBS com CST e cClassTrib — nos serviços, derivados da NBS. Enquadramento novo, família nova de validações; o simulador de serviços mostra o par correto por NBS.

Erro depois da nota emitida é erro de evento

Nem todo código aparece na hora de emitir. Depois que a NFS-e existe, ela não é mais alterada: cancelar, substituir, confirmar e bloquear passam a ser eventos ligados à chave de acesso — e o pedido de registro de cada um tem catálogo de erro próprio, com códigos que não aparecem na validação da DPS.

A recusa aqui costuma surpreender porque o pedido está correto. O sistema nacional olha o que a nota já tem antes de aceitar: nota já cancelada não aceita novo cancelamento, nota bloqueada por ofício não aceita o evento bloqueado. É uma matriz de “evento já registrado × pedido novo”, e é dela que vem boa parte das negativas.

O caso mais procurado é o prazo. Não existe prazo nacional para cancelar ou substituir: cada município parametriza o seu, e a documentação oficial fixa só o teto — o máximo parametrizável é de 2 anos. A substituição fora do prazo é recusada, com uma exceção prevista no texto: quando a justificativa é desenquadramento ou enquadramento no Simples Nacional. Muita fonte repete “168 horas”, que é o prazo do cancelamento por substituição da NFC-e — documento diferente, regra diferente.

NF-e não é NFS-e (e cada uma rejeita do seu jeito)

Fecha o mapa a distinção mais básica: NF-e é o documento de mercadorias, autorizado pelas SEFAZ estaduais, e rejeita com códigos cStat (204 — duplicidade, 539 — chave divergente…). Serviço puro não passa por lá. A tabela de rejeições da NF-e — com a regra de validação que dispara cada cStat — tem guia próprio.

Operações mistas (mercadoria + serviço) podem exigir os dois documentos, cada um com sua parcela — a fronteira é a da lista da LC 116, e o assistente fiscal ajuda a montar o quadro da NF-e.

A série 1000 chegou na NF-e — e quem emite os dois documentos sente primeiro

Se a sua operação também emite NF-e, o mapa de erros do lado das mercadorias mudou de tamanho: a NT 2025.002 criou os códigos da série 1000+ pra validar o grupo IBS/CBS da Reforma Tributária — obrigatório desde 03/08/2026 pro regime normal (CRT 3). A obrigação não foi adiada; o que a NT 2025.002-RTC v1.51 suspendeu, sem nova data, é a rejeição 1115; classificação errada devolve 1023/1024. As rejeições da reforma organizadas pela causa e o validador de XML (que confere o grupo no navegador, sem enviar a nota) cobrem esse lado — e no mundo dos serviços, a correlação NBS × cClassTrib já mostra o enquadramento IBS/CBS de cada serviço. Do lado da NFS-e os campos novos já estão publicados: o anexo do leiaute do IBS/CBS traz regras próprias e sete códigos de erro que não existem no leiaute da DPS em uso — cada ficha diz em qual documento a regra é declarada, e a lista de campos do XML mostra o que existe só no desenho da reforma e o que existe só no arquivo de hoje.

Fontes oficiais

• Erros e alertas NFS-e 2.04 — biblioteca pública da ABRASF
• Documentação técnica da NFS-e Nacional (gov.br)
• Lei Complementar nº 116/2003 (Planalto)

Se o que você precisa é ler a nota, e não corrigir o erro, o gerador de DANFSe monta o documento a partir do XML — no leiaute da NT 008, direto no navegador.