Rejeição 567: Falha no schema XML – versão informada na versaoDados do SOAPHeader diverge da versão do lote de NF-e

Descrição oficial da SEFAZ: Falha no schema XML – versão informada na versaoDados do SOAPHeader diverge da versão do lote de NF-e

O que significa

A versão do leiaute declarada no cabeçalho SOAP da chamada (versaoDados) não é a mesma versão declarada no XML do lote. Os dois precisam coincidir.

Por que acontece

Quase sempre é a integração com a versão fixa no código do cabeçalho enquanto o gerador do XML já subiu de versão, ou o contrário. Também aparece depois de atualização parcial do componente de comunicação, quando só uma das duas camadas foi atualizada.

Como resolver

Compare o valor de versaoDados no cabeçalho SOAP com o atributo de versão da tag raiz do lote e deixe os dois com o mesmo valor, na versão vigente do serviço. Faça esse valor vir de um único ponto de configuração, e não de duas constantes separadas. Retransmita.

Como evitar

Derive a versão do cabeçalho SOAP da mesma configuração que gera a versão do XML, para não haver como divergirem.