Como usar o Validador TISS Online do TISS Manager: tutorial 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.
Continue lendo
- Tutoriais
Tutorial do Faturamento TISS no TISS Manager: atendimento, lote validado, glosa e relatórios
Aprenda o fluxo de 4 etapas do Faturamento TISS — Atendimentos, Lotes, Glosas e Relatórios — com XML validado contra o schema oficial da ANS antes do envio.
- Tutoriais
Como converter XML TISS para a 4.03.00 e validar no Validador TISS: tutorial completo
Passo a passo para converter arquivos TISS antigos para a versão 4.03.00 e confirmar no Validador TISS que o XML está pronto para a operadora.
- Tutoriais
Validador TISS em lote: como validar vários XMLs de uma vez e acompanhar no Histórico
Passo a passo para validar vários arquivos XML TISS de uma vez, corrigir os problemas e guardar cada validação no Histórico do TISS Manager.