Os 10 erros mais comuns no XML TISS (e como corrigir cada um)

Quem trabalha com faturamento TISS sabe: o XML quase sempre dá problema antes mesmo de chegar à operadora. A boa notícia é que 90% dos erros se concentram em 10 padrões repetitivos. Neste guia listamos cada um, com exemplo, causa raiz e a correção definitiva.
1. Como resolver hash MD5 inválido no XML TISS?
O hash MD5 protege a integridade do arquivo. Se ele for calculado sobre o XML formatado (com quebras de linha e indentação) em vez do canônico, a operadora rejeita.
- Causa: cálculo após pretty-print.
- Correção: gere o hash sobre o XML serializado sem espaços extras. Veja como calcular o hash MD5.
2. Como resolver versão TISS divergente entre XML e operadora?
A operadora aceita TISS 4.01, mas você envia 3.05.00. Resultado: rejeição imediata.
- Correção: confirme a versão vigente no contrato e migre com nosso guia de migração.
3. Como corrigir tags fora da ordem definida pelo XSD?
O XSD do TISS é estrito: a ordem dos elementos importa. Trocar nomeProfissional com conselhoProfissional quebra a validação.
- Correção: rode o XML no validador TISS online que mostra o caminho exato da tag fora de lugar.
4. Como identificar códigos TUSS incorretos no XML?
Procedimento descontinuado, código com 7 dígitos onde se espera 8, ou TUSS de outra tabela. Veja atualizações TUSS 2026.
5. Como resolver CNES inválido ou desatualizado?
O CNES do estabelecimento muda quando há alteração societária. Verifique no portal CNES e atualize seu cadastro.
6. Como corrigir datas em formato errado no XML TISS?
TISS exige formato ISO (AAAA-MM-DD). Sistemas que exportam DD/MM/AAAA quebram a estrutura.
7. Como corrigir valores monetários com vírgula em vez de ponto?
XML é dado tipado. Use ponto como separador decimal: 120.00, nunca 120,00.
8. Como resolver CBO incompatível com o procedimento?
Um CBO de pediatria assinando guia de cardiologia é regra de bloqueio em muitas operadoras. Veja como escolher o CBO correto.
9. O que fazer quando o beneficiário aparece sem elegibilidade?
Carteirinha vencida ou contrato suspenso geram rejeição automática. Consulte sempre antes — leia elegibilidade no TISS.
10. Como corrigir assinatura digital ausente ou inválida?
Quando a operadora exige assinatura, o XML sem o bloco ds:Signature é rejeitado. Configure seu certificado conforme o guia ICP-Brasil.
Como prevenir os 10 erros de XML TISS de uma vez só?
Antes de enviar qualquer lote, rode o XML em validação local — o validador TISS online identifica todos os 10 erros acima em segundos. Para tutoriais visuais, busque no YouTube: como validar XML TISS.
Perguntas frequentes
Posso corrigir o XML manualmente?
Pode, mas só recomendado para ajustes pontuais. Para correções estruturais, regenere o arquivo no sistema de origem para evitar reintroduzir o erro.
Operadora aceita reenvio do mesmo número de lote?
Geralmente não. Após rejeição, gere um novo número de lote para o reenvio.
Como descobrir qual tag está com erro?
Use validador com saída XPath — ele mostra o caminho completo até o nó problemático, facilitando a correção.
Conclusão
Os erros do TISS são previsíveis — e por isso, evitáveis. Crie o hábito de validar todo XML antes do envio com o validador TISS e use o conversor TISS quando precisar migrar entre versões. Esse simples processo reduz rejeição em até 80%.
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.