Faturamento pronto não é faturamento enviado. Entre um e outro existem 14 portais de operadora, um XML que não valida, um login que expirou e uma janela que fecha na sexta-feira. O agente cuida desse trecho: audita a conta antes de mandar, transmite lote a lote, traz o protocolo de volta e mostra em que pé está cada envio.
TISS é o padrão da ANS, e o agente trabalha dentro dele. Ele audita cada guia contra o que o prontuário registra e devolve o item que a documentação não sustenta; reescrever a guia e decidir o que entra no lote quando falta documento continua sendo do hospital.
O time de faturamento fecha a competência. A partir dali começa outro trabalho, que ninguém chama de trabalho: abrir o portal de cada operadora, lembrar a senha, subir o arquivo, esperar o processamento, anotar o número do protocolo num caderno ou numa planilha compartilhada e repetir isso catorze vezes. Se um XML volta recusado por um campo obrigatório, ninguém sabe dizer qual guia causou a recusa sem abrir o arquivo à mão.
O problema não é faturar. É atravessar a distância entre o faturamento pronto e a operadora.
Todas as páginas desta seção descrevem o mesmo hospital de referência: uma rede de médio-grande porte, com 28 especialidades ambulatoriais, cerca de 60 mil pacientes por ano no ambulatório, aproximadamente 2.500 horários de consulta ofertados por semana, WhatsApp oficial com cerca de 23 mil conversas por mês e 14 operadoras contratadas.
É o porte em que a transmissão deixa de ser tarefa de uma pessoa e vira gargalo de calendário: sempre a mesma semana, sempre a mesma fila.
Recusa por inconsistência técnica é o retrabalho mais caro do ciclo, porque acontece depois que todo mundo achou que tinha terminado; glosa por documentação é pior, porque o atendimento já foi prestado. O agente inverte a ordem: antes de transmitir, ele audita o lote contra o padrão TISS, contra as regras da operadora específica e contra o que o prontuário registra, e só manda o que a documentação sustenta.
Estrutura do arquivo, versão declarada, campos obrigatórios, tipo e tamanho de cada campo, hash da guia, sequência do lote. É a checagem que o portal da operadora faria — só que aqui ela acontece antes, com o arquivo ainda na sua mão.
Duas operadoras leem o mesmo padrão de jeitos diferentes: uma exige anexo para determinado procedimento, outra não aceita guia sem autorização prévia, outra usa uma tabela contratada própria. Essas regras ficam cadastradas por operadora e entram na conferência.
O arquivo pode estar tecnicamente perfeito e ainda assim cobrar item fora do contrato ou item que a documentação não sustenta: procedimento sem evolução correspondente, material sem justificativa, diária sem registro que a acompanhe. Essa auditoria tem página própria, em conformidade e tabelas de referência, e o resultado dela chega aqui antes do lote ser montado — é o que faz a glosa não acontecer.
Quando alguma coisa não se sustenta, o lote inteiro não é bloqueado sem explicação. O agente devolve o achado pronto, guia por guia: o item, a evidência que falta, a causa provável e o prazo que corre, escritos em português — e diz o que ele mesmo não pode resolver.
O agente também simula: ele roda a validação sobre o lote em construção quantas vezes for preciso, sem transmitir nada, para a equipe ver o que ainda falta antes do dia do envio.
Recusa por inconsistência técnica é a que dá para evitar sem negociar com ninguém: é forma, não mérito. Conferir antes de enviar é o que muda a proporção.
Recusa de mérito — a operadora discordar do que foi cobrado — é outra conversa, e ela vive na página de glosas.
O que voltou para a equipe — competência 09, operadora Aurora
| Guia | Item | Motivo | Resolve | Estado |
|---|---|---|---|---|
| G-48210 | Procedimento ambulatorial | Código fora da tabela contratada desta operadora | Faturamento | Bloqueia o envio |
| G-48257 | Autorização prévia | Número de autorização ausente e exigido pelo contrato | Autorizações | Bloqueia o envio |
| G-48301 | Anexo de justificativa | Procedimento exige anexo nesta operadora; o arquivo não veio | Assistência | Sai do lote se não resolver |
| G-48344 | Data de execução | Data fora do período informado no cabeçalho do lote | Faturamento | Correção simples |
| 612 guias conferidas = 608 aprovadas + 4 devolvidas. Das 4 devolvidas, 2 bloqueiam o envio e 2 saem do lote se não forem resolvidas até o fechamento. | ||||
Cada operadora tem o seu caminho de recebimento: serviço web publicado, área de troca de arquivos, portal com upload manual. O que muda de uma para outra é o transporte e a credencial, não o trabalho da sua equipe. Do lado de dentro, o lote é montado, validado e despachado sempre pelo mesmo fluxo.
O agente lê as guias fechadas no sistema de faturamento por api_get_guias_competencia e separa por operadora, respeitando o limite de guias por lote que cada uma aceita.
Roda as três camadas de conferência. O que passa segue; o que não passa volta para a equipe com item e motivo, e o lote espera ou segue sem aquela guia — a decisão é humana.
A credencial vem da central de acesso, nunca de um arquivo na máquina de alguém. O envio é registrado com data, hora, tamanho do arquivo e quantidade de guias.
Transmitir não é receber. O agente volta ao mesmo canal para buscar o protocolo e o resultado do processamento, e só considera o lote entregue quando o número volta.
Senha de portal de operadora costuma circular por mensagem, planilha e post-it. Na plataforma, o acesso de cada operadora fica na central de acesso: guardado com segurança, usado pelo agente no momento do envio e nunca exibido de volta na tela.
Acrescentar a décima quinta operadora não é um projeto: é um cadastro. O endereço de transmissão entra como ferramenta, as regras específicas entram na validação e o painel passa a mostrar mais uma coluna de lotes.
As mesmas APIs REST que a sua equipe de TI já mantém viram ferramentas do agente, sem conector proprietário. Ver como funcionam as integrações.
A operadora continua sendo catorze. O trabalho da sua equipe passa a ser um.
O protocolo é a prova de que o lote chegou. Quando ele mora numa planilha paralela, a prova depende de alguém ter copiado certo — e a primeira vez que se descobre que ninguém copiou é quando a operadora diz que nunca recebeu.
Depois de transmitir, o agente volta ao canal da operadora, busca o protocolo do envio e grava o número no lote dentro do sistema de faturamento. Nada de copiar e colar, nada de planilha intermediária, nada de "o protocolo está no e-mail da Cláudia".
api_post_protocolo_lote no mesmo lote que o gerou.É a mesma disciplina que a plataforma aplica em qualquer documento publicado: o número que aparece na tela veio de uma chamada de API feita naquela execução, não da memória do modelo. Como o agente monta um documento com dado por referência.
Conferir protocolo à mão deixa de ser a rotina e passa a ser a exceção: só o que a operadora não devolveu automaticamente continua exigindo olho humano.
A conferência de protocolo sai de nove postos dedicados para três. Os seis postos que deixam de ser necessários eram digitação e conferência linha a linha; o que continua pedindo gente é o caso de julgamento — recurso, autorização, negociação.
Dobrar o número de contas deixa de significar dobrar o time que confere.
Falha de transmissão não é evento raro: serviço fora do ar, certificado vencido, fila de processamento travada na outra ponta. O desenho assume isso.
O agente repete a tentativa nas janelas seguintes em vez de martelar o serviço da operadora. Cada tentativa fica registrada com horário e resposta recebida.
Se o lote não fecha depois das tentativas previstas, o caso sobe para a fila humana com o que já foi tentado — e não fica esperando alguém abrir um painel por acaso.
Reenvio só acontece quando o agente confirma que o envio anterior não foi aceito. Lote duplicado na operadora é dor de cabeça maior do que lote atrasado.
A pergunta que ninguém consegue responder na quinta-feira é simples: onde está cada lote agora? O painel responde sem abrir portal de operadora, porque o estado é atualizado pelo próprio agente a cada consulta que ele faz.
Lotes por estado — competência 09
Conferência de protocolo — últimas 24 horas
| Operadora | Lote | Guias | Protocolo | Estado |
|---|---|---|---|---|
| Aurora Norte | 09-0384 | 254 | 2026-09-0000615 | Aceito |
| Serra Azul | 09-0386 | 139 | 2026-09-0000623 | Aceito |
| Sertão Claro | 09-0391 | 203 | 2026-09-0000688 | Recusa parcial |
| Vitória | 09-0397 | 376 | 2026-09-0000731 | Em análise |
| Rota 12 | 09-0398 | 118 | 2026-09-0000742 | Em análise |
| Meridiano | 09-0402 | 441 | — | Aguardando protocolo |
| Autogestão Ipê | 09-0404 | 87 | — | Aguardando protocolo |
| Aurora | 09-0409 | 612 | — | Retido na validação |
| Guias nos lotes listados — 254 + 139 + 203 + 376 + 118 + 441 + 87 + 612 | 2.230 | 2 protocolos ainda não devolvidos · 1 lote retido antes do envio | ||
A competência inteira numa tela: os lotes prontos para sair, os que já foram transmitidos e esperam protocolo, os que estão em análise na operadora e os que fecharam com protocolo gravado. Abaixo, a conferência das últimas 24 horas e a janela de envio comparada com o cenário anterior.
Ninguém precisou abrir catorze portais para montar esta lista. O que exige gente é exatamente o que está marcado em âmbar e vermelho: um lote retido na validação e uma recusa parcial que vai virar recurso. Os oito lotes aceitos não pedem nada de ninguém.
Repare no que a tela não mostra: nenhum dado clínico de paciente. As colunas são operadora, lote, quantidade de guias, protocolo e estado. O painel acompanha o transporte do faturamento, não o conteúdo assistencial — e cada mudança de estado tem registro de quem ou o que a provocou.
O mesmo dado alimenta o painel diário que o Squad publica e envia. Ver painéis e indicadores
Vale dizer com todas as letras: transmitir mais cedo não aumenta o valor faturado. O efeito é no calendário, não no bruto. O que muda é quando o dinheiro entra, quanto retrabalho some do caminho e quão previsível fica a conta do mês.
A recuperação de valor propriamente dita — glosa classificada, recurso com evidência, prazo contratual que não vence — é o assunto da página vizinha.
Não prometemos aumento de receita. Transmitir no prazo não faz a operadora pagar mais, não antecipa recebível, não substitui negociação de contrato e não transforma glosa de mérito em pagamento.
O que o agente entrega é antecipação e menos retrabalho: o lote sai antes, sai certo e sai rastreado.
O agente audita o lote e cuida do transporte. A decisão sobre o que se cobra, de quem e com qual argumento continua sendo de gente — e é bom que seja.
Falta o anexo de justificativa, a evolução não foi fechada, o procedimento precisa de autorização que ainda não saiu. Segurar a guia e esperar, ou mandar o lote sem ela e faturar depois? Isso é decisão de coordenação, com efeito em prazo contratual e em relacionamento com a operadora. O agente mostra o impacto de cada caminho; quem escolhe é uma pessoa.
Regra de envio que mudou sem aviso, exigência de anexo que não está no contrato, prazo de processamento que estourou. Nada disso se resolve num XML. O agente documenta o que aconteceu — quando enviou, o que recebeu de volta, quantas vezes tentou — e entrega o material para quem senta à mesa.
Quando a operadora audita, ela pede justificativa técnica e assistencial. Boa parte do que ela vai apontar já foi auditada aqui dentro antes do envio, e o agente chega com o histórico do lote, o protocolo, as datas e os documentos anexados reunidos; a resposta em si é escrita por quem tem responsabilidade profissional sobre ela.
Ele não altera conteúdo de guia para o lote passar na validação, não troca código de procedimento, não decide o que fica de fora da competência e não fala com a operadora em nome do hospital fora dos canais de transmissão contratados.
Os controles de acesso, credencial e registro estão detalhados em integrações e segurança.
Ela continua sendo atendida pelo portal, e isso é dito sem rodeio: onde não existe caminho automatizado, alguém sobe o arquivo à mão. O que muda é o resto do trabalho. O lote daquela operadora é montado e validado do mesmo jeito, aparece no mesmo painel e recebe o mesmo acompanhamento — e o protocolo, quando é registrado, fica na mesma linha dos outros.
Na prática, a exceção deixa de contaminar o processo inteiro: em vez de catorze envios manuais, sobra o punhado que a operadora ainda exige assim.
Mudança de versão é evento de plataforma, não projeto do seu hospital. As regras de estrutura do padrão são atualizadas no lado da Hal-AI e o agente passa a validar contra a versão vigente. O que exige conversa é o calendário: operadoras migram em ritmos diferentes, e durante a transição convivem duas versões no mesmo mês.
Por isso a versão é uma propriedade de cada operadora no cadastro, e não um ajuste global. O painel mostra em que versão cada lote saiu.
O agente repete a tentativa nas janelas seguintes, com intervalo, e registra cada uma com horário e resposta recebida. Se o prazo apertar, o caso sobe para a fila humana com o histórico pronto — inclusive para o envio pelo caminho alternativo que aquela operadora aceite.
O lote não é dado como entregue enquanto o protocolo não voltar, e o agente nunca preenche um número que não recebeu. Preferimos um campo vazio a um registro falso.
Não. Corrigir conteúdo de guia é ato de faturamento, com consequência contratual e, às vezes, assistencial. O agente aponta o item e o motivo, indica quem resolve e devolve para a equipe. Nenhuma alteração de guia é gravada por ele.
Ele pode, sim, remontar o lote depois que a pessoa corrigiu, revalidar quantas vezes for preciso e transmitir de novo — sem duplicar o envio anterior.
Ficam na central de acesso da plataforma, guardadas com segurança e usadas pelo agente no momento do envio. Elas não são exibidas de volta na tela, não circulam por mensagem e não ficam num arquivo na máquina de ninguém. Cada operadora é uma ferramenta declarada do agente: o que não foi declarado, ele não alcança.
Vencimento de certificado e renovação de senha viram alerta antes do fechamento. O detalhamento está em integrações e segurança.
A gente desenha com você como ficaria a transmissão da sua competência: o que é validado antes de sair, o que sai sozinho, o que continua passando pela mão de alguém e como fica a janela de envio.