Tutoriais

Como juntar vários XMLs TISS em um único lote: tutorial do Unificador

Administrador TISS Manager23 de setembro de 20269 min de leitura
Como juntar vários XMLs TISS em um único lote: tutorial do Unificador

Se a sua clínica atende por mais de um sistema, filial ou profissional que exporta o próprio XML, você já viveu esse problema: a operadora pede um único arquivo por lote, e você tem cinco. Juntar na mão significa abrir XML no bloco de notas, copiar guias de um arquivo para outro e rezar para os somatórios e o hash MD5 continuarem batendo — quase sempre não batem. O Unificador do TISS Manager resolve isso: você sobe todos os XMLs de uma vez e recebe um único lote válido, no padrão oficial da ANS. Neste tutorial mostramos o fluxo completo, do upload à validação final. Se você ainda não conhece a ferramenta, vale ler antes como o unificador TISS acelera o faturamento.

O que o Unificador faz — e por que não dá para juntar na mão

Um lote TISS não é uma simples lista de guias: ele tem cabeçalho, somatório total dos valores, número de lote e um epílogo com hash MD5 calculado sobre o conteúdo, em ISO-8859-1, excluindo a própria tag de epílogo. Quando você copia guias manualmente de um arquivo para outro, o somatório total deixa de refletir as guias e o hash fica inválido — a operadora rejeita o lote inteiro.
O Unificador do TISS Manager faz essa junção da forma certa: lê cada arquivo, detecta a versão TISS automaticamente (aceita da 2.02.03 até a 4.03.00), extrai as guias, preserva os campos imutáveis do padrão, deduplica itens repetidos, recalcula o somatório de cada guia e do lote e gera o hash MD5 oficial da ANS no encoding correto. O resultado é um arquivo novo, pronto para enviar.

Passo 1: acesse o Unificador dentro do app

Faça login em TISS Manager e, na home de módulos, abra o Unificador em /app/unificador. Ele também aparece no menu lateral, com o ícone de junção.
O módulo funciona com qualquer volume: dois arquivos pequenos de consultório ou dezenas de lotes de uma rede com várias unidades. Cada arquivo pode vir de um sistema diferente — o que importa é que todos sigam o padrão TISS da ANS.

Passo 2: envie os XMLs que quer unificar

Arraste todos os arquivos de uma vez para a área de upload ou clique para selecionar vários. O sistema detecta sozinho a versão TISS de cada arquivo pelo namespace — você não precisa indicar nada.
Antes de confirmar, revise a lista de arquivos carregados: o Unificador mostra a versão detectada, o número do lote de origem e a quantidade de guias de cada um. Se algum arquivo estiver corrompido ou fora do padrão, ele é apontado na hora, e você pode removê-lo da lista sem perder os demais.

Passo 3: escolha os dados do lote final

O lote unificado precisa de identificação própria: informe o número do lote que você usará no envio (cada operadora tem sua regra de numeração) e confirme o registro ANS da operadora de destino. Lembre-se da regra de ouro do lote TISS: um lote, uma operadora — se os arquivos forem de operadoras diferentes, unifique separadamente por operadora.
Se os arquivos de origem estiverem em versões diferentes do padrão, o Unificador pergunta para qual versão você quer padronizar a saída. Em 2026, a resposta quase sempre é a TISS 4.03.00, obrigatória desde julho — quando precisar, a conversão é feita na mesma operação, sem ferramenta extra.

Passo 4: revise o resultado da unificação

Ao concluir, o resumo mostra o que aconteceu com cada guia: quantas foram incorporadas, quantos itens duplicados foram removidos e como ficou o valor total do lote. A deduplicação protege você do erro mais caro desse processo: enviar o mesmo procedimento duas vezes e ter o excedente glosado por quantidade.
Campos imutáveis do padrão — como o número do lote de origem e o sequencial de cada item — são preservados, para que a operadora consiga rastrear cada guia até o arquivo original. O somatório de cada guia e o total geral são recalculados a partir dos itens finais, e não copiados dos arquivos antigos.

