Críticas e erros mais comuns no envio do XML TISS (e o que fazer em cada um)

Você mandou o lote, e o sistema da operadora respondeu com uma mensagem curta e pouco amigável: uma crítica. Às vezes ela vem como aviso, às vezes como bloqueio — e nem sempre fica claro se o problema está no seu arquivo ou numa regra daquele convênio.

Este texto reúne as críticas que mais aparecem no dia a dia de quem envia XML TISS, com o que cada uma costuma significar e o caminho de correção. Se você chegou aqui com uma mensagem específica na mão, procure por ela nos títulos abaixo.

"Total críticas de bloqueio" vs. "total críticas de aviso"

Muitos portais devolvem um resumo com esses dois contadores, e a diferença importa:

• Crítica de aviso — o lote foi recebido. A operadora registrou uma ressalva, mas o processamento seguiu. Nem sempre exige ação imediata.
• Crítica de bloqueio — aquela guia (ou o lote inteiro) não entrou. Aqui você precisa corrigir e reenviar.

Comece sempre pelas de bloqueio. Se o contador de bloqueio está zerado, o envio passou, mesmo com avisos na tela.

"O campo Hora inicial / Hora final deve ser informado"

Uma das críticas mais frequentes, e das mais fáceis de resolver. Alguns tipos de guia — especialmente SP/SADT com determinados procedimentos — exigem o horário de início e fim do atendimento, mesmo quando isso parece irrelevante para o serviço prestado.

O que fazer: preencha as colunas de hora na planilha e gere o arquivo de novo. Se o seu atendimento não tem horário formal, use o horário real em que ele ocorreu — o campo não aceita ficar vazio quando é exigido.

"Guia já cobrada no protocolo XXXXX"

Essa crítica costuma significar que a operadora já recebeu uma guia com aquele mesmo número antes. Normalmente acontece em dois cenários:

1. O lote foi enviado duas vezes (reenvio depois de uma correção, sem trocar a numeração).
2. A numeração das guias se repetiu entre meses ou entre lotes diferentes.

O que fazer: confirme com a operadora se a guia original foi processada. Se foi, não reenvie. Se precisa reapresentar a mesma cobrança, pergunte a eles qual o procedimento — em muitos casos é um fluxo de recurso, não um reenvio simples.

Como evitar: mantenha a numeração das guias sempre única e crescente. É o hábito que elimina essa crítica de vez.

"Arquivo inválido" logo no upload, sem detalhar o campo

Quando o portal recusa o arquivo inteiro sem apontar campo, quase sempre é uma das causas abaixo:

• Versão do TISS diferente da que a operadora aceita. É comum um portal aceitar 4.00.01 e recusar 4.01.00, ou o contrário. Confirme com a operadora qual versão ela exige hoje e gere naquela versão. A tabela de campos por versão TISS mostra o que muda entre elas.
• Um valor acima do limite do padrão. Vários campos do TISS têm limite de tamanho ou de faixa. Um número fora da faixa torna o arquivo inválido como um todo.
• Uma tag que não deveria existir naquele contexto. O schema da ANS orienta, em alguns casos, a não gerar a tag quando não há informação — preenchê-la com vazio é o que quebra o arquivo.

O que fazer: se a mensagem não diz o campo, a forma mais rápida de achar o problema é validar o XML contra o schema antes de enviar, ou converter o XML de volta para Excel e conferir o conteúdo numa planilha legível.

Críticas relacionadas à carteirinha do beneficiário

Aparecem de formas variadas — "carteirinha inválida", "beneficiário não localizado", crítica no numeroCarteira. As causas mais comuns:

• Pontos e traços. Algumas operadoras querem o número limpo, só dígitos; outras aceitam a formatação. Se a crítica é de carteirinha e o número está certo, tente sem pontuação.
• Carteirinha de outra operadora (intercâmbio). O beneficiário pode ser de outra praça, e a regra de aceitação muda.
• Vigência. A carteirinha pode estar correta mas fora da validade na data do atendimento.

O que fazer: confirme o número junto ao beneficiário ou no portal de elegibilidade da operadora antes de reenviar.

"Guia principal" e críticas de referência entre guias

Quando um atendimento se desdobra em mais de uma guia, o campo de guia principal amarra uma à outra. Preencher esse campo quando não deveria — ou apontar para uma guia que a operadora não tem — gera crítica.

O que fazer: só informe guia principal quando existir de fato uma guia principal já enviada e aceita. Na dúvida, deixe em branco e confirme a regra com a operadora.

Quantidade, duplicidade e tratamento seriado

Guias com quantidade diária maior que 1, ou sessões repetidas do mesmo procedimento, costumam disparar crítica de duplicidade. Aqui é importante ser honesto sobre a natureza do problema: isso quase sempre é regra da operadora, não erro de arquivo. Algumas aceitam a cobrança consolidada no mês; outras exigem fracionamento; outras recusam as duas formas em situações específicas.

O que fazer: essa é uma conversa com a operadora, não um ajuste no XML. Pergunte qual formato de apresentação ela espera para aquele procedimento e siga o que ela responder.

E quando o arquivo está certo e a operadora recusa mesmo assim?

Acontece. Já houve caso de portal recusar por indentação do XML, por nome do arquivo, por limite próprio diferente do limite do padrão. Nessas situações o arquivo é válido pelo TISS e o impedimento é do sistema da operadora.

O teste que separa os dois casos é simples: se o XML passa numa validação contra o schema da ANS e ainda assim é recusado, o problema não está no arquivo — e a operadora tem a obrigação de te dizer qual regra ela está aplicando.

Gere o XML já validado, antes de descobrir pelo portal

A maior parte das críticas desta lista aparece depois do envio, quando o retrabalho já custou tempo. Validar antes muda isso.

O Conversor TISS da connexio confere os campos ao gerar o arquivo e aponta a aba, a linha e o campo que precisam de ajuste — você corrige antes de mandar pra operadora. Ele entrega o XML no padrão da ANS, nas versões 3.05.00 a 4.03.00, sem instalar nada. Dá pra começar com 20 guias grátis por mês.

→ Gerar meu XML TISS grátis