Unimed Blumenau — notas e observações
Conectores:unimed-blumenau(RPA) eunimed-blumenau-soap(webservice)
Registro ANS: 334561
Portal: https://planodesaude.unimedblumenau.com.br/PlanodeSaude
Webservice: https://webserviceprd.unimedblumenau.com.br:443/TISS40200OPS/
Última revisão: 2026-11-02 · anterior: 2026-10-21
Prazos contratuais
| Prazo | Quanto | Conta a partir de | Fonte |
|---|---|---|---|
| Envio do lote | não medido | — | — |
| Pagamento | não medido | — | — |
| Recurso de glosa | não medido | — | — |
O valor operável fica emHealthPlan(submissionDeadlineDays,
paymentDeadlineDays,appealDeadlineDays), que é de onde o Monitoramento
calcula vencimento. Enquanto estiver "não medido" aqui, o cadastro está no
default de 30 dias — convenção, não declaração.
Criar autorização: só o webservice. E ele funciona. (medido 20/10/2026)
Pergunta recorrente — "o RPA ou o webservice cria autorização?". A resposta
está declarada no código e foi confirmada rodando os dois com a credencial do
Indalab (indalab, usuário do tipo prestador; a mesma serve para portal e
webservice, produção e homologação):
RPA unimed-blumenau | webservice unimed-blumenau-soap | |
|---|---|---|
| autentica hoje | sim (login em 5,2s) | sim (validado em 2,0s) |
REQUEST_AUTH | não — ausência declarada apontando para o webservice | sim |
CHECK_AUTH_STATUS | sim, e é quem traz o motivo | sim, mas sem motivo |
A criação já roda em produção
Histórico do Indalab: 6 execuções REQUEST_AUTH com SUCCESS, a última em
14/10/2026. Não é teste de laboratório — saiu senha:
| guia prestador | guia operadora | status | senha | validade |
|---|---|---|---|---|
MYD2610140001 | 18820940 | 1 Autorizado | 18820940 | 12/01/2027 |
MYD2609270002 | 18711301 | 1 Autorizado | 18711301 | 26/12/2026 |
MYD2609280001 | 18713789 | 3 Negado | — | — |
As autorizadas foram canceladas depois (CANCEL_GUIDE, 2x SUCCESS), então
o ciclo fecha: cria, autoriza, cancela.
Mapa do statusSolicitacao como o conector lê: 1 autorizado, 7 autorizado
parcialmente, 3 negado, qualquer outro em análise.
Ensaio de criação em homologação, hoje
https://webservicetst.unimedblumenau.com.br:443/TISS40200OPS/, mesma
credencial, beneficiário e médica dos pedidos reais (CRM 27285/SC, CBO 225124):
numeroGuiaPrestador HML261021014358
→ Autorizado — guia operadora 18837572, senha 18837572, validade 2027-01-18
hemograma 40304361: solicitada 1, autorizada 1
**O ambiente de teste compartilha a FAIXA de numeração com produção, mas não a
base.** Produção emitiu 18820940 em 14/10 e o teste emitiu 18837572 em 20/10 —
sequência contínua, o que sugere base única. Não é:
- •o webservice de produção não acha a guia: `Guia não encontrada no
sistema! (5012)`;
- •o portal de produção, consultado pelo mesmo número, mostra uma requisição
diferente — procedimento 10101039 (consulta), não o hemograma pedido.
Ou seja: o mesmo número significa coisas diferentes nos dois ambientes.
Não confira guia de homologação pelo número em produção — a resposta vem,
parece plausível, e é de outro registro.
Criação em produção, ponta a ponta (20/10/2026)
Beneficiário SAMUEL DE PAULA BATISTA, carteira 00265555068163003
(validade 28/02/2027, confere com a carteirinha do app).
checkEligibility → elegível, validade 2027-02-28
requestAuthorization MYD2610210001
→ Autorizado — guia operadora 18868500, senha 18868500, validade 2027-01-18
hemograma 40304361: solicitada 1, autorizada 1
portal (RPA) → estágio "Aprovada", hemograma, quantidade autorizada 1
cancelGuide MYD2610210001 → "Guia cancelada com sucesso" (statusCancelamento 1)
portal (RPA) → estágio "Cancelada"
A guia de validação foi cancelada em seguida, como as anteriores. O ciclo
completo — elegibilidade, autorização com senha, leitura no portal e
cancelamento — está medido ponta a ponta nesta data.
CHECK_AUTH_STATUS pelo webservice não acha a guia — nem a recém-criada
Correção de uma leitura que eu mesmo escrevi errado nesta nota horas antes.
O 5012 - Guia não encontrada no sistema! tinha sido atribuído ao
cancelamento: "o webservice perde a guia depois de cancelada". É falso.
Medido na guia 18868500, **autorizada minutos antes pelo próprio
webservice**:
webservice checkAuthorizationStatus → "Guia não encontrada no sistema! (5012)"
portal checkAuthorizationStatus → "Aprovada", hemograma, qtd autorizada 1
Vale para guia viva e para guia cancelada (MYD2610140001, mesma resposta).
Não é o número que vai no campo errado — essa hipótese foi levantada e
morreu na medição. check-authorization-status.ts:85 manda
providerGuideNumber || operatorGuideNumber em numeroGuiaPrestador, e na
primeira tentativa foi o da operadora que viajou ali. Refeito com o do
prestador (MYD2610210001): mesmo 5012.
O que fecha o caso: o cancelamento acha a guia com esse mesmo número.
cancelGuide numeroGuiaPrestador=MYD2610210001 → "Guia cancelada com sucesso" (status 1)
statusAutoriz. numeroGuiaPrestador=MYD2610210001 → 5012 Guia não encontrada
Mesma guia, mesma chave, mesma credencial, operações diferentes: a chave está
certa e o problema é outro — da operação tissSolicitacaoStatusAutorizacao,
não do identificador.
O que ainda precisa ser checado: capturar a requisição que o portal faz e
comparar com o nosso envelope dessa operação (data? tipoEtapaAutorizacao?
serviço não habilitado para este prestador?). Até lá, **não afirmar que a
Unimed não oferece a consulta** — e usar o portal, que responde certo:
Aprovada com a guia viva, Cancelada depois do cancelamento.
Os dois canais são complementares, não alternativos
Some-se ao que esta nota já registra sobre a negativa: o webservice devolve
<motivosNegativa/> vazio e o motivo só existe na página do portal. Com o
achado acima, o desenho fica: criar pelo webservice, ler pelo portal.
A troca de número 18… → 95… existe, mas é sinal raro demais para servir de fonte (medido 13/11/2026)
MED-3 do benchmark MedWise, respondida sem tocar no portal. A hipótese era
que a Unimed troca o número da operadora quando a guia é executada (18… vira
95…), e que contar essas trocas em portal_executions mediria quantas
execuções o sistema já viu de graça.
A troca existe e o retorno carrega os dois números — o consultado vai em
referenceId.operatorGuideNumber, o devolvido em
resultSummary.details.numeroGuiaOperadora. Mas o volume mata a ideia:
CHECK_AUTH_STATUS SUCCESS com os dois números presentes
unimed-blumenau-soap 108 trocou: 2 no padrão 18→95: 1
scsaude-atendimento 3 trocou: 0
bradesco-saude 1 trocou: 0
E na base de autorizações da Unimed (ANS 334561), de todos os tempos:
12 guias com prefixo 18, 4 com 17, 2 com 95.
Por que isso não é falha de captura. A base inteira de autorizações em
produção tem 88 linhas, de todas as operadoras, desde o começo. Não há execução
suficiente para medir execução. O denominador é o problema, não o parser.
O que fica em pé. Em 510 CHECK_AUTH_STATUS bem-sucedidas de todos os
conectores, nenhum desfecho é "executada" — os rótulos são Autorizado, Em
análise, Negado, Cancelado, Não localizada, Erro. E nenhuma das 29 chaves que já
apareceram em details é data de execução. O buraco de execução do dossiê está
medido: não é que a tela não mostre, é que o dado não entra.
Descartado: usar a troca de número como fonte de execução. Um caso em 108
não sustenta regra de bloqueio de faturamento, e 95… também não prova execução
por si — prova que a operadora reemitiu o documento.
O que ainda precisa ser checado: a utilizacoes_beneficiario está com **0
linhas** em produção. As únicas duas FETCH_UTILIZATION bem-sucedidas são de
27/09 e 21/10/2026, anteriores ao módulo de persistência (28/10). Antes de
tratar a utilização do beneficiário como fonte da checagem pré-faturamento,
rodar uma FETCH_UTILIZATION de verdade e conferir se as linhas gravam.
FETCH_UTILIZATION roda, grava, e responde "foi executada?" (medido 13/11/2026, Indalab)
Primeira execução real depois que a persistência existiu (utilizacoes_beneficiario,
28/10/2026). Conexão cmubwicdn2d71pd1q2gtzq8vr (Indalab, RPA de produção),
carteirinha 00265555068164000.
POST /api/portal-connect/executions → 202, QUEUED
status SUCCESS, durationMs 21.748
resultSummary.total = 60 eventos
utilizacoes_beneficiario: 0 → 60 linhas
21,7 s, não 8,5. A medição anterior de 8,5 s era de sessão já aberta. Com
login, a operação leva ~22 s. Para dimensionar fila de checagem, é este o número.
O evento do próprio prestador aparece, e é o que a checagem precisa. Entre os
60, exatamente um é nosso:
realizadaEm 2026-11-02 40304361 Hemograma LABORATORIO DE ANALISES CLINICAS INDALAB LTDA
É a autorização de MURILO DE PAULA BATISTA, AUTORIZADA em 02/11. Ou seja: a
utilização responde foi executada, quando e por quem para o nosso CNPJ — as
três perguntas que o CHECK_AUTH_STATUS não responde em nenhum conector. O
casamento é por carteirinha + código + data, como o dossiê previu.
O preço é dado clínico de terceiro. Dos 60 eventos, 59 são de outros
prestadores (NASO Clínica, MESO Medical, consultório…), com procedimento e data.
O contrato de UtilizationEvent já avisa disso. Quem for construir a checagem em
cima desta fonte precisa decidir o que guarda e o que descarta — hoje grava tudo.
O que ainda precisa ser checado: proximoPermitidoEm veio igual nas 60 linhas
— 2026-11-13, a data da consulta. O parser lê a coluna Próx execução
(utilizacao.parse.ts:59). Pode ser leitura legítima ("elegível a partir de
hoje", já vencida a carência de todos os 60) ou coluna errada. Não dá para
separar as duas sem o HTML da tela, e esta execução não guardou screenshot nem
log. Até medir, não usar proximoPermitidoEm como regra anti-glosa — é o
campo que o módulo chama de "o dado anti-glosa", e um valor constante não
sustenta regra nenhuma.
A varredura de histórico leva mais de 30 minutos — e o prazo cortava no meio
Medido na ativação do Indalab em 21/09/2026, primeira varredura da conexão:
initial_sync_fetch | 1.832.600 ms — 30min30s |
| Arquivos baixados | 1.181 |
initial_sync_persist | 44s |
OPERATION_TIMEOUTS.INITIAL_SYNC era de 30 min. O cão de guarda disparou aos
30min00s, marcou a execução como FAILED com Timeout apos 1800s — e o
trabalho continuou, terminou meio minuto depois e persistiu os 1.181
arquivos. O prazo foi elevado para 90 min por causa desta medição.
O Promise.race do worker não cancela nada. Ele para de esperar; o processo
segue vivo. Uma execução FAILED por timeout pode ter dado certo: antes de
concluir que a varredura não trouxe nada, olhe portal_execution_steps — o
passo initial_sync_persist diz a verdade, o status da execução não.
O portal gera o ZIP na hora — e a dedup por hash não funciona aqui
**Este é o achado que desmonta a leitura anterior, e ele custou quatro
varreduras para aparecer.**
A sequência que enganou: quatro passadas, cada uma trazendo ~1.000 arquivos
"novos", a inbox subindo de 986 para 3.831. A conclusão óbvia — e errada — era
que cada passada avançava mais fundo num histórico grande demais para uma janela
só. Foi o que se registrou aqui antes de medir direito.
A medição que desmente:
Linhas em inbox_files | 3.831 |
| Nomes de arquivo distintos | 1.155 |
| Hashes distintos | 3.831 |
O mesmo demonst_pagamento_prot_32513515.xml entrou **8 vezes, com 8 hashes
diferentes**. O portal monta o ZIP no momento do download, e o carimbo de tempo
dentro dele muda os bytes a cada vez. Resultado: existingFileHashes nunca
reconhece o que já foi baixado, e **toda varredura rebaixa e regrava o acervo
inteiro**.
O histórico, portanto, já estava completo desde cedo. As passadas seguintes não
trouxeram documento novo nenhum — trouxeram cópias.
O dado financeiro NÃO duplicou
Isto é o que impede o estrago de ser sério, e vale saber por quê:
| Antes das 2 últimas varreduras | Depois | |
|---|---|---|
| Demonstrativos de análise | 381 | 381 |
| Protocolos distintos | 381 | 381 |
| Glosas | 9.022 | 9.022 |
A deduplicação de domínio é por protocolo, e essa funciona. Quem reimporta o
mesmo demonstrativo não cria protocolo nem glosa em dobro. O desperdício fica na
camada de arquivo: 3.831 linhas de inbox e o mesmo tanto de objeto no S3 para
1.155 documentos reais.
O conserto certo é existingFileNames
O contrato de FetchOptions já prevê exatamente este caso, e o executor já
preenche o campo. unimed-brusque e scsaude-credencia o usam; unimed-blumenau
ignora e deduplica só por hash — que, para este portal, **chega tarde e chega
errado**.
Antes de implementar é preciso medir uma coisa no portal: se o número do
protocolo (que é o que nomeia o arquivo) é legível na listagem, antes de abrir o
download. parseDemonstrativeLink hoje extrai batchNumber, não protocolo. Se
o protocolo não estiver na listagem, o caminho alternativo é deduplicar por nome
na persistência, depois do download — resolve a duplicação no banco e no S3, mas
não economiza o tempo de baixar.
Enquanto não houver conserto
- •Não conclua "trouxe N novos, logo faltava histórico". Nesta operadora,
"novo" por hash não quer dizer novo. Meça count(DISTINCT "nomeArquivo").
- •Retry de varredura aqui não recupera nada — só multiplica cópia. Os três
retries de 21/09/2026 não acrescentaram um documento sequer.
- •
initialSyncDone = truecontinua não significando histórico completo: ele é
gravado por qualquer varredura que persista algo, inclusive uma cortada pelo
prazo.
Baixado não é igual a gravado — o portal repete demonstrativo
Uma fração dos arquivos de cada passada é descartada por hashSHA256 (195 de
1.181 na primeira; 199 de 1.099 na segunda) — são os PDFs, cujos bytes o portal
reproduz igual. Os ZIPs de XML não: esses passam sempre, porque são montados na
hora. Ver a seção acima.
O mesmo padrão de prazo curto já tinha mordido na Unimed Brusque, por outro
caminho (FETCH_ANALYSIS de 600s). Prazo curto em operação de varredura não
falha barulhento: ele desliga a integração por consecutiveFailures e a base
para.
Não interprete a diferença como perda. E não use numeroDemonstrativo nem o
hash do arquivo como identidade do documento: o que identifica um pagamento é
protocolo + data.
Todo demonstrativo de pagamento vem em par XML + PDF
E o PDF sempre entra em INBOX_ERRO_PROCESSAMENTO com
PARSING — Nenhuma guia extraída do documento.
No Indalab: 48 PDFs, 48 erros, exatamente. Os dados estão no XML irmão (557
pagamento + 381 análise entraram inteiros). É ruído esperado, não incidente —
a taxa de erro da inbox nesta operadora tem um piso proporcional ao número de
demonstrativos de pagamento.
Vale decidir, quando incomodar: ou o PDF para de ser enfileirado para parsing de
guias (é anexo de conferência humana, não fonte de dados), ou ganha um status
próprio. Hoje ele polui a contagem de falhas.
As glosas chegam em ITEM e GUIA — nunca em PROTOCOLO
Medido no Indalab, 9.022 glosas importadas:
nivelGlosa | Quantidade |
|---|---|
| ITEM | 8.776 |
| GUIA | 246 |
| PROTOCOLO | 0 |
Isso é o comportamento normal do TISS — a operadora glosa o procedimento, não o
lote — mas derrubou a coluna Auditoria do histórico de importações, que contava
só protocolo.glosas e portanto respondia "0 glosas" para todo demonstrativo.
Corrigido em 21/09/2026 em audit-api.router.ts, que agora soma os três níveis.
**Ao consultar glosa desta operadora, sempre percorra
protocolo → guia → item.** Filtrar por protocoloId devolve conjunto vazio, e
vazio aqui se lê como "não houve glosa", que é a mentira mais cara do módulo.
Autorização só passa pela TISS 4.03 — a 4.02 responde, mas recusa no item
Medido em 27/09/2026 na homologação (webservicetst), conta do Indalab
(código do prestador 6971), beneficiário de teste Murilo, hemograma 40304361,
etapa 1, eletiva. Mesmo pedido, duas versões:
| Versão | Resposta |
|---|---|
4.02.00 (TISS40200OPS) | Guia criada (18683611), statusSolicitacao 3, motivosNegativa da guia vazio — e o ÚNICO item com glosa 5001: "NÃO É NEGATIVA AO CLIENTE — erro no sistema autorizador do prestador, que deve atualizar para a última versão da TISS vigente". Quantidade autorizada 0. |
4.03.00 (TISS40300OPS) | Autorizado (guia 18683612), quantidade autorizada 1, senha 18683612 válida até 26/12/2026. |
Produção, 27/09/2026: mesma solicitação (hemograma, etapa 1, eletiva), com
solicitante real — Dra. Lidia Ferraz Gracioli, CRM 27285/SC, pediatra (CBO
225124) — pela conexão de webservice produtivo do Indalab: autorizado, guia
operadora 18711082, senha 18711082 válida até 26/12/2026 (guia prestador
IDL0525158180). Status e elegibilidade também passaram. Nada disso exigiu o
paciente ou a médica cadastrados no Revenue: os dados vão no pedido, e quem
valida é a Unimed. Em homologação a Unimed aceitou um CRM fictício; em produção
não foi testado se aceitaria.
Três armadilhas no caminho, todas corrigidas no código:
- •A recusa vinha só no item. O parser lia
motivosNegativada guia, que
vinha vazio, e a tela dizia "em análise" para um pedido recusado. Os motivos
agora são lidos na guia e em cada servicoAutorizado.
- •A senha mora em
dadosAutorizacao, não no nível deautorizacaoServico
onde o código procurava. A solicitação autorizada saía sem senha.
- •O status acha a guia pelo número do PRESTADOR na 4.03. Com o número da
operadora (18683612) a resposta é 5012 — Guia não encontrada no sistema;
com o do prestador (IDL0522628872) volta completa, com senha. O runbook dizia
o oposto — medido na 4.02 (v7). A consulta agora manda providerGuideNumber
quando o chamador tem.
Mais um, que explicava por que o status nunca funcionou por aqui: a operação de
status própria da Unimed lia autorizacaoStatus, elemento que não existe. A
resposta é situacaoAutorizacaoWS > situacaoAutorizacao, como no padrão ANS.
O conector passou a usar as operações TISS compartilhadas (as mesmas de Orizon e
Porto) para solicitação e status.
**A autorização vai na 4.03 em toda conexão; o resto fica na versão da
conexão.** Solicitação e status de autorização são fixados na 4.03.00 pelo
conector — nenhum prestador precisa configurar nada. Lote, demonstrativo,
recurso e elegibilidade seguem connectorConfig.tissVersion (padrão
4.02.00), porque nunca foram medidos na 4.03 em produção e já faturam pela
4.02. O conector troca <Padrao> e o caminho do endereço (TISS40200OPS →
TISS40300OPS) juntos, por operação.
Homologação é webservicetst, não webservicehml. Os dois respondem 200.
O catálogo de produção tinha webservicehml, gravado à mão; o que a Unimed
homologa é o TST (planilha "webservice TST 40200.xls" da operadora).
Descartado
- •*"A 5001 é credencial ou cadastro do prestador."* Não: mesma credencial, mesmo
código, mesmo pedido — só a versão mudou, e passou.
- •*"
statusSolicitacao3 = em análise."* **Derrubada em 28/09/2026 com caso real
de produção:** guia 18713789 (Indalab) voltou 3, <motivosNegativa/> vazio,
quantidade autorizada 0 nos três itens — e o portal mostrava "Reprovada"; a
consulta seguinte deu 3 de novo. O caso que sustentava a regra (18005779) era
de homologação. Agora 3 = negado. O webservice NÃO traz o motivo nesses casos
(nem na solicitação, nem na consulta); ele só existe na tela da requisição do
portal. Causa provável deste caso: carteirinha da Unimed Nacional (0865…,
vencida em 31/08/2026) em vez da Unimed Blumenau.
O portal tem "Pesquisa de Autorização" — MAPEADO em 28/09/2026 (detalhe da requisição)
Informado em 27/09/2026: o portal do prestador tem uma tela **Pesquisa de
Autorização**, com filtros de estágio, tipo de guia, tipo de transação (Guia /
Requisição), beneficiário, código do prestador, guia/requisição, procedimento e
período (De/Até, padrão de 30 dias). O RPA não a usa.
É o complemento natural do status por webservice: lista autorizações por
beneficiário ou período, sem precisar do número da guia — inclusive as pedidas
fora do Revenue. Não mapeado ≠ não existe: antes de afirmar o que ela
devolve, navegar e capturar a requisição.
Medido em 28/09/2026 (requisição 18713789, Indalab), o que o robô usa hoje:
- •Menu lateral (frame
menuLateral): link cujoonclickchama
linkTargetMenu("pls_montarListaRequisicao.action?ieExecutarConsulta=false", "paginaPrincipal").
Procurar por texto visível falha — o link é achado pelo onclick.
- •Pesquisa: campo
#nrSeqTransacao+ botão#btnVisualizar. A linha do
resultado só faz window.location para
pls_montarListaRequisicaoProcMat.action?nrSeqRequisicao=N&nrSeqTransacao=N&…&ieTipoConsulta=2&ieOrigemProc=8&ieEstagio=0.
- •O número da requisição é o número da guia na operadora (o
numeroGuiaOperadora
que o webservice devolve). Com a sessão logada, abrir a pesquisa e dar GET no
detalhe basta (requisicao.ts, via context.request — sem dirigir a tela).
- •Estrutura: cada bloco é uma
<table>comtr.tituloLista(título) e
tr.fonteNormal (linhas); itens em tr.registroLista, código num <label>.
"Estágio:" no cabeçalho é a âncora — sem ele a página não é a requisição.
- •Ainda não visto: tela de guia Parcialmente aprovada e Aprovada (o
mapa estágio → código em statusDoEstagio tem essas por texto, não medidas),
nem glosa POR ITEM na tela (só o texto de status do item).
Hash: 5014 com aspas na descrição — o hash é do texto, não do XML
Medido em 28/09/2026 (MYD2609280002): pedido com a descrição TUSS
Vitamina "D" 25 HIDROXI… voltou mensagemErro 5012/"5014 - CODIGO HASH
INVALIDO". O XML leva ", e o Tasy calcula o MD5 sobre o texto já lido
("). O Miydas calculava sobre a entidade. Agora calculateTissHash decodifica
as entidades antes do MD5, e todo texto passa por paraLatin1 (aspas curvas,
travessão e emoji viravam "?" só do nosso lado). A resposta de erro também
passou a chegar à tela com o motivo da operadora, em vez de "resposta inesperada".
Conexão de homologação ao lado da de produção: dois defeitos, medidos
Criar a vaga "webservice homologação" do Indalab (27/09/2026) expôs duas coisas:
1. **A validação da credencial dispara a sincronização inicial — e em homologação
ela baixou 12 demonstrativos de TESTE para a inbox real** (a base de teste é
cópia da produção, os arquivos parecem reais). Pararam na identificação, nada
virou demonstrativo; foram marcados INBOX_REJEITADO / `faseErro =
AMBIENTE_HOMOLOGACAO`. Corrigido: sincronização inicial não roda em homologação.
2. O resolvedor de canal não olhava o ambiente: homologação e produção, mesmo
método, empatavam, e a ordem do banco decidia para onde ia uma chamada real.
Corrigido no resolvedor da API, no LIS, na inbox e na conciliação
(ambiente: 'PRODUCAO' para operar).
A conexão de homologação do Indalab está desativada até ser preciso testar de
novo. A de produção tem initialSyncDone = true de propósito: quem baixa
demonstrativo do Indalab é o RPA; ligar a sincronização pelo webservice duplicaria.
Cancelamento: a Unimed cancela, e o recibo tem o elemento repetido
Medido em 27/09/2026 com a guia MYD2609270001 (senha 18711287), cancelada pela
tela do Miydas. O webservice cancelou — mas o Miydas registrou
CANCEL_REJECTED / "Estrutura de resposta de cancelamento inesperada" e a guia
seguiu como AUTORIZADA.
O recibo real (TISS 4.x; o cabeçalho diz Padrao 4.02.00 mesmo no pedido 4.03):
reciboCancelaGuiaWS
reciboCancelaGuia ← wrapper
reciboCancelaGuia ← ct_reciboCancelaGuia (o nome se repete)
registroANS, dadosPrestador
retornoStatus
guiasCanceladas
dadosGuia { tipoGuia, numeroGuiaPrestador, statusCancelamento }
(ou loteCancelado { numeroLote, statusCancelamento })
statusCancelamento = dm_statusCancelamento (1 cancelado, 2 não cancelado,
3 guia inexistente…). Os dois leitores (genérico e Unimed) procuravam
reciboCancelamento, formato que nenhuma operadora medida devolveu. Hoje há um
leitor só, lerReciboCancelamento (tiss-operations/cancel-guide.ts), com a
resposta real como teste.
Depois de cancelar, a consulta de situação diz "em análise". A mesma guia,
consultada logo após o recibo de cancelamento, voltou com statusSolicitacao 2
(dm_statusSolicitacao: 2 = em análise; o esperado seria 6 = cancelada), com
senha e itens autorizados intactos. Ou seja: a consulta da Unimed não mostra
o cancelamento. O Miydas trata o recibo como final — a consulta não rebaixa uma
guia CANCELADA (registro-negocio, registrarStatus). A checar: se o portal
mostra a guia como cancelada, e se a Unimed aceita faturar uma guia cancelada.
A consulta devolve "2" também em guia AUTORIZADA, no dia seguinte. A guia
18711082 (Indalab) veio com statusSolicitacao 1 em 27/09/2026 e 2 em 28/09
(03:34), com quantidade autorizada 1, senha e data de autorização intactas. O
"2" da Unimed não é "em análise": parece ser o que ela responde para guia já
decidida. O Miydas não rebaixa AUTORIZADA para EM_ANALISE por consulta.
Descartado: a hipótese de a Unimed exigir numeroGuiaOperadora no pedido de
cancelamento — ela localiza pela guia do PRESTADOR e respondeu com ela.
Negativa de autorização: o que o portal mostra e o que o webservice traz
A tela de detalhe da requisição no portal (prints de 27/09/2026, requisições
18681748 e 18689680 do Indalab, pedidas fora do Miydas) tem três camadas:
1. Glosas/Ocorrências da Requisição — da guia: "Glosa: 1014 - Beneficiário
com data de exclusão" + "Ocorrência: 1014 - O cartão informado encontra-se com
data de exclusão…"; ou só "Ocorrência: CM414 - BENEFICIÁRIO INTERCAMBIO ESTADUAL".
2. Inconsistências PTU (intercâmbio): "2008 - Benef. com atendimento Suspenso".
3. Status por item em texto: "Negado pelo sistema" (Qtd aprovada 0);
cabeçalho "Estágio: Reprovada" / "Parcialmente aprovada".
O webservice TISS devolve glosa da guia e do item (motivosNegativa, código +
descrição) e observacao — o Miydas guarda e mostra as duas como motivos
(a observação desde 28/09/2026). Status por item em texto NÃO existe no XML.
Ainda não medido
- ☐Se a "Ocorrência" chega no
observacaodo webservice, e se a
inconsistência PTU chega por ele (nas 9 respostas guardadas até
28/09/2026 não há nenhuma negativa). Medir com uma negativa real —
consulta de situação de uma das requisições acima (precisa da carteirinha).
- ☑O webservice NÃO traz PTU nem ocorrência: na negada 18713789 veio
status 3 com <motivosNegativa/> vazio (28/09/2026). Por isso o robô
(unimed-blumenau, CHECK_AUTH_STATUS) passou a ler a tela da requisição:
o acompanhamento leva cada negada SEM motivo UMA vez ao portal
(AcompanhamentoService.buscarMotivos), e a consulta seguinte pelo
webservice não apaga o motivo trazido (registrarStatus só limpa motivo
quando a situação muda).
O envio de lote vai pelo PORTAL, não pelo webservice (Indalab)
Decidido e configurado em 21/10/2026. A operadora tem os dois canais e os
dois declaram SUBMIT_BATCH; PREFERENCIA_CANAL manda no webservice. Para a
conexão da Indalab, a de webservice passou a declarar no cadastro que não é o
canal de envio:
-- operator_portal_configs.connectorConfig, conexão cmuk0fu3y0001nx3pvyrpzb9c
{"environment": "producao", "naoUsarPara": ["SUBMIT_BATCH"]}
Efeito medido logo depois, resolvendo por operação:
| Operação | Canal escolhido |
|---|---|
SUBMIT_BATCH | unimed-blumenau (RPA) |
CHECK_ELIGIBILITY | unimed-blumenau-soap |
REQUEST_AUTH | unimed-blumenau-soap |
CANCEL_GUIDE | unimed-blumenau-soap |
CHECK_AUTH_STATUS | unimed-blumenau-soap |
É cirúrgico de propósito: só o envio troca de canal. **Para voltar, remova a
chave naoUsarPara** do connectorConfig dessa conexão — nada mais depende
dela.
naoUsarPara é cadastro, não contrato: a API pública não tem e não vai ter
parâmetro de canal (ver api-publica-canal-abstraido). Quem integra pede
"envie este lote"; por onde vai é decisão da clínica e da operadora.
O envio por portal é ENFILEIRADO, e a rota responde 202
Diferente do webservice, que termina dentro da requisição e devolve 200 com o
protocolo. O portal abre navegador, navega o menu (item_4 → subItem_4_1),
clica a pasta "Upload", acha o iframe pasta_destino, anexa o arquivo e lê a
confirmação. O lote fica TRANSMITINDO com portalExecutionId, e quem fecha o
estado é o executor.
TRANSMITINDO não é INDETERMINADO. Os dois bloqueiam reenvio, mas o que
fazer é oposto: aqui é esperar, porque o desfecho chega sozinho; lá é mandar
alguém olhar o portal. Não há retentativa automática — SUBMIT_BATCH é
familia: 'ESCRITA' e o executor não repete escrita.
Falha de RPA chega sem código de erro (CONNECTOR_ERROR), e
classificarFalhaDeEnvio manda o desconhecido para INDETERMINADO de
propósito: um upload que quebrou depois de anexar o arquivo pode ter
entrado, e ERRO_ENVIO convida a reenviar.
Verificado até a borda do irreversível, em 21/10/2026
Montagem pela API pública com a credencial da Indalab, sem mandar
codigoNaOperadora no corpo: lote PRONTO, XSD válido, zero erro, e o XML com
<ans:codigoPrestadorNaOperadora>6971</...> nas quatro posições — o código
veio da conexão (extraFields.codigoPrestador), que é como deve ser: quem
integra não tem por que conhecer o código que a operadora deu à clínica.
A transmissão em si NÃO foi feita, e não por falta de autorização: não há
lote real para enviar. lis_lotes_envio estava vazia e os 18 lotes_guias são
todos IMPORTADO, nenhum da produção própria. Transmitir um lote montado para
teste é apresentar cobrança falsa à operadora. A primeira transmissão real
precisa de competência de verdade do prestador.
A tela de envio de lote, medida campo a campo (22/10/2026)
Até aqui submit-batch.ts era transcrição da referência iTISS (Puppeteer) e
nunca havia rodado contra este portal — zero execução SUBMIT_BATCH de qualquer
conector, desde sempre. O caminho estava certo. O que ia dentro dele, não.
O caminho (confirmado, sem mudança)
#item_4 "Contas médicas" → #subItem_4_1 "Upload de contas médicas (XML)" →
pls_montarTelaConsultaTISS.action. A tela é um conjunto de pastas, e a de
envio é a única com setarPasta:
div[onclick="setarPasta('upload','pls_verificarPodeImportar.action');"] → "Upload"
div[onclick="abrirPastaProtocolos();"] → "Protocolos - 32568126"
div[onclick="abrirResumoImportacao();"] → "Resumo importação"
div[onclick="abrirPastaContas();"] … → Contas, Glosas, Procedimentos, Materiais, Diagnóstico
O portal carrega a pasta escolhida no iframe pasta_destino, e lá mora o
formulário:
<form id="form_importar" action="pls_importarXMLTISS.action"
method="POST" enctype="multipart/form-data">
<input type="file" id="arquivo">
<input type="submit" id="botaoEnviar" value="Enviar">
</form>
Só .zip. A tela diz isso, em letra pequena
Envio de Arquivo TISS
Será criado um lote do sistema para cada lote prestador.
\*somente arquivos .zip são aceitos
\*são aceitos no máximo 10 arquivos .xml dentro do arquivo .zip
\*não é permitido caracteres especiais no nome dos arquivos .xml
O código mandava o .xml cru, e os três chamadores de submitBatch
(lis.service, e duas vezes portal-executor) nomeiam o arquivo lote_*.xml.
A primeira transmissão real teria sido recusada na porta — depois de o lote
existir no banco como enviado.
Os bytes do XML entram no zip intactos: o documento se declara ISO-8859-1
e o hash do epílogo é calculado sobre bytes latin-1 (ver *Hash: 5014 com aspas*).
Reescrever o conteúdo ao empacotar quebraria o hash declarado — a assinatura de
defeito de 8 dos 86 lotes reais que não fecharam.
O protocolo NÃO vem na resposta do POST
A importação é assíncrona — a legenda da própria tela tem cinco estados:
Aceito · Importando · Rejeitado · Integrado · Em Validação
O protocolo se lê depois, na lista de lotes, consultando por **"Lote
prestador"** — que é o <ans:numeroLote> de dentro do XML que foi enviado. A
URL é a que o consultar() do portal monta:
pls_montarListaLotesProtocolo.action
?ieStatus=&nrSeqProtocoloFiltro=
&dtTransIni=DD/MM/AAAA&dtTransFim=DD/MM/AAAA
&ieSituacaoLote=&ieTipoGuia=
&nrProtocoloPrestador=<numeroLote> ← o filtro que importa
&nrSeqLoteFiltro=&nrSeqPrestador=&ieTipoData=dt_recebimento
Campos do filtro na tela: #nrSeqProtocolo, #ieStatus (Aceito/Rejeitado/
Integrado), #ieSituacaoLote (Todos/pendentes/enviados), #ieTipoGuia,
#dtInicio, #dtFinal, #nr_protocolo_prestador (= *Lote prestador*),
#nr_seq_lote (= *Lote contas*), radio tipo_data.
A grade devolve uma linha por protocolo:
<tr id="linha_protocolo_32568126" onclick="abrirProtocolo('2469130','32568126');">
| Coluna | Valor medido |
|---|---|
| Protocolo | 32568126 |
| Tipo guia | Guia de SP/SADT |
| Data protocolo | 21/10/2026 |
| Lote (prestador) | 4919 |
| Prestador imp | 6971 - LABORATORIO DE ANALISES CLINICAS INDALAB LTDA |
| Tipo apresentação | Apresentação |
| Usuário web | indalab |
As colunas trocam de posição conforme o filtro: com situação diferente de
"pendentes" entra uma coluna *Data recebimento*. Por isso a leitura é por
rótulo de cabeçalho, nunca por índice fixo.
O filtro funciona — e ainda assim a linha é conferida
Medido: nrProtocoloPrestador=4919 devolve 1 linha, 999999 devolve 0, e o
campo volta preenchido com o valor pedido. Mesmo assim, o código **bate a coluna
"Lote" contra o nosso numeroLote** antes de aceitar o protocolo. Foi a fé num
filtro que fez o CHECK_STATUS antigo deste portal responder com a guia do
vizinho (seção própria abaixo); protocolo lido e não conferido é o mesmo erro
com dinheiro maior.
protocolNumber: 'PENDING' não existe mais
O código antigo procurava a palavra "Protocolo" no texto da página e, não
achando, devolvia protocolNumber: 'PENDING'. Essa string seria gravada em
lis_lotes_envio.protocolo, o lote viraria ENVIADO, e a consulta de status
depois iria perguntar à operadora por um protocolo chamado PENDING.
Agora, se o protocolo não aparece em 30s (6 tentativas de 5s), o conector lança
PORTAL_PROTOCOLO_NAO_LOCALIZADO — código que não está em
ANTES_DE_TRANSMITIR nem em RECUSA_EXPLICITA, então
classificarFalhaDeEnvio o manda para INDETERMINADO, que bloqueia o
reenvio até alguém olhar o portal. Protocolo ausente é melhor que protocolo
inventado.
Dois códigos de erro novos, e por quê
| Código | Desfecho | Quando |
|---|---|---|
PORTAL_NAO_CHEGOU_A_ENVIAR | NAO_TRANSMITIU | tudo antes do clique em #botaoEnviar: menu que mudou, pasta que não abriu, formulário que não apareceu, arquivo grande demais |
PORTAL_RECUSOU_LOTE | RECUSADO | a tela validou por alert() e recusou o arquivo (não é .zip, caractere especial, mais de 10 XML) |
Sem o primeiro, **qualquer mudança de leiaute do portal congelava o lote em
INDETERMINADO**: ninguém transmitiu nada e o reenvio ficava bloqueado
esperando uma apuração que não tinha o que apurar.
E não existe um terceiro código para "protocolou e rejeitou", de propósito: ali
a transmissão foi um sucesso. Essa recusa volta em SubmitResult.processing,
não como erro — ver *Duas perguntas, e o conector só sabia responder uma*.
O iframe é pego por NOME
A versão anterior lia o atributo src de #pasta_destino e procurava um frame
cuja URL o contivesse. Naquele instante o src ainda é o da pasta anterior
(pls_montarListaLotesProtocolo.action?ieSituacaoLote=P&…), e o ?? mainFrame
do final devolvia silenciosamente o frame errado — onde #arquivo nunca
existiria. O frame tem nome (pasta_destino); usa-se getNamedFrame.
O Indalab JÁ envia por esta tela, à mão
Protocolo 32568126, lote prestador 4919, data 21/10/2026, usuário web
indalab. Resumo da importação daquele lote:
Contas apresentadas: 21 Contas criticadas: 43
Itens apresentados: 279 Itens criticados: 96
Valor total apresentado: 4.030,06 Valor total criticado: 8.467,28
Arquivo XML: 00000000000000004919_34b93081ef2141a26bdb7c821774fcc7.xml
Isto muda o que SUBMIT_BATCH por RPA significa: **não é capacidade nova, é
automatizar o que uma pessoa do laboratório faz hoje** — e o portal guarda o
arquivo com o nome <numeroLote zero-padded>_<hash>.xml, o que confirma que
numeroLote é a chave pela qual ele indexa.
Note também que o lote 4919 teve 43 contas e 96 itens criticados: a importação
pelo portal critica e isso aparece no *Resumo importação*
(pls_montarResumoImportacaoTISS.action?nrSeqProtocolo=<protocolo>), que é a
tela a mapear para saber o que a operadora recusou dentro de um lote aceito.
Um lote enviado por engano PODE ser excluído
A grade monta um botão btnExcluirProt<protocolo> e o exibe quando o lote ainda
não foi processado:
if ((dtGeracaoLote == null || dtGeracaoLote == '') && qtProcessoPendente == '0' && …) {
campo('btnExcluirProt32568126').style.display = '';
}
// excluirProtocolo(nrSequencia) → DWR pls_importacaoTISS.deleteProtoco…
Reversibilidade medida, não suposta — mas só antes de a análise começar.
Descartado
- •
protocolNumbervindo do corpo da resposta do POST. Não vem. A tela de
destino do pls_importarXMLTISS.action não traz o número; quem traz é a lista
de lotes.
- •
ieSituacaoLotecomo filtro de URL. Passado na URL, não alterou a grade.
Quem filtra de verdade nos testes foi nrProtocoloPrestador.
- •Acrescentar
numeroLoteaTissBatchContext. O número é lido do próprio
XML. Tirá-lo de outro lugar abriria a chance de consultarmos um número
diferente do que foi transmitido — e aí o protocolo lido seria de outro lote.
Ainda não transmitido, e continua sendo por isso
O único lote em lis_lotes_envio é TESTE-PEDIDO-SAMUEL-01: 1 guia, 1
procedimento, R$ 8,28, numeroLote 202610, montado para testar a requisição de
autorização. Ele está VALIDADO com XSD limpo — e **transmiti-lo seria
apresentar cobrança falsa à operadora**, por um hemograma que ninguém fez, no
nome de um beneficiário real. A primeira transmissão real continua precisando de
competência de verdade do prestador.
Dois detalhes para quando ela vier:
- •
numeroLote=202610é competência, e colide. O portal indexa por este
número; dois lotes com 202610 tornam a leitura do protocolo ambígua. O
número do lote tem de ser único por prestador (o manual do Indalab usa
sequencial: 4919).
- •
lis_lotes_envio.versaoTissgrava4.01.00(default da coluna) enquanto
o XML declara <ans:Padrao>4.02.00</ans:Padrao>. A coluna está mentindo sobre
o documento.
O primeiro envio real: protocolado e REJEITADO (22/10/2026)
SUBMIT_BATCH rodou em produção pela primeira vez na história do sistema, com
o lote de teste do Indalab, pelo RPA. Execução cmvjc08720001oa1vq0w0ysz4,
24,6s, SUCCESS, protocolo 32568556.
O SUCCESS estava certo sobre a transmissão, e mudo sobre o que importava.
Duas perguntas, e o conector só sabia responder uma
Este envio ensinou que **"o lote chegou?" e "a operadora aceitou?" são duas
perguntas**, respondidas em momentos diferentes, e que juntar as duas numa só
resposta erra nas duas direções. Custou duas versões erradas para a distinção
aparecer:
| versão | o que afirmava | por que estava errado |
|---|---|---|
| 1ª | SUCCESS, sem olhar o ícone | dizia que a cobrança entrou. lis_lotes_envio gravou ENVIADO para um lote que a Unimed recusou |
| 2ª | AppError PORTAL_RECUSOU_LOTE ao ler rejeitado_.png | reportava falha de envio para um envio que funcionou, marcava ERRO_ENVIO e jogava fora o protocolo |
| atual | SUCCESS com protocolo + processing: REJECTED | as duas afirmações convivem: a transmissão foi um sucesso, e nenhuma conta entrou |
A 2ª versão parecia a correção óbvia da 1ª, e produziu um registro que se
contradizia: um lote ERRO_ENVIO — "não foi enviado" — carregando o número de
protocolo que a operadora deu a ele. O protocolo é justamente o que a pessoa
precisa para discutir a recusa; perdê-lo ao "corrigir" o relato foi pior do que
o relato original.
Onde cada resposta mora hoje:
| pergunta | campo | valor no caso real |
|---|---|---|
| a transmissão funcionou? | lis_lotes_envio.status | ENVIADO, protocolo = 32568556 |
| a operadora aceitou o conteúdo? | processamentoStatus / Detalhe / Em | REJEITADO, CM104 - NUMERO DE GUIA INVALIDO |
| quanto pagou? | retornoStatus / valorPago / glosas | nunca vai existir: nada entrou |
PORTAL_RECUSOU_LOTE continua existindo, com o escopo estreito que sempre foi
o dele: a recusa na porta, pelo alert() da tela (arquivo que não é .zip,
caractere especial no nome, mais de 10 XML). Ali nada saiu de verdade, e é falha
de transmissão.
Protocolo não é aceite
O portal protocola e só depois crítica. O estado do lote **não é coluna da
grade** — é um ÍCONE, lido contra a legenda da tela principal:
| ícone | estado | mapeado |
|---|---|---|
aceitar.gif | Aceito | CONFIRMED |
importado_.png | Importando | PROCESSING |
rejeitado_.png | Rejeitado | REJECTED |
enviado.png | Integrado | CONFIRMED |
Interrogacao.png | Em Validação | PROCESSING |
A grade do protocolo 32568556 veio com rejeitado_.png. O conector leu o
número, não olhou o ícone, devolveu SUCCESS — e lis_lotes_envio gravou
status = ENVIADO para um lote que a Unimed havia recusado. É a mesma
família de defeito do CHECK_STATUS que respondia pela guia do vizinho: ler
metade da tela e chamar de resposta.
Corrigido: submitBatch lê o ícone e devolve o estado em
SubmitResult.processing, junto com o protocolo — sem lançar erro, porque
recusa de conteúdo não é falha de envio. A regra saiu de dentro da navegação
para montarResultadoDeEnvio(), função pura: era a regra que mais custou nesta
operação e só se verificava transmitindo um lote de verdade.
Estado que não esteja na legenda vira PROCESSING, nunca CONFIRMED: se a
operadora trocar o ícone, o pior desfecho aceitável é "alguém olha". E
processing ausente é "ainda não se sabe", nunca "aceito" — no webservice o
protocolo chega antes do julgamento, sempre.
Por que a Unimed rejeitou
pls_montarContasProtocoloTISS.action?nrSeqProtocolo=32568556&nrSeqConta=0:
Sequência Registro ANS Cartão identif Beneficiário Guia
70710322 334561 00265555068163003
Ocorrencia: CM104 - NÚMERO DE GUIA INVÁLIDO -
Guia prestador informada errada. Existem caracteres inválidos!
O numeroGuiaPrestador do lote de teste era TESTEPEDIDO01. **A Unimed exige
numérico.** O lote não entrou — a cobrança de teste nunca chegou a existir como
cobrança, e foi o próprio formato do número de guia de teste que a barrou.
Resumo da importação do nosso protocolo:
Contas apresentadas: 1 Contas criticadas: 1
Itens apresentados: 1 Itens criticados: 1
Valor total apresentado: 8,28 Valor total criticado: 8,28
Arquivo XML: lote_202610.xml
Note o nome: lote_202610.xml — o nome interno do .zip que montamos, e não o
<numeroLote>_<hash>.xml com que o portal renomeia os arquivos do envio manual.
O portal guarda o nome que recebe.
As três telas que explicam uma rejeição
Todas por nrSeqProtocolo, e todas lidas por criticasDoProtocolo():
| Tela | O que traz |
|---|---|
pls_montarResumoImportacaoTISS.action | contas/itens apresentados e criticados, valor apresentado e criticado, nome do arquivo |
pls_montarContasProtocoloTISS.action | por conta, as linhas Ocorrencia: CMxxx - … |
pls_montarGlosasProtocoloTISS.action | o agregado Tipo / Código / Motivo / Grupo glosa / Qt contas |
O que o envio MANUAL do Indalab está levando de crítica
Lido do protocolo 32568126 (lote 4919, enviado à mão pelo usuário indalab em
21/10/2026) — não é nosso, e é o retrato do que a automação vai encontrar:
| Tipo | Código | Motivo | Qt contas |
|---|---|---|---|
| Ocorrência | CM32 | NECESSARIO AUTORIZAÇÃO | 11 |
| Ocorrência | CM82 | VALIDAR DUPLICIDADE DE GUIA | 21 |
| Ocorrência | CM114 | GUIA PRESTADOR DUPLICADA PARA PRESTADOR | 21 |
| Ocorrência | CM551 | QUANTIDADE MAXIMA 1X DIA | 15 |
| Ocorrência | CM569 | QUANTIDADE MAXIMA 1X - INFORMAR INDICAÇÃO CLINICA | 13 |
| Glosa | 9906 | Médico solicitante não informado | 1 |
E o detalhe que dói: as 21 contas de CM82/CM114 apontam todas para o
protocolo 32568117, do lote 2469122, importado por indalab às 16:07:16 —
três minutos antes do 32568126, às 16:10. **O laboratório subiu o mesmo lote
duas vezes** e a segunda veio inteira duplicada. É precisamente o dano que
enviarLote protege com idempotência por estado, e que o envio manual não tem.
CHECK_STATUS volta, pela tela certa
A consulta de protocolo de lote estava sem resposta em canal nenhum: o
webservice falhou 3 vezes e o RPA havia sido removido por mentir. Medindo o
envio, a tela apareceu: é a mesma lista de lotes. Declarado de novo no
conector de RPA, lendo por nrSeqProtocoloFiltro, com a linha conferida contra
o protocolo pedido e as críticas em details.
A leitura mora em protocolo-lote.ts, compartilhada por submitBatch e
checkStatus. Duas leituras da mesma tela é como se produz divergência entre o
que o envio relata e o que a consulta responde — foi assim que a primeira versão
do CHECK_STATUS divergiu de tudo.
Descartado
- •
ieStatuscomo filtro. Medido:ieStatus=A,ReIdevolvem a grade
VAZIA, inclusive havendo protocolo naquele estado (os dois protocolos do
Indalab estão Rejeitado e ieStatus=R não os traz). Filtrar por estado era
o caminho óbvio, e é o errado. O estado se lê do ícone de cada linha.
- •"A primeira imagem da linha" como estado. Toda linha traz também
<img src="excluir.png" onclick="excluirProtocolo(...)">, visível ou não.
Pegar a primeira imagem leria o botão de excluir como se fosse estado.
- •Excluir o protocolo pelo portal. O botão existe (
btnExcluirProt<id>,
title="Excluir"), e o portal o renderiza com display: none. A condição que
o mostraria é:
```js
if ((dtGeracaoLote == null || dtGeracaoLote == '') && qtProcessoPendente == '0'
&& 'RE' != 'I' && 'S' != 'S') { … }
```
'S' != 'S' é sempre falso: para este prestador o botão nunca aparece.
Chamar excluirProtocolo() à força seria contornar uma decisão que o servidor
tomou — não foi feito. Retirada de lote, aqui, se pede à operadora.
- •Janela de data curta na consulta. A coluna "Data protocolo" vem da
dataRegistroTransacao do XML, não do instante do upload: o lote montado em
21/10 e enviado em 22/10 aparece com 21/10. Uma janela de poucos dias
perderia o próprio lote que acabou de subir; a consulta usa 60 dias para trás.
Elegibilidade pelo portal: não tem tela, e mesmo assim dá para fazer (medido 21/10/2026)
O conector de RPA declarava CHECK_ELIGIBILITY como "feito pelo webservice".
Isso dizia quem fazia, não que o portal não fizesse — e a diferença foi medida
com a conta do Indalab (indalab), navegando.
O menu inteiro do prestador, lido do frame menuLateral: Página inicial ·
Documentos TISS · Dossiê beneficiário · Beneficiário (cadastro de digital) ·
Contas médicas (upload XML, complemento, contas complementadas, demonstrativo
de retorno) · Recurso de glosa (upload XML, digitar, consultar protocolo) ·
Digitação de contas médicas · Solicitações pendentes (justificativa médica
on-line) · Autorização (consulta de autorizações) · Requisição para autorização
(requisitar, pesquisa de autorização, pesquisa de utilização) · Execução da
requisição · Comunicados · Relatórios · Alterar dados cadastrais · Privacidade ·
Configurações · Logoff.
Não existe tela de elegibilidade. Nada parecido com a "Validação de
Elegibilidade" da SulAmérica. Quem responde a pergunta é a **tarja da
carteirinha** — pls_pesquisaUtilizacao.obterValoresTarja.dwr, o mesmo
resolvedor que a consulta de utilização usa para achar NR_SEQ_SEGURADO_P.
Ele devolve, numa chamada só:
CD_USUARIO_PLANO_P 00265555068163003
NM_BENEFICIARIO_P SAMUEL DE PAULA BATISTA
DS_SITUACAO_BENEF_P Ativo
IE_SITUACAO_BENEF_P 2
DT_VALIDADE_P 28/02/2027
NM_PRODUTO_P Uniflex Vale - Apto co-participação 50%
NM_OPERADORA_P UNIMED BLUMENAU - COOPERATIVA DE TRABALHO MEDICO
IE_EXIGE_BIOMETRIA_P N
NR_SEQ_SEGURADO_P 1414064
NR_SEQ_TIPO_ACOMODACAO_P / NR_SEQ_PLANO_P / IE_TIPO_SEGURADO_P / CD_PESSOA_FISICA_P
O veredito sai de DS_SITUACAO_BENEF_P, não do código irmão.
IE_SITUACAO_BENEF_P vale 2 para "Ativo" — e essa é a ÚNICA situação já
medida. Um código cujo significado se conhece em um valor só não serve de
régua: decidir por ele chamaria de inelegível todo beneficiário em qualquer
situação ainda não vista. O código vai no detalhe, sem decidir nada.
É rápido — e isso muda o que dá para fazer com ela. 52 ms na medição, contra
os ~27 s da consulta de utilização. A utilização é operação de fila; a
elegibilidade serve em caminho síncrono de recepção.
Carteirinha que a operadora não conhece volta sem NR_SEQ_SEGURADO_P
(testado com 00260000000000000). O conector responde "não encontrado" em vez
de "inelegível": digitação errada e beneficiário excluído levam a ações opostas
no balcão.
Escopo é beneficiário, não procedimento. A tarja diz quem é e como está, não
o que pode ser feito. procedureCode/procedureCodes são ignorados, e
details.escopo = 'beneficiario' avisa quem consome — é a mesma limitação do
webservice TISS, que não tem onde colocar procedimento no XSD.
O webservice continua preferido. PREFERENCIA_CANAL manda WEBSERVICE antes
de RPA e nada aqui mudou isso. O portal é o caminho alternativo explícito
(canal: 'RPA'), para quando o webservice está fora ou a credencial TISS ainda
não saiu — a do portal o prestador tem no primeiro dia.
Descartado
- •Dossiê beneficiário (
pls_montarTelaDossieBenef.action) não foi aberto.
Pode trazer mais que a tarja (carências, coberturas), mas a tarja já responde
elegibilidade e custa uma chamada.
- •Dirigir a tela em vez de chamar o DWR: a tela é só cliente do mesmo
endpoint. Acrescentaria os modos de falha do DOM sem acrescentar informação.
CHECK_STATUS respondia pela guia do vizinho (medido 21/10/2026, removido)
O conector de RPA declarava CHECK_STATUS. Exercitado em produção com um
protocolo REAL do Indalab — 32488412, de um demonstrativo de análise — ele
voltou SUCCESS:
message Status do portal: Reprovada
portalStatus Reprovada mappedStatus PROCESSING
details { number: "18877049", date: "21/10/2026",
type: "Guia de solicitação SP/SADT",
stage: "Reprovada", totalResults: 514 }
A guia 18877049 não tem relação nenhuma com o protocolo 32488412. Duas causas,
somadas:
1. A tela está errada para a pergunta. O código navegava para
item_9 → subItem_9_2, "Pesquisa de autorização", que responde por número de
guia/requisição. Protocolo de lote é outra tela: *Digitação de contas
médicas → Consultar protocolo* (pls_montarTelaFiltroProtocolo.action), e
também existe a do recurso de glosa (pls_montarTelaConsultaProtocoloRecursoGlosa.action).
Nenhuma das duas foi percorrida.
2. O parser caía na primeira linha. Era
const row = statusData.match ?? statusData.firstResult — não achando o
protocolo entre as 514 linhas da grade, devolvia a primeira como se fosse a
resposta. Isso é pior do que não responder: vem com cara de certeza e alguém
age sobre ela.
O que foi feito: o fallback caiu (sem match → NOT_FOUND, dizendo quantas
linhas foram varridas e onde mora a tela certa), e a operação saiu de
supportedOperations com motivo declarado. O método checkStatus() foi
removido junto — o contrato de capacidades exige que método implementado seja
método declarado, e deixar um que responde errado só adiaria a próxima
descoberta. Quem responde CHECK_STATUS hoje é o webservice, que a declara.
A lição não é da Unimed, é do padrão: **toda operação que procura uma linha
numa grade precisa dizer o que faz quando não acha.** Vale reler os outros
conectores com esse olho.
FETCH_UTILIZATION: o parser de eventos finalmente viu evento (21/10/2026)
A única execução anterior (27/09) voltou total: 0 — sucesso que não provava o
parser. Com a carteirinha 00265555068163003 e janela de 12 meses: **28
eventos**, lidos certo, com prestador, data, código e descrição do
procedimento, e nextAllowedAt preenchido.
2025-11-04 10101039 Consulta Em Pronto Socorro HU- UNIDADE VILA NOVA
2026-01-19 40316521 Tireoestimulante (TSH) HEMOS - ALAMEDA
2026-01-20 10106146 Atendimento Ambulatorial Puericultura MESO MEDICAL GROUP
Confirma o que o cabeçalho do arquivo já dizia: **a abrangência é a operadora
inteira, não o prestador que pergunta** — os três exemplos acima são de outros
prestadores. Quem exibe isso em tela precisa dizer isso ao usuário.
Custo medido desta vez: 8,5 s (a medição de julho falou em ~27 s; a diferença
não foi investigada — pode ser tamanho da janela ou carga do portal).
CHECK_AUTH_STATUS pelo RPA exige DOIS campos
referenceId com só operatorGuideNumber é recusado na hora, com
MISSING_REFERENCE: o executor pede **operatorGuideNumber e
beneficiaryCard** juntos. Custou uma execução para descobrir.
Solicitar autorização pelo portal: funciona, e a regra NÃO é a do webservice (21/10/2026)
Medido ponta a ponta com a conta do Indalab: **requisição 18878335 criada e
finalizada**, beneficiário SAMUEL DE PAULA BATISTA, hemograma 40304361,
estágio Aberta, estimativa de coparticipação R$ 4,78.
A diferença que importa: o portal exige validação do beneficiário
A requisição não passa sem o token do app do beneficiário
(ds_token_telesaude — a aba "QRCode/Token" do app da Unimed) ou um motivo
declarado de ausência (cd_ausencia_val_benef_tiss, domínio TISS
dm_ausenciaValidacaoBeneficiario):
01 Beneficiário internado 05 Beneficiário em coleta domiciliar
02 Urgência/emergência 06 Material enviado ao prestador por terceiros
03 Intermitência/instabilidade de sistemas 07 Beneficiário não possui celular
04 Beneficiário se negou a transmitir o token
A mesma solicitação pelo webservice TISS passa sem nada disso (seção do topo:
a criação por webservice roda em produção desde setembro). Ou seja: os dois
canais não são alternativos para a mesma pergunta — **trocar de canal troca de
regra de negócio**. Quem migrar de um para o outro precisa saber disso.
O conector não tem padrão para o motivo, e isso é de propósito: cada opção é
uma afirmação de fato sobre o atendimento, gravada na operadora em nome do
prestador. Vem do pedido (beneficiaryValidationAbsenceReason) ou do cadastro da
conexão (connectorConfig.motivoAusenciaToken). Sem um dos dois, a operação
recusa antes de abrir o navegador, com TOKEN_BENEFICIARIO_OBRIGATORIO.
O fluxo, passo a passo
1. Menu item_9 → subItem_9_1. GET direto em pls_montarTelaRequisicaoAut.action
devolve a PÁGINA DE LOGIN mesmo com sessão válida — a tela só existe dentro
do frameset. (Elegibilidade e utilização, por contraste, são endpoints HTTP puros.)
2. Cabeçalho. O portal preenche sozinho o que dá:
- •
cd_prestador/nr_seq_prestador_solicjá vêm 6971 (Indalab) ao abrir; - •carteirinha digitada resolve nome, nascimento e produto;
- •CRM resolve o médico E o CBO — 27285 → LIDIA FERRAZ GRACIOLI, CBO
943
(MÉDICO PEDIATRA). Esse CBO é código interno do portal, não o CBO TISS
(225124) que o webservice usa. Como ele resolve sozinho, não há o que mapear.
- •obrigatórios que o contrato não carrega:
tp_acidente_servico(9 = não
acidente), ie_tipo_atendimento (23 = Exame) e ie_regime_atendimento_servico
(01 = Ambulatorial). Os dois últimos são configuráveis na conexão.
3. #btnSalvar → nasce a requisição e a tela vai para
pls_montarTelaSolicItens.action?nrSeqRequisicao=N. **O passo 1 já cria
registro na operadora:** falhar no passo 2 deixa requisição aberta e vazia lá.
Por isso o erro do passo 2 carrega o número.
4. Itens. ie_tipo_item = 8 (TUSS; 4 é PROPRIO). CD_PROCED resolve a
descrição no blur; QT_PROCED; botão #btn_add_proced, um por procedimento.
5. finalizarRequisicaoItens(n, '2', '0', '0') → "Solicitação finalizada com
sucesso", estágio e estimativa de coparticipação.
Três armadilhas que custaram caro
- •
fill()não resolve nada. Carteirinha, CRM e código de procedimento
resolvem no onblur, e a carteirinha ainda agenda atualizaCampoTarja no
onkeypress. fill() não digita tecla a tecla e el.blur() não dispara
handler em elemento sem foco. A tela fica em branco e parece que o portal não
respondeu.
- •O motivo de ausência precisa de Tab.
validaMotivoTelesaude()roda no
onblur do select, e é ela que tira o Obrigatorio do campo do token.
Escolher o motivo por selectOption e clicar em Continuar dá "É obrigatório
preencher o campo token" com o motivo já escolhido na tela.
- •O portal valida por
alert(). O Playwright fecha diálogo sozinho e em
silêncio: sem ouvinte de dialog, toda recusa vira "a tela não reagiu". Foi
assim que a primeira tentativa pareceu um clique que não funcionou.
Aberta é análise pendente, não autorização
Consultada logo depois pelo CHECK_AUTH_STATUS, a 18878335 voltou estágio
Aberta com quantidadeAutorizada: 0. Entrou em statusDoEstagio como 2
(em análise). Não confundir com autorizada.
Descartado
- •Dirigir o localizador de beneficiário (
abrirLocalizadorBenefReq, a lupa):
digitar a carteirinha e sair com Tab resolve o mesmo, sem popup.
- •Preencher
NR_PRESTADOR_ENTRADA_S(cód. prestador executante): está no
DOM mas invisível no fluxo de SP/SADT do Indalab, e a requisição finalizou sem
ele.
O menu inteiro, varrido (22/10/2026)
scripts/explore-unimed-menu.ts — 17 itens, 24 subitens, com o .action de
destino de cada um. Rodou porque três dos quatro naoSuportadas deste conector
eram "ninguém olhou" disfarçado de "não tem", e um deles era falso.
Armadilha: o frame menuLateral é destacado a cada clique — o menu se
remonta e o handle guardado morre com Frame was detached. Re-obter o frame
dentro do laço. (Mesma armadilha que a sessão do Bradesco achou no portal
dela.)
| Item | Subitem | .action |
|---|---|---|
| 1 Documentos TISS | — | pls_montarDocumentacao |
| 2 Dossiê beneficiário | — | — |
| 3 Beneficiário | Cadastro de digital | pls_montarTelaCadBiometriaBenef |
| 4 Contas médicas | Upload de contas médicas (XML) | pls_montarTelaConsultaTISS |
| Complemento contas médicas | pls_montarTelaComplementoContas | |
| Contas complementadas | pls_montarTelaProtocolosComplementados | |
| Demonstrativo de retorno | pls_montarTelaDemonstrativoPagamentoNovaTela | |
| 5 Recurso de glosa | Upload de recurso de glosa (XML) | pls_montarTelarRecursoGlosa |
| Digitar recurso de glosa | pls_montarTelaDigitacaoRecursoGlosa | |
| Consultar protocolo | pls_montarTelaConsultaProtocoloRecursoGlosa | |
| 6 Digitação de contas médicas | Digitar conta médica | pls_montarListaProtocolosDigitacao |
| Consultar protocolo | pls_montarTelaFiltroProtocolo | |
| 7 Solicitações pendentes | Justificativa médica on-line | pls_montarTelaAuditoria |
| 8 Autorização | Consulta de autorizações | pls_montarPastaConsultaAut |
| 9 Requisição para autorização | Requisitar autorização | pls_montarTelaRequisicaoAut |
| Pesquisa de autorização | pls_montarListaRequisicao | |
| Pesquisa de utilização | pls_montarTelaPesquisaUtilizacao | |
| 10 Execução da requisição | Executar requisição | pls_montarTelaExecucaoRequisicao |
| 11 Comunicados | Visualizar comunicados | pls_montarTelaComunicadoExterno |
| 12 Relatórios | Relatórios prestador | pls_filtrosRelatorio |
O que a varredura corrigiu
| Operação | Dizia | É | ||
|---|---|---|---|---|
EXECUTE_PREAUTH | "não foi procurada neste portal" | existe, item_10 | ||
SUBMIT_APPEAL | "feito pelo webservice" | 3 telas existem, item_5 | ||
CHECK_APPEAL_STATUS | "feito pelo webservice" | existe, subItem_5_3 | ||
CANCEL_GUIDE | "feito pelo webservice" | confirmado: 0 candidatas para `/cancel | estorn | exclu/` no menu inteiro |
Só o último era verdade — e agora é verdade medida, com data.
Descoberta de bônus: pls_montarTelaFiltroProtocolo.action, que numa sessão
anterior foi hipótese para CHECK_STATUS, é a consulta de protocolo da
digitação de contas (item_6), não do upload. A tela certa do CHECK_STATUS
segue sendo a lista de lotes de *Contas médicas → Upload*.
A tela de executar requisição, medida campo a campo (22/10/2026)
pls_montarTelaExecucaoRequisicao.action. Aberta pelo menu — GET direto num
.action deste portal devolve a página de login. Sem iframe aninhado
(diferente da tela de upload).
| Campo | Papel |
|---|---|
NR_SEQ_REQUISICAO | a requisição a executar — é a chave da tela |
CD_USUARIO_PLANO | carteirinha; limpa a tarja ao mudar (limparCamposTarja()) |
NM_SEGURADO, NR_SEQ_SEGURADO, campoTarja | nome e sequência, preenchidos pela tarja |
CD_PRESTADOR_EXEC, NM_PRESTADOR_EXEC, NR_SEQ_PRESTADOR_EXEC | prestador executante |
ds_token_telesaude | token do beneficiário |
cd_ausencia_val_benef_tiss | os mesmos 7 motivos de ausência de token da tela de requisição |
DS_BIOMETRIA, IE_VALIDACAO_FACIAL, TOKEN_VALIDACAO_FACIAL (hidden) | validação por digital/facial |
btnConsultar → montarListaExecucaoRequisicao() | carrega os itens da requisição |
btnConfirma → carregarItensSelecionados() | confirma os itens selecionados |
Consequência para a implementação: o fluxo é de dois passos (consultar a
requisição → selecionar itens → confirmar), e a regra de ausência de token é a
mesma que já vale na requisição — o motivo nunca é inventado, vem do pedido
ou do connectorConfig.motivoAusenciaToken da conexão.
O que faltava medir — a grade de itens e o que o botão final devolve — foi
medido no mesmo dia, com requisição aprovada de verdade. Ver a seção *O fluxo de
executar requisição, medido até a porta da escrita* logo abaixo.
O lote real que o Indalab sobe à mão, medido (22/10/2026)
CORREÇÃO. Esta seção dizia "o lote que a Unimed ACEITA". Era afirmação
minha, não medição — e estava errada. O arquivo ...4919_... foi
REJEITADO (protocolo 32568126,rejeitado_.png), porCM82eCM114:
duplicidade de guia, referenciando o protocolo 32568117 do lote
2469122, importado pelo Indalab 9 minutos antes.
>
Medido depois: o protocolo 32568117 está Integrado — 21 contas, **0
criticadas, 279 itens, 0 criticados**, zero bloqueios — e o arquivo dele é
...4918_252b225c...xml. Ou seja: o prestador subiu o lote 4918, que
entrou limpo, e depois o 4919 com as mesmas guias, que caiu por
duplicidade.
>
O conteúdo do arquivo que tenho é, então, o mesmo que a operadora aceitou —
mas isso só é verdade porque foi medido no 32568117. Repetir o erro de chamar
de "aceito" um arquivo cujo protocolo ninguém leu é a mesma falha que esta
página inteira documenta.
O usuário entregou um lote de verdade que o Indalab sobe à mão no portal:
00000000000000004919_34b93081ef2141a26bdb7c821774fcc7.zip. É a melhor
referência que existe nesta operadora — o único exemplo de arquivo do fluxo que
funciona.
Não está no repositório, e não deve estar. 21 guias com nome, carteirinha
e CPF de beneficiários reais. Fica fora do git; o que se guarda aqui são os
fatos medidos.
A convenção de nome
00000000000000004919_34b93081ef2141a26bdb7c821774fcc7.zip
└──────── numeroLote, 20 dígitos ────────┘ └──── hash do epílogo ────┘
- •O zip e a entrada dentro dele têm o mesmo nome, trocando a extensão.
- •
numeroLotecom zeros à esquerda até 20 dígitos. - •O hexadecimal não é md5 do nome nem do arquivo: é o
<ans:hash>do
epílogo TISS, o mesmo valor que está dentro do documento.
Adotado em nomeDoLoteComoAOperadoraEscreve(). O portal aceitou
lote_202610.xml no envio de 22/10/2026, então o nome não é validação — mas o
portal guarda o nome que recebe e o mostra no *Resumo importação*, e o nosso
aparecia como forasteiro numa tela cheia de <lote>_<hash>.
O nosso cálculo de hash está certo
calcularHashLote() reproduz 34b93081ef2141a26bdb7c821774fcc7
exatamente. É a 87ª confirmação do algoritmo, e a primeira contra um arquivo
que esta operadora aceitou nesta competência. Travado em teste.
Estrutura do lote aceito
| Fato | Valor |
|---|---|
<ans:Padrao> | 4.01.00 (XSD tissV4_01_00.xsd) |
tipoTransacao | ENVIO_LOTE_GUIAS |
sequencialTransacao | 4919 — igual ao numeroLote |
codigoPrestadorNaOperadora | 6971 |
| guias | 21 guiaSP-SADT, 279 procedimentos |
numeroGuiaPrestador | 6 dígitos numéricos, 262765–292767 (sequencial do Indalab) |
numeroGuiaOperadora / senha | presentes em 19 das 21 — duas guias sem autorização prévia |
tipoAtendimento | 23 em todas |
caraterAtendimento | 1 (eletivo) |
indicacaoAcidente | 9 |
| encoding | ISO-8859-1, com espaços na declaração (version = "1.0") |
Isto confirma por medição a regra que o CM104 já tinha mostrado: **o
numeroGuiaPrestador desta operadora é numérico**, e o padrão do prestador é
sequencial de 6 dígitos — não competência, não alfanumérico.
E dá o padrão de numeroLote: sequencial (4919), não a competência
(202610) que o nosso lote de teste usou.
A divergência de versão TISS — três fontes discordando
| Fonte | Diz |
|---|---|
| lote que a Unimed aceita | 4.01.00 |
lis_lotes_envio.versaoTiss (coluna) | 4.01.00 (default) |
lis-tiss-builder.ts (const PADRAO) | 4.02.00, fixo no código |
O nosso lote de teste foi protocolado com 4.02.00 e a única crítica foi
CM104 — então a versão não barrou a importação.
Resolvido em 22/10/2026: a versão virou parâmetro
Antes de mexer, medi a compatibilidade: **o lote aceito valida nos XSDs
4.01.00 E 4.02.00, sem um único erro.** Logo a escolha não muda a estrutura
do documento — só o que ele declara e o que registramos sobre ele. Isso tornou a
mudança segura.
- •
const PADRAOsaiu do código. A versão éBuildSpSadtOptions.versao, vem de
HealthPlan.tissVersion (uma por convênio, porque é a operadora que diz o que
recebe) e cai em 4.01.00 quando não há valor.
- •O XSD é conferido na mesma versão que o XML declara. Antes validava-se em
4.02.00 fixo: o veredito era sobre um documento que não era o enviado.
- •
lis_lotes_envio.versaoTisspassa a guardar o que foi usado de verdade. - •Unimed Blumenau não tem linha em
health_plans(nenhumansCode334561),
então ela cai no fallback: os lotes dela passam a sair 4.01.00, igual ao
do Indalab.
Dois problemas nos dados que isso desenterrou
A versão agora vem do banco, e o banco não está limpo (medido em produção):
| Problema | Exemplo |
|---|---|
| Convênios duplicados com versões diferentes | Bradesco 005711 aparece 3× — 4.01.00, 4.02.00, 04.01.00; SC Saúde 757444 4× |
| Versões com zero à esquerda | 04.01.00, 03.02.01, 04.03.00 |
O segundo é silencioso e caro: versão que não casa com nenhuma pasta de XSD faz
validateAgainstXsd pular a validação e devolver valid: true — e o lote
sai marcado VALIDADO sem ninguém ter validado nada. normalizarVersaoTiss()
apara o zero do primeiro segmento (e só dele: a primeira tentativa usava
/\b0(\d)/g e transformava 4.01.00 em 4.1.0, versão que não existe).
O primeiro ficou repetível, não resolvido: findHealthPlanByAns ganhou
orderBy updatedAt desc. Sem ordenação, qual linha ganhava dependia do plano de
execução do Postgres — e um lote podia mudar de versão entre duas chamadas
idênticas. A duplicata em si é dado, e está na lista de pendências.
O primeiro lote ACEITO pelo sistema (22/10/2026)
Teste real pedido pelo usuário: um hemograma para o beneficiário Samuel.
Protocolo 32570079, Aceito, zero críticas — medido na tela, não inferido
do ícone:
Contas apresentadas: 1 Contas criticadas: 0
Itens apresentados: 1 Itens criticados: 0
Valor apresentado: 8,45 Valor criticado: 0,00
Mensagens de aviso: 0 Mensagens de bloqueio: 0
Arquivo XML: 00000000000000202612_2de6164e478aebda37e182586628a6a3.xml
O nome do arquivo confirma a convenção adotada no mesmo dia.
Duas transmissões, uma variável de diferença
| Lote | Protocolo | numeroGuiaPrestador | CBO | Desfecho |
|---|---|---|---|---|
| 202610 | 32568556 | TESTEPEDIDO01 | — | CM104 — número de guia inválido |
| 202611 | 32570041 | 292800 | 999999 | CM342 — CBO inválido |
| 202612 | 32570079 | 292801 | 225124 | ACEITO, 0 críticas |
A armadilha do CBO — copiar o arquivo que funciona não basta
O lote que o prestador sobe à mão usa CBOS 999999 e é integrado. Copiei
999999 dele e tomei CM342. A diferença não está no CBO, está em **quem é o
solicitante**:
| Lote do prestador (4918, integrado) | Nosso (202611, CM342) | |
|---|---|---|
contratadoSolicitante | cpfContratado 94758450978 | codigoPrestadorNaOperadora 6971 |
nomeContratadoSolicitante | CINTIA ADRIANA SCHROEDER (médica) | o laboratório |
CBOS | 999999 | 999999 |
Quando o solicitante é pessoa, a Unimed aceita o CBO genérico. Quando é o
próprio prestador (PJ), exige CBO real. Com 225124 o lote entrou.
Isto virou regra de código, não só nota: regras-da-operadora.ts recusa o lote
antes de transmitir, com o código da crítica e a data da medição. É o lugar
que faltava para as regras que são da operadora e não do TISS — e ele nasceu com
as duas que custaram um lote cada.
O que ainda NÃO está provado
- •O lote aceito tem 1 guia e 1 item. O do prestador tem 21 e 279. Volume
real nunca passou pelo nosso envio.
- •
Aceito(aceitar.gif) não éIntegrado(enviado.png). O do prestador
chegou a Integrado; o nosso foi medido em Aceito. Falta ver a transição.
- •Nenhum demonstrativo foi recebido para este lote: o ciclo até o dinheiro
continua aberto.
O fluxo de executar requisição, medido ponta a ponta (22/10/2026)
EXECUTE_PREAUTH não estava implementada porque **a medição parava no primeiro
campo**: faltava uma requisição aprovada para exercitar a tela. O motivo no
conector dizia isso, e estava certo sobre as *nossas* requisições e errado sobre
o portal. Medido, autorizado e executado no mesmo dia: hoje a operação está
implementada em execute-preauth.ts.
Primeiro: existem requisições aprovadas, e muitas
A afirmação anterior ("falta requisição autorizada") era verdadeira sobre as
*nossas*, não sobre o portal. Censo de 31 dias pela tela *Pesquisa de
autorização* (subItem_9_2), tipo de consulta por requisição, guia SP/SADT:
| Estágio | Qtd |
|---|---|
| Aprovada | 407 |
| Reprovada | 79 |
| Parcialmente aprovada | 8 |
| Cancelada | 5 |
| Aguardando justificativa do médico | 2 |
| Auditoria intercâmbio | 1 |
| Auditoria | 1 |
| Total | 503 |
Das 407 aprovadas, 402 já têm guia gerada e **5 estão pendentes de
execução** (18720485, 18680132, 18679759, 18679729, 18676274 — de 22 a
28/09/2026, validade até 27/11/2026).
Duas armadilhas de vocabulário. (1) O estágio da requisição tem lista
própria (ieEstagioR: Aprovada, Parcialmente aprovada, Reprovada, Auditoria,
Cancelada, Aguardando envio intercâmbio) e é diferente do estágio da guia
(ieEstagioG: Autorizado sem glosa, Autorizado com glosa, Autorizado
parcialmente, Negado, Em auditoria...). Confundir os dois leva a filtrar pela
lista errada. (2) "Aberta" não está em nenhuma das duas listas — e é
exatamente o estágio em que as nossas requisições param. Ver o item aberto no
fim desta página.
A tela só responde se for clicada
Forjar a URL do ajax da pesquisa — pls_montarListaRequisicao.action?...&ieEstagio=6
— devolve a página de login, de forma reprodutível, para ieEstagio 6, 10 e
vazio; e devolve a grade de verdade para o 5. Não é sessão expirada: a mesma
sessão serve o 5 no meio dos outros. Então a pesquisa é feita na tela
(atualizarConsulta()), não por URL montada.
Os cinco passos
| Passo | O que acontece | Escreve? |
|---|---|---|
| 1 | Menu item_10 → subItem_10_1 abre pls_montarTelaExecucaoRequisicao.action | não |
| 2 | Carteirinha em CD_USUARIO_PLANO + Tab → a tarja preenche NM_SEGURADO e NR_SEQ_SEGURADO; CD_PRESTADOR_EXEC/NR_SEQ_PRESTADOR_EXEC já vêm com 6971 | não |
| 3 | btnConsultar → montarListaExecucaoRequisicao() | gera um nº de lote |
| 4 | marcar o checkbox do item → verificaCheck() habilita o botão final | não |
| 5 | btnConfirma, rotulado "Gerar guia" → carregarItensSelecionados(lote) | sim |
Passo 3 valida nesta ordem, por alert():
1. É necessário informar um beneficiário. — a requisição sozinha não basta:
foi o primeiro alerta que a tela devolveu, com NR_SEQ_REQUISICAO preenchido
e a carteirinha vazia.
2. É necessário informar um prestador.
3. É necessário validar o token ou selecionar um motivo de ausência. — só
quando a linha .token está visível. Para o Indalab ela veio
display: none e ds_token_telesaude com value="undefined" e readonly.
4. pls_execucaoRequisicao.validaBenefReq(requisição, segurado) — devolve
ERRO<mensagem> se o beneficiário não for o da requisição.
Passo 3 tem efeito colateral: cada consulta gera um "Lote de consulta"
sequencial no portal (medido: 20971272 e, na consulta seguinte, 20971274). Ou
seja, consultar não é de graça — consome número de lote de execução. Sondar em
loop deixa rastro no sistema da operadora.
A grade: só o que ainda não foi executado
Tabela #tabelaItensExecucao, título "Requisições não executadas":
tr.registroLista#reg<nrSeqItem>
└ input[type=checkbox] value="<nrSeqItem>,P" onclick="verificaCheck()"
└ colunas: Item | Requisição | Dt requisição | Dt validade | Código |
Descrição | Qt solic | Qt aprov | Qt exec | Qt pend | Médico | Tipo de guia
└ hidden: #tipoGuia<nrSeqItem> = "2" (SP/SADT) · #caraterAtend<nrSeqItem> = "E" (eletivo)
└ link "Detalhes" → montarModalDetalhesReq(requisição, tipoGuia, nrSeqDetalhe)
O ,P do checkbox é o tipo do item — P de procedimento.
É isto que explica o botão desabilitado. Na requisição 18885492 (aprovada,
guia 95246603 já gerada) a grade veio vazia e "Gerar guia" ficou
disabled. Na 18720485 (aprovada, sem guia) a grade trouxe a linha do hemograma
40304361 com Qt aprov 1 / Qt exec 0 / Qt pend 1. Ou seja: **grade vazia =
requisição já executada**, e não "tela quebrada".
O que o botão final faz, lido no JS da própria tela
bibliotecas/js/plsExecucaoRequisicaoAutorizacao.js (62 KB, baixado e lido —
leitura pura, sem clicar). carregarItensSelecionados(nrSeqExecucaoLote):
1. para cada checkbox marcado: pls_execucaoRequisicao.plsMarcarItemExecusao(lote, item, ieLimparExec);
2. validaRegraExecucaoTotal(lote);
3. ramo de biometria/facial, condicional em ieBiometria,
nrSeqRegraBiometriaFacial, ieTipoBiometria e iePermiteExecSemBiometria.
Pode chamar processoReconhecimentoFacial() ou abrirBiometria() e **parar o
fluxo** com É obrigatório capturar a digital do beneficiário.;
4. se passou: navega para a segunda tela,
pls_montarListaItensExec.action?nrSeqPrestadoExec=…&nrSeqSegurado=…&nrSeqExecucaoLote=…;
5. lá, carregarGeracaoGuia() → confirmaGeracaoGuia(listaItensExecucao, lote, …)
é o que gera a guia, item por item, com quantidade executada e médico.
A execução autorizada, e a guia que saiu dela
O usuário autorizou executar uma das cinco, a de menor valor. Das cinco, só
duas tinham item liberado:
| Requisição | Item liberado | Itens cancelados |
|---|---|---|
| 18720485 | hemograma 40304361 | 0 |
| 18676274 | cariótipo de sangue 40501051 | 0 |
| 18680132 | — | 20 |
| 18679759 | — | 32 |
| 18679729 | — | 27 |
Detalhe que muda leitura: três das cinco estão Aprovada no cabeçalho e
têm todos os itens Cancelado. Olhar só o estágio da requisição diz que
há trabalho a executar onde não há. Quem decide execução tem que ler o item.
Escolhida a 18720485 (hemograma, o mais barato dos dois). Resultado, 22/10/2026:
requisição 18720485 → lote de consulta 20971321 → item 63241529
→ "Confirmar geração de guias"
→ GUIA DE SERVIÇO 95249229 · senha 95249229 · validade 27/11/2026
Conferido fora da tela que gerou: a *Pesquisa de autorização* passou a
mostrar, na linha da 18720485, `Guia: 95249229 / Dt execução: 22/10/2026 /
Prestador: LABORATORIO DE ANALISES CLINICAS INDALAB LTDA`. E a requisição, que
antes vinha com quantidadeAutorizada: 0, agora vem 1.
O que a tela 2 traz pronto — e por que isso importa
pls_montarListaItensExec.action, por item e por requisição:
| Campo | Veio preenchido com |
|---|---|
#ed_execucao_<item> | 1 — a quantidade pendente |
#ed_ie_tipo_atend_<requisição> | 23 = Exame |
#ed_ie_regime_atend_<requisição> | 01 = Ambulatorial |
#ed_cd_medico_<item> | vazio — e ieMontarMedicoItens = 'N', então não é exigido |
| botão | "Confirmar geração de guias" → carregarGeracaoGuia('[<item>]', <lote>, '', <segurado>, 'N', '') |
O conector não escolhe nenhum desses valores. Tipo de atendimento é
afirmação sobre o que foi feito no paciente; o portal já traz o certo para o
fluxo do laboratório, e a implementação só sobrescreve se o cadastro da conexão
mandar (connectorConfig.tipoAtendimentoPortal /
regimeAtendimentoPortal). Se a tela vier sem tipo de atendimento, a
implementação recusa com TIPO_ATENDIMENTO_OBRIGATORIO em vez de escolher um.
O que a execução NÃO prova
- •Biometria/facial nunca foi exercida. Para este prestador o ramo não
disparou: a linha .token veio display: none e nenhum alerta de digital
apareceu. Se a regra mudar, a implementação recusa com BIOMETRIA_EXIGIDA —
RPA headless não captura digital. Isso é tratamento, não medição.
- •Nada aqui fala de dinheiro. A guia de serviço é o registro do
atendimento. O faturamento continua indo pelo lote.
- •Uma execução, um item. Execução com vários itens, quantidade parcial e
item de pacote (uncheckPacote<item>, mantemPacoteCheck) seguem sem medição.
A etapa de glosa e documentos, varrida (22/10/2026)
A coluna estava vazia nas duas pontas — e a causa era diferente em cada
operação. Duas afirmações nossas eram falsas, uma tela **existe e não
serve**, e duas foram implementadas.
A lista de webservices estava a um clique
O menu item_1 "Documentos TISS" (pls_montarDocumentacao.action) publica
os webservices da operadora. São 12:
| Serviço | Operação |
|---|---|
tissLoteGuias | SUBMIT_BATCH |
tissSolicitacaoStatusProtocolo | CHECK_STATUS |
tissSolicitacaoDemonstrativoRetorno | FETCH_RETURNS |
tissVerificaElegibilidade | CHECK_ELIGIBILITY |
tissSolicitacaoProcedimento | REQUEST_AUTH |
tissSolicitacaoStatusAutorizacao | CHECK_AUTH_STATUS |
tissCancelaGuia | CANCEL_GUIDE |
tissRecursoGlosa | SUBMIT_APPEAL |
tissSolicitacaoStatusProtocoloRecurso | CHECK_APPEAL_STATUS |
tissLoteAnexo | SUBMIT_ATTACHMENT |
tissEnvioDocumentos | SUBMIT_DOCUMENT |
tissComunicacaoBeneficiario | COMMUNICATE_BENEFICIARY (decisão de não fazer) |
CORREÇÃO. O conector SOAP declarava, para os dois destacados: *"Serviço
não publicado no webservice TISS 4.02.00 da operadora"*. Era falso. Os dois
estão na lista da própria operadora, e os WSDL respondem **200 nas duas
bases** —TISS40200OPSeTISS40300OPS—, com
tissLoteAnexo_Operation/loteAnexoWSe
tissEnvioDocumentos_Operation/envioDocumentoWS. Ninguém tinha aberto a
página que a operadora mantém exatamente para isso.
Os dois foram implementados no conector SOAP, reusando as operações TISS
compartilhadas que já existiam (tiss-operations/submit-attachment-batch.ts e
tiss-operations/submit-document.ts). Nenhum dos dois foi exercitado: o
laboratório não envia anexo de quimio/radio/OPME, e não houve documento clínico
para enviar.
Recurso de glosa pelo portal: três telas
item_5 "Recurso de glosa":
| Subitem | Tela | Para quê |
|---|---|---|
subItem_5_1 | pls_montarTelarRecursoGlosa.action | upload do XML |
subItem_5_2 | pls_montarTelaDigitacaoRecursoGlosa.action | digitar o recurso |
subItem_5_3 | pls_montarTelaConsultaProtocoloRecursoGlosa.action | consultar protocolo |
O upload é o mesmo desenho da tela de contas médicas: pastas no topo e um
iframe pasta_destino. As pastas são Protocolos, Contas, Procedimentos,
Resumo, Glosas retornadas e Upload — só a última usa setarPasta
(setarPasta('upload', 'pls_telaUploadRecursoGlosa.jsp')); as outras têm função
própria (abrirPastaProtocolos(), abrirPastaConsultaGlosasRetornadas()…).
Dentro dela, form_importar posta em pls_importarXMLRGTISS.action — RG
de recurso de glosa, .action diferente do lote de guias. **As regras do
arquivo são da tela**, texto literal dela:
- •*"somente arquivos .zip são aceitos"* — e o
enviar()da página confere a
extensão e barra com alert() antes de postar;
- •*"são aceitos no máximo 10 arquivos .xml dentro do arquivo .zip"*;
- •*"não é permitido caracteres especiais no nome dos arquivos .xml"*.
A consulta de protocolo filtra por data (vem com os últimos 2 meses), status,
prestador e lote de recurso; o botão é btnVisualizar → consularProtocolo()
(sim, com o erro de digitação). Grade: `Protocolo | Prestador | Status | Origem
| Dt recurso | Lote recurso. Os sete status vêm do ieStatusFiltro`:
1 Recebido, 2 Em análise, 3 Liberado para pagamento, 4 Encerrado sem pagamento,
5 Analisado e aguardando liberação para pagamento, 6 Pagamento efetuado,
9 Em digitação.
O que NÃO foi possível medir: uma linha. Para o Indalab a tela respondeu
"Sem registros encontrados" — ele não tem recurso nesta operadora. Por
isso o leitor da grade acha a coluna pelo título do cabeçalho, não por
posição: cabeçalho é medido, posição seria chute. E o envio **não inventa
protocolo**: devolve que o arquivo foi aceito e manda consultar.
O relatório de glosas existe, gera — e eu o rodei errado
CORREÇÃO, no mesmo dia. Esta seção dizia: *"a glosa deste prestador não
sai por aqui"*, porque o relatório voltou com 139 bytes. O erro era meu. A
tela traz o filtro Prestador como um <select> sem nenhuma opção — e
eu o deixei em branco. Relatório sem prestador devolve só o cabeçalho.
>
Com NUMBER_NR_SEQ_PRESTADOR = 6971, o mesmo relatório, na mesma janela,
devolveu 2.435 linhas e R$ 32.982,33. Rodado de 01/2024 a 22/10/2026:
6.953 itens glosados, R$ 84.738,76.
>
"Voltou vazio" não é medição da operadora enquanto o filtro obrigatório não
foi preenchido. É o mesmo erro que esta página cobra dos outros — e que ela
própria cometeu.
item_12 > subItem_12_1 "Relatórios prestador" (pls_filtrosRelatorio.action)
tem 21 relatórios. Três interessam:
| Código | Relatório | Parâmetros | Resultado medido |
|---|---|---|---|
| 3805 | Analítico do Demonstrativo de Glosas | prestador, data inicial, data final | 6.953 itens, R$ 84.738,76 (01/2024–10/2026) |
| 3364 | Analítico do Demonstrativo de Pagamento | prestador, competência, lote | 5.032 linhas (competência 09/2026) |
| 2038 | Status importação recurso de glosa | guia do prestador | PDF, 50 KB |
Os dois analíticos só respondem com o prestador preenchido: o de pagamento
devolveu 158 bytes sem ele e 1,6 MB com ele. Mesmo defeito, mesma causa.
Como o download funciona: gerarRelatorioServlet() troca a action do form
para GeraRelatorio, põe target='_blank' e submete. Vem
RELATORIO_CPLS_3805_<timestamp>.xls que não é XLS — é TSV latin-1, 15
colunas: `Prestador, Medico, Data, Nm segurado, Cd usuario, Nr documento, Qt
item, Nr crm, Cd item, Ds item, Motivo glosa, Parecer, Vl glosa, Prest envio, Dt
item`.
De onde vem o prestador: do próprio portal. A tela de executar requisição
chega com CD_PRESTADOR_EXEC e NR_SEQ_PRESTADOR_EXEC preenchidos (ambos
6971 aqui), e abri-la não escreve nada — o lote de consulta só nasce no
btnConsultar. Pedir isso em cadastro seria transformar em configuração algo
que o portal já sabe. connectorConfig.nrSeqPrestadorRelatorio sobrescreve.
Nota sobre os dois campos:CDeNR_SEQsão iguais neste prestador, então
não dá para saber qual dos dois o relatório quer. A implementação prefere
o NR_SEQ (é o nome do parâmetro) e cai no código quando falta. Em prestador
onde os dois divergirem, isso precisa ser medido de novo.
O que o analítico mostrou (01/2024 a 22/10/2026)
| Motivo | Itens | Valor |
|---|---|---|
| 1817 — Cobrança de procedimento incluso no principal | 3.746 | R$ 38.019,60 |
| CM566 — Cobrança fora do prazo — credenciados | 1.982 | R$ 31.644,36 |
| 2708 — Quantidade incompatível com o procedimento | 696 | R$ 8.023,41 |
| 1705 — Valor apresentado a maior | 340 | R$ 4.297,94 |
| demais (duplicidade, outros, fora de validade) | 189 | R$ 2.283,44 |
| Total | 6.953 | R$ 84.738,76 |
Dois fatos que saltam e não são técnicos:
- •Colesterol LDL (40301591) sozinho é R$ 34.053,90 em 3.110 itens — quase
metade de tudo, quase sempre por "incluso no procedimento principal". O mesmo
código e o mesmo motivo que geraram o primeiro recurso na Clinipam.
- •R$ 31.644,36 é perda por prazo, não por mérito: `CM566 - cobrança fora do
prazo - credenciados`. Isso não se recursa discutindo clínica; evita-se
faturando no prazo.
Como a etapa ficou
| Operação | RPA (portal) | Webservice |
|---|---|---|
SUBMIT_APPEAL | implementada (upload XML) | implementada |
CHECK_APPEAL_STATUS | implementada (consulta de protocolo) | implementada |
SUBMIT_ATTACHMENT | não é a mesma coisa que "Anexar arquivo" do item | implementada |
SUBMIT_DOCUMENT | nenhuma tela no menu | implementada |
FETCH_GLOSA_REPORT | implementada (relatório 3805, com prestador) | vem no demonstrativo de retorno |
Das cinco, FETCH_GLOSA_REPORT foi exercitada pelo conector e trouxe
6.953 itens. As outras quatro não: azul é a cor certa para elas.
O logout no finally pode apagar o comprovante (22/10/2026)
Achado em outra operadora, no mesmo dia, e corrigido aqui antes de custar:
toda operação deste conector chama doLogout() num finally. Se o logout
lançar, a exceção substitui o valor de retorno — e o retorno é o
comprovante.
Na Clinipam isso aconteceu de verdade: um recurso de glosa aceito pela
operadora (protocolo 736783, R$ 85) virou execução FAILED, porque o "Sair"
ficou atrás de um diálogo aberto e o clique estourou na saída. O recurso estava
feito.
Aqui as operações de escrita devolvem exatamente esse tipo de número: protocolo
do lote, requisição criada, guia de execução gerada, recurso transmitido.
Vermelho em operação que deu certo manda fazer de novo — e lote ou recurso em
duplicidade é problema com a operadora (foi CM82/CM114 no lote 4919 do próprio
prestador).
Correção: doLogout() do conector tenta encerrar a sessão e **engole a
falha com log**. Sessão pendurada no portal expira sozinha; comprovante perdido
não volta. Preso em logout-nao-derruba.test.ts, inclusive o caso inverso — erro
real da operação continua propagando.
As quatro operações que fecharam pela fila de produção (22/10/2026)
Até aqui, quase tudo tinha sido exercitado por script. Isso prova o
conector e não prova o caminho: fila, executor, config da conexão, persistência.
Estas quatro rodaram pela rota de verdade (POST /api/portal-connect/executions),
com a conexão do Indalab, e estão em portal_executions como SUCCESS.
| Operação | Canal | Resultado |
|---|---|---|
REQUEST_AUTH | webservice | requisição 18888000, AUTORIZADA na hora |
EXECUTE_PREAUTH | portal | guia de serviço 95249337 |
CHECK_APPEAL_STATUS | portal | protocolo 41525, Em digitação |
FETCH_GLOSA_REPORT | portal | 2.459 linhas de glosa |
O webservice autoriza; o portal deixa "Aberta"
Este é o achado que destrava o ciclo. A mesma solicitação — Samuel, hemograma
40304361 — teve destinos opostos conforme o canal:
- •pelo portal (
REQUEST_AUTHRPA): ficaAberta,quantidadeAutorizada: 0,
e some da *Pesquisa de autorização*; as anteriores viraram Cancelada;
- •pelo webservice (
tissSolicitacaoProcedimento, TISS 4.03): volta
AUTORIZADA na resposta, com quantidadeAutorizada: 1 e número de guia da
operadora — 18888000, pronta para executar.
Ou seja: a execução de pré-autorizada não dependia de pedir autorização a
terceiros nem de requisição antiga do prestador. Dependia de pedir pelo canal
certo. Fluxo fechado de ponta a ponta com dado nosso:
REQUEST_AUTH (webservice) → requisição 18888000 AUTORIZADA
→ EXECUTE_PREAUTH (portal) → guia de serviço 95249337
O tipo de atendimento não veio preenchido — e o conector recusou
A primeira tentativa de EXECUTE_PREAUTH pela fila falhou de propósito:
A tela de execução não trouxe o tipo de atendimento preenchido e ele é
obrigatório. Informe-o no cadastro da conexão (connectorConfig.tipoAtendimentoPortal)
— o conector não escolhe tipo de atendimento.
Diferença medida: requisição criada no portal chega na tela de execução com
tipo = 23 (Exame) e regime = 01 (Ambulatorial) preenchidos; requisição criada
pelo webservice chega com os dois vazios. O conector não inventa — tipo
de atendimento é afirmação sobre o que foi feito no paciente.
Resolvido onde deve ser resolvido, no cadastro da conexão:
{ "tipoAtendimentoPortal": "23", "regimeAtendimentoPortal": "01" }
Não é chute: são os mesmos valores que o próprio portal preenche para este
prestador quando ele mesmo cria a requisição. Na segunda tentativa saiu a guia.
SUBMIT_APPEAL pelo webservice: três tentativas, a mesma recusa
Caso escolhido (o mais recente e o mais comum da base): protocolo 32568032,
lote 4912, guia prestador 292616 / operadora 95234592, item 35, Colesterol LDL
40301591, glosa 1817 ("incluso no procedimento principal"), R$ 11,26.
| # | O que mudou | Resposta da operadora |
|---|---|---|
| 1 | numeroGuiaOrigem = guia do prestador (292616) | Número da guia inválido (1307) |
| 2 | numeroGuiaOrigem = guia da operadora (95234592) | Número da guia inválido (1307) |
| 3 | nosso numeroGuiaRecGlosaPrestador em 6 dígitos | Número da guia inválido (1307) |
Uma variável por tentativa, como no lote. Nenhuma das três era a causa — e
é aí que parar de tentar vale mais que a quarta tentativa.
A pista está na tela. O detalhe do protocolo de recurso
(pls_montarTelaDigitacaoRecursoGlosaDetalhe.action?nrSeqProtocoloRec=41525&ieStatus=9)
tem exatamente dois botões: *Voltar* e "Vincular contas"
(vincularContasRecurso). Ou seja: no modelo desta operadora, o recurso **não
nasce citando uma guia qualquer** — ele nasce de um protocolo e depois se
*vinculam as contas* que ela mesma lista como recursáveis. O 1307 é
provavelmente a guia não estar nessa lista, e a lista é que precisa ser medida.
Hipótese a derrubar na próxima sessão: recurso só aceita conta de
demonstrativo de pagamento; o nosso caso veio do demonstrativo de análise
(prévia de glosa), que talvez ainda não seja recursável.
O 1307 resolvido: o recurso é por CONTA e por ITEM DA CONTA (02/11/2026)
A hipótese acima caiu, e a do número de guia também. Abri "Vincular contas"
no protocolo 41525 com a credencial do Indalab e li o que a operadora oferece:
guia prestador 292616 → conta 70700373 (guia operadora 95234592)
item 140790038 — 40301591 Colesterol LDL glosado R$ 11,26
item 140790039 — 40302695 Colesterol VLDL glosado R$ 8,28
Nenhum dos três números de guia que tentamos estava errado. A guia do
prestador 292616 *acha* a conta (foi o filtro que usei), a guia da operadora
95234592 aparece na linha, e o protocolo 32568032 é válido — filtrando por ele
voltam três contas (70700371, 70700372, 70700373). O que faltava era outro
nível: a operadora endereça recurso por nr_seq_conta e
nr_seq_conta_proc, numeração interna dela que **o demonstrativo não
carrega**. Nenhuma combinação de guia e protocolo chegaria lá.
Conferido do nosso lado: para a guia 292616 o banco tem sequencialItem 1 e 2 e
codigoTabela nulo. A tentativa de 23/10 mandou sequencialItem: '35' — número
que não existe nem na nossa conciliação nem na conta dela.
Por isso o recurso tem um passo de LEITURA antes da escrita
É o que a própria tela da operadora faz: filtra por guia, recebe a conta com os
itens recursáveis, e só então escreve. A rota é GET e devolve fragmento de
tabela:
pls_montarTelaDigitacaoNovoRecursoGlosaConsulta.action
?nrSeqProtocolo=&nrSeqConta=&cdGuia=&cdGuiaPrestador=292616
&dtInicio=01/01/2026&dtFim=02/11/2026&ieTipoData=CT&nrSeqProtocoloRec=41525
- •o período é obrigatório (
consultar()alerta sem ele) e filtra a data da
CONTA, não a do atendimento — por isso o conector abre a janela 180 dias
antes do item mais antigo: estreitar devolve "sem registros", que é
indistinguível de "não é recursável";
- •
ieTipoDataaceitaCT(conta) eRP(recebimento do protocolo). No teste
com o protocolo 32568032 os dois devolveram o mesmo conjunto de 3 contas;
- •um dos quatro — protocolo, conta, guia ou guia do prestador — é obrigatório
(ieObrigaFiltro=S);
- •cada item traz
vl_glosano atributo do checkbox: é o teto do recurso
daquele item.
O fluxo completo da digitação, função por função
| # | Chamada | O que faz | Escreve? |
|---|---|---|---|
| 1 | menu item_5 → subItem_5_2 → pls_montarTelaDigitacaoRecursoGlosa.action | a grade dos protocolos de recurso | não |
| 2 | DWR gerarProtocolo() — sem argumento | cria o protocolo | sim |
| 3 | ...NovoRecursoGlosaConsulta.action (GET) | conta + itens recursáveis | não |
| 4 | DWR gerarRecurso(dadosItens, nrSeqProtocoloRec) | vincula os itens | sim |
| 5 | DWR liberarProtocolo(nrSeq) | entrega à operadora | sim |
DWR em /PlanodeSaude/dwr, classe pls_recursoGlosaDigitacaoWebAction.
Retornos medidos: gerarProtocolo e gerarRecurso devolvem OK…;
liberarProtocolo devolve OK, SM ("não é possível finalizar um
protocolo vazio") ou a mensagem de erro da operadora.
O passo 5 é o que ninguém adivinharia. Sem liberarProtocolo o recurso fica
Em digitação e a operadora não o vê — é exatamente o estado do 41525,
criado à mão em 22/10/2026 e ainda em digitação dez dias depois. Um conector que
parasse no passo 4 reportaria sucesso com o recurso parado.
dadosItens: a chave é o registro inteiro
O mapa que o passo 4 recebe tem a justificativa no VALOR e treze campos
concatenados na CHAVE:
"<conta>;<itemDaConta>;P;<valor BR>;00;00;N;N;N;N;N;N;N" → justificativa
"70700373;140790038;P;11,26;00;00;N;N;N;N;N;N;N" → "Dosado por método direto…"
P é procedimento e M é material (vem do atributo tipo do checkbox). Os
doze últimos campos são odontologia — região da boca, dente e sete faces — e o
portal só os exige quando tipo_guia é 11; para procedimento médico vão
fixos, como a tela dele mesmo monta.
Limites, lidos nos atributos da tela
| O quê | Valor | Onde |
|---|---|---|
| justificativa por item | 500 | maxlength da textarea ds_justificativa_item_<item> |
| justificativa de conta | não existe | nenhum ds_justificativa_conta_* na tela |
| valor recursado | teto = vl_glosa do item | gerarRecurso recusa com alert |
| lote por motivo de glosa | não há | o filtro é protocolo, conta ou guia |
A ausência da justificativa de conta tem consequência de contrato: nesta
operadora protocolAppeal/textoGuia não tem onde entrar — o recurso é por
item e só.
O que ficou implementado
recursar-digitacao.ts, e submitAppeal do RPA passou a bifurcar pelo
CONTEÚDO do pedido: com xmlContent vai para o upload de ZIP (submit-appeal.ts,
para quem já tem o documento TISS); sem ele vai para a digitação, que é a única
das duas telas que aceita item + justificativa + valor. Antes disso **todo
recurso montado na tela do Miydas levava 400 depois do login**.
O casamento entre o nosso item e o dela é pelo código do procedimento, que é
o único elo que os dois lados compartilham. Procedimento repetido na mesma conta
desempata pelo glosado mais próximo do que se recursa; quando nem isso resolve,
o item é recusado com motivo em vez de chutado — recursar o item errado
gasta o único recurso que aquela glosa tem.
Recusa da operadora deixou de contar como falha nossa
As três recusas 1307 de 23/10 ficaram FAILED, e não deviam: a operadora
respondeu, e com clareza. O caminho de erro do tissRecursoGlosa devolvia
{ message, details: { codigoGlosa } } sem processing, o que
desfechoDeEnvio lê como INDETERMINADO — e INDETERMINADO reprova a execução.
Três custos, e o terceiro é o caro: consecutiveFailures **desativa a conexão
do cliente em cinco**, e aquelas três já tinham gastado três.
Corrigido em tiss-operations/recusa-de-recurso.ts, usado pelos dois caminhos
de webservice — e com isso vale também para Caixa Saúde, Porto Saúde e Orizon
Fature, que compartilham a operação.
A rota do recurso é CADASTRO, e foi mudada (02/11/2026)
O resolvedor prefere WEBSERVICE a RPA, e é uma boa regra geral. Aqui ela
mandaria o recurso pelo canal com três recusas em três tentativas, enquanto
o caminho medido ficaria sem uso. Então a conexão do webservice do Indalab
passou a dizer que não é o canal do recurso:
{ "environment": "producao", "naoUsarPara": ["SUBMIT_BATCH", "SUBMIT_APPEAL"] }
SUBMIT_BATCH já estava lá, pelo mesmo tipo de motivo (o lote sai pelo portal).
O acréscimo é SUBMIT_APPEAL, na conexão cmuk0fu3y0001nx3pvyrpzb9c.
Não é afirmação de que o webservice não recursa — é afirmação de que, para
ESTE prestador e com o que sabemos hoje, o portal é o canal. Reversível em um
UPDATE, e o exigeCredencial/naoUsarPara existem exatamente para isso.
As outras três conexões ficaram como estavam, de propósito. A Clínica da
Saúde do Aparelho Digestivo e o Laboratório Santa Catarina têm só o
webservice: marcá-lo as deixaria sem canal nenhum, e uma recusa 1307 é pelo
menos uma resposta medida. Para elas, o recurso pelo portal depende de
cadastrar a credencial do portal.
O Santa Isabel não pode ser conta de prova desta operadora
Medido em 02/11/2026, porque foi a conta pedida para o primeiro envio:
| O que | Estado |
|---|---|
| conexões Unimed Blumenau | duas, isActive = true |
| credenciais | as duas com credentials NULO |
| execuções (qualquer operação) | zero, desde sempre |
| guias conciliadas desta operadora | zero (as 27 que ele tem são Porto Seguro) |
| glosas de item desta operadora | zero (as 334 que ele tem são Porto Seguro) |
Conexão ativa sem credencial é um estado que a matriz mostra como "Ligado" e que
não executa nada. Com o canal-de-recurso.ts a tela passou a dizer isso em vez
de oferecer "Enviar" — mas o cadastro continua precisando de credencial, e o
recurso continua precisando de glosa ingerida.
Quem tem as duas coisas nesta operadora: Indalab (7.053 glosas de item,
R$ 35.655,59, credencial de portal e de webservice) e a **Clínica da Saúde do
Aparelho Digestivo** (2.466 glosas, R$ 242.485,06, só webservice).
Ainda não medido
- •O envio real pela digitação. Nada do passo 2 ao 5 foi executado:
gerarProtocolo,
gerarRecurso e liberarProtocolo escrevem na operadora, e o protocolo 41525
existente foi criado à mão pelo usuário. O que está provado é a LEITURA
(passos 1 e 3) e o formato exato dos três passos de escrita, lido no JS da
própria tela.
- •Se o webservice aceita a CONTA em
numeroGuiaOrigem. É a quarta tentativa
que agora tem evidência por trás, e não foi feita: seria a quarta escrita no
recurso desta operadora.
- •
exportarXmlRecursoGlosaexiste no DWR. Se ele exporta o XML de um recurso
que a operadora aceitou, é a forma de construir o emissor de
RECURSO_GLOSA com a ordem de elementos vinda de arquivo aceito, não de
leitura de XSD — a mesma disciplina do emit-lote-guias.ts.
A tela faz os DOIS passos: autorizar e executar (31/10/2026)
Até hoje a tela de autorização parava no sim. Nesta operadora isso não é o
fluxo completo: autorizar e executar são duas transações, em dois canais
diferentes, e quem só autoriza deixa a requisição liberada e pendente para
sempre (ver a seção do fluxo de execução, medido em 22/10/2026).
| Passo | Canal | Transação | O que produz |
|---|---|---|---|
| Autorizar | webservice TISS 4.03.00 | tissSolicitacaoProcedimento | requisição + senha |
| Executar | portal | pls_montarTelaExecucaoRequisicao → ...ListaItensExec → ...DadosGuiaExecutada | guia de serviço |
O canal não é escolhido por ninguém: os 12 webservices publicados pela
operadora foram lidos em 22/10/2026 e nenhum executa pré-autorizada — o
TISS não normatiza essa transação. O resolvedor cai no portal sozinho porque é
lá que EXECUTE_PREAUTH está declarada.
Consequência de cadastro, e ela aparece na tela: o botão "Executar exame"
só existe para quem tem a conexão do PORTAL. Medido em 31/10/2026 nas conexões
de produção: o Indalab tem as duas (unimed-blumenau-soap e
unimed-blumenau) e vê o botão; o Laboratório Santa Catarina e a Clínica da
Saúde do Aparelho Digestivo têm só o webservice e não veem — para elas a
execução continua sendo manual no portal até alguém cadastrar a credencial do
portal. A tela não mente sobre isso: operação que o canal não declara não ganha
botão.
A guia de serviço NÃO é a requisição — e quase trocou de lugar
operatorGuideNumber da execução é a guia de serviço (95249229 no caso
medido), não a requisição (18888000). São números de naturezas diferentes:
- •a requisição é a identidade da guia na operadora — é por ela que a
consulta de situação e a própria execução acham o registro;
- •a guia de serviço é o que a operadora emite ao executar, e é o número que
o faturamento cobra.
O registro de negócio gravava o desfecho por cima quando a execução vinha
apontada a um recurso (_recurso), sem a proteção de acrescentar. Dois
estragos, os dois corrigidos em 31/10/2026 com teste:
1. a requisição era substituída pela guia de serviço, e a consulta de
situação passava a procurar um número que aquela tela não conhece;
2. a recusa do repetido ("já executada"), que situacaoDaExecucao lê como
NEGADA, rebaixava para NEGADA uma guia autorizada — e ninguém faturaria
um atendimento que já foi feito.
Agora a requisição fica onde está e o número emitido vai para
extraFields.execucao.guiaGerada, que é o que a tela mostra ("Guia de serviço
X — é ela que o faturamento cobra").
A solicitação não tem onde pôr tipo, regime, acidente nem CID
Lido em 31/10/2026 o ctm_sp-sadtSolicitacaoGuia do tissGuiasV4_02_00.xsd (e
conferido igual no 4.03.00): a guia de solicitação tem 13 elementos, e
tipoAtendimento, regimeAtendimento, indicacaoAcidente,
saudeOcupacional, grauParticipacao e CID não estão entre eles. Mandar
qualquer um reprova no XSD antes de sair da máquina.
O que a solicitação ACEITA: caraterAtendimento, indicacaoClinica,
coberturaEspecial, observacao, numeroGuiaPrincipal e o código de validação
do beneficiário.
**CUIDADO AO COPIAR PARA O PORTAL DA MESMA OPERADORA: lá estes campos
existem.** A tela pls_montarTelaRequisicaoAut.action foi varrida no mesmo dia
(114 campos) e tem ie_tipo_atendimento (23=Exame),
ie_regime_atendimento_servico (01=Ambulatorial),
ie_saude_ocupacional_servico, ie_cobertura_especial_servico e CID. A
diferença é do canal, não da operadora — por isso a declaração
(pedidoIgnora) mora em cada conector, e o RPA irmão não a repete.
O efeito prático: a tela parou de perguntar o bloco "Atendimento" quando a
operadora é atendida pelo webservice. Antes ela perguntava quatro coisas e
gravava no recurso uma resposta que a operadora nunca viu.
O envio real ponta a ponta pela tela (31/10/2026)
Hemograma 40304361 para SAMUEL DE PAULA BATISTA, carteira
00265555068163003, solicitante Lidia Ferraz Gracioli CRM 27285/SC CBO
225124 (o CBO veio sugerido pelo CFM, ninguém digitou). Tudo pela tela de
miydas.com.br, em produção.
| Passo | Canal | Quando | Desfecho |
|---|---|---|---|
| Autorizar | webservice | 18:03:39 UTC | AUTORIZADA — requisição 18945436, senha 18945436, validade 29/01/2027 |
| Executar | portal | 18:05:21 UTC | Executada — guia de serviço 95313994 |
| Consultar | webservice | 18:06:53 UTC | Autorizado, quantidade autorizada 1 |
Guia do prestador 2610310001. Nenhum campo de atendimento foi perguntado — o
bloco sumiu, como tem de ser neste canal.
DEPOIS DE EXECUTADA, A OPERADORA RENUMERA A GUIA
Esta é a descoberta cara do dia, e ela só aparece quando se faz os dois passos
seguidos. A consulta de situação foi enviada com
operatorGuideNumber = 18945436 (a requisição) e a operadora **respondeu com
outro número**:
resultSummary: { "numeroGuiaOperadora": "95313994", "senha": "95313994",
"statusSolicitacao": "1", "dataValidadeSenha": "2027-01-29" }
Ou seja: a partir da execução, a guia de serviço passa a ser a identidade da
guia para a própria operadora, e a requisição deixa de ser o número que ela
devolve. A consulta ainda ACHA a guia pela requisição antiga — foi assim que
esta resposta chegou —, mas o que ela informa é o número novo.
Duas consequências que não se adivinham:
1. A execução não pode renumerar; a consulta pode. A execução só emite a
guia de serviço — ela não é autoridade sobre a identidade do registro, e
deixá-la gravar por cima trocaria o número antes de a operadora concordar.
A consulta pergunta à operadora "o que é esta guia?", e o que ela responde
vale. É por isso que a correção de 31/10/2026 em registro-de-execucao
protege o número na execução e não mexe em registrarStatus.
2. O número do prestador é a única chave estável do começo ao fim. Aqui
2610310001 atravessou os três passos sem mudar, enquanto o número da
operadora mudou de 18945436 para 95313994. Conciliação que casar só pelo
número da operadora perde a guia no meio do caminho.
Os pré-preenchidos do convênio: por que NÃO há solicitante padrão aqui
A Clinipam tem solicitante padrão (conselho 06, 11648/SC, CBO 225125)
porque foi MEDIDO: 21 de 21 autorizações do Indalab em 10/2026 têm o mesmo
médico de transcrição da operadora.
Aqui a medida não existe, e por isso o campo fica vazio de propósito. Procurado
em 31/10/2026 no banco de produção: zero guias SP/SADT faturadas do Indalab
para a ANS 334561 (guias_spsadt), e profissionalSolicitanteId nulo em todas
as 13 solicitações. O único solicitante repetido é o dos nossos próprios
envios de teste (Lidia Ferraz Gracioli, CRM 27285/SC, CBO 225124) — medir o
próprio rastro seria circular. Dizer quem pediu o exame é afirmação gravada na
operadora em nome do laboratório: fica para quem opera configurar, e o campo
já aparece em "médicos recentes" para ser escolhido num clique.
O que a tela JÁ resolve sozinha nesta operadora: o CBO — exigência de canal
(o XSD obriga CBOS) — vem sugerido pelo CFM a partir da especialidade
(medido: CRM 27285/SC → 225124, preenchido sem ninguém digitar).
O que ainda precisa ser checado
- ☐O teto de 9 procedimentos por guia no webservice é NOSSO, não do TISS.
MEDIDO em 31/10/2026 no XSD oficial da ANS: em
ctm_sp-sadtSolicitacaoGuia, tanto no tissGuiasV4_02_00.xsd quanto no
tissGuiasV4_03_00.xsd, procedimentosSolicitados é
maxOccurs="unbounded". Mesmo assim
soap/tiss-operations/request-authorization.ts recusa acima de 9 com a
mensagem "O TISS aceita no maximo 9 procedimentos por guia SP/SADT" — uma
afirmação falsa sobre o padrão, aplicada aos QUATRO conectores que usam a
função (Caixa Saúde, Porto Saúde, Orizon Fature e esta operadora). O 9 vem
do manual do Autorize da Orizon, que é regra de operadora, e já está
declarado onde pertence (orizon-autorize, bradesco-saude:
maxProcedimentos: { REQUEST_AUTH: 9 }).
Consequência aqui: um painel de laboratório com 10 exames é recusado pelo
nosso próprio código, citando o motivo errado — e a tela não divide em
guias porque o canal declara maxExamesPorGuia: null.
Não foi corrigido nesta sessão de propósito: a função é compartilhada
e mexer nela muda o comportamento de três operadoras que ninguém mediu
hoje; e declarar 9 só aqui apenas lavaria o teto inventado, dividindo em
guias que a operadora não pediu (o mesmo argumento da nota da Nossa
Saúde). O conserto certo é tirar o teto da função e declará-lo por
conector onde ele foi medido — e para esta operadora ele não foi: o
portal e o webservice nunca receberam um pedido com mais de 9 itens.
- ☑Quantas passadas até convergir? RESPONDIDO em 22/09/2026: uma só. Com
90 min a varredura terminou sozinha em 30min56s e reportou SUCCESS — a
primeira a fechar por conta própria. O que parecia falta de convergência
era a dedup por hash falhando (seção acima).
- ☐Deduplicar por nome. Ver a seção do ZIP gerado na hora. É a pendência
de maior valor nesta operadora hoje: sem ela, toda varredura noturna
regrava ~1.200 arquivos.
- ☐Limpar as 2.676 linhas duplicadas de
inbox_filesdo Indalab, e os
objetos correspondentes no S3. O dado financeiro não precisa de reparo.
- ☐A varredura inicial cobre quanto tempo?
buildInitialSyncOptionspede
uma janela única de 2 anos para RPA (fromDate = hoje − 2 anos). Não foi
medido se o portal honra a data inicial ou se ele próprio limita a
listagem. E totalAvailable volta 599 enquanto totalNew volta 1.181 —
os dois contadores não estão medindo a mesma coisa, e nenhum foi
conferido contra a tela.
- ☐Fatiar por competência no RPA. O webservice já varre mês a mês
(MESES_SINCRONIZACAO_INICIAL = 12); o RPA faz uma passada só. Fatiar
tiraria o INITIAL_SYNC da dependência de um prazo único e daria
isolamento por competência, como na Brusque. Não foi feito porque exige
confirmar que fetch-returns.ts honra competenceYear/competenceMonth.
- ☑Credenciais do webservice. RESPONDIDO em 27/09/2026 para o Indalab:
o login e a senha do portal servem no webservice, e o codigoPrestador é
6971 (o mesmo codigoPrestadorNaOperadora de 339 demonstrativos de
análise). Conexões de homologação e de produção criadas, credenciais
validadas; sincronização automática do webservice desligada (o RPA
continua sendo quem baixa demonstrativos).
- ☑A tela de envio de lote. MEDIDA em 22/10/2026, campo a campo (seção
própria acima). O caminho do menu estava certo; o conteúdo não: o portal
só aceita .zip e o protocolo não vem na resposta do POST, lê-se
na lista de lotes por "Lote prestador". Corrigido, com os bytes do XML
preservados e a linha da grade conferida contra o nosso numeroLote.
- ☑Primeira transmissão real de lote pelo portal. FEITA em 22/10/2026
com o lote de teste, por decisão do usuário: protocolada como 32568556 e
REJEITADA pela Unimed com CM104 - NÚMERO DE GUIA INVÁLIDO (o
numeroGuiaPrestador de teste tinha letras). A cobrança não entrou. Ver
a seção própria: foi esse envio que revelou que protocolo não é aceite —
e, na segunda tentativa de corrigir o relato, que **transmissão e
processamento são duas respostas** e não cabem num campo só.
- ☐Primeira transmissão de lote que a operadora ACEITE. Falta competência
real do prestador — e, antes dela, resolver o numeroGuiaPrestador.
É regra da Unimed, não do TISS: o padrão tipa o campo como
st_texto1a20 (alfanumérico), e a operadora recusou TESTEPEDIDO01 com
CM104 - Existem caracteres inválidos! embora ele não tenha nenhum
caractere especial — só letras. As guias que o Indalab envia à mão são
todas numéricas (95234038, 18874459, 292729). Logo: aqui o número de guia
do prestador tem de ser numérico, e isso é uma pré-validação por
operadora que o sistema ainda não tem onde pendurar — validar numérico
para todo mundo seria errado, porque o TISS permite letras.
- ☑O
Resumo importaçãodo protocolo. MEDIDO e implementado em
22/10/2026 — criticasDoProtocolo() lê as três telas (resumo, contas com
Ocorrencia: CMxxx, e o agregado de glosas) e as devolve no details do
CHECK_STATUS.
- ☐Quem responde a segunda pergunta nos outros canais?
processingsó é
preenchido pelo RPA da Unimed, porque aqui a tela do protocolo mostra o
estado junto. No webservice o protocolo chega antes do julgamento, e aí o
lote fica com processamentoStatus nulo — "ainda não se sabe" — até
alguém rodar CHECK_STATUS com o protocolo na mão. E **não existe
varredura de pendentes**: o scheduler diz isso em cada boot
(`CHECK_STATUS nao agendado: a operacao exige protocolo e nao existe
varredura de pendentes`). Ou seja: a distinção existe no registro, mas em
todo canal que não seja este RPA ela depende de alguém perguntar. Enquanto
isso, um lote transmitido por webservice é indistinguível de um lote
aceito para quem só olha o status.
- ☐
STATUS_NOT_FOUNDé resposta definitiva e mesmo assim é retentado 3x.
Medido em 22/10/2026: cada consulta a um protocolo inexistente gera 3
execuções FAILED (attempt 1, 2, 3) e soma **3 ao
consecutiveFailures da conexão** — de 5, que é quando isActive vira
false e a conexão do cliente para. Duas consultas a protocolo errado
derrubam a conexão do Indalab. Não existe hoje mecanismo de "código não
retentável"; enquanto não existir, consulta de protocolo é para rodar em
conexão de sonda, não na do cliente (ver a memória *teste desativa a
conexão do cliente*). O contador ficou em 3 depois das sondas desta
sessão e foi zerado à mão.
- ☐Ninguém usa as críticas ainda.
criticasDoProtocolo()lê as três
telas e o processamentoDetalhe guarda o motivo, mas nada no sistema
consome isso: o lote 4919 do envio manual do Indalab tem **43 contas e 96
itens criticados** que hoje ninguém vê em tela nenhuma.
- ☑A versão TISS estava fixa no código. RESOLVIDO em 22/10/2026 — virou
parâmetro, vem de HealthPlan.tissVersion, o XSD é conferido na mesma
versão e o valor usado é gravado no lote. Ver a seção própria.
- ☑Primeira transmissão de lote que a operadora ACEITE. FEITA em
22/10/2026 — lote 202612, protocolo 32570079, hemograma do Samuel,
0 críticas. As duas regras que faltavam (guia numérica e CBO real) estão
em regras-da-operadora.ts.
- ☐Lote com volume real. O aceito tem 1 guia e 1 item; o do prestador tem
21 e 279 (224 KB). A tela de upload tem limite de tamanho não medido.
- ☐Ver a transição
Aceito→Integrado. O nosso foi medido em
aceitar.gif; o do prestador chegou a enviado.png. Não se sabe quanto
tempo leva nem se algo pode barrar no meio.
- ☐Limpar
health_plans: duplicatas poransCodee versões malformadas.
Bradesco 005711 tem 3 linhas com tissVersion diferente entre si
(4.01.00, 4.02.00, 04.01.00); SC Saúde 757444 tem 4. E há
04.01.00/03.02.01/04.03.00 com zero à esquerda. O código já
normaliza e escolhe de forma repetível, mas **a versão TISS do XML sai
dessa coluna** — duas linhas discordando é a operadora recebendo versões
diferentes dependendo de qual linha o Postgres devolver primeiro.
- ☐Unimed Blumenau não tem linha em
health_plans(ansCode334561
ausente), então ela depende do fallback. Funciona, e é frágil: o dia em
que a operadora mudar de versão, não há onde declarar isso.
- ☐O número do lote tem de ser único por prestador. O portal indexa por
numeroLote; o lote de teste usa 202610 (a competência), que colide no
mês seguinte e torna a leitura do protocolo ambígua. O manual do Indalab
usa sequencial (4919).
- ☐Lote e demonstrativo na 4.03. Só autorização, status e elegibilidade
foram medidos na 4.03. Antes de mudar a versão de uma conexão que fatura,
medir envio de lote e retorno nela.
- ☑A tela certa de
CHECK_STATUS. RESPONDIDO em 22/10/2026, e ela não
era a que todo mundo supunha: é a própria lista de lotes de *Contas
médicas → Upload*, que o envio já consultava. Declarado no RPA, lendo por
nrSeqProtocoloFiltro com a linha conferida e as críticas no details.
pls_montarTelaFiltroProtocolo.action (*Digitação de contas médicas →
Consultar protocolo*) segue não mapeada — mas aquela é para conta
digitada, não para lote enviado.
- ☐As outras situações de beneficiário. Só "Ativo" (`IE_SITUACAO_BENEF_P
= 2`) foi visto. Falta medir um beneficiário excluído ou suspenso para
saber o que o portal escreve — e só então decidir se o código numérico
vira régua. Até lá, qualquer situação que não seja "Ativo" é tratada como
não elegível, com o texto do portal na mensagem.
- ☑
REQUEST_AUTHpelo portal. RESPONDIDO em 21/10/2026 — e não era
redundância: o portal exige validação do beneficiário que o webservice não
exige. Ver a seção acima.
- ☐Anexo e questionário na requisição. A tela de itens tem "Anexar
arquivo" (pls_montarTelaUploadDocItem.action) e "Questionário"
(abrirQuestionario). Nenhum dos dois foi aberto — e o Savi da Clinipam
já mostrou que anexo pode ser condição para a solicitação se completar.
- ☐O que o portal faz com procedimento que exige senha prévia. Só foi
medido hemograma, que passou direto para "Aberta".
- ☑Recurso de glosa pelo portal. RESPONDIDO: as três telas estão medidas e
as duas de envio implementadas (upload de ZIP e digitação). SUBMIT_APPEAL
e CHECK_APPEAL_STATUS são declaradas pelo RPA desde 22/10/2026.
- ☐Segundo telefone do cadastro. O site do Indalab publica (47) 3333-0746
além do 3333-2984 que consta no CNES e na Receita. Sem impacto técnico,
mas o cadastro ficou com um só.
- ☐**As nossas requisições param em "Aberta" — e as do Indalab chegam a
"Aprovada".** Medido em 22/10/2026: a 18878339 (criada por nós hoje, hemograma
do Samuel) está Aberta, com quantidadeAutorizada: 0, e não aparece na
*Pesquisa de autorização* — "Aberta" não é nem opção do filtro. As duas
requisições anteriores do Samuel (18820940 de 14/10 e 18868500 de 20/10,
também nossas) estão Cancelada. No mesmo período, 407 requisições do
próprio Indalab estão Aprovada, 402 delas já com guia. Ou seja: o que o
nosso REQUEST_AUTH produz não é o que o fluxo do prestador produz, e
ninguém sabe ainda o que falta — o passo final da tela, um campo, ou um
prazo de auditoria. É isso que hoje impede de fechar EXECUTE_PREAUTH com
requisição nossa, sem tocar em paciente de terceiro.
- ☑Autorização para executar uma requisição real. CONCEDIDA e usada em
22/10/2026: a 18720485 (hemograma, a de menor valor das duas com item
liberado) virou a guia de serviço 95249229. EXECUTE_PREAUTH está
implementada. Restam 4 pendentes, das quais 3 só têm itens cancelados.
- ☐Execução com mais de um item, quantidade parcial e pacote. O caso
medido tinha 1 item e quantidade 1. O checkbox uncheckPacote<item> e a
função mantemPacoteCheck tratam item de pacote — nenhum dos dois foi
exercido.
- ☐Biometria/facial na execução.
iePermiteExecSemBiometria,
ieBiometria e nrSeqRegraBiometriaFacial governam um ramo que pode
exigir digital ou reconhecimento facial e travar o RPA. Nenhum deles foi
lido para este prestador.
- ☐O primeiro recurso de verdade. As quatro operações novas de glosa e
documentos foram implementadas sem nunca rodar — este prestador não tem
glosa nesta operadora. A grade de lotes de recurso e a de protocolos nunca
tiveram uma linha, então a leitura é pelo cabeçalho; o primeiro recurso
real precisa ser conferido tela contra retorno.
- ☐O relatório 3805 com login de cooperado. O filtro Prestador vem vazio
no login do laboratório e o relatório é classificado como CPLS. Com um
acesso de cooperado dá para saber se o relatório serve a alguém — e, se
servir, FETCH_GLOSA_REPORT passa a ter sentido por canal.
- ☑"Digitar recurso de glosa" (
subItem_5_2). PERCORRIDA em 02/11/2026,
e é o caminho que a tela do Miydas usa: recursar-digitacao.ts. Os cinco
passos, o formato de dadosItens e os limites estão na seção "O 1307
resolvido". Falta só executar os três passos de escrita.
- ☐O protocolo 41525, "Em digitação", não aparece na consulta. Em
22/10/2026 o usuário gerou um protocolo de recurso pela tela de *Digitar
recurso de glosa* (sequência 41525, status Em digitação) e a tela de
*Consultar protocolo* seguiu dizendo "Sem registros encontrados",
mesmo abrindo a janela para 01/02/2026. Ou seja: CHECK_APPEAL_STATUS
pelo portal não enxerga recurso em digitação — só o que já foi
protocolado de verdade. A tela de digitação tem a grade própria
(`Sequência | Status | Prestador | Vl recursado | Vl acatado | Dt
recurso`), e é dela que sai o estado do rascunho.
- ☐O relatório 3364 (analítico de pagamento) não está ligado a nada. Ele
responde — 5.032 linhas na competência 09/2026 — e seria um segundo
caminho para FETCH_PAYMENT, hoje feito pelo demonstrativo. Vale comparar
os dois antes de decidir se serve para conciliação.
- ☑"Vincular contas" do recurso. ABERTA em 02/11/2026, e era a resposta do
1307: o recurso é endereçado por nr_seq_conta e nr_seq_conta_proc,
que o demonstrativo não carrega. A leitura (...Consulta.action, GET) foi
feita sem tocar em gerarRecurso. Ver a seção "O 1307 resolvido".
- ☑As nossas requisições param em "Aberta". RESPONDIDO em 22/10/2026 —
e a resposta é o canal: pelo webservice a mesma solicitação volta
AUTORIZADA na hora (requisição 18888000). O portal é que deixa Aberta.
Falta saber se é regra da operadora para requisição de portal ou defeito
do nosso fluxo de tela.
28/10/2026 — o webservice entregava fragmento, e o holerite tem DOIS leiautes
346 demonstrativos de pagamento que não existiam para o sistema
O conector SOAP remontava só o miolo da resposta — <demonstrativoPagamento>,
sem envelope mensagemTISS — e gravava isso como arquivo. O conteúdo é
completo: um arquivo real de 28/07/2026 tem **343 KB, 27 protocolos, 1.107
guias** e os lançamentos de imposto retido (R$ 904.041,10 informado,
R$ 882.484,94 liberado, R$ 840.954,90 líquido, com IRPJ e Pis/Cofins/CSLL).
Sem o envelope, nada disso chega: tiss-generic.identify() exige a string
mensagemTISS, detectTissVersion estoura e parseEnvelope não tem de onde
tirar o tipoTransacao. Resultado: **346 arquivos em
INBOX_PENDENTE_IDENTIFICACAO** desde julho, com a execução verde.
Duas correções, de propósito:
1. Na origem (connectors/soap/envelopar-demonstrativo.ts): o conector
envelopa, reusando o cabeçalho que usou na chamada — **sem o
loginSenhaPrestador**, que não pode ir para o S3 — e trocando o
tipoTransacao do pedido para o da resposta. A versão é a que ele negociou.
2. Na leitura (tiss-engine/fragmento-tiss.ts): fragmento conhecido é
envelopado para ser lido, resgatando o que já está gravado. A versão aí é
assumida e o campo versaoTiss fica nulo — gravar suposição como fato é
o erro que isso evita.
O holerite de laboratório não é o de cooperado
408 holerites em INBOX_ERRO_PROCESSAMENTO com "Nenhuma guia extraída". O
leitor estava certo no fechamento financeiro e cego nas linhas de produção:
cooperado 20/03/2026JOAO CARLOS PEREIRA 900…001019257 1,00 40901793 Elasto… 12 0,00 85,11 9,89 95,00 9770
laboratório 25/06/2026DIETER PRUST00266309000151009288710 1,00 40311171 Microalbuminuria 0,00 28,15 28,15
Três diferenças, todas fatais para o regex: nome colado na carteira (sem o
espaço que ele exigia), três colunas de valor em vez de quatro, e **sem grau
de participação nem código de executante** no fim.
Medido no demonstrativo de julho/2026 do Indalab: **5.350 linhas, nenhuma
reconhecida**. Com o leiaute novo: 582 guias, 5.350 itens, cobrado = pago =
R$ 80.756,34, que é exatamente o Valor Produção do rodapé. Zero avisos.
A carteira tem comprimento variável (17 dígitos no laboratório, 21 no
cooperado): o Doc são sempre os últimos 6 dígitos da corrida, e contar da
direita é a única leitura estável.
A descrição é capturada de forma GULOSA, e isso não é detalhe. Ela vem
truncada em largura fixa e pode terminar em dígito —
Marcadores Tumorais (Ca 19.9, Ca 12. Com captura preguiçosa o 12 virava
120,00 de honorário, e o documento ganhava R$ 600,00 que não existem (5
ocorrências × R$ 120,00, medido).
O relatório 3805 mente no nome e na extensão
RELATORIO_CPLS_3805_<timestamp>.xls não é planilha: é TSV em latin-1,
15 colunas. E tem registro quebrado em várias linhas — o campo Parecer
carrega texto livre com salto de linha dentro, sem aspas que o delimitem.
Medido no relatório de 24/10/2026: 758 linhas físicas para 736 registros,
19 deles partidos em três pedaços (12 + 1 + 4 campos). Quem ler linha por linha
perde 19 glosas e produz 41 linhas de lixo. A remontagem é por **contagem de
campos**: acumula até fechar 15.
O que o relatório tem e o demonstrativo não tem é o parecer do auditor, e é
o melhor insumo de recurso desta operadora:
"Conforme MAME: Esse teste diagnóstico não deve ser pago porque não é
efetivamente realizado pelo laboratório. O resultado apresentado no laudo é
produto do cálculo matemático (fórmula de Friedewald)…"
Leitura do arquivo real: 480 guias, 736 itens, R$ 8.294,92 de glosa, 123
itens com parecer de auditor, 607 com código da TUSS 38 e 128 com código
próprio da Unimed (CM566). Os dois vocabulários vêm no MESMO campo
(1817 - … e CM566 - …) e vão para colunas diferentes: só o numérico é
comparável entre operadoras.
O 5012 da guia do balcão: era o caraterAtendimento (02/11/2026)
Primeira guia nascida de requisição do balcão. Tudo que já estava medido nesta
nota (20/10, 27/09) vinha do caminho direto.
REQUEST_AUTH GUIA2611020001 etapa 2, carteira 00265555068164000
→ FAILED em 1,1s — PEDIDO_RECUSADO_PELO_PORTAL
"5012 - RECEBIMENTO DE MENSAGEM NÃO FINALIZADO. " (sem detalhe nenhum)
A elegibilidade do mesmo beneficiário tinha passado 6 minutos antes
(validade 28/02/2027): não era carteira.
A causa, achada comparando o XML com os que passaram: a mensagem levava
<caraterAtendimento>ELETIVO</caraterAtendimento>. O domínio
dm_caraterAtendimento tem dois valores e eles são códigos — 1 eletivo,
2 urgência/emergência. Todos os outros envios da casa mandaram 1; só os
dois do balcão mandaram o rótulo, e só eles levaram 5012.
-- os 12 últimos envios de SP-SADT, lado a lado
2026-11-02 23:51 carater>ELETIVO GUIA2611020001 etapa 2 → 5012
2026-11-02 18:16 carater>ELETIVO GUIA2611020001 etapa 2 → 5012
2026-11-02 14:50 carater>1 2611020002 etapa 1 → ok
2026-11-02 14:48 carater>1 2611020001 etapa 2 → ok
...
Vinha de a coluna solicitacoes_autorizacao.caraterAtendimento ter dois
vocabulários: o caminho direto gravava o código, a requisição gravava o rótulo
da tela. Corrigido com um tradutor único (connectors/soap/carater-atendimento.ts),
aplicado na escrita da guia e também na saída — guia antiga com ELETIVO
reenviada hoje sai como 1.
Hipótese que caiu no caminho, e vale registrar. Antes disso eu atribuí o
5012 à ausência do bloco dadosExecutante, que de fato nunca era emitido: quem
grava credencial escreve cnesPrestador e o leitor procurava cnes. Era um
defeito real, foi corrigido (e a credencial do INDALAB ganhou
cnesPrestador = 2521865, o CNES que a unidade matriz já apontava), **mas não
era a causa do 5012**: com o bloco presente e o CNES certo, a resposta foi o
mesmo 5012, byte por byte. Serve de lembrete: o 5012 desta operadora não diz
qual campo recusou, então a prova é o diff contra uma mensagem que passou.
Cuidado ao ler 5012 nesta operadora. Ele aparece em três situações
diferentes, e só o texto ao lado separa:
| Texto junto ao 5012 | O que é |
|---|---|
RECEBIMENTO DE MENSAGEM NÃO FINALIZADO (na solicitação) | a mensagem foi recusada por conteúdo/leiaute; nada foi pedido |
Guia não encontrada no sistema! (na consulta) | a operação tissSolicitacaoStatusAutorizacao não acha guia nenhuma — vale até para guia autorizada minutos antes |
CODIGO HASH (5014, vizinho) | hash do cabeçalho |
Etapa 2 passa — medido no mesmo pedido (03/11/2026, 00:18)
Terceiro envio da MESMA guia, só com o caráter como código:
REQUEST_AUTH GUIA2611020001 etapa 2, caraterAtendimento 1
→ AUTORIZADA em 3,4s
guia da operadora 95315515, senha 95315515, validade 2027-01-31
hemograma 40304361: solicitada 1, autorizada 1
É a primeira etapa 2 autorizada nesta operadora, e ela saiu com
dadosExecutante (código 6971, CNES 2521865). Fica medido que a Unimed
Blumenau aceita a etapa do executante — o que faltava era o domínio do
caráter, não a etapa.
As duas linhas que ainda tinham o rótulo na coluna foram normalizadas para o
código, para a guia impressa não sair com o campo 13 em branco.
A guia tem PDF nativo, e a chamada está mapeada (20/11/2026)
A Unimed Blumenau ficou de fora da varredura de impressão de 31/10 (nove
portais; só a Brusque, que não tem módulo de autorização para a credencial).
Medido agora, com sessão real.
A chamada
imprimirSolicitacao() (em bibliotecas/js/plsAutorizacao.js, linha ~3464)
tem dois caminhos:
// guia comum → imprime direto
function imprimirAcao() {
novaWindow("pls_imprimirConsultaAut.action?relat=" + urlEncode(
"nrSeqGuia=" + getComponente("NR_SEQUENCIA").value +
"&ieTipoGuia=" + getComponente("IE_TIPO_GUIA").value +
"&statusGuia=" + this.statusGuiaImpressao +
"&estagioGuia=" + this.estagioGuia), "", "", 600, 800);
}
Os parâmetros vão embrulhados num único relat=, url-encoded. Um botão
comentado no HTML (__fixtures__/requisicao-reprovada.html, linha 276) passa
os mesmos nomes SOLTOS na query — montar a URL por ele dá requisição inválida.
A fixture serve para descobrir os nomes, não o formato.
nrSeqGuia é a SENHA
Medido ao abrir a guia 3707 do Indalab: o portal navegou com
pls_montarListaRequisicaoProcMat.action?nrSeqGuia=95466445..., e 95466445 é
exatamente a senha/numeroGuiaOperadora que gravamos. **O número já está no
nosso banco** — não é id interno inacessível.
Quimio, radio, OPME e odonto NÃO imprimem direto
Quando parametrosClienteRadio|Quimio|OPME|Odonto não é nulo, a função abre
pls_autorizacaoRelatorio.jsp num modal de biometria (#modalBiometria), com
NR_SEQ_GUIA, IE_TIPO_GUIA, IE_STATUS, IE_ESTAGIO e um sufixo
(&IE_OPME=S etc.). Exame de laboratório cai no caminho direto; o conector
precisa reconhecer o modal para não travar nele quando o tipo aparecer.
O download tem de ser pelo RPA
GET direto em .action devolve a tela de login — já estava medido para
pls_montarTelaRequisicaoAut.action em 21/10/2026, e vale aqui. O PDF não
pode virar link para o navegador do usuário: ele é baixado na sessão do RPA,
logo após autorizar, e guardado. Efeito colateral bom: a guia fica arquivada
no momento da autorização, sem depender de o portal servi-la meses depois.
O que a tela de Consulta de autorizações oferece
Menu #item_9 → #subItem_9_2 (já em SELECTORS.menu.authSearch*, mapeados
e até hoje sem uso). Campos: CD_USUARIO_PLANO (carteirinha), NM_SEGURADO,
CD_PRESTADOR, nrSeqTransacao, CD_PROCED, dtInicio/dtFinal,
ieEstagioR/ieEstagioG, ieTipoGuia, e o botão #btnVisualizar.
O radio Tipo de transação separa Guia de Requisição: abrir pela
REQUISIÇÃO leva a pls_montarListaRequisicaoProcMat.action, que só oferece
cancelarReqAut() e voltarTelaConsultaRequisicao() — não tem o botão de
imprimir. O botaoImpSolic é da GUIA.
Como foi medido
Container irmão da imagem da API (receita em notas/orizon.md), credencial do
cofre decifrada DENTRO do container, nunca em trânsito. Três navegações, só
telas de consulta. O plsAutorizacao.js é público: dá para reler a função
sem sessão nenhuma, com curl.
LIST_AUTHORIZATIONS — a Consulta de autorizações, medida (20/11/2026)
Primeira operadora a ter a operação. O contrato é genérico
(listAuthorizations, AuthorizationSummary); isto aqui é o que só vale para
este portal.
Caminho
Menu #item_9 → #subItem_9_2. Os seletores estavam em utils.ts
(SELECTORS.menu.authSearch*) desde sempre e nunca haviam sido usados.
Campos da busca: CD_USUARIO_PLANO (carteirinha), NM_SEGURADO,
CD_PRESTADOR, nrSeqTransacao, CD_PROCED, dtInicio/dtFinal (ambos
DD/MM/AAAA), ieEstagioR/ieEstagioG, ieTipoGuia, botão #btnVisualizar.
O radio de Tipo de transação divide o name ieTipo: #ieTipoGuia_ e
#ieTipoReq. elemento.checked = true não basta — o portal escuta o
evento, então use check() do Playwright. Sem isso a busca volta pelo recorte
de REQUISIÇÃO.
A grade tem DUAS alturas
19082216 20/11/2026 00265360000147006 - ANELISE CORTELETTI Guia de solicitação SP/SADT …
Guia: 95466445 Dt execução: 20/11/2026 Prestador: LABORATORIO … INDALAB LTDA
A primeira linha é a REQUISIÇÃO; a segunda, a GUIA que ela gerou. Uma
requisição pode gerar mais de uma guia, e é a guia que o faturamento cobra.
A leitura caminha guardando a requisição corrente e emite uma entrada por
guia; a requisição só vira entrada quando não gerou guia nenhuma — aí é ela
que está presa.
"Parcialmente aprovada" contém "aprovada"
A ordem das regras de estágio é o que separa as duas. Invertida, todo parcial
vira integral — e o faturamento cobra o que não foi liberado. Tem teste.
Os dois caminhos levam à lista de proc/mat
Clicar na linha da requisição ou na da guia vai para
pls_montarListaRequisicaoProcMat.action (com nrSeqRequisicao ou
nrSeqGuia). Essa tela só oferece cancelarReqAut() e
voltarTelaConsultaRequisicao() — não tem o botão de imprimir.
pls_montarPastaConsultaAut.action é a pasta (casca Tasy com
primeiroRegistro(), Detalhe, Visualizar e um frame_1 interno), mas
abriu com a grade VAZIA usando os parâmetros herdados da lista. Chegar ao
registro por aí ficou não resolvido — e é o que falta para imprimir a guia
de uma autorização ANTIGA. Para as novas, o PDF sai na hora de autorizar.
Não rebaixar desfecho ao reconciliar
A consulta mostra o estágio da REQUISIÇÃO, que fica atrás do da guia. Aceitar
cegamente faria uma guia AUTORIZADA voltar para EM_ANALISE, e perder um
"autorizada" é perder a senha que fatura. A senha que faltava, essa sim, é
aceita mesmo em guia já decidida. Ver sincronizar-autorizacoes.ts.
O que NÃO foi medido
- •Paginação: a consulta foi feita com uma guia no período. Janela larga
pode paginar, e a varredura traria só a primeira página sem avisar.
- •Colunas em outros tipos de guia (internação, odonto) — o regex da linha da
requisição espera … Guia de <tipo>.
O relat= é assinado — não se monta à mão (20/11/2026)
A URL que o portal abre ao imprimir:
pls_imprimirConsultaAut.action?relat=MEQyMTlCRjIwRjQ2MTg3NzAxN0U1Q0IyQkY1OUIxNUMjQCNuclNlcUd1aWE9...
Em base64, isso é:
0D219BF20F461877017E5CB2BF59B15C#@#nrSeqGuia=95466445&ieTipoGuia=2&statusGuia=1&estagioGuia=6#@#2112383141
<hash de 32 hex>#@#<parâmetros>#@#<número>, tudo em base64. O urlEncode
que o JS do portal chama não é encodeURIComponent: é função própria que
assina e embrulha.
Consequência prática: não dá para construir a URL a partir dos parâmetros,
nem mesmo tendo todos eles. É por isso que a impressão tem de ser feita
CLICANDO no controle e capturando o evento de download — não por
request.get numa URL montada. Quem tentar "otimizar" o clique para uma
chamada direta vai receber a tela de login, que é o que a .action devolve
para requisição sem a assinatura.
E o frame tem de ser rebuscado depois da busca
#btnVisualizar submete e o paginaPrincipal recarrega. Reaproveitar o handle
de Frame anterior devolve string vazia em vez de erro — a linha não é
encontrada, o conector conclui que não há impressão e o usuário recebe a guia
de fallback achando que é a da operadora. Silencioso de ponta a ponta, e foi
a única diferença entre a sonda (que achava) e a primeira versão do conector
(que não achava).
O portal fala HTTP puro — login e DWR sem navegador (21/11/2026)
Medido, com a credencial do Indalab. O RPA não é obrigatório para falar com
este portal.
Login: POST de formulário
verificarRegras() (em bibliotecas/js/plsLogin.js) faz validações por DWR e
termina em document.getElementById('Login').submit() — ou seja, o login é um
POST comum para login.action:
POST /PlanodeSaude/login.action
Content-Type: application/x-www-form-urlencoded
tipoUsuario=P&nmUsuario=<usuario>&dsSenha=<senha>
&cdEstabelecimentoPortal=&ieAutenticacaoTws=null&obrigaRecaptcha=false&otpCode=
tipoUsuario é P (Prestador). O select só tem E (Estipulante) e P;
qualquer outro valor devolve 200 com a PRÓPRIA tela de login — sem erro, sem
redirecionamento. Foi o que me fez concluir, na primeira tentativa, que o
login HTTP não funcionava.
A sessão vem no JSESSIONID da primeira visita a montaTelaLogin.action.
DWR: POST de texto, resposta em JavaScript
POST /PlanodeSaude/dwr/call/plaincall/<script>.<metodo>.dwr
Content-Type: text/plain
callCount=1
c0-scriptName=consultaAut
c0-methodName=getValoresConsulta
c0-id=0
c0-param0=string:95466445
batchId=0
instanceId=0
page=%2FPlanodeSaude%2Fpls_montarListaRequisicao.action
scriptSessionId=
Resposta medida para a guia 95466445:
handleCallback("0","0",["00265360000147006",830601,"ANELISE CORTELETTI",41,
"Uniflex Nacional Empresarial - Apto 20","1200052","Programa de Rastreamento Ma…
Carteirinha, sequencial do beneficiário, nome, plano, produto e solicitante —
em UMA chamada, em milissegundos. Sem sessão o mesmo POST responde
handleCallback("0","0",null): não dá erro, devolve nulo. Confundir isso
com "a guia não existe" é fácil.
scriptSessionId vazio funcionou nesta chamada. Não medi se todos os
métodos aceitam.
A superfície
Quatro interfaces públicas, legíveis com curl, sem sessão:
| Interface | Métodos |
|---|---|
dwr/interface/pls_requisicaoAtendimento.js | 621 |
dwr/interface/pls_requisicaoConsultaAtendimento.js | 594 |
dwr/interface/consultaAut.js | 317 |
dwr/interface/pls_intercambioSCS.js | 269 |
1.801 métodos. O arquivo dá nome e aridade (function(p0, p1, callback)),
não tipos nem semântica — cada um ainda precisa ser medido.
E tem método que ESCREVE: consultaAut.cancelarAutorizacao está nessa
lista. Qualquer catálogo que se construa daqui precisa nascer com escrita
bloqueada, como o gateway do Lisya faz (HTTP 423 atrás de flag).
Listar autorizações pelo DWR: o getter existe, a BUSCA não (21/11/2026)
Procurei o endpoint DWR que lista autorizações. Ele existe — mas sozinho não
lista, e entender por quê economiza a próxima tentativa.
O padrão: a action busca, o DWR lê
Todos os candidatos têm zero parâmetros:
| Script | Método | Params |
|---|---|---|
consultaAut | getListaConsulta | 0 |
consultaAut | getResultado | 0 |
pls_requisicaoConsultaAtendimento | getListaRequisicao | 0 |
pls_requisicaoConsultaAtendimento | getQtDiasFiltroConsultAut | 0 |
É Struts clássico: a action executa a busca e guarda o resultado na
sessão; o DWR só lê de volta. Sem busca prévia não há o que ler — e foi
exatamente o que a medição mostrou:
consultaAut.getListaConsulta → [] ← lista vazia de verdade
pls_requisicaoConsultaAtendimento.getListaRequisicao → null
A diferença entre [] e null importa: getListaConsulta responde, só
não tem nada. É o getter certo.
Por que não dá para fazer a busca por HTTP (ainda)
GET pls_montarListaRequisicao.action devolve a tela de login, 64 KB,
com <form id="Login">. E não é sessão expirada: na MESMA sessão, no mesmo
segundo, consultaAut.getValoresConsulta("95466445") devolveu
["00265360000147006", 830601, "ANELISE CORTELETTI", …].
Sessão viva, action recusando. A action exige contexto que só a navegação
pelo menu/frameset estabelece. Mandar Referer da tela principal não bastou.
O que isso habilita hoje
Um híbrido que vale a pena: **RPA para executar a busca, DWR para ler o
resultado**. Trocaria a leitura da grade em HTML — que depende de posição de
coluna e de altura de linha — por JSON estruturado na mesma sessão.
Não medido ainda: se getListaConsulta é de fato populado pela busca da
tela de Consulta. Para provar, é preciso rodar o RPA até a grade aparecer e,
com os MESMOS cookies, chamar o getter. Enquanto isso não for feito, não
afirme que o híbrido funciona.
Descartado
- •
montar*como porta de entrada: são INDEFINIDO no catálogo e não executam.
montarListaRequisicao tem 0 parâmetros — não recebe filtro, então não é
ele que busca por data.
- •
dwr/index.html(o índice do DWR): 404, desabilitado. A descoberta de
interfaces é pelos <script src="dwr/interface/X.js"> de cada tela.
CORREÇÃO: listar é UM GET, e o limite de janela nunca existiu (21/11/2026)
Duas coisas que escrevi acima estão erradas, e esta seção manda.
Capturei o tráfego do botão Visualizar com o navegador. Ele dispara **uma
requisição**, um GET com os filtros na query:
GET /PlanodeSaude/pls_montarListaRequisicao.action
?dtInicio=01/11/2026&dtFim=20/11/2026
&ieTipoConsulta=1&ieOrigemProc=8&ieMontarFiltros=false&ieEstagio=0
&ieTipoGuia=&nrSeqSegurado=&nrSeqTransacao=&cdUsuarioPlano=
&nmBeneficiario=&nrSeqPrestador=&nmPrestador=&cdPrestador=
&cdProcedimento=&_=<epoch ms>
Funciona em sessão criada só por HTTP, fora do frameset:
login 663 ms
busca 935 ms → 435 guias (20 dias)
Antes eu havia pedido essa action sem parâmetros e recebido a tela de
login, e daí concluí "exige contexto do menu". Era falta dos quatro
parâmetros de controle (ieTipoConsulta, ieOrigemProc, ieMontarFiltros,
ieEstagio), não falta de contexto.
O "recorte por competência" era TIMEOUT do meu RPA
| Janela | Guias | Tempo |
|---|---|---|
| 20 dias | 435 | 0,9 s |
| 80 dias | 1.268 | 2,2 s |
| 180 dias | 3.604 | 6,2 s |
| 1 ano | 5.585 | 9,8 s |
Nenhuma janela volta vazia. O zero que eu media pelo RPA era a grade ainda
não renderizada quando meus 10 s de espera acabavam — li página vazia como
"o portal recusou o recorte", montei uma teoria de competência em cima
disso e fatiei por mês civil para resolver um problema inexistente.
A lição: o artefato estava no MEU código, e a tabela que eu apresentei
como medida do portal media o meu timeout.
A estrutura da resposta
HTML, grade de duas alturas. A primeira linha tem 7 células:
| # | Campo | Exemplo |
|---|---|---|
| 0 | nº da requisição | 19082216 |
| 1 | data | 20/11/2026 |
| 2 | carteira − nome | 00265360000147006 - ANELISE CORTELETTI |
| 3 | tipo de guia | Guia de solicitação SP/SADT |
| 4 | validade | 18/02/2027 (vazio quando reprovada) |
| 5 | situação | Aprovada / Reprovada |
| 6 | ações | botões |
O número da guia (senha) não é uma célula — vem no onclick do botão de
impressão: imprimirGuia(95466445, '1', '6', '2', 0, 0, 0). O da requisição
vem em abrirRelatorioRequisicao('19082216','2','0', …).
A listagem NÃO traz os itens. Sem TUSS, sem quantidade, sem valor — as
264 ocorrências de cdProcedimento no HTML são o campo do FILTRO, não dado
de linha.
O detalhe, por guia, em milissegundos
Com a senha da listagem, quatro chamadas DWR completam o registro:
| Método | Tempo | Devolve |
|---|---|---|
getValoresConsulta | 120 ms | carteira, nome, plano, produto, tipo, caráter, senha, validade |
getProcConsulta | 68 ms | [40301591, "Colesterol (Ldl) …", 1, 1, null] — TUSS, descrição, qtd |
getDiagConsulta | 26 ms | diagnósticos ([] nesta guia) |
getMatConsulta | 44 ms | materiais ([] nesta guia) |
getAnexoConsulta | 1.986 ms | anexos — o único lento |
Ou seja: listagem + detalhe completo sem navegador, com a listagem num
GET e cada guia em ~260 ms.
O que isso obriga a rever
- •
listar-autorizacoes.tsfatia por mês civil citando um limite que não
existe. O fatiamento não quebra nada — só desperdiça.
- •Os testes de
fatiarcodificam a teoria errada no comentário. - •A leitura da grade por posição de coluna e altura de linha pode sair.
O upload exige ZIP, e XML cru falha EM SILÊNCIO (21/11/2026)
Envio real do lote 4947 (Indalab), autorizado pelo usuário. O caminho HTTP
funciona ponta a ponta — mas só descobri porque conferi a grade depois.
O protocolo
1. GET pls_verificarPodeImportar.action monta a tela e habilita
2. POST pls_importarXML.action multipart, campo "arquivo"
3. DWR pls_ImportarArquivoXMLWebAction.arquivoCarregado() "" → "arq" → "fin"
Para recurso de glosa a action é pls_importarXMLRGTISS.action, mesmo campo.
O ZIP é obrigatório, e o portal não diz isso
A tela se chama "Upload de contas médicas (XML)". Mandei o .xml cru
três vezes:
POST 200 em 157–332 ms · arquivoCarregado → "fin" · NENHUM LOTE CRIADO
O mesmo arquivo dentro de um .zip, 2.870 bytes:
POST 200 em 36 ms · arquivoCarregado → "arq" → "fin" · LOTE CRIADO
Três "sucessos" que não criaram nada. Um conector que lesse o 200, ou o
"fin", reportaria envio bem-sucedido para sempre. O desfecho só aparece na
grade de lotes.
E o "fin" NÃO é lixo: medi o canário — antes de qualquer upload
arquivoCarregado devolve string vazia. Ele realmente indica que o
arquivo subiu. Só não indica que foi importado.
O desfecho: rejeitado
O lote 4947 virou o protocolo 2490033, com situação RE — Rejeitado
pela operadora. A grade carrega o estado em JavaScript, não numa célula:
campo('DT_CONFIRMACAO_2490033').value // data de confirmação
campo('QT_VALIDACAO_PENDENTE_2490033') // validações pendentes
... && 'RE' != 'I' && ... // a situação do lote
A grade de lotes NÃO usa class="registroLista" (a de autorizações e a de
demonstrativos usam). Minha primeira conferência procurou por essa classe,
achou 0 linhas e eu quase concluí que o lote não tinha entrado.
E cuidado com grep solto: /4947/ casou no HTML antes de o lote existir,
porque o número aparece em outros contextos. A régua é a LINHA da grade.
progressoImportacao, não porcent
A página devolvida pelo POST tem porcent() no fonte, mas a tela real dispara
progressoImportacao — capturei no navegador. Nenhum dos dois devolveu nada
nas minhas execuções, inclusive na que deu certo: **o lote foi criado sem que
o progresso respondesse**. Acompanhar o progresso é opcional; conferir a grade
não é.
Baixar arquivo: o servlet genérico (21/11/2026)
Existe um servlet de download, descoberto na tela de XML do demonstrativo:
function finalizarTelaDownloadArquivo(nmArquivo){
window.location = 'DownloadArquivo?file=' + nmArquivo;
}
Ou seja: GET /PlanodeSaude/DownloadArquivo?file=<nome>. A tela que gera o
arquivo (pls_montarTelaDemonstrativoPagDownloadXml.action?nrSeqLote=<n>)
produz o nome e chama o servlet.
Na grade de demonstrativos, o botão é
montarTelaDownloadXml('3.02.01', 3522, '2') — versão TISS, número do
demonstrativo e tipo.
Não medido ainda: se dá para baixar o XML que o prestador ENVIOU (só o de
retorno está provado como disponível).
O que mais o portal oferece e pode servir ao faturamento (21/11/2026)
Dados do prestador — pls_montarDadosPrestador.action (sem função)
Prestador: Laboratorio De Analises Clinicas Indalab Ltda
Tipo vínculo: Profissional recebe da operadora
Tipo prestador: LABORATÓRIO CREDENCIADO
CGC: 81007866000126
Município: INDAIAL / SC
Tipo vínculo e Tipo prestador são regra de negócio: definem como a
operadora paga.
Relatórios do prestador — pls_filtrosRelatorio.action (função 1332)
21 relatórios, no select cdClassifCdRelatorio, com o valor no formato
<id>;<sistema>;<nome>. Os que interessam ao faturamento:
| id | Relatório |
|---|---|
| 2968 | Relatório de Regra de Exames Autogerado para Cooperados — Excel |
| 1922 | Controle Produção Prestadores |
| 2038 | Status importação recurso de glosa |
| 1472 | OPS — Contas complementadas (Demais procedimentos) |
| 1836 | Comprovante de Rendimentos IRRF/CSF — PJ |
| 1977 | Declaração de INSS — Portal |
| 1397 | Extrato Quota-Parte Cooperado (PF e PJ) |
| 398 | OPS — TISS 3.0 — Guia de Comprovante Presencial |
O 2968 é o mais promissor: regra de exames em Excel, direto da operadora.
Hoje essa regra é adivinhada.
Parâmetros em pls_montarParametrosRelat.action; há também
pls_filtroRelatorioGuiasGeradas.action.
Outras telas que respondem a HTTP
| Tela | Action | Função |
|---|---|---|
| Documentos TISS | pls_montarDocumentacao.action | — |
| Dossiê beneficiário | pls_montarTelaDossieBenef.action | 1335 |
| Pesquisa de utilização | pls_montarTelaPesquisaUtilizacao.action | 1289 |
| Comunicados | pls_montarTelaComunicadoExterno.action | 1331 |
Comunicados é onde a operadora anuncia MUDANÇA DE REGRA — vale ler.
Os 21 relatórios do prestador, medidos um a um (21/11/2026)
pls_filtrosRelatorio.action (função 1332). Escolher um relatório dispara
GET pls_montarParametrosRelat.action
?cdClassifCdRelatorio=<id>;<sistema>;<título>
&cdRelatorio=<id>&cdClassifRelat=<sistema>&nmRelatorio=<título>
e carrega os filtros num iframe parametrosRelatorio. **Mandar só o
cdClassifCdRelatorio devolve a tela de login** — faltam os outros três.
O botão chama if (validacaoOK()) gerarRelatorioServlet();.
O que tem filtro preenchido (serve ao Indalab)
| id | Relatório | Filtros |
|---|---|---|
| 1922 | Controle Produção Prestadores | dt inicial, dt final, prestador |
| 2038 | Status importação recurso de glosa | cd guia prestador |
| 512 | OPSW — Contas NÃO Complementadas | prestador exec, período, médico |
| 1472 / 313 | OPS — Contas complementadas | prestador exec, médico, período |
| 1836 | Comprovante de Rendimentos IRRF/CSF — PJ | prestador |
| 398 | OPS — TISS 3.0 — Guia de Comprovante Presencial | prestador |
| 2289 | Vacinação Gestão | prestador (3 opções), período, tipo |
| 50134 | Agenda Cirúrgica | período, convênio (3), prestador |
O que vem com o select de prestador VAZIO
2968 Regra de Exames Autogerado para Cooperados
3805 Analítico do Demonstrativo de GLOSAS — Excel
3364 Analítico do Demonstrativo de PAGAMENTO — Excel
1397 Extrato Quota-Parte Cooperado
1977 Declaração de INSS (competência tem 94 opções; prestador, 0)
1386 Comprovante de Rendimentos IRRF — PF
2703 Fundo Para Margem de Solvência
2136 Pareceres — Oftalmologia
NÃO CONCLUA QUE ESSES OITO "NÃO SE APLICAM"
Foi a minha primeira leitura, e ela não se sustenta. O 2968 é "para
Cooperados" e o Indalab é LABORATÓRIO CREDENCIADO — ali faz sentido. Mas o
3364 é o Analítico do Demonstrativo de Pagamento, e o Indalab TEM 20
demonstrativos de pagamento, que eu mesmo li por HTTP. Dado existe e o filtro
vem vazio.
E o 1977 entrega a prova de que o formulário carrega selects em momentos
diferentes: DATE_PVG_COMPETENCIA vem com 94 opções e
VARCHAR2_NR_SEQ_PRESTADOR_EXEC_P com zero, no mesmo iframe.
**A hipótese viva é que o select de prestador seja preenchido por uma chamada
dependente** — depois de escolher competência, ou por DWR que eu não disparei.
Medir isso vale muito: 3805 e 3364 são o analítico de glosa e de pagamento em
Excel, exatamente o que o faturamento quer.
"Filtro vazio não é resposta da operadora" — é medida do meu preenchimento.