Resposta rápida: a maioria das rejeições na NFS-e Nacional cai em seis grupos: certificado e conexão mTLS, assinatura digital, schema do XML, cadastro do prestador no município, regras de tributação e numeração duplicada da DPS. O código e a mensagem do retorno dizem em qual grupo está o problema. Resolver a causa no sistema, e não nota por nota, é o que impede a rejeição de voltar.
Com a obrigatoriedade do padrão nacional para o Simples Nacional desde 01/11/2026, muitas empresas que emitiam pelo sistema da prefeitura passaram a ver notas rejeitadas. Abaixo estão os erros mais frequentes, por que acontecem e como corrigir. O código exato de cada rejeição aparece na resposta da API e na tabela de mensagens do leiaute, publicada no portal oficial da NFS-e.
1. Certificado digital e conexão mTLS
Sintoma: a requisição falha antes de qualquer validação do XML, com erro de conexão, de handshake TLS ou de acesso negado.
- Certificado vencido ou revogado.
- Certificado de um CNPJ diferente do prestador da DPS.
- Cadeia de certificados incompleta no servidor, ou chave privada não exportada junto com o certificado.
- Uso do certificado A3 em servidor, onde o token não está disponível.
Como resolver: confira validade e CNPJ do certificado, use o A1 no servidor e monitore o vencimento com alerta antecipado.
2. Assinatura digital inválida
Sintoma: rejeição informando assinatura inválida ou documento alterado.
- O XML foi modificado depois de assinado (formatação, espaços, quebras de linha, troca de codificação).
- A referência da assinatura não aponta para o
Idcorreto da DPS. - Algoritmo ou canonicalização diferente do exigido pelo leiaute.
Como resolver: assine como último passo antes de compactar e enviar, sem nenhuma transformação depois. Teste a assinatura com um validador antes de mandar para o ambiente nacional.
3. Erro de schema (leiaute)
Sintoma: rejeição apontando campo obrigatório ausente, valor em formato inválido ou elemento inesperado.
- Sistema gerando XML de uma versão antiga do leiaute.
- Datas sem fuso horário ou em formato diferente do esperado.
- Valores com vírgula, casas decimais a mais ou campos vazios que deveriam ser omitidos.
- Elementos fora da ordem definida no XSD.
Como resolver: valide cada DPS contra o XSD da versão vigente antes de assinar. Esse passo sozinho elimina boa parte das rejeições.
4. Cadastro e parametrização do município
Sintoma: rejeição sobre o prestador, a inscrição municipal, o município ou o código de serviço.
- Município de incidência ainda sem a parametrização correta no sistema nacional.
- Código de Tributação Nacional que o município não aceita para aquela atividade.
- Dados do prestador divergentes do cadastro (inscrição municipal, regime de tributação, opção pelo Simples Nacional).
Como resolver: confira a parametrização do município no sistema nacional e o enquadramento do serviço. Se o município não estiver configurado, a correção depende da prefeitura, e vale registrar o caso para cobrar o ajuste.
5. Regras de tributação
Sintoma: rejeição em alíquota, base de cálculo, retenção ou regime especial.
- Alíquota de ISS diferente da permitida para o serviço ou para o regime.
- Retenção de ISS informada quando não cabe, ou omitida quando é obrigatória para o tomador.
- Informações do Simples Nacional incoerentes com o enquadramento da empresa.
- Grupos de IBS e CBS ausentes ou preenchidos fora do padrão da versão vigente.
Como resolver: centralize as regras de tributação no sistema, por serviço e por município, em vez de deixar o usuário digitar alíquotas na hora da emissão.
6. DPS duplicada
Sintoma: rejeição informando que a DPS já foi recebida.
Acontece quando o sistema reenvia a mesma série e número, quase sempre depois de um timeout em que a nota, na verdade, foi autorizada. O erro oposto também é comum e pior: o sistema troca o número e reenvia, gerando duas notas para o mesmo serviço.
Como resolver: antes de reenviar, consulte se a DPS já gerou NFS-e. Controle a numeração no servidor, nunca no navegador do usuário, e use fila com retentativa idempotente.
Como evitar que as rejeições voltem
- Guarde em log o XML enviado e a resposta completa de cada tentativa.
- Monte um painel com as rejeições agrupadas por código: o mesmo erro repetido indica uma regra a corrigir no sistema.
- Teste mudanças no ambiente de Produção Restrita antes de publicar.
- Acompanhe as notas técnicas, porque o leiaute muda, principalmente nos campos da Reforma Tributária.
Perguntas frequentes
A nota rejeitada conta na numeração?
A DPS rejeitada não gera NFS-e. Depois de corrigir, você pode reenviar, mas confirme antes se a primeira tentativa realmente não foi autorizada, para não duplicar.
Posso continuar emitindo pelo sistema da prefeitura enquanto resolvo?
Depende do município e do seu enquadramento. Para o Simples Nacional, a regra a partir de 01/11/2026 é o padrão nacional; o portal web do Emissor Nacional pode servir de contingência manual enquanto a integração é corrigida.
Suas notas estão sendo rejeitadas e o faturamento parou? Veja o guia completo do Emissor Nacional ou fale com um especialista da iLAB4 para um diagnóstico gratuito.
