Guia recusada por erro de estrutura no XML: causas e como resolver
Você preencheu tudo, gerou o XML, enviou pra operadora — e a guia voltou com uma mensagem de erro que parece grego. Antes de entrar em pânico: na maioria das vezes isso é só um erro de estrutura, e erro de estrutura tem conserto rápido. Neste texto a gente explica o que é, por que acontece e como resolver os casos mais comuns.
O que é um "erro de estrutura"
Todo XML TISS precisa seguir exatamente o formato definido pela ANS: certos campos são obrigatórios, cada informação tem um lugar e um jeito de ser escrita. Quando o arquivo não bate com esse formato, o sistema da operadora recusa a guia na hora — antes mesmo de alguém analisar o mérito. Isso é o erro de estrutura.
A boa notícia: como é uma questão de forma, e não de conteúdo, quase sempre dá pra localizar e corrigir rápido.
Se você ainda está se ambientando com o assunto, o guia básico sobre XML TISS explica o que é o padrão e por que a operadora exige.
Os erros de estrutura mais comuns (e como resolver)
- Campo obrigatório em branco. Faltou preencher algo que o padrão exige. Solução: complete o campo — uma boa planilha modelo já sinaliza quais são obrigatórios.
- Número da carteirinha ausente ou incompleto. Sem a identificação do beneficiário, o arquivo não fecha. Confira o
numeroCarteirade cada guia. - Data ou valor num formato inválido. Data fora do padrão, valor com separador errado. Solução: siga o formato do modelo, sem inventar.
- Código do procedimento (TUSS) ausente ou inválido. Todo procedimento precisa do código correto. Confira se nenhum ficou em branco ou digitado errado.
- Somatório que não bate. O total da guia precisa fechar com a soma dos itens. Se você mexeu num valor na mão, revise as somas.
- Versão do TISS errada. Enviar o XML numa versão que a operadora não usa também faz a guia voltar. Gere sempre numa das versões que aquela operadora aceita.
Cuidado pra não confundir dois problemas diferentes. O erro de estrutura (acima) é sobre o arquivo estar no padrão da ANS — isso você resolve. Já a glosa por regra da operadora é outra coisa: cada convênio tem exigências próprias sobre o que aceita em cada situação, e isso foge do arquivo. Uma ferramenta de conversão garante o primeiro — o XML sair no padrão da ANS —, mas as regras específicas de cada operadora você necessariamente precisa confirmar com ela.
Como evitar o erro antes de reenviar
Corrigir depois da recusa é retrabalho. Dá pra pegar o problema antes de enviar, de dois jeitos:
- Parta de uma planilha no formato certo. Metade dos erros de estrutura nasce de uma planilha bagunçada. Se ainda não faz assim, veja como transformar sua planilha Excel em XML TISS do jeito certo.
- Use uma conversão que valida e aponta o erro. Em vez de só recusar, uma boa ferramenta mostra a aba, a linha e o campo exato que precisam de ajuste — você corrige na hora, antes de mandar pra operadora. Se tiver dúvida sobre um campo específico, o guia como preencher a planilha detalha campo a campo.
Reenvie sua guia sem erro de estrutura
Se a sua guia voltou por erro no XML, o caminho mais rápido é gerar de novo a partir da planilha, com validação.
O Conversor TISS da connexio confere cada campo, aponta o que precisa de ajuste e entrega o XML no padrão da ANS — em segundos, sem instalar nada. Dá pra começar com 20 guias grátis por mês.