Validador TISS: o que ele verifica no XML, onde obter, erros mais comuns e como corrigir antes de enviar

O validador TISS é a ferramenta que confere se o arquivo XML de faturamento gerado pela clínica está no formato exigido pela ANS antes de ser enviado à operadora. Ele checa a estrutura do arquivo contra o esquema XSD da versão vigente, os campos obrigatórios, os códigos TUSS e a integridade (hash). Se o XML não passa, a operadora nem recebe o lote.

Neste guia você vai entender exatamente o que o validador XML TISS verifica, onde obter um validador, quais erros aparecem com mais frequência e como corrigi-los, e qual é o fluxo completo desde a geração do XML no sistema até o retorno da operadora.

Por que o padrão TISS exige validação

O padrão TISS (Troca de Informações na Saúde Suplementar) é a linguagem única que a ANS definiu para a comunicação entre prestadores e operadoras: guias de consulta, SP/SADT, internação, honorários, além das mensagens de retorno (demonstrativos de análise e de pagamento). Toda essa troca é feita em XML, com uma estrutura rígida descrita em esquemas XSD publicados pela ANS.

Como a estrutura é rígida, qualquer desvio (uma tag fora de ordem, um campo em branco, uma data no formato errado) faz o arquivo ser considerado inválido. A validação existe para pegar esses problemas do lado da clínica, antes que eles virem rejeição ou glosa do lado da operadora. Para quem ainda está começando, o artigo faturamento TISS passo a passo explica o processo inteiro.

O que o validador TISS verifica

1. Esquema XSD da versão vigente

O XSD é a "gramática" do XML. O validador compara o arquivo com o esquema da versão TISS que a operadora está usando e aponta qualquer elemento fora de ordem, tag desconhecida, tipo de dado incorreto (texto onde era número, data fora do padrão AAAA-MM-DD) ou tamanho de campo excedido. Erro aqui é o mais comum quando a clínica gera XML em uma versão e a operadora já migrou para outra.

2. Campos obrigatórios

Cada guia tem campos que não podem ficar vazios: número da guia no prestador, registro ANS da operadora, número da carteira do beneficiário, código na operadora e nome do contratado, CBO e conselho do profissional executante, data e código do procedimento, quantidade e valor. O validador lista cada campo obrigatório ausente.

3. Códigos de domínio e TUSS

Além da estrutura, o validador confere se os códigos usados existem nas tabelas de domínio do padrão: tabela de procedimentos (TUSS, tabela 22), tipo de atendimento, indicação de acidente, tipo de consulta, grau de participação, unidade de medida, entre outras. Código TUSS inexistente ou tabela errada é rejeição certa.

4. Hash e integridade do arquivo

O XML TISS carrega no epílogo um hash (resumo criptográfico) calculado sobre o conteúdo. Se qualquer caractere foi alterado depois da geração (edição manual, por exemplo), o hash não bate e o arquivo é recusado. Isso impede que lotes sejam editados fora do sistema.

5. Consistência interna

Validadores mais completos checam regras de negócio: soma dos itens igual ao total da guia, data de execução dentro do período do lote, quantidade compatível com o procedimento, profissional executante com conselho e UF preenchidos.

Onde obter o validador XML TISS

• ANS. O portal da ANS publica os esquemas XSD de cada versão do padrão TISS e disponibiliza um componente de validação de arquivos. É a referência oficial e serve para testar qualquer XML.
• Operadoras. A maioria das operadoras mantém no portal do prestador um validador próprio, que além do XSD aplica as regras específicas daquele convênio (versão aceita, campos extras exigidos, tabelas próprias). É o validador que realmente importa, porque é o que ela vai usar na recepção do lote.
• Sistema de gestão. Um sistema com módulo de faturamento TISS gera o XML já validado contra o XSD e aponta os erros antes de fechar o lote, o que elimina a etapa manual na maior parte dos casos.

Erros mais comuns no XML TISS e como corrigir

Fluxo completo: gerar, validar, enviar, receber retorno

1. Registrar o atendimento no sistema com guia preenchida: beneficiário, autorização (quando exigida), procedimentos TUSS, profissional executante, valores da tabela contratada.
2. Fechar o lote por operadora e competência, respeitando o prazo de envio do contrato (varia por convênio; muitos aceitam até 60 ou 90 dias do atendimento).
3. Gerar o XML na versão TISS aceita pela operadora. O sistema calcula o hash.
4. Validar no sistema e, se houver dúvida, no validador da operadora. Corrigir no cadastro, nunca no arquivo, e gerar novamente.
5. Enviar pelo portal do prestador ou webservice. Guardar o protocolo de recebimento.
6. Acompanhar o retorno: o demonstrativo de análise informa o que foi aceito, glosado ou pendente; o demonstrativo de pagamento confirma os valores pagos.
7. Tratar glosas com recurso dentro do prazo do contrato, usando a guia de recurso de glosa do padrão TISS.
8. Guardar os arquivos (XML enviado, protocolo, retornos) para auditoria e para eventual recurso. Os registros de faturamento e os documentos vinculados ao atendimento devem ficar disponíveis pelo prazo exigido na legislação e no contrato.

Validação não é a mesma coisa que ausência de glosa

Um erro comum de interpretação: o XML passou no validador, logo o pagamento está garantido. Não está. O validador confere a forma; a operadora analisa o mérito. Autorização ausente, procedimento fora da cobertura, valor acima da tabela contratada, guia fora do prazo ou profissional não credenciado geram glosa mesmo em arquivo perfeito. Por isso o controle do faturamento precisa de duas camadas: validação técnica (automática) e conferência administrativa antes do fechamento do lote. O artigo como reduzir glosas de convênio cobre a segunda camada.

Checklist rápido antes de enviar o lote

• Versão TISS configurada igual à aceita pela operadora.
• Cadastro do convênio com registro ANS e código do prestador corretos.
• Cadastro de cada profissional com CBO, conselho, número e UF.
• Carteirinha, validade e número de autorização preenchidos em cada guia.
• Tabela TUSS atualizada; itens de tabela própria identificados como tal.
• Datas de execução dentro da competência e do prazo contratual.
• XML gerado e validado pelo sistema, sem edição manual.

Validador TISS no dia a dia da clínica

Quando o faturamento é feito à mão ou em ferramentas separadas, a validação vira uma etapa de retrabalho no fim do mês. Com o faturamento TISS integrado ao atendimento, como no OnDoctor, a guia nasce com os dados do prontuário e do cadastro do convênio, o XML sai na versão correta e os erros são apontados antes de fechar o lote, o que reduz rejeições e encurta o prazo até o pagamento.