Rejeição 239: Versão do arquivo XML não suportada

A Rejeição 239 do DC-e (Declaração de Conteúdo Eletrônica, modelo 99) é um código de erro devolvido pelo autorizador da SEFAZ quando a versão do arquivo XML enviada para o Web Service não é suportada pela configuração vigente.

A mensagem oficial exibida é: “Versão do arquivo XML não suportada”.

Em termos práticos: o cabeçalho do arquivo XML que você está tentando transmitir está em uma versão de leiaute que o ambiente da SEFAZ não aceita mais. Isso normalmente acontece quando há uma migração de versão e o sistema emissor ainda está configurado para enviar o formato antigo.

A validação está catalogada na seção “Regras de Validação dos Webservices” do manual oficial do DC-e, identificada como B06 obrigatória:

Verifica se a versão do XML é suportada

A condição para disparo é simples: se a versão declarada no XML do DC-e for inferior ou incompatível com a versão vigente exigida pela SEFAZ, o documento é rejeitado.

Imagine que o ambiente autorizador passou a aceitar apenas a versão 1.01 do leiaute do DC-e. Se o seu sistema emissor ainda está configurado para transmitir na versão 1.00, a SEFAZ identifica a incompatibilidade e retorna a rejeição 239 .

O mesmo conceito se aplica a outros documentos fiscais eletrônicos: quando o CT-e migrou da versão 3.00 para 4.00, qualquer envio na versão antiga gerava rejeição 239 .

Mensagem de Erro: “Rejeição: Versão do arquivo XML não suportada”

A correção envolve alinhar a versão do XML do DC-e com a versão atualmente suportada pelo ambiente autorizador.

O código 239 surge em 3 documentos fiscais eletrônicos com 2 significados distintos :

Atenção: Buscar a solução do código 239 na tabela da NF-e pode levar à resposta errada. O que identifica a rejeição é a mensagem, não apenas o número.

ERPs e emissores frequentemente exibem um código próprio de protocolo ou sistema junto à mensagem. Se o texto for “Versão do arquivo XML não suportada”, o código oficial do DC-e é o 239.

Rejeições 239 são mais comuns durante janelas de atualização de leiaute. A SEFAZ costuma estabelecer prazos irrevogáveis para descontinuação de versões antigas — como fez com o CT-e, cuja versão 3.00 foi extinta em 31/01/2024 . Acompanhe as Notas Técnicas e mantenha seu sistema atualizado.

Significa que a versão do XML do DC-e enviada ao Web Service da SEFAZ não é suportada pela configuração vigente.

Atualize o XML e o sistema emissor para a versão de leiaute vigente, ajuste os endereços dos Web Services se necessário e retransmita o documento.

Não. O DC-e rejeitado não existe juridicamente. Não precisa ser cancelado e o número pode ser reaproveitado.

Não. O número 239 tem significados diferentes no DC-e, BP-e e CT-e. Sempre confira pela mensagem, não apenas pelo código.

Provavelmente sim. O que identifica a rejeição é a mensagem, não o número exibido na tela. ERPs costumam “embrulhar” o texto oficial com códigos próprios de sistema.

Sim. A regra é marcada como obrigatória no manual do DC-e. A validação vale para todos os autorizadores e o documento não é autorizado enquanto a condição persistir.

A Rejeição 239 do DC-e é um erro de incompatibilidade de versão do XML com o leiaute suportado pelo ambiente autorizador.

Resumo da solução:

Palavras-chave: Rejeição 239 DC-e, versão XML não suportada, erro DC-e, como resolver rejeição 239, DC-e modelo 99, SEFAZ rejeição 239, leiaute DC-e, versão suportada, correção DC-e, XML DC-e.