Rejeição 242: Cabeçalho – Falha no Schema XML

Descrição oficial da SEFAZ: Cabeçalho – Falha no Schema XML

O que significa

A falha de schema está no cabeçalho da mensagem, não no corpo da nota. É a estrutura que acompanha a chamada do serviço que não bateu com o formato esperado.

Por que acontece

A regra é objetiva: o cabeçalho precisa existir com os campos e a versão que o serviço espera. A causa concreta depende do que foi enviado — normalmente é integração montando o cabeçalho fora do padrão, com versão divergente da do corpo da mensagem, ou enviando cabeçalho para um serviço que não usa mais esse elemento. É um erro de camada de comunicação, e a nota em si pode estar perfeita.

Como resolver

Compare a mensagem enviada com o formato exigido pelo serviço que você chamou, incluindo a versão declarada — a do cabeçalho e a do corpo precisam ser coerentes. O ajuste é na integração que monta a chamada, não no conteúdo fiscal da nota. Corrigida a chamada, retransmita o mesmo XML assinado.

Como evitar

Use uma biblioteca de comunicação que monte a chamada conforme o manual do serviço, em vez de montar a requisição na mão.