Rejeição 238 — Cabeçalho - Versão do arquivo XML superior a Versão vigente

O que é esta rejeição?#

A Rejeição 238 é retornada pela SEFAZ quando o sistema identifica o seguinte problema na NF-e: Cabeçalho - Versão do arquivo XML superior a Versão vigente. A nota fiscal não foi autorizada e precisa ser corrigida antes de ser retransmitida.

Este código indica que rejeição: Cabeçalho – Versão do arquivo XML superior a Versão vigente.

Causas comuns#

• O XML contém erros de formatação, namespaces inválidos ou codificação incorreta
• A versão do layout XML não é suportada ou é superior à vigente na SEFAZ
• Há caracteres especiais, espaços ou quebras de linha indevidas no XML
• O XML deve usar codificação UTF-8 sem BOM (Byte Order Mark)

Como resolver#

1. Valide o XML com um parser antes de enviar — ele deve ser bem-formado (well-formed)
2. Use apenas o namespace padrão da NF-e: http://www.portalfiscal.inf.br/nfe
3. Salve o XML com codificação UTF-8 sem BOM
4. Atualize a versão do layout no sistema emissor para a versão vigente aceita pela SEFAZ
5. Remova caracteres de edição (tabs, espaços extras) do início e fim do XML

Verificações analíticas#

• Se o atributo versao do elemento nfeProc ou NFe for diferente de '4.00' (por exemplo '4.01', '3.10' ou qualquer valor superior ao aceito pela SEFAZ vigente) então a NF-e será rejeitada com cStat 238 independentemente do conteúdo fiscal: corrija o atributo versao para exatamente '4.00' e garanta que o mesmo valor esteja declarado também em infNFe/@versao.
• Se o namespace declarado no elemento raiz NFe ou nfeProc contiver variações como 'http://www.portalfiscal.inf.br/nfe/' (com barra final), 'https://...' ou qualquer prefixo de namespace adicional além do padrão 'http://www.portalfiscal.inf.br/nfe' então o schema será rejeitado por namespace inválido: remova prefixos extras e normalize o xmlns para exatamente 'http://www.portalfiscal.inf.br/nfe' sem barra final.
• Se o campo verAplic ou cStat presente em retorno anterior indicar versão de schema superior à 4.00 e o XML submetido mantiver verProc ou atributos de layout incompatíveis com essa versão então há desalinhamento entre o schema declarado e o schema efetivamente processado pela SEFAZ: atualize o sistema emissor para gerar o XML estritamente conforme o leiaute 4.00 publicado no Portal da NF-e.
• Se o XML contiver a declaração de codificação '<?xml version="1.0" encoding="UTF-8"?>' porém o arquivo binário apresentar os bytes EF BB BF no início (BOM UTF-8) ou estiver salvo em UTF-16/ISO-8859-1 então o parser da SEFAZ interpretará os bytes extras como conteúdo inválido antes do elemento raiz, causando rejeição de cabeçalho: salve o arquivo explicitamente como UTF-8 sem BOM e valide a ausência do BOM com um editor hexadecimal antes do envio.
• Se o elemento infNFe contiver o atributo Id com valor que não inicie exatamente com a letra maiúscula 'NFe' seguida dos 44 dígitos da chave de acesso (cUF+AAMM+CNPJ+mod+serie+nNF+tpEmis+cNF+cDV) então a assinatura digital referenciada no SignedInfo/Reference/@URI ficará inconsistente com o Id real do elemento, gerando falha de validação de schema anterior à verificação de versão: reconstrua o Id concatenando corretamente todos os campos da chave e refaça a assinatura XAdES/XMLDSig sobre o novo Id.