Como Resolver Erros Comuns de Validação XML na SEFAZ

Introdução

Erros de validação XML são a causa mais comum de rejeição de NF-e pela SEFAZ. Conhecer esses erros e suas soluções é essencial para qualquer desenvolvedor que trabalhe com sistemas fiscais.

Neste artigo, vamos listar os erros mais comuns e fornecer soluções práticas para cada um deles.

Categorias de Erros

1. Erros de Schema

Erros relacionados à estrutura do XML não conformar com o schema XSD oficial.

Erro 225: Falha no Schema

Descrição: O XML não está conforme com o schema XSD

Causas comuns:

• Tags obrigatórias ausentes
• Tipos de dados incorretos
• Atributos faltando
• Ordem dos elementos incorreta

Solução:

1. Valide o XML contra o schema XSD
2. Verifique se todos os campos obrigatórios estão presentes
3. Confirme os tipos de dados (numérico, data, etc.)
4. Use nosso Validador XML para identificar o erro exato

Erro 226: Tag Não Permitida

Descrição: Uma tag que não pertence ao schema foi encontrada

Causas comuns:

• Tag de outro modelo inserida
• Tag customizada não removida
• Cópia incorreta de template

Solução:

1. Remova a tag não permitida
2. Verifique se está usando o schema correto (55 para NF-e, 65 para NFC-e)

2. Erros de Negócio

Erros relacionados às regras de negócio da SEFAZ.

Erro 239: CNPJ do Destinatário Inválido

Descrição: O CNPJ informado não existe ou está inapto

Causas comuns:

• CNPJ digitado incorretamente
• CNPJ de empresa inapta
• CNPJ de empresa baixada

Solução:

1. Verifique o CNPJ na Receita Federal
2. Use nosso Gerador de CNPJ para testes
3. Confirme com o cliente o CNPJ correto

Erro 247: Valor Total dos Produtos Diferente

Descrição: A soma dos valores dos itens não confere com o total informado

Causas comuns:

• Erro de arredondamento
• Item omitido no cálculo
• Valor de frete/seguro não incluído

Solução:

1. Recalcule todos os valores
2. Verifique o arredondamento (2 casas decimais)
3. Inclua todos os custos adicionais

Erro 574: Código de Benefício Fiscal Inválido

Descrição: O código de benefício fiscal informado não existe ou não se aplica

Causas comuns:

• Código desatualizado
• Código não aplicável à operação
• UF de destino não participa do benefício

Solução:

1. Verifique a tabela de benefícios fiscais atualizada
2. Confirme se o benefício se aplica à operação
3. Consulte a SEFAZ da UF de destino

3. Erros de Assinatura

Erros relacionados à assinatura digital do XML.

Erro 244: Assinatura Digital Inválida

Descrição: A assinatura do XML não pôde ser validada

Causas comuns:

• XML alterado após assinatura
• Certificado não corresponde à assinatura
• Algoritmo de assinatura incorreto

Solução:

1. Assine novamente o XML
2. Verifique se o certificado é válido
3. Confirme o algoritmo (RSA-SHA256)

Erro 245: Certificado Não Encontrado

Descrição: O certificado utilizado não foi encontrado na base da SEFAZ

Causas comuns:

• Certificado revogado
• Certificado não cadastrado
• Certificado de outra AC não reconhecida

Solução:

1. Verifique o status do certificado
2. Cadastre o certificado na SEFAZ (se necessário)
3. Use um certificado ICP-Brasil válido

4. Erros de Validação de Dados

Erros de formatação e validação de campos específicos.

Erro 236: Formato de Data Inválido

Descrição: O formato da data não está conforme com o padrão

Causas comuns:

• Formato incorreto (deve ser AAAA-MM-DD)
• Data inexistente
• Fuso horário incorreto

Solução:

1. Use o formato ISO 8601: AAAA-MM-DDThh:mm:ssTZD
2. Valide se a data existe
3. Configure o fuso horário corretamente

Erro 237: CPF/CNPJ com Formato Incorreto

Descrição: O CPF ou CNPJ não está no formato válido

Causas comuns:

• Dígitos verificadores incorretos
• Formatação errada (usar apenas números)
• Tamanho incorreto

Solução:

1. Remova formatação (pontos, traços, barras)
2. Verifique os dígitos verificadores
3. Use 11 dígitos para CPF, 14 para CNPJ

Fluxo de Depuração

Passo 1: Identificar o Erro

1. Leia a mensagem de rejeição: Anote o código e descrição
2. Localize o campo: Identifique onde está o erro
3. Verifique o schema: Confirme o que é esperado

Passo 2: Corrigir o Erro

1. Faça a correção necessária
2. Valide novamente: Use nosso Validador XML
3. Teste em homologação: Antes de enviar para produção

Passo 3: Reenviar

1. Gere nova chave de acesso (se necessário)
2. Assine novamente o XML
3. Envie para a SEFAZ

Ferramentas de Validação

Nosso Validador XML

Use nossa ferramenta para validar XMLs antes de enviar para a SEFAZ:

1. Faça upload do XML
2. Selecione o modelo (55 ou 65)
3. Clique em validar
4. Veja os erros identificados

Validação Local

Para validação em lote ou automação:

const validator = require('xml2js');
// Valide contra o schema XSD

Boas Práticas

1. Valide sempre antes de enviar: Use nosso Validador XML
2. Mantenha schemas atualizados: A SEFAZ atualiza periodicamente
3. Teste em homologação: Nunca teste em produção
4. Documente erros: Mantenha registro dos erros encontrados
5. Automatize validações: Implemente validação no seu sistema

Conclusão

Erros de validação XML são comuns, mas com conhecimento e ferramentas adequadas, podem ser resolvidos rapidamente. A chave é entender a causa raiz do erro e aplicar a solução correta.

Use nossas ferramentas para validar, assinar e gerenciar XMLs de forma eficiente, minimizando erros e retrabalho.