Uma falha estrutural pode impedir a leitura do arquivo antes mesmo da análise das informações assistenciais. Aprenda a registrar o erro, localizar a camada afetada e encaminhar uma correção segura.
Um XML TISS inválido nem sempre contém um dado assistencial incorreto. Em muitos casos, o problema está na forma como o arquivo foi montado: uma tag foi fechada com outro nome, um elemento ficou fora do seu grupo-pai ou campos irmãos foram apresentados em uma ordem que o schema não aceita. Distinguir essas situações evita alterações aleatórias em guias, valores, códigos e dados do beneficiário. (Extensible Markup Language (XML) 1.0 (Fifth Edition)) (W3C XML Schema Definition Language (XSD) 1.1 Part 1: Structures)
No Padrão TISS, o componente de Conteúdo e Estrutura define a arquitetura dos dados das mensagens eletrônicas, enquanto o componente de Comunicação adota XML. Por isso, investigar a estrutura exige confirmar primeiro qual conjunto de documentos e arquivos técnicos se aplica ao cenário analisado; comparar o arquivo com uma referência de outra vigência pode levar a uma correção inadequada.
Neste artigo
Erro de conteúdo ou erro de estrutura XML?
A investigação fica mais rápida quando a equipe separa duas perguntas: “o arquivo pode ser lido como XML?” e “os dados obedecem às regras do layout aplicável?”. A primeira trata da boa formação, como aninhamento e fechamento correto. A segunda trata de validação contra regras adicionais (W3C XML Schema Definition Language (XSD) 1.1 Part 1: Structures), que podem envolver nomes permitidos, obrigatoriedade, quantidade de ocorrências, tipos de dados e sequência dos elementos. (W3C XML Schema Definition Language (XSD) 1.1 Part 1: Structures)
Como classificar o problema antes de corrigir
| Sinal observado | Camada provável | Primeira ação segura |
|---|---|---|
| Tag de abertura sem fechamento correspondente | Boa formação do XML | Localizar a abertura e conferir a tag de fechamento correspondente |
| Fechamento em ordem incompatível com a abertura | Boa formação do XML | Reconstituir a árvore de elementos de dentro para fora |
| Elemento permitido, mas posicionado depois de um irmão indevido | Validação pelo schema | Conferir a sequência prevista no artefato técnico aplicável |
| Campo presente com formato ou valor não aceito | Conteúdo ou regra do schema | Preservar a estrutura e revisar a regra específica do campo |
| Mensagem genérica sem linha aparente | Diagnóstico insuficiente | Registrar o arquivo, a versão, a mensagem completa e o ponto do processo em que ela surgiu |
Tags, elementos e atributos: o vocabulário mínimo
Uma tag é a marca entre sinais de menor e maior usada para delimitar uma parte do XML. Um elemento é a unidade completa formada pela abertura, pelo conteúdo quando houver e pelo fechamento. Em um trecho como <nome>Maria</nome>, “nome” identifica o elemento e “Maria” é seu conteúdo. Já um atributo aparece na tag de abertura e agrega uma característica ao elemento; sua utilização depende do que o layout admitir.
Leitura prática de um trecho XML
- Tag de abertura: inicia o elemento, como <guia>.
- Conteúdo: fica entre a abertura e o fechamento, quando o elemento recebe texto ou outro elemento.
- Tag de fechamento: encerra o elemento com o mesmo nome, como </guia>.
- Elemento pai: contém outros elementos em seu interior.
- Elemento filho: está contido diretamente em um elemento pai.
- Elemento irmão: compartilha o mesmo elemento pai com outro elemento.
- Atributo: informação escrita na tag de abertura, quando prevista pelo modelo.
Hierarquia e fechamento: leia o XML como uma árvore
Pense no XML como uma árvore. O elemento raiz envolve o documento; abaixo dele existem grupos e subgrupos; nas pontas ficam elementos que carregam dados. Para que o documento seja bem-formado, os elementos precisam ser corretamente aninhados: se <guia> abre antes de <identificacao>, então </identificacao> deve aparecer antes de </guia>. Além disso, a tag de fechamento deve usar o mesmo nome da abertura.
Não corrija apenas a linha apontada
Um validador ou parser pode apontar a posição em que deixou de compreender o arquivo. A origem da falha pode estar antes dessa posição, por exemplo em uma tag não fechada, em um caractere indevido ou em um fechamento trocado. Use a linha indicada como ponto de partida e revise também as aberturas anteriores que ainda deveriam estar ativas.
Por que a ordem dos elementos pode invalidar o XML TISS
Um arquivo pode estar bem-formado e ainda assim ser rejeitado na validação estrutural. (W3C XML Schema Definition Language (XSD) 1.1 Part 1: Structures) XML Schema permite descrever a estrutura e restringir o conteúdo de documentos XML. Quando o modelo declara elementos em uma sequência, a ordem declarada faz parte da regra (W3C XML Schema Definition Language (XSD) 1.1 Part 1: Structures): não basta que os campos existam; eles precisam aparecer no local e na posição previstos.
Na prática, não tente deduzir a ordem por nomes que “parecem” relacionados. Abra a documentação e os schemas correspondentes à versão aplicável, encontre o elemento pai e verifique a definição dos filhos. A ANS disponibiliza um arquivo compactado de schemas TISS; esse tipo de artefato técnico é a referência apropriada para conferir a organização prevista, em vez de copiar um trecho de outro arquivo sem checar sua compatibilidade.
Roteiro seguro para investigar um erro de estrutura XML
Antes de editar, salve uma cópia identificada do XML original e trate a mensagem de erro como evidência. O objetivo não é “fazer passar” qualquer arquivo, mas entender qual regra falhou, corrigir somente o necessário e manter rastreabilidade para uma nova conferência.
Sequência de investigação
- Registre a mensagem completa, inclusive linha, coluna, código, nome do elemento e momento em que a falha ocorreu.
- Anote a operadora, o tipo de guia ou lote, a data de geração e a versão do padrão ou layout usada pelo processo.
- Guarde uma cópia imutável do arquivo recebido ou gerado originalmente.
- Verifique primeiro se existe erro de sintaxe: fechamento ausente, nomes diferentes entre abertura e fechamento, aninhamento quebrado, aspas incompletas ou caracteres especiais sem tratamento.
- Identifique o elemento apontado e suba para localizar seu elemento pai e os irmãos próximos.
- Compare os nomes, a obrigatoriedade, a cardinalidade e a ordem com o schema e a documentação aplicáveis.
- Altere uma causa por vez e registre o que foi modificado.
- Valide novamente o arquivo corrigido e revise se a nova mensagem é a mesma, mudou de local ou revelou outra regra.
- Se o erro vier de integração ou de geração sistêmica, encaminhe o registro técnico e o XML original ao responsável, sem editar dados clínicos ou financeiros por tentativa.
Exemplo ilustrativo: identificar um fechamento fora de ordem
Exemplo ilustrativo — este trecho é simplificado e não representa um layout TISS oficial. Ele serve apenas para mostrar como uma falha de aninhamento pode confundir a leitura do arquivo.
Do erro à correção
| Etapa | Conteúdo |
|---|---|
| Entrada | <guia><identificacao><numero>123</numero></guia></identificacao> |
| Mapeamento | <guia> é o pai de <identificacao>; <identificacao> é o pai de <numero>. |
| Erro | A tag </guia> fecha o elemento pai antes de </identificacao>. O aninhamento foi invertido. |
| Correção | <guia><identificacao><numero>123</numero></identificacao></guia> |
| Conferência posterior | Depois de restaurar o aninhamento, comparar a ordem, os nomes e as demais regras com a referência aplicável antes de concluir a validação. |
Quando encaminhar o caso ao suporte técnico
Encaminhe o caso ao suporte técnico ou à equipe responsável pela geração do XML quando a estrutura for produzida automaticamente, quando a correção exigir alteração de integração, quando o mesmo erro reaparecer em vários arquivos ou quando a mensagem mencionar schema, namespace, versão ou elemento não reconhecido. A equipe administrativa pode ajudar muito fornecendo evidências organizadas, mas não deve reconstruir manualmente arquivos em produção sem uma regra confirmada.
Informações para um encaminhamento objetivo
- XML original sem alterações e cópia do arquivo corrigido, se houver
- Mensagem completa retornada pela validação ou pelo processo de recebimento
- Linha, coluna, caminho do elemento ou identificador técnico apresentado
- Versão e documentação técnica adotadas na geração
- Tipo de guia, lote ou transação envolvida
- Data e horário da geração, sem expor informações além do necessário
- Descrição da última alteração feita no cadastro, sistema ou integração
- Quantidade de arquivos afetados e indicação de repetição do erro
Validação após a correção: confirme a causa, não só o resultado
Depois da alteração, valide a cópia corrigida e compare o retorno com o erro original. Se o problema estrutural desaparecer, prossiga para as demais verificações de conteúdo e regras do processo. Se surgir uma nova mensagem, registre-a como uma etapa distinta: é comum que a primeira falha impeça a leitura das verificações seguintes, mas a nova ocorrência ainda precisa ser analisada pela sua própria causa.
Para uma conferência adicional antes de seguir com o processo, use o Validador TISS online para verificar o XML corrigido e manter o retorno de validação junto ao registro do atendimento. Para aprofundar a rotina da equipe, acompanhe também os Conteúdos sobre TISS, faturamento médico e erros e glosas.
Pontos principais
- Estrutura inválida e conteúdo inválido são problemas diferentes e exigem verificações diferentes.
- Tag aberta sem fechamento correspondente, nomes divergentes e aninhamento quebrado impedem a boa formação do XML.
- Um XML bem-formado pode falhar se a ordem dos elementos contrariar a sequência definida no schema aplicável.
- A mensagem de erro, o XML original e a versão adotada devem acompanhar toda investigação.
- Corrija uma causa por vez, valide novamente e encaminhe ao suporte técnico quando a origem estiver na geração sistêmica ou na integração.
Perguntas frequentes sobre XML TISS com estrutura inválida
O que torna a estrutura de um XML inválida?
Um XML fica estruturalmente inválido quando não pode ser interpretado como um documento bem-formado ou quando não atende às regras estruturais aplicáveis. Exemplos incluem fechamento ausente, fechamento com nome diferente, aninhamento incorreto, elemento inesperado, quantidade de ocorrências incompatível ou ordem diferente da prevista.
O que são tags e elementos em XML?
Tags são as marcações usadas para abrir e fechar partes do documento, como <campo> e </campo>. O elemento é a unidade formada pela abertura, conteúdo quando houver e fechamento. Elementos podem conter outros elementos, formando uma hierarquia.
A ordem dos elementos pode importar no XML TISS?
Sim. Um XML pode estar bem-formado e ainda falhar na validação se os elementos irmãos não estiverem na sequência estabelecida pelo modelo técnico aplicável. A ordem deve ser verificada no schema e na documentação correspondentes à versão usada.
Por que uma tag sem fechamento causa falha?
Porque a abertura deixa um elemento pendente. O interpretador perde a referência de onde termina aquele grupo e não consegue montar corretamente a hierarquia do documento. O fechamento deve ter o mesmo nome da abertura e ocorrer na ordem adequada.
Devo corrigir o dado apontado na linha do erro?
Não automaticamente. A posição informada pode ser onde a leitura falhou, não necessariamente onde a causa começou. Revise a linha indicada e as tags abertas anteriormente, procurando fechamento ausente, nome divergente ou aninhamento fora de ordem.
Quando devo envolver suporte técnico?
Envolva suporte quando o XML é gerado automaticamente, quando a correção depende de integração ou configuração, quando o erro se repete em diversos arquivos ou quando a mensagem aponta problema de schema, namespace, versão ou elemento não reconhecido. Envie o XML original, a mensagem completa e o contexto da geração.
Qual documentação devo usar para conferir a estrutura?
Use os documentos e schemas correspondentes à versão aplicável ao seu processo. A ANS organiza o Padrão TISS por componentes e disponibiliza arquivos técnicos de schemas. Não presuma que um XML antigo ou de outro fluxo seja modelo compatível.
Próximo passo
Registre a mensagem de validação e valide o XML corrigido antes de prosseguir. Validador TISS online
Fontes e referências
W3C XML Schema Definition Language (XSD) 1.1 Part 1: Structures