Erros da versão TISS 4.03.00: causas e correção passo a passo

Q: Qual é o erro mais comum na versão TISS 4.03.00?

Hash MD5 inválido e somatório divergente lideram entre os erros de integridade; entre os estruturais, o uso de valores de domínio de versões anteriores. Os três são detectáveis antes do envio com uma validação contra o XSD oficial 4.03.00.

Q: O XML passou no meu sistema, por que a operadora rejeitou?

Porque a operadora valida contra o XSD oficial da ANS e depois contra as próprias regras administrativas. Seu sistema geralmente confere apenas as regras internas de emissão.

Q: Posso corrigir o XML no bloco de notas e reenviar?

Não é recomendado: qualquer edição manual invalida o hash MD5 e pode quebrar somatórios. Corrija na origem e regere o lote.

Q: Erro de enum inválido significa o quê?

Que o valor informado não consta na tabela de domínio da versão TISS 4.03.00. Costuma acontecer quando o sistema continua usando as tabelas de 4.01.00 ou 4.02.00.

Q: Como saber se o problema é estrutural ou administrativo?

Se o arquivo é recusado na entrada, é estrutural. Se é aceito e a perda aparece no demonstrativo, é administrativo — glosa por TUSS, CBO, autorização, quantidade ou duplicidade.

Q: Validar antes do envio reduz mesmo a glosa?

Reduz a rejeição estrutural quase a zero e antecipa parte das causas administrativas. A glosa que depende de decisão da operadora continua exigindo recurso.

Depois que o lote passa a ser gerado na versão TISS 4.03.00, os erros mudam de natureza: deixam de ser "arquivo antigo" e passam a ser detalhes de estrutura, domínio e aritmética. Este artigo é um catálogo de consulta rápida: para cada erro, a mensagem típica devolvida pela operadora, a causa real e a correção. Se quiser conferir o seu arquivo enquanto lê, use o validador TISS online. Para o contexto da versão, veja o que é a versão TISS 4.03.00; para migrar, o tutorial de conversão em 7 passos.

Por que um XML válido no seu sistema é rejeitado na versão TISS 4.03.00?

Porque o sistema que gera o arquivo normalmente confere apenas as próprias regras de negócio, enquanto a operadora confere o arquivo contra o XSD oficial da ANS e, em seguida, contra as regras administrativas dela. São três camadas independentes:

Estrutural (XSD): tags, ordem, tipos, tamanhos e enums definidos pela ANS.
Aritmética e integridade: somatórios de guia e lote, hash MD5 do epílogo.
Administrativa (operadora): autorização, elegibilidade, CBO, vigência de TUSS, regras de contrato.
Passar na primeira não garante as outras duas — e a maior parte das rejeições vem das duas últimas.

Quais são os erros estruturais mais frequentes na versão TISS 4.03.00?

Esses erros travam o arquivo logo na entrada do webservice ou do portal, antes de qualquer análise de conteúdo.

Erro	Causa real	Correção
1. Versão incompatível	`versaoPadrao` diferente de 4.03.00 ou tabela de domínio de outra versão	converter o lote e atualizar o gerador
2. Namespace inválido	prefixo `ans:` ausente/duplicado ou URI errada	corrigir a declaração no elemento raiz
3. Ordem de elementos	XSD usa `sequence`: ordem é obrigatória	reordenar conforme o XSD 4.03.00
4. Tipo/tamanho inválido	campo numérico com máscara, texto acima do limite	remover máscaras e truncar no limite oficial
5. Enum não previsto	valor de domínio válido em 4.01/4.02 e removido em 4.03.00	usar o valor vigente da tabela de domínio
6. Encoding	arquivo salvo em UTF-8 declarando ISO-8859-1 (ou o inverso)	gravar na codificação declarada no cabeçalho

Regra prática: erro estrutural nunca é "caso isolado". Se apareceu em uma guia, o gerador vai repeti-lo em todas as guias do mesmo tipo — corrija na origem, não no arquivo.

Como corrigir hash MD5 inválido na versão TISS 4.03.00?

O hash do epílogo é calculado sobre o conteúdo do lote, e qualquer alteração posterior o invalida. Três causas concentram quase todos os casos: edição manual depois de gerar o arquivo, codificação diferente da declarada e entidades XML (&, <) consideradas de forma inconsistente.

A regra correta é: concatenar o conteúdo relevante do lote, decodificar as entidades XML, usar a codificação oficial (ISO-8859-1) e só então calcular o MD5. Implementações caseiras costumam calcular sobre a string ainda escapada — o resultado muda e a operadora rejeita.

Detalhamento completo, com exemplo comentado, em hash MD5 no TISS: o que é e como corrigir.

