Tutoriais

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

Equipe 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. Hash MD5 inválido

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. Versão TISS divergente

A operadora aceita TISS 4.01, mas você envia 3.05.00. Resultado: rejeição imediata.

3. Tags fora da ordem do XSD

O XSD do TISS é estrito: a ordem dos elementos importa. Trocar nomeProfissional com conselhoProfissional quebra a validação.

4. Códigos TUSS incorretos

Procedimento descontinuado, código com 7 dígitos onde se espera 8, ou TUSS de outra tabela. Veja atualizações TUSS 2026.

5. 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. Datas em formato errado

TISS exige formato ISO (AAAA-MM-DD). Sistemas que exportam DD/MM/AAAA quebram a estrutura.

7. Valores monetários com vírgula

XML é dado tipado. Use ponto como separador decimal: 120.00, nunca 120,00.

8. 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. Beneficiário sem elegibilidade

Carteirinha vencida ou contrato suspenso geram rejeição automática. Consulte sempre antes — leia elegibilidade no TISS.

10. 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 uma vez

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