Rejeição 545: Falha no schema XML – versão informada na versaoDados do SOAPHeader diverge da versão da mensagem

Descrição oficial da SEFAZ: Falha no schema XML – versão informada na versaoDados do SOAPHeader diverge da versão da mensagem

O que significa

A versão declarada no cabeçalho da chamada ao serviço web não é a mesma versão do XML da mensagem enviada dentro dela. A SEFAZ exige que as duas coincidam.

Por que acontece

É um erro de integração, não de dados fiscais: o componente que monta a requisição envia uma versão fixa no cabeçalho enquanto o XML foi gerado em outra. Costuma aparecer logo depois de atualizar o gerador do XML ou de trocar de UF/ambiente, quando só um dos lados foi ajustado.

Como resolver

Compare a versão declarada no cabeçalho da requisição com a versão declarada no XML da mensagem e deixe as duas iguais. Confirme também qual versão o serviço daquela UF aceita hoje. Não há nada a corrigir na nota em si: é a chamada que precisa ser refeita.

Como evitar

Derive a versão do cabeçalho do próprio XML gerado, em vez de manter uma constante em outro ponto do código.