Tutorial: Validador TISS Online Grátis — Como Usar Passo a Passo

O Validador TISS Online é a ferramenta mais usada do TISS Manager — e a única que não exige cadastro. Nele você arrasta seu arquivo XML, escolhe a versão do padrão TISS e, em poucos segundos, recebe um relatório completo sobre a estrutura, o hash MD5, os somatórios e as regras de preenchimento. Neste tutorial mostramos como usar cada parte da tela, como interpretar os erros e como corrigir os problemas mais comuns antes de transmitir o lote para a operadora.

Para que serve o Validador TISS Online?

A ferramenta simula a primeira checagem que a operadora faz ao receber um arquivo TISS. Ela compara o XML contra o XSD oficial da ANS, recalcula o hash MD5, soma os valores das guias e ainda alerta sobre regras de preenchimento que costumam gerar glosa — tudo no navegador, sem instalar nada.

A diferença para validadores genéricos é que o motor do TISS Manager foi calibrado para as versões 3.02.01, 3.03.03, 3.04.00, 3.05.00, 4.01.00, 4.02.00 e 4.03.00, com tratamento de encoding ISO-8859-1, namespaces e totalizadores por tipo de guia.

Passo 1: acesse a ferramenta e escolha a versão TISS

Abra /validador-tiss-online. A tela inicial mostra uma área para arrastar ou selecionar o arquivo XML e um seletor de versão. A versão padrão é a 4.03.00, que se tornou obrigatória em 1º de julho de 2026. Se o seu arquivo foi gerado em outra versão, escolha a correspondente antes de validar.

Dica: versão errada é uma das causas mais comuns de falso positivo. O arquivo pode estar correto para a 4.01.00, mas aparecer cheio de erros se você validar como 4.03.00. Veja as diferenças entre as versões em versões do padrão TISS.

Passo 2: envie o arquivo XML TISS

Clique na área tracejada ou arraste o XML direto dela. O validador aceita arquivos `.xml` e `.xlm` (extensão comum em sistemas legados). Após o upload, a ferramenta lê o conteúdo, detecta a codificação e mostra o nome do arquivo ao lado do botão.

Se você preferir testar a ferramenta antes de subir um arquivo real, use a opção "Usar exemplo" disponível na tela. O exemplo carrega um XML TISS 4.03.00 com guias de consulta e SP/SADT para que você veja como o relatório é apresentado.

Passo 3: leia o resumo da validação

Assim que a análise termina, o validador exibe um painel com três indicadores principais: estrutura XSD, hash MD5 e somatórios. Cada um pode estar verde (OK), amarelo (alerta) ou vermelho (erro que precisa de correção).

Estrutura XSD: verifica se as tags, atributos, ordem e tipos de dados estão de acordo com o esquema oficial da ANS.
Hash MD5: recalcula a impressão digital do arquivo e compara com o valor declarado no epílogo. Se diferir, a operadora rejeita por integridade.
Somatórios: confere se os totalizadores do lote batem com a soma dos itens de cada guia.

Passo 4: interprete os erros de XSD

Quando a estrutura XSD falha, o validador lista cada erro com a linha aproximada, o caminho da tag e uma mensagem em português simplificada. Os erros mais frequentes são: campo obrigatório em branco, tag fora da ordem esperada, CPF com dígitos inválidos, registro ANS com menos ou mais de 6 dígitos e código IBGE inexistente.

Clique no erro para expandir e ver o trecho do XML. Use essa informação para corrigir no sistema que gerou o arquivo — nunca edite o XML manualmente, porque qualquer alteração invalida o hash MD5.

Passo 5: corrija hash MD5 e somatórios

Se o hash MD5 estiver vermelho, significa que o conteúdo do arquivo foi modificado depois de gerado ou que o hash foi calculado com encoding errado. A solução é regenerar o XML no sistema de origem. Se você precisa converter o arquivo para outra versão TISS sem perder o hash, use o Conversor de Versões TISS.

Erros de somatório geralmente acontecem quando uma guia é editada manualmente e os totalizadores não são recalculados. O validador mostra o valor esperado e o valor encontrado, facilitando a correção na fonte.

Passo 6: revise os alertas de regras de preenchimento

