Quem emite NFS-e regularmente acaba se deparando com erros — alguns triviais, outros frustrantes. O sistema do Padrão Nacional é rigoroso na validação dos dados, e qualquer inconsistência impede a emissão. Saber identificar rapidamente o erro e como corrigi-lo economiza horas e evita dores de cabeça.
Este artigo lista os erros mais comuns reportados por emissores de NFS-e Padrão Nacional, com explicação da causa e solução prática para cada um.
Erro: CNPJ inválido ou não localizado
Um dos erros mais frequentes. Acontece quando o CNPJ do prestador, do tomador ou do intermediário está digitado errado, ou está com situação cadastral irregular na Receita.
Causas: erro de digitação (típica troca de dígito), CNPJ baixado/inativo, CNPJ ainda não totalmente validado em sistemas federais.
Solução: verificar o CNPJ no portal da Receita Federal antes de tentar reemitir. Se o CNPJ está ativo lá mas o sistema da NFS-e não aceita, aguarde 24h (sincronização) e tente novamente.
Erro: município de prestação não autorizado
Quando você tenta emitir uma NFS-e indicando um município que ainda não aderiu ao Padrão Nacional, ou que tem regras específicas que bloqueiam aquela operação.
Solução: confirme se o município emissor adotou o Padrão Nacional. Se sim, verifique o tipo de serviço — algumas atividades podem exigir regras locais específicas. Em último caso, consulte o suporte da prefeitura.
Erro: código de serviço (cTribNac) inválido
Acontece quando o código tributário nacional escolhido não existe na tabela vigente, ou não é compatível com a atividade declarada do prestador (CNAE).
Solução: use a consulta de códigos no portal nacional para encontrar o código correto. Verifique também os CNAEs cadastrados do seu CNPJ — se o serviço prestado não está coberto por nenhum CNAE seu, é necessário atualizar o cadastro antes.
Erro: valor de retenção fora dos limites permitidos
Quando o valor declarado de retenção (ISS retido, IRRF, etc.) excede o que a regra tributária permite — por exemplo, ISS retido com alíquota fora da tabela do município, ou IRRF acima do percentual padrão.
Solução: conferir as alíquotas aplicáveis ao tipo de serviço e ao regime tributário do prestador. Sistemas bem configurados calculam isso automaticamente; se você está digitando manualmente, verifique tabelas oficiais.
Erro: regime tributário incompatível com retenção
Caso clássico: prestador do Simples Nacional ou MEI tenta emitir nota com retenção federal indevida. O sistema rejeita.
Solução: revisar o regime tributário cadastrado para o prestador. Se realmente é Simples ou MEI, não pode haver retenção (com raras exceções). Se é Lucro Presumido/Real, configurar o sistema para incluir corretamente.
Converta XML em DANFSe (PDF) sem instalar nada
Se você tem arquivos XML de NFS-e Padrão Nacional e precisa gerar PDFs para conferência ou arquivamento, nosso conversor gratuito faz isso em segundos. O processamento acontece no seu navegador — seus arquivos não são enviados para servidor algum.
Abrir o conversor →Erro: data de emissão futura
Não é permitido emitir uma NFS-e com data futura. A data deve ser a do dia da emissão (ou anterior, em casos específicos).
Solução: ajustar a data para a data corrente. Se você está corrigindo uma nota emitida com atraso, ainda assim a data é a do momento da emissão real.
Erro: descrição do serviço muito curta ou genérica
Alguns sistemas (e algumas prefeituras) exigem descrição mínima do serviço para evitar lançamentos genéricos. “Serviços” ou “Consultoria” pode ser rejeitado.
Solução: escrever uma descrição específica. Em vez de “serviços profissionais”, escrever “Consultoria em gestão financeira para o cliente X, mês de abril/2026”. Mais detalhe geralmente é melhor.
Erro: sistema do portal indisponível
Indisponibilidades do portal nacional acontecem ocasionalmente, especialmente em finais de mês com volume alto de emissões.
Solução: aguardar e tentar novamente em alguns minutos. Se for crítico, consulte o status do sistema no portal de status oficial. Em situações extraordinárias, há contingência (emissão posterior com data retroativa, dentro de regras específicas).
Erro: certificado digital inválido ou expirado
Para emissões via sistema próprio (não pelo portal nacional), é necessário certificado digital. Se o certificado expirou, está revogado, ou não tem cadeia de confiança válida, o sistema rejeita.
Solução: verificar a validade do certificado. Se está expirado, renovar com a autoridade certificadora. Se está válido mas o sistema não aceita, conferir cadeia de certificados intermediários e raiz.
Erro: número da NFS-e duplicado
Quando há tentativa de emissão com número sequencial já usado pelo emitente. Sistema rejeita para preservar unicidade.
Solução: ajustar o sistema emissor para usar o próximo número disponível. Em sistemas bem configurados, isso é automático; falhas geralmente vêm de migrações de banco de dados ou intervenções manuais.
Quando o erro persiste
Se o erro persiste mesmo após as soluções acima, o caminho é:
- Coletar evidências: screenshot da tela de erro, número de protocolo (se houver), XML que tentou emitir.
- Consultar suporte do sistema: se você usa um software de emissão, abrir chamado com a equipe deles.
- Consultar a prefeitura ou Receita: em casos onde o erro vem do portal oficial, o suporte da prefeitura ou da Receita pode ajudar.
- Comunidades técnicas: fóruns de contadores e desenvolvedores frequentemente têm a resposta — alguém já passou pelo mesmo problema.