Nunca edite o XML depois que o hash foi gerado — regere o lote.
Confirme a codificação real do arquivo, não apenas o que está escrito no cabeçalho.
Decodifique entidades antes do cálculo.
Revalide o arquivo final: hash correto e somatórios fechados na mesma passada.

Por que o somatório do lote é acusado como divergente?

Porque o valor total informado não bate, ao centavo, com a soma dos itens. Na versão TISS 4.03.00 a conta é hierárquica: procedimentos + materiais + medicamentos + taxas/aluguéis + OPME + gases medicinais formam o total da guia; a soma das guias forma o total do lote.

A causa mais comum é arredondamento por item. Se cada linha é arredondada para duas casas e depois somada, o total pode divergir do valor calculado com precisão plena. Some com precisão e arredonde só no total.

A segunda causa é guia cancelada ou glosada que permanece no somatório do lote sem constar nas guias enviadas — ou o contrário.

Quais erros de conteúdo passam pelo XSD e mesmo assim geram glosa?

Este é o grupo que mais custa dinheiro: o arquivo entra, é processado e a glosa aparece semanas depois no demonstrativo de pagamento.

7. Código TUSS fora de vigência — o código existe na Tabela 22, mas com vigência encerrada na data do atendimento. Correção: usar a versão vigente da tabela e validar a data.
8. CBO incompatível com o procedimento — executante com CBO que não cobre o procedimento faturado. Veja como escolher o CBO correto.
9. Autorização ausente ou vencida — procedimento que exige senha enviado sem número de autorização ou fora do período autorizado.
10. Sexo ou idade incompatíveis — procedimento restrito a um sexo/faixa etária lançado para beneficiário fora da regra.
11. Quantidade implausível — consulta com quantidade 10, diária maior que o período de internação, digitação de quantidade no campo errado.
12. Duplicidade — mesma guia/procedimento/beneficiário/data reenviada em competências diferentes.
Todos esses são checáveis antes do envio pelas regras de risco de glosa.

Tutorial: como diagnosticar um lote rejeitado em 15 minutos?

Fluxo objetivo, aplicável a qualquer mensagem de rejeição na versão TISS 4.03.00:

1. Suba o arquivo no validador TISS online e leia os erros estruturais primeiro — eles explicam a maioria das rejeições genéricas.
2. Confirme versaoPadrao e o namespace no cabeçalho.
3. Cheque somatórios de guia e de lote antes de olhar qualquer outra coisa.
4. Recalcule o hash MD5 sobre o arquivo final.
5. Rode as verificações de risco de glosa e trate os apontamentos de TUSS, CBO, autorização e quantidade.
6. Reenvie só depois de zerar erro estrutural — reenvio com erro consome mais prazo do que uma nova rodada de validação.
7. Registre a causa em uma planilha por operadora: em dois meses você identifica os três erros que respondem pela maior parte do retrabalho.

Como evitar que os mesmos erros voltem no próximo lote?

Corrigir arquivo é operação; corrigir a origem é processo. Depois de mapear os erros recorrentes, ajuste o cadastro (TUSS, CBO, contratos), o gerador do XML e o checklist da equipe. Ver também o checklist de implantação do padrão TISS.

A referência oficial de tabelas, XSDs e comunicados fica no portal TISS da ANS.

Vídeo: analisando erros de XML TISS na prática

Perguntas frequentes

Qual é o erro mais comum na versão TISS 4.03.00?

Hash MD5 inválido e somatório divergente lideram entre os erros de integridade; entre os estruturais, o uso de valores de domínio de versões anteriores. Os três são detectáveis antes do envio com uma validação contra o XSD oficial 4.03.00.

O XML passou no meu sistema, por que a operadora rejeitou?

Porque a operadora valida contra o XSD oficial da ANS e depois contra as próprias regras administrativas. Seu sistema geralmente confere apenas as regras internas de emissão.

Posso corrigir o XML no bloco de notas e reenviar?

Não é recomendado: qualquer edição manual invalida o hash MD5 e pode quebrar somatórios. Corrija na origem e regere o lote.

Erro de enum inválido significa o quê?

Que o valor informado não consta na tabela de domínio da versão TISS 4.03.00. Costuma acontecer quando o sistema continua usando as tabelas de 4.01.00 ou 4.02.00.

Como saber se o problema é estrutural ou administrativo?

Se o arquivo é recusado na entrada, é estrutural. Se é aceito e a perda aparece no demonstrativo, é administrativo — glosa por TUSS, CBO, autorização, quantidade ou duplicidade.

Validar antes do envio reduz mesmo a glosa?