Os 12 erros mais comuns na versão TISS 4.03.00 (e como corrigir cada um)

Depois que o lote passa a ser gerado na versão TISS 4.03.00, os erros mudam de natureza: deixam de ser "arquivo antigo" e passam a ser detalhes de estrutura, domínio e aritmética. Este artigo é um catálogo de consulta rápida: para cada erro, a mensagem típica devolvida pela operadora, a causa real e a correção. Se quiser conferir o seu arquivo enquanto lê, use o validador TISS online. Para o contexto da versão, veja o que é a versão TISS 4.03.00; para migrar, o tutorial de conversão em 7 passos.
Por que um XML válido no seu sistema é rejeitado na versão TISS 4.03.00?
Porque o sistema que gera o arquivo normalmente confere apenas as próprias regras de negócio, enquanto a operadora confere o arquivo contra o XSD oficial da ANS e, em seguida, contra as regras administrativas dela. São três camadas independentes:
- Estrutural (XSD): tags, ordem, tipos, tamanhos e enums definidos pela ANS.
- Aritmética e integridade: somatórios de guia e lote, hash MD5 do epílogo.
- Administrativa (operadora): autorização, elegibilidade, CBO, vigência de TUSS, regras de contrato.
- Passar na primeira não garante as outras duas — e a maior parte das rejeições vem das duas últimas.
Quais são os erros estruturais mais frequentes na versão TISS 4.03.00?
Esses erros travam o arquivo logo na entrada do webservice ou do portal, antes de qualquer análise de conteúdo.
| Erro | Causa real | Correção |
|---|---|---|
| 1. Versão incompatível | versaoPadrao diferente de 4.03.00 ou tabela de domínio de outra versão | converter o lote e atualizar o gerador |
| 2. Namespace inválido | prefixo ans: ausente/duplicado ou URI errada | corrigir a declaração no elemento raiz |
| 3. Ordem de elementos | XSD usa sequence: ordem é obrigatória | reordenar conforme o XSD 4.03.00 |
| 4. Tipo/tamanho inválido | campo numérico com máscara, texto acima do limite | remover máscaras e truncar no limite oficial |
| 5. Enum não previsto | valor de domínio válido em 4.01/4.02 e removido em 4.03.00 | usar o valor vigente da tabela de domínio |
| 6. Encoding | arquivo salvo em UTF-8 declarando ISO-8859-1 (ou o inverso) | gravar na codificação declarada no cabeçalho |
Regra prática: erro estrutural nunca é "caso isolado". Se apareceu em uma guia, o gerador vai repeti-lo em todas as guias do mesmo tipo — corrija na origem, não no arquivo.
Como corrigir hash MD5 inválido na versão TISS 4.03.00?
O hash do epílogo é calculado sobre o conteúdo do lote, e qualquer alteração posterior o invalida. Três causas concentram quase todos os casos: edição manual depois de gerar o arquivo, codificação diferente da declarada e entidades XML (&, <) consideradas de forma inconsistente.
A regra correta é: concatenar o conteúdo relevante do lote, decodificar as entidades XML, usar a codificação oficial (ISO-8859-1) e só então calcular o MD5. Implementações caseiras costumam calcular sobre a string ainda escapada — o resultado muda e a operadora rejeita.
Detalhamento completo, com exemplo comentado, em hash MD5 no TISS: o que é e como corrigir.
- Nunca edite o XML depois que o hash foi gerado — regere o lote.
- Confirme a codificação real do arquivo, não apenas o que está escrito no cabeçalho.
- Decodifique entidades antes do cálculo.
- Revalide o arquivo final: hash correto e somatórios fechados na mesma passada.
Por que o somatório do lote é acusado como divergente?
Porque o valor total informado não bate, ao centavo, com a soma dos itens. Na versão TISS 4.03.00 a conta é hierárquica: procedimentos + materiais + medicamentos + taxas/aluguéis + OPME + gases medicinais formam o total da guia; a soma das guias forma o total do lote.
A causa mais comum é arredondamento por item. Se cada linha é arredondada para duas casas e depois somada, o total pode divergir do valor calculado com precisão plena. Some com precisão e arredonde só no total.
A segunda causa é guia cancelada ou glosada que permanece no somatório do lote sem constar nas guias enviadas — ou o contrário.
Quais erros de conteúdo passam pelo XSD e mesmo assim geram glosa?
Este é o grupo que mais custa dinheiro: o arquivo entra, é processado e a glosa aparece semanas depois no demonstrativo de pagamento.
- 7. Código TUSS fora de vigência — o código existe na Tabela 22, mas com vigência encerrada na data do atendimento. Correção: usar a versão vigente da tabela e validar a data.
- 8. CBO incompatível com o procedimento — executante com CBO que não cobre o procedimento faturado. Veja como escolher o CBO correto.
- 9. Autorização ausente ou vencida — procedimento que exige senha enviado sem número de autorização ou fora do período autorizado.
- 10. Sexo ou idade incompatíveis — procedimento restrito a um sexo/faixa etária lançado para beneficiário fora da regra.
- 11. Quantidade implausível — consulta com quantidade 10, diária maior que o período de internação, digitação de quantidade no campo errado.
- 12. Duplicidade — mesma guia/procedimento/beneficiário/data reenviada em competências diferentes.
- Todos esses são checáveis antes do envio pelas regras de risco de glosa.
Tutorial: como diagnosticar um lote rejeitado em 15 minutos?
Fluxo objetivo, aplicável a qualquer mensagem de rejeição na versão TISS 4.03.00:
- 1. Suba o arquivo no validador TISS online e leia os erros estruturais primeiro — eles explicam a maioria das rejeições genéricas.
- 2. Confirme
versaoPadraoe o namespace no cabeçalho. - 3. Cheque somatórios de guia e de lote antes de olhar qualquer outra coisa.
- 4. Recalcule o hash MD5 sobre o arquivo final.
- 5. Rode as verificações de risco de glosa e trate os apontamentos de TUSS, CBO, autorização e quantidade.
- 6. Reenvie só depois de zerar erro estrutural — reenvio com erro consome mais prazo do que uma nova rodada de validação.
- 7. Registre a causa em uma planilha por operadora: em dois meses você identifica os três erros que respondem pela maior parte do retrabalho.
Como evitar que os mesmos erros voltem no próximo lote?
Corrigir arquivo é operação; corrigir a origem é processo. Depois de mapear os erros recorrentes, ajuste o cadastro (TUSS, CBO, contratos), o gerador do XML e o checklist da equipe. Ver também o checklist de implantação do padrão TISS.
A referência oficial de tabelas, XSDs e comunicados fica no portal TISS da ANS.
Vídeo: analisando erros de XML TISS na prática
Perguntas frequentes
Qual é o erro mais comum na versão TISS 4.03.00?
Hash MD5 inválido e somatório divergente lideram entre os erros de integridade; entre os estruturais, o uso de valores de domínio de versões anteriores. Os três são detectáveis antes do envio com uma validação contra o XSD oficial 4.03.00.
O XML passou no meu sistema, por que a operadora rejeitou?
Porque a operadora valida contra o XSD oficial da ANS e depois contra as próprias regras administrativas. Seu sistema geralmente confere apenas as regras internas de emissão.
Posso corrigir o XML no bloco de notas e reenviar?
Não é recomendado: qualquer edição manual invalida o hash MD5 e pode quebrar somatórios. Corrija na origem e regere o lote.
Erro de enum inválido significa o quê?
Que o valor informado não consta na tabela de domínio da versão TISS 4.03.00. Costuma acontecer quando o sistema continua usando as tabelas de 4.01.00 ou 4.02.00.
Como saber se o problema é estrutural ou administrativo?
Se o arquivo é recusado na entrada, é estrutural. Se é aceito e a perda aparece no demonstrativo, é administrativo — glosa por TUSS, CBO, autorização, quantidade ou duplicidade.
Validar antes do envio reduz mesmo a glosa?
Reduz a rejeição estrutural quase a zero e antecipa parte das causas administrativas. A glosa que depende de decisão da operadora continua exigindo recurso.
Conclusão
Erro na versão TISS 4.03.00 raramente é imprevisível: é sempre estrutura, aritmética ou regra administrativa. Use este catálogo como consulta rápida, valide cada lote no validador TISS online antes do envio e corrija a origem quando o mesmo erro aparecer duas vezes.
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.