Tutoriais

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

Administrador TISS Manager30 de maio de 20269 min de leitura
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.

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.

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