Erros NFS-e
Validações e mensagens da SEFIN / Receita Federal.
Guia de erros e mensagens de validação mais frequentes retornados pelo Ambiente de Dados Nacional (SEFIN / RFB) na emissão de NFS-e.
Erros Mais Frequentes
| Código / Mensagem | Causa Raiz | Como Resolver |
|---|---|---|
| Código de Tributação Inválido | O código de serviço informado não consta na lista nacional da LC 116 ou não é permitido para o CNAE da empresa. | Consulte a tabela de correlação CNAE × LC 116 no painel da NFER e informe o código correto no formato XX.YY.ZZ. |
| Tomador com Documento Inválido | CPF ou CNPJ do tomador contém dígito verificador inválido ou tamanho incorreto. | Valide o CPF/CNPJ antes de enviar na requisição. |
| DPS em Duplicidade | Já existe uma DPS com o mesmo número de série e número sequencial transmitida para este CNPJ. | O NFER gerencia a numeração automaticamente, mas caso informe numeração manual, incremente o número sequencial. |
| Certificado A1 Vencido / Inválido | O certificado digital da empresa expirou ou não possui permissão para assinatura. | Atualize o arquivo .pfx do Certificado A1 na aba Configurações > Empresa do painel NFER. |
| Alíquota de ISS Divergente | A alíquota informada está fora dos limites legais (mínimo 2% e máximo 5%) ou em desacordo com o Simples Nacional. | Para optantes do Simples Nacional, o NFER calcula a alíquota automaticamente com base na faixa do PGDAS. |
Boas Práticas de Prevenção
- Validação Prévia: O NFER valida a estrutura do JSON e os dígitos do CPF/CNPJ antes de assinar e transmitir a DPS à SEFIN.
- Webhook com Fallback: Trate eventos de erro para notificar o operador do sistema com a mensagem clara retornada no payload.