Além da estrutura técnica, o validador mostra alertas de regras que as operadoras usam para glosar guias: idade incompatível com o procedimento, sexo divergente da cobertura, quantidade acima do permitido, CBO incompatível com o TUSS e ausência de autorização quando exigida.

Esses alertas não impedem o envio do XML — afinal, a decisão final é da operadora —, mas dão chance de você corrigir a guia antes de transmitir e evitar glosa. Para quem quer uma rotina mais avançada de análise de risco, o app pago inclui o painel de Riscos de Glosa.

Passo 7: baixe o relatório e compartilhe com a equipe

Após a validação, você pode baixar um relatório em PDF com todos os itens verificados. Esse relatório é útil para abrir chamados com o suporte do sistema gestor da clínica ou para anexar em e-mails internos. A versão online também permite validar novamente após cada correção, sem limite de uso.

Integração com as outras ferramentas do TISS Manager

O Validador TISS Online é a porta de entrada de um ecossistema de ferramentas. Se você precisa unificar vários XMLs em um só lote, use o Unificador de XMLs TISS. Se precisa converter de uma versão para outra, o Conversor TISS mantém hash e somatórios. Para quem ainda usa planilha, o Gerador de Guias TISS cria XMLs a partir de CSV ou Excel.

Usuários logados ainda têm acesso ao Histórico de Validações, onde todos os arquivos analisados ficam salvos para consulta futura e comparação entre versões.

Erros mais comuns e como resolver

Veja abaixo os problemas que aparecem com mais frequência e a ação corretiva para cada um.

"Arquivo XML inválido": geralmente o arquivo não é um XML TISS ou está corrompido. Verifique a extensão e tente abrir em um editor de texto.
"Lote sem hash MD5": o epílogo não contém o hash. Regenere o arquivo no sistema de origem.
"Encoding declarado não bate com o conteúdo": o arquivo diz ser UTF-8 mas os bytes estão em ISO-8859-1. Use o conversor ou peça ao gestor para exportar no encoding correto.
"Versão TISS não detectada": o namespace do arquivo não corresponde a nenhuma versão conhecida. Confira a documentação oficial da ANS.
"Totalizadores divergentes": some os valores das guias manualmente e compare com os totalizadores do lote; corrija na origem.

Perguntas frequentes

O Validador TISS Online é realmente gratuito?

Sim. A validação de estrutura XSD, hash MD5 e somatórios é gratuita e não exige cadastro. Recursos avançados, como histórico de validações e painel de riscos de glosa, fazem parte do app pago.

Quais versões do TISS o validador aceita?

O validador trabalha com as versões 3.02.01, 3.03.03, 3.04.00, 3.05.00, 4.01.00, 4.02.00 e 4.03.00. Saiba mais em versões do padrão TISS.

Posso validar vários arquivos ao mesmo tempo?

A versão online valida um arquivo por vez. Para validação em lote e relatórios consolidados, use o app logado em /app/validador.

O validador substitui a validação da operadora?

Não. Ele valida a estrutura técnica do XML contra o padrão TISS, mas a operadora ainda pode rejeitar por regras de negócio como elegibilidade, autorização e cobertura.

Por que o hash MD5 está errado mesmo sem eu ter editado o arquivo?

Isso costuma acontecer quando o sistema gestor calculou o hash com encoding diferente do declarado no XML. A ANS exige ISO-8859-1 para algumas versões, e a diferença de encoding quebra o hash.

Posso usar o validador em celular ou tablet?

Sim. A ferramenta é responsiva e funciona em qualquer navegador moderno. Arquivos podem ser enviados direto do celular.

Onde encontro o XSD oficial da ANS?

A ANS publica os esquemas, tabelas e notas técnicas no site oficial do padrão TISS.

Conclusão

O Validador TISS Online do TISS Manager é a maneira mais rápida de conferir um arquivo XML antes de enviar para a operadora. Escolha a versão correta, envie o XML, analise os três pilares (XSD, hash e somatórios) e corrija os alertas de preenchimento na fonte. Quanto mais cedo você detectar o erro, menos retrabalho terá no ciclo de faturamento. Valide seu primeiro arquivo agora em /validador-tiss-online e, se precisar de controle completo, conheça o app em TISS Manager.

Como usar o Validador TISS Online do TISS Manager: tutorial passo a passo