A origem dos dados no XML TISS fica mais clara quando a equipe deixa de procurar apenas a tag e passa a registrar de qual fonte vem cada informação, quem pode confirmá-la e qual evidência sustenta a conferência. Este mapa interno transforma uma divergência em uma investigação rastreável, sem correções por suposição.
Quando um campo do XML TISS apresenta divergência, a pergunta mais útil não é apenas “qual tag preciso alterar?”. A pergunta que evita retrabalho é: “qual sistema, guia, cadastro ou registro forneceu esse dado, quem responde por ele e como posso conferi-lo?”. Um mapa de origem organiza essas respostas antes que uma alteração isolada seja feita no arquivo. Ele ajuda a equipe a separar o local em que a informação aparece no XML do lugar onde ela foi criada, mantida ou confirmada.
Neste artigo
O que o mapa de origem precisa distinguir
O mapa não é uma cópia do XML nem uma lista genérica de campos obrigatórios XML TISS. É um controle de relações. Para cada campo ou grupo relevante, ele mostra o caminho entre o valor exibido no arquivo e a referência que permite confirmá-lo. Essa referência pode ser um cadastro, um lançamento da guia, um registro do atendimento, uma autorização, uma tabela interna ou outra fonte definida pela instituição.
Quatro conceitos que não são sinônimos
- Campo XML: elemento ou grupo do arquivo em que um valor é representado.
- Guia: registro de cobrança ou atendimento no qual a equipe reúne informações para o fluxo de faturamento.
- Fonte do dado: local que fornece, mantém ou calcula a informação usada na guia e no XML.
- Evidência: referência que permite a outra pessoa localizar o motivo da confirmação, sem depender da memória de quem fez a análise.
Por que uma tag não prova a causa da divergência
Uma mensagem de validação ou uma conferência interna pode apontar uma tag, um grupo ou uma relação entre valores. Use esse apontamento como ponto de partida, não como conclusão automática. O mesmo valor pode ter sido digitado diretamente na guia, recuperado de cadastro, calculado por uma regra, importado de outro sistema ou associado por um mapeamento. Alterar somente o resultado no XML pode deixar a fonte original divergente e permitir que o problema reapareça na próxima geração.
Monte uma matriz campo–fonte–responsável–evidência
Comece com os campos que geram dúvidas recorrentes, recebem alteração manual ou dependem de mais de uma área. Não é necessário mapear todo o arquivo em um único dia. Uma matriz pequena, usada de verdade e revisada quando o processo muda, é mais útil do que uma planilha extensa sem responsáveis definidos. Agrupe campos que possuem a mesma fonte e a mesma lógica, mas abra linhas separadas quando o responsável ou a evidência mudar.
Modelo mínimo de matriz de origem
| Campo ou grupo no XML | O que representa no processo | Fonte primária | Responsável por confirmar | Evidência de conferência | Ação se houver divergência |
|---|---|---|---|---|---|
| Identificação do beneficiário | Dado de identificação usado na guia | Cadastro consultado pela instituição | Cadastro ou recepção | Referência do cadastro e data da consulta | Suspender a alteração até confirmar a fonte autorizada |
| Dados do profissional | Identificação vinculada à execução ou ao lançamento | Cadastro profissional ou registro definido no processo | Área que mantém o cadastro profissional | Identificador interno e referência consultada | Corrigir na fonte ou encaminhar para ajuste de mapeamento |
| Data do atendimento | Data ligada ao evento representado na guia | Registro do atendimento ou agenda confirmada | Área assistencial ou recepção, conforme rotina | Localizador do atendimento | Conferir vínculo com a guia antes de gerar novo XML |
| Item, quantidade ou valor | Informação lançada para cobrança | Registro do atendimento e referência interna de cobrança | Faturamento com apoio da área responsável | Linha do lançamento e documento ou registro associado | Revisar origem do item, cálculo e totalizadores |
| Campo calculado ou transformado | Valor produzido por regra ou integração | Regra de sistema, parametrização ou mapeamento | Tecnologia ou área proprietária da regra | Identificador da regra, configuração ou chamado interno | Testar a correção em cópia controlada e registrar o resultado |
Depois de registrar a matriz, incorpore-a ao roteiro de revisão do lote ou da guia. Ela complementa um checklist para validar XML TISS porque acrescenta uma resposta operacional para a pergunta que costuma travar a correção: onde o valor deve ser confirmado antes de uma nova geração do arquivo?
Separe cadastro, atendimento, guia e documento de apoio
A qualidade do mapa depende de não chamar tudo de “documentação”. Cadastros normalmente sustentam dados de identificação e referências permanentes. O atendimento explica o evento e suas circunstâncias. A guia consolida informações para o faturamento. O documento ou registro de apoio permite localizar a base da confirmação. A mesma informação pode aparecer em mais de uma dessas camadas, mas o mapa deve declarar qual delas prevalece em caso de conflito e quem tem autorização para atualizá-la.
Perguntas de controle para cada fonte
- Cadastro: qual registro é considerado fonte autorizada para este dado e quem pode atualizá-lo?
- Atendimento: qual identificador interno liga a informação ao episódio correto?
- Guia: o valor foi digitado, importado ou calculado a partir de outra fonte?
- Documento de apoio: qual localizador permite encontrar a evidência sem copiar conteúdo sensível para a planilha?
- Regra de mapeamento: quem mantém a transformação entre a fonte e o campo XML?
- Conferência: quem revisou, em que data e qual foi o resultado da comparação?
Use uma sequência de investigação antes de corrigir
A sequência deve preservar o estado original e tornar visível a decisão tomada. Primeiro, registre o arquivo, a guia ou o lote analisado e a mensagem ou divergência observada. Depois, localize o campo ou grupo correspondente no XML e consulte a linha da matriz. Em seguida, compare o valor com a fonte definida, solicite confirmação ao responsável quando necessário e registre a evidência usada. Somente após essa confirmação, corrija a fonte adequada, gere uma nova revisão e compare o resultado com o arquivo anterior.
Evite três atalhos
Não use um valor lembrado como evidência. Não substitua a mensagem original por uma interpretação interna. Não marque a ocorrência como resolvida apenas porque o novo XML parece diferente: registre o que mudou, por qual motivo e quem revisou.
Exemplo ilustrativo de mapeamento e correção
Exemplo ilustrativo
Considere uma equipe que encontra um dado de profissional diferente entre a guia e o XML. O exemplo não descreve um caso real nem estabelece uma regra universal; ele mostra como usar o mapa para evitar que a tag seja editada sem verificar a origem.
- Entrada: a conferência identifica que o identificador do profissional apresentado no XML não corresponde ao valor esperado pela equipe na guia analisada.
- Mapeamento: a matriz informa que o campo XML é alimentado pelo cadastro profissional, que a área de cadastro confirma o registro e que a evidência é o identificador interno do cadastro associado ao atendimento.
- Erro de abordagem: o faturista troca o valor diretamente no arquivo apenas para eliminar a divergência visual, sem confirmar se a guia, o cadastro e a regra de geração usam a mesma referência.
- Correção: a equipe preserva o XML original, consulta o cadastro e o vínculo usado no atendimento, pede confirmação ao responsável, corrige a fonte aplicável ou abre chamado para o mapeamento e gera uma nova versão para conferência.
- Registro: a ocorrência recebe identificador, valor encontrado, valor confirmado, referência consultada, responsável pela decisão, data, revisão do XML e resultado da nova validação interna.
Transforme o mapa em uma rotina de conferência
O mapa funciona melhor como parte da rotina, e não como documento consultado apenas em crises. Defina um local controlado para a matriz, uma convenção para identificar revisões de XML e uma fila de pendências que indique responsável, prazo e status. Revise as linhas quando houver novo tipo de guia, mudança no cadastro, alteração de integração, novo campo ou retorno recorrente. Também limite o que é copiado para o controle: use identificadores e localizadores internos em vez de reproduzir dados assistenciais ou pessoais sem necessidade.
Pontos essenciais
- A tag mostra onde o dado aparece no arquivo; ela não confirma sozinha onde a divergência começou.
- Cada linha do mapa deve ligar campo ou grupo, fonte primária, responsável, evidência e ação de correção.
- Cadastro, atendimento, guia e documento de apoio precisam ser registrados como camadas diferentes.
- A fonte deve ser confirmada antes de corrigir, gerar outra versão do XML e fazer nova validação interna.
- O arquivo original, a revisão de trabalho e o arquivo corrigido devem continuar identificáveis no histórico do caso.
Checklist final antes de gerar uma nova versão
- Preserve o XML original, a mensagem ou a divergência que iniciou a investigação e o identificador da ocorrência.
- Localize o campo ou grupo no XML e consulte a linha correspondente na matriz de origem.
- Diferencie o valor exibido no XML da fonte que o forneceu e da evidência usada para confirmá-lo.
- Confirme quem pode validar ou alterar o dado sem criar conflito entre cadastro, guia e atendimento.
- Registre a decisão, o responsável, a data, a referência consultada e a alteração aplicada.
- Gere uma nova revisão identificável e compare o escopo alterado com o arquivo anterior.
- Faça uma nova conferência e trate o resultado como evidência interna do cenário analisado.
- Atualize a matriz quando a ocorrência revelar uma fonte, regra ou responsável que ainda não estava documentado.
Perguntas frequentes sobre a origem dos dados no XML TISS
- Uma tag indica automaticamente a causa do erro? Não. A tag indica onde o valor aparece ou onde uma inconsistência foi percebida. A causa precisa ser investigada na fonte do dado, na guia, no mapeamento e nas evidências disponíveis.
- Quem deve confirmar o dado de origem? A matriz deve indicar a área ou função que mantém ou autoriza aquele dado. O faturamento pode abrir a investigação, mas não deve confirmar por suposição informações sob responsabilidade de outra área.
- Que evidência registrar no mapa? Registre um localizador suficiente para outra pessoa encontrar a fonte consultada, como identificador interno, número de guia, referência de cadastro, data de consulta, documento aplicável ou chamado de mapeamento.
- É preciso criar uma linha para cada tag do XML? Não necessariamente. Comece por campos críticos, recorrentes ou que mudam de fonte. Agrupe elementos apenas quando compartilham fonte, responsável, evidência e lógica de correção.
- Posso corrigir o XML diretamente? Trate a edição direta como exceção controlada pela rotina interna. Antes de qualquer alteração, confirme se o valor correto também precisa ser ajustado na fonte que alimentará as próximas gerações.
- A nova validação comprova aceite pela operadora? Não. A nova validação é uma conferência interna do arquivo e do cenário analisado. Regras operacionais e etapas posteriores precisam ser tratadas no fluxo aplicável ao relacionamento da instituição.
Aplique o mapa antes da próxima validação
Use o mapa de origem antes de gerar uma nova versão do arquivo e validar o XML. O TISSXML oferece recursos para digitação e emissão de Guias TISS, geração de XML TISS e faturamento de guias médicas e odontológicas; para conhecer a solução, acesse TISSXML.