Validação

XSD TISS: como funciona a validação oficial da ANS

Administrador TISS Manager29 de julho de 20268 min de leitura
XSD TISS: como funciona a validação oficial da ANS

XSD é o “molde” que a ANS publica dizendo exatamente como cada campo do XML TISS deve aparecer — nome, tipo, ordem, obrigatoriedade e valores permitidos. Se o seu arquivo não bate 100% com o XSD da versão declarada, a operadora rejeita antes de olhar qualquer regra de negócio. Este artigo explica em linguagem simples o que é validado e como testar isso agora, grátis, no validador TISS online.

O que é XSD e por que ele existe no TISS?

XSD (XML Schema Definition) é um arquivo que descreve a estrutura permitida de um XML: quais tags existem, em que ordem, quantos filhos podem ter e o tipo de cada valor (data, número, texto com tamanho X). Sem XSD, cada operadora interpretaria o padrão de um jeito — foi exatamente o problema que a ANS resolveu ao criar o TISS.

Cada versão TISS (2.02.03, 3.02.00, ..., 4.03.00) tem seu conjunto de XSDs publicado no portal da ANS. Um arquivo declarado como 4.03.00 é validado contra os XSDs da 4.03.00, não das anteriores.

Vídeo: como XSD valida um XML na prática

O que exatamente o XSD verifica no seu XML TISS?

Quatro camadas, na ordem em que o parser as aplica:

  • Estrutura: tag existe, aparece na ordem certa e tem os filhos obrigatórios.
  • Cardinalidade: quantas vezes uma tag pode/deve aparecer (mínimo e máximo).
  • Tipo: data no formato AAAA-MM-DD, número com casas decimais, texto no tamanho permitido.
  • Enumeração: valor pertence à lista fechada (ex.: regime de atendimento aceita só valores oficiais).

Quais são os erros de XSD mais comuns em 2026?

A distribuição não muda muito ano a ano — mas em 2026, com a virada da 4.03.00, os erros de tipo e enumeração subiram muito:

  • Campo obrigatório ausente após conversão de versão.
  • Data em formato antigo (DD/MM/AAAA em vez de AAAA-MM-DD).
  • Valor de enumeração fora da lista da 4.03.00.
  • Tag com filho na ordem errada (parser não aceita).
  • Texto acima do tamanho máximo permitido pelo XSD.

Como validar seu XML contra o XSD oficial da ANS?

Existem três caminhos: (1) usar o validador oficial da ANS (desktop, exige Java), (2) rodar xmllint no terminal com o XSD baixado, ou (3) usar um validador online que já traga os 131 XSDs publicados. Para uso do dia a dia, o navegador ganha por praticidade: você arrasta o XML e vê erro linha a linha em segundos, sem instalar nada.

Se prefere comparar as duas ferramentas, veja nosso guia alternativa ao validador da ANS.

XSD × regras de negócio: por que XSD não é suficiente?

XSD prova que o XML está bem-formado para o padrão. Ele não sabe se o beneficiário está elegível, se o CBO combina com o procedimento ou se a quantidade é plausível. Por isso um XML 100% válido no XSD ainda pode ser glosado. A prevenção completa exige XSD + regras de risco de glosa — as duas coisas rodam juntas no TISS Manager.

Perguntas frequentes

Onde encontro os XSDs oficiais do TISS?

No portal da ANS, seção Padrão TISS. O TISS Manager já embarca os 131 XSDs publicados (versões 2.02.03 a 4.03.00), então você não precisa baixar nada para validar.

Meu XML passou no XSD e mesmo assim foi glosado. Por quê?

XSD só valida estrutura. Glosa é decisão administrativa/clínica sobre um XML já aceito estruturalmente. Para prevenir glosa, você precisa de motor de regras (idade, sexo, CBO, autorização) rodando junto — é o que o painel de risco de glosa faz.

Posso alterar um XML depois de validado?

Pode, mas qualquer alteração invalida o hash MD5 do lote. Sempre recalcule o hash após editar e revalide o arquivo antes de transmitir.

Validação XSD é grátis?

Sim, no TISS Manager a validação de XML no navegador é gratuita e ilimitada. Não é necessário cadastro para o validador básico.

Conclusão

XSD é o piso da validação TISS: sem ele, o lote nem entra na fila da operadora. Mas é só o piso — para chegar em faturamento saudável, some XSD + regras de risco de glosa + revisão pré-envio. Comece agora testando seu XML no validador contra o XSD oficial da ANS.

Continue lendo