Passo 5: baixe o XML unificado e valide antes de enviar

Baixe o arquivo unificado e faça a última conferência: jogue o XML no Validador dentro do app (ou no Validador TISS Online gratuito, sem login). Ele confere a estrutura contra o XSD oficial da ANS, o hash MD5 e os somatórios — os três pontos que mais rejeitam lote unificado.
Se o validador apontar qualquer problema, volte ao Unificador e gere novamente. Nunca ajuste o XML à mão: qualquer edição manual invalida o hash e joga fora todo o trabalho da unificação.

Passo 6: envie o lote único à operadora

Com o XML validado, envie pelo canal da operadora — portal, webservice ou troca de arquivo, conforme o contrato. A vantagem prática aparece no fim do mês: em vez de acompanhar cinco lotes com cinco protocolos e cinco demonstrativos de pagamento, você acompanha um.
No módulo de Faturamento, registre o protocolo de envio e acompanhe o status do lote até o pagamento. Se vier glosa, o fluxo de recurso de glosa fica muito mais simples com um único lote para auditar.

Cuidados que evitam rejeição do lote unificado

A unificação só funciona quando os arquivos de origem são válidos individualmente. Antes de juntar, garanta que cada XML passou na validação estrutural — erros de cadastro no sistema de origem (CNPJ, CNES, registro ANS) continuam existindo depois de unificados.
  • Uma operadora por lote: nunca mescle guias de operadoras diferentes, mesmo que a ferramenta aceite ler os arquivos.
  • Conferir o CNPJ/CNES do prestador: os arquivos de origem precisam apontar para o mesmo prestador; dados divergentes no cabeçalho geram rejeição.
  • Padronizar a versão: prefira gerar a saída na versão vigente, a TISS 4.03.00, para não depender de janelas de transição da operadora.
  • Guardar os XMLs originais: em caso de questionamento da operadora, você precisa demonstrar de qual arquivo cada guia veio.

Perguntas frequentes

O Unificador funciona com versões antigas do padrão TISS?

Sim. Ele lê arquivos da versão 2.02.03 até a 4.03.00, detectando a versão automaticamente pelo namespace do XML, e pode padronizar a saída em uma única versão — inclusive convertendo arquivos antigos para a TISS 4.03.00.

Posso unificar XMLs de operadoras diferentes em um só lote?

Não. A regra do padrão TISS é um lote por operadora. Unifique separadamente por operadora e gere um arquivo para cada uma, mesmo que a leitura dos arquivos seja feita na mesma sessão.

O que acontece se dois arquivos tiverem a mesma guia?

O Unificador deduplica itens repetidos e mostra no resumo o que foi removido. Isso evita o cenário clássico de glosa por quantidade, em que o procedimento duplicado é cortado na segunda ocorrência.

O hash MD5 do lote unificado é recalculado?

Sim. O epílogo é gerado do zero com o hash MD5 oficial da ANS, calculado em ISO-8859-1 e excluindo a própria tag de epílogo, sobre o conteúdo final do arquivo. Por isso o lote unificado passa na validação da operadora.

Preciso instalar algum programa para unificar os XMLs?

Não. O Unificador roda no navegador, dentro do TISS Manager, em /app/unificador. Você só precisa dos arquivos XML e de uma conta ativa.

O Unificador altera os dados das guias?

Ele não altera o conteúdo clínico-financeiro das guias: preserva os campos imutáveis do padrão, como número do lote de origem e sequencial dos itens, e apenas recalcula o que depende do conjunto final — somatórios, valor total e hash.

Conclusão

Unificar XMLs TISS na mão é risco desnecessário: somatório errado e hash inválido rejeitam o lote inteiro e atrasam o recebimento em semanas. Com o Unificador do TISS Manager, você sobe todos os arquivos de uma vez, recebe um único lote na versão vigente, com deduplicação, somatórios recalculados e hash MD5 oficial — e valida tudo no mesmo app antes de enviar. Crie sua conta em TISS Manager e teste agora em /app/unificador.

Continue lendo