Hapvida / Clinipam — notas e observações
Conector: clinipam-hapvida (RPA + API)
Registro ANS: 340782 (Clinipam) · 368253 (Hapvida)
Portal:portalprestador.clinipam.com.br· API:api.hapvida.com.br
Autorização/elegibilidade: saviatendimento.com.br (medido 20/10/2026, ver abaixo)
Última revisão: 2026-10-22
Prazos contratuais
| Prazo | Quanto | Conta a partir de | Fonte |
|---|---|---|---|
| Envio do lote (XML) | dias 1 a 6 do mês | mês de produção | tela /import-xml — fora da janela o "Enviar" não habilita |
| Envio da NF-e | dias 1 a 7 do mês | mês de produção | GET /v3/invoices/check-valid-period, lido em 22/10/2026 |
| Pagamento | não medido | — | previsão vem por processo em invoiceForecastPayment |
| Recurso de glosa (1º) | 30 dias | EM DISPUTA — o FAQ diz "liberação do demonstrativo de pagamento" (releaseOfPaymentStatementDate); o banner da tela /disallowance diz "liberação do Demonstrativo de Análise de Contas". Ver a seção "Duas fontes do portal discordam", no fim | FAQ e banner do /disallowance, ambos lidos em 22/10/2026 |
| Réplica do recurso | não medido | liberação da Carta Resposta | banner da tela /disallowance, 22/10/2026 |
A frase do FAQ, inteira:
"As solicitações de Recurso de Glosa serão feitas, exclusivamente, por meio do
nosso Portal do Prestador […] na aba 'Glosa' […] e o recurso deve ser
apresentado em até 30 dias após a liberação do demonstrativo de pagamento."
Conferido contra os quatro processos em aberto da Indalab: 27, 57, 94 e 125 dias
desde a liberação, e só o de 27 seguia com allowedSuspensionAppeal: true. A
regra explica os quatro.
Os três convênios Clinipam cadastrados estão com appealDeadlineDays = 30 — o
valor bate, mas era o default, não declaração. Agora tem fonte.
As duas janelas de envio são um dia diferentes uma da outra — lote até o
dia 6, nota até o dia 7 — e isso não é erro de transcrição: são duas telas e
duas respostas de API distintas. Nenhuma das duas enfileira: fora da janela o
portal recusa na hora.
O que o portal NÃO publica: o prazo da operadora para RESPONDER o recurso. O
próprio FAQ manda olhar o contrato ("O prazo está previamente estabelecido em
seu contrato").
O portal é uma casca; o trabalho todo é API
A tela é um SPA React que consome api.hapvida.com.br/provider-portal/web/api.
Praticamente nada precisa de raspagem: login, listagens, geração de relatório e
download são chamadas REST. O RPA existe para obter as credenciais de sessão
e manter o SPA coerente — não para clicar em tabela.
Autenticação: são DOIS segredos, não um
Authorization: Bearer <JWT do login, ~1150 chars>
Ocp-Apim-Subscription-Key: <32 chars, constante do portal>
Timezone: GMT+0000
O segundo é do Azure API Management e vem embutido no bundle do portal —
não é credencial do prestador. Sem ele, toda chamada devolve:
401 "Access denied due to missing subscription key"
Isso custou uma investigação inteira: com o Bearer correto e sem a chave, a API
responde 401 como se a credencial estivesse errada.
O login é POST /v5/authentications/login com
{ userName: <CNPJ>, password, tenantId: 9 } — o tenantId identifica a
Clinipam dentro da Hapvida.
O limit tem teto de 50
Qualquer listagem com limit > 50 devolve 400:
"O parâmetro 'limit' deve ser menor ou igual a 50."
Parece detalhe e não é: quando a função tratava a recusa como lista vazia, a
execução terminava SUCCESS com zero itens — indistinguível de "a operadora
não tem nada a informar". Só apareceu porque havia medição anterior (3 processos
com glosa, 9 lotes) para estranhar o zero.
O demonstrativo de análise é XML TISS oficial
O maior achado da operadora. O portal **gera DEMONSTRATIVO_ANALISE_CONTA no
padrão ANS 3.05.00** — não é planilha própria:
<ans:mensagemTISS xmlns:ans="http://www.ans.gov.br/padroes/tiss/schemas">
<ans:cabecalho>
<ans:tipoTransacao>DEMONSTRATIVO_ANALISE_CONTA</ans:tipoTransacao>
Consequência: não precisa de parser novo. É o mesmo que atende Unimed e
Bradesco. O conector baixa e entrega ao inbox.
A glosa vem codificada, e um item pode ter várias
<ans:relacaoGlosa>
<ans:valorGlosa>85.00</ans:valorGlosa>
<ans:tipoGlosa>1818</ans:tipoGlosa>
<ans:ansCodigo>1818</ans:ansCodigo>
<ans:ansDescricao>COBRANCA DE PROCEDIMENTO QUE EXIGE AUTORIZACAO PREVIA</ans:ansDescricao>
</ans:relacaoGlosa>
Medido no processo 2660555130: 18 guias, 7 glosas, códigos 1818, 1602, 1714
— todos da Tabela 38 da ANS, cruzáveis com a base do Revenue.
O arquivo NÃO sai pronto — e o download mente 200
O fluxo tem fila:
GET /v1/payment-statement/export-report?id={uuid}&type=xml → enfileira, devolve {"notifications":[]}
GET /v1/reports/download?fileName=…&reportType=2 → baixa
Enquanto a geração não termina, o download responde 200 com corpo vazio.
Parar no status é gravar zero byte como se fosse demonstrativo — a condição de
parada tem que ser o conteúdo.
E o conteúdo vem em UTF-16: startsWith('<?xml') sobre string UTF-8 falha,
porque os bytes são <\0?\0x\0m\0l.
Outros dois detalhes do download:
- •
reportType=2é o único que devolve conteúdo. 1 e 3 respondem 200 vazio;
4 devolve 400. O parâmetro não é o formato — o formato vem da extensão.
- •O nome do arquivo é derivável — mas NÃO termina em
-0.
DemonstrativoPagamento-{processo}-{processPortalId}.{ext}. (E sim: o
arquivo do demonstrativo de análise se chama DemonstrativoPagamento-….)
> Corrigido em 21/10/2026, e custou três demonstrativos. O conector
> derivava -0, e com esse nome o download responde **HTTP 200 com zero
> byte** — exatamente o que ele responde enquanto a geração não terminou.
> Resultado: FETCH_ANALYSIS devolvia SUCCESS com nenhum arquivo para a
> Indalab, que tem quatro processos na Clinipam (R$ 2.518,98 em análise e
> três concluídos). Zero não era ausência; era nome errado.
>
> O nome certo veio de escutar o SignalR que avisa o portal quando a
> geração acaba — wss://…/client/?hub=ProviderPortalNotificationHub:
>
> ```json
> {"Title":"Processo 2660741859","Description":"Demonstrativo de Pagamento (XML)",
> "Status":3,"Report":{"Name":"DemonstrativoPagamento-2660741859-4753053.xml","Type":2}}
> ```
>
> Status vai de 1 (enfileirado) a 3 (pronto). O processPortalId **não
> está em nenhuma coluna da tabela** — vem de /v6/medical-files/search,
> cujo content é uma lista, não um objeto paginado com items. Ler
> content.items devolve mapa vazio em silêncio, e sem mapa o nome volta ao
> -0. Esse engano custou uma rodada inteira de medição.
>
> O -0 ficou como última tentativa: funcionou por meses no ESADI, e não
> medimos se a convenção mudou ou se aquele prestador coincide.
- •
type=excelé inválido na geração; os aceitos sãoxml,csv,pdf.
Três fontes de glosa, com alcances diferentes
| XML TISS | XLSX consolidado | API guide-items-error | |
|---|---|---|---|
| Glosa por item | ✅ | ✅ | ✅ |
| Várias glosas no mesmo item | ✅ | ✗ achata | ✗ |
| Código ANS | ✅ | ✅ | ✗ só texto |
| Código proprietário da operadora | ✗ | ✅ (ex.: 329) | ✗ |
| Tributos e valor líquido | ✗ | ✅ | via /header |
| Parser | já existe | novo | novo |
O consolidado é o único com o par completo: `329 VALOR DO PROCEDIMENTO COBRADO
ACIMA DA TABELA (operadora) ao lado de 1714 VALOR DO SERVICO SUPERIOR AO VALOR
DE TABELA` (ANS). Um serve para auditar no padrão, o outro para conversar com a
operadora nos termos dela.
Glosa com valor ZERO existe, e é invisível para filtro por valor
No consolidado de 05/2026: 89 itens, Valor Glosado = 0,00 em todos, e ainda
assim uma linha tem motivo preenchido — cobrança acima da tabela, paga pelo valor
da operadora. Um parser que filtre valorGlosado > 0 não vê nada e conclui que
não houve glosa.
O que só o portal tem (fora do TISS)
- •
/v2/suspensions— o que ainda dá para contestar. Cada processo traz
allowedSuspensionAppeal, que é a operadora dizendo se a janela de recurso
segue aberta. Isso é melhor que o appealDeadlineDays que o Revenue estima em
30 dias: é resposta, não convenção. Na tela, o processo de 02/2026 aparece
sem link de recurso — janela fechada.
- •
/v6/medical-files/search—processForecastPaymentepaymentDate:
previsão e data efetiva de crédito, que nenhuma transação TISS carrega.
- •
/v3/medical-files/check-valid-period— a janela em que a operadora
aceita envio, declarada por ela.
- •
/v4/process-portal/without-invoice— processos esperando nota fiscal.
Pendência que segura pagamento e hoje ninguém enxerga.
Recurso de glosa: mapeado, envio não medido
/suspension-appeal-new/{processo} — título "Recurso de Glosa".
Campos: appealValue, note (máx. 500 caracteres), healthAccountXml
(arquivo, com botão "Versões Suportadas").
Tabela item a item, com Valor Glosa, Saldo, Valor Recurso *, Glosa,
Anexos, Justificativa *. Os asteriscos são obrigatórios: **recorre-se por
item**, com valor e justificativa próprios — não pelo processo inteiro.
Endpoints do formulário, todos GET:
/v2/suspensions/{processo}/header
/v2/suspensions/{processo}/items?limit=50&offset=0
/v2/suspensions/{processo}/totalizer
/v2/suspensions/{processo}/request-items/totalizer
/v2/suspensions/{processo}/xml/status
O POST de envio não foi capturado — só apareceria ao clicar "Enviar", e
recurso protocolado é fato criado na operadora. Precisa de uma sessão
acompanhada, com um processo real de baixo valor.
/xml/statussugere que o recurso pode ir por XML TISS (RECURSO_GLOSA),
não só pelo formulário. Se for, o caminho é gerar o XML em vez de preencher
tela — mas isso também não foi medido.
A listagem de produção NÃO mostra todos os processos
O achado mais caro de 02/08/2026, e o que mais se paga: **/v6/medical-files/search
não é o inventário da operadora.** É a fonte da tela /medical-production, de
onde o fetchAnalysis tira a lista — e ela mente por omissão.
Medido para a ESADI, em 2026: nove processos. Sempre os mesmos nove, **com
qualquer filtro de data**:
(sem filtro) 9 itens
?startDate=2026-01-01&endDate=2026-12-31 9 itens
?productionDateStart=…&productionDateEnd=… 9 itens
?initialDate=…&finalDate=… 9 itens
?year=2026 9 itens
?competence=2026-02 9 itens
Todos respondem HTTP 200. Nenhum parâmetro de data teve efeito — não é
janela de tempo que dá para alargar, é uma lista que simplesmente não inclui
tudo. Não gaste tempo procurando o filtro certo: já foi procurado.
/v2/suspensions vê o que a listagem esconde
O décimo processo apareceu ali:
2660174542 produção 02/2026 importado 04/03/2026
diferença R$ 83,60 allowedSuspensionAppeal: false
Invisível para nós desde março, com a janela de recurso já fechada. Ou seja: o
buraco não é acadêmico — custou o prazo de contestar.
E o arquivo dele existe. Baixa direto, sem mandar gerar:
GET /v1/reports/download?fileName=DemonstrativoPagamento-2660174542-0.xml&reportType=2
→ 200, 24.915 bytes, XML TISS em UTF-16
Isso importa porque para processo que só aparece em suspensions **não temos o
statementUuid**, e a geração (export-report?id={uuid}) exige. O caminho é
pedir o arquivo pronto pelo nome derivável.
O conector hoje faz a UNIÃO das duas fontes. Se um dia aparecer uma terceira
lista, o padrão já está montado.
Não descarte a suspeita ao contrário: pode haver processo que não esteja
em NENHUMA das duas. As duas listas juntas são o melhor que medimos, não uma
garantia de completude.
Inventário de 2026, para conferência futura
Dois processos por competência — um CONSULTA, um SADT:
| Competência | Processos |
|---|---|
| 02/2026 | 2660174542 *(só em suspensions)* |
| 03/2026 | 2660367835 · 2660367839 |
| 04/2026 | 2660371962 · 2660371963 · 2660372287 |
| 05/2026 | 2660467641 · 2660467651 |
| 06/2026 | 2660555130 · 2660555132 |
Nada em 01/2026 nem em 07/2026, em nenhuma das duas fontes.
O login mente sobre o motivo da recusa
O SPA mostra a recusa num toast do Toastify, que some sozinho em ~5 segundos.
O código antigo clicava em Confirmar, esperava até 30s pela URL mudar e só então
procurava a mensagem — quando ela já tinha evaporado. Sobrava o genérico
"página pós-login não detectada", que não distingue credencial errada, bloqueio,
limite de sessão ou lentidão.
O print da falha mostra o formulário preenchido, na tela de login, sem
mensagem nenhuma. Não conclua "credencial inválida" a partir disso.
A verdade está em POST /v5/authentications/login: o conector escuta a resposta
e reporta status e corpo. Sem resposta em 45s, também é log próprio — "o clique
não virou chamada" é outro diagnóstico.
O que a investigação DESCARTOU
Houve duas recusas desse tipo (31/07 21:12 e 02/08 18:29). Tentamos reproduzir:
| Hipótese | Teste | Resultado |
|---|---|---|
| Limite de logins seguidos | 5 logins em série, 5s de intervalo | 5/5 HTTP 200, 6-7s cada |
| Sessão única por usuário | sessão B com a A viva | as duas OK; a A seguiu funcionando |
| Logins simultâneos | duas sessões em Promise.all | as duas OK |
7 de 7 com HTTP 200. Nenhuma hipótese se sustentou — a recusa é transitória e
não reproduz sob condição controlada. As duas ocorrências coincidiram com
atividade paralela nossa contra a API (varredura de diagnóstico rodando junto),
o que sugere throttle por VOLUME de chamadas e não por sessão. É suspeita, não
medição: não conseguimos provocá-la de novo.
A repetição automática cobre o caso. Em 02/08 a execução falhou em 35s e a
tentativa seguinte, no mesmo minuto, passou em 59s e trouxe o demonstrativo. O
que não pode voltar é o diagnóstico genérico: da próxima vez, o log dirá o
status que a operadora devolveu.
Armadilhas de navegação
Deep-link quebra o tenant. Abrir /suspension-appeal-new/{id} direto no
navegador leva à tela de login: o SPA usa o primeiro segmento da URL como
identificador de host, e chama layout?host=/suspension-appeal-new. A navegação
tem que ser de dentro — clicando no link.
O campo de login mudou de nome. Era #userName; desde 31/07/2026 a página
serve <input id="cnpj" placeholder="CPF/CNPJ">. O sintoma da quebra era mudo:
18 segundos esperando um seletor que nunca ia aparecer, e a mensagem genérica
"formulário de login não encontrado". O seletor atual aceita os dois nomes.
fetchReturns monta CSV e perde código de glosa. O caminho antigo serializa
o JSON de guide-items; guide-items-error só traz message em texto livre.
Para glosa codificada, use FETCH_ANALYSIS (XML TISS).
CHECK_STATUS: a consulta de protocolo, e o verde que não era verde
Medido em 22/10/2026 na conta da Indalab. A operação é a tela
/medical-production, que lista os processos do prestador. O thead tem 14
colunas e a coluna 0 é a de expandir — por isso os índices úteis começam
em 1:
| Índice | Coluna |
|---|---|
| 1 | Número Processo |
| 2 | Número Lote |
| 3 | Mês Produção |
| 4 | Status |
| 5 | Tipo Processo |
| 6 | Data Importação |
| 7 | Valor Produção |
| 8 | Status NF |
| 9 | Previsão Pagamento |
| 10 | Valor Pagamento |
| 11 | Data do pagamento |
O filtro é #processNumber ("Buscar por nº do processo") + o button[type=submit]
do formulário. Comportamento medido, que é o que importa aqui:
| Busca | Resposta da grade |
|---|---|
2660632996 (existe) | 1 linha, a do processo pedido: Concluído, pago R$ 6.280,03 em 21/09/2026 |
9999999999 (não existe) | 1 linha-placeholder vazia + o texto "Nenhum registro" |
Dois defeitos que se somavam num verde falso
1. O leitor caía na primeira linha. check-status.ts tinha, depois do laço
de busca, um "se não achou, devolve a primeira linha da grade". Como a busca
por número inexistente ainda devolve UMA linha (vazia), o retorno era
portalStatus: '' → mapPortalStatus('') → PROCESSING. Com um filtro que
não tivesse sido aplicado, seria o processo de outro prestador devolvido
como resposta. É o mesmo defeito que a Unimed Blumenau tinha em
CHECK_STATUS — e lá ele devolveu a guia de outra pessoa como SUCCESS.
2. NOT_FOUND contava como sucesso. O executor devolvia SUCCESS para
qualquer desfecho de CHECK_STATUS, inclusive "não encontrei". Na matriz
pública isso acende a célula de verde ("rodou em produção") sem que o status
de nada tenha sido lido.
Corrigidos em 22/10/2026: igualdade exata no número de processo ou de lote (sem
contains, que casaria o processo de outra competência), sem fallback de
primeira linha, e NOT_FOUND → FAILED com errorCode: STATUS_NOT_FOUND.
O terceiro defeito estava no DTO, e explicava três vermelhos
As três falhas de CHECK_STATUS de 02/08/2026 — bradesco-saude,
clinipam-hapvida e unimed-blumenau-soap — eram a mesma coisa:
referenceId (protocol) obrigatorio para CHECK_STATUS. A execução foi criada
sem protocolo porque CreateExecutionSchema não exigia referenceId para esta
operação; quem recusava era o executor, já com navegador aberto e login feito.
CHECK_STATUS entrou na lista exigeRef — agora é 400 na criação.
Não era, portanto, defeito de conector nenhum dos três: era chamada sem
insumo, e a matriz pintava de vermelho o canal.
Autorização fica NOUTRO portal: o Savi
Atualizado em 20/10/2026. A seção abaixo dizia que elegibilidade e
autorização "não foram encontradas". A ressalva estava certa — *não mapeado* não
é *não existe* — e o canal apareceu: saviatendimento.com.br.
https://saviatendimento.com.br/saviatendimento/login.faces
Como se sabe que é do grupo Hapvida (medido, não deduzido)
1. O captcha da tela de login é servido pelo próprio Hapvida:
https://www.hapvida.com.br/captcha/captcha.php?l=100&cp=191&a=45&tf=20&ql=4.
O link do manual tem id idManualHap.
2. O portal tem um logo por empresa-plano em
/saviatendimento/img/logoEmpresaPlano/<id>.png. Varridos os ids de 1 a 30,
existem cinco:
| id | Empresa |
|---|---|
| 1 | Hapvida |
| 8 | Hapvida PORTO ALEGRE (CCG SAÚDE) |
| 9 | Hapvida CLINIPAM |
| 10 | Hapvida NOTRE DAME MG |
| 14 | Hapvida NOTRE DAME SP / RJ |
A palavra "Clinipam" NÃO aparece no HTML da tela de login. A prova é o
logo da empresa-plano 9, não o texto. Um grep por "clinipam" na página dá
zero — e um teste frouxo por /clinipam|hapvida/ dá "verdadeiro" casando só
com *hapvida*, do captcha. Já custou uma conclusão errada nesta sessão.
O que se sabe da tela de entrada
| Item | Medido |
|---|---|
| Stack | JSF (login_form:username, .faces) — mesma família do SC Saúde |
| Login | CPF + senha + captcha de imagem |
| Campos | login_form:username, login_form:password, login_form:codigo_captcha |
| Submit | login_form:j_idt24 (id instável, ancorar no texto "Entrar") |
| Versão | v1.7.11-1.457 |
| Extras | "Tutorial - Instalação Biometria", "Instaladores", manual próprio |
O que isso implica para o conector
- •O captcha é o obstáculo real. Diferente dos outros portais, aqui ele está
na porta de entrada e é imagem. RPA sem resolução de captcha não passa — e
isso precisa de decisão de produto, não de código.
- •Biometria aparece de novo, como no SC Saúde. Provavelmente o fluxo de
autorização pede confirmação do beneficiário por token/biometria, com
justificativa como alternativa.
- •O JSF traz as mesmas armadilhas já pagas no
scsaude-atendimento: ids
j_idt<N> instáveis, modal que rouba foco do teclado, campos que se limpam
durante a montagem da página. Ver
[notas/sc-saude.md](sc-saude.md) antes de começar.
Respondido em 21/10/2026: o Savi entra, e ele AUTORIZA
As três perguntas acima foram medidas com credencial de prestador
(CPF 04201470989, operador CHARLENE CENSATO / 155120):
| Pergunta de ontem | Resposta medida |
|---|---|
| A credencial entra? | Sim — mas é outra credencial, de CPF, não a do portalprestador |
| O Savi solicita ou só consulta? | Solicita. Criamos uma autorização de verdade |
| Qual empresa-plano? | CLINIPAM CLIN. PARAN. DE ASSIST. LTDA, com link "Trocar de Operadora" no cabeçalho |
Prestador que o login enxerga: LABORATORIO DE ANALISES CLINICAS T.W.A LTDA
(o LabVW), código 214602900 no select de prestador. Logo, para a Clinipam o
executante das nossas provas é o LabVW — a guia de teste em
[guias-teste/](../guias-teste/README.md) é do Santa Isabel e precisa da mesma
adaptação que a SulAmérica.
O logo carregado depois do login foi /img/logoEmpresaPlano/10.png, e a
tabela de ids acima (varredura de 20/10) diz que 10 é NOTRE DAME MG e 9 é
CLINIPAM. Não use o id da imagem como prova de operadora — pelo menos um
dos dois está errado, e quem manda é o texto do cabeçalho.
O menu inteiro, que é o mapa das operações
Elegibilidade Beneficiário /pages/autorizacao/elegibilidade/elegibilidade_autorizacao.faces
Autorização → Consulta /pages/autorizacao/consulta/autorizacao_consulta.faces
Autorização → Procedimento /pages/autorizacao/procedimento/autorizacao_procedimento.faces ← SP/SADT
Autorização → Executar /pages/autorizacao/execucao/execucao_procedimento.faces
Autorização → Cancelar /pages/autorizacao/procedimento/cancelar_autorizacao.faces
Relatório → Produção /pages/relatorio/relatorio_producao.faces ← o que foi autorizado
Relatório → Pendências /pages/relatorio/relatorio_pendencia.faces ← o que está em análise
Relatório de Protocolo /pages/relatorio/relatorio_protocolo.faces
Demonstrativo de Produção /pages/encerramento/encerramento.faces
Honorários /pages/honorarios/honorario_pesquisa.faces
Solicitações Internação/PQA /pages/autorizacao/solicitacao/solicitacao.faces
Ativação de Senhas /pages/ativasenha/ativacaoSenha.faces
Biometria → Elegibilidade /pages/biometria/elegibilidade.faces
Campos da tela de autorização de procedimento (JSF, form formulario):
codigo_beneficiario + j_idt80 (pesquisar) · tipo_consulta · prestador ·
crmExecutante + conselho + j_idt118 (pesquisar) · medico ·
diagnostico · codigo_procedimento + adicionar · botão Confirmar.
As oito armadilhas do Savi, todas medidas em 21/10/2026
1. O captcha de imagem é a porta. captcha.php?l=100&cp=95&a=45&tf=20&ql=4
— 4 caracteres manuscritos, servidos por www.hapvida.com.br, não pelo Savi.
O botão de recarregar é login_form:j_idt20; recarregar REBATE o código na
sessão, então dá para pedir um legível em vez de adivinhar o borrado.
2. Modal de mensagem fica aberto e engole o clique seguinte. Toda recusa
abre #ModalMensagens; enquanto ele estiver lá, qualquer click falha com
*timeout* ("subtree intercepts pointer events") e parece mudança de leiaute.
É a mesma armadilha da SulAmérica. Feche antes de cada passo:
$('.modal').modal('hide'); $('.modal-backdrop').remove();
3. "Usuário não encontrado" não quer dizer carteira inválida. A carteira da
guia de teste é 0E3IW000002003 — com I maiúsculo, que na impressão é
idêntico a 1. Três tentativas morreram nisso. Confira o PDF a 300dpi antes
de culpar o portal.
4. O solicitante tem que existir na base da operadora. O médico da guia
(RODRIGO KRAFT ROVERE, CRM 15751/SC) devolve "CRM não encontrado"; o CRM
11648/SC (EDSON ANDRE STAKONSKI) resolve na hora. A busca por nome exige 10+
caracteres e só acha quem está na base: MARIA SILVA devolve zero, então
ela não serve de teste de saúde do portal. Para achar um CRM bom, leia o
Relatório de Produção do próprio prestador — ele mostra o solicitante de
cada autorização que já passou.
5. Diagnóstico é texto livre, 100 caracteres (alfanumerico-espaco), não
CID. Não procure a tabela: não tem.
6. **Alguns procedimentos exigem anexo de solicitação médica — e o portal só
diz isso DEPOIS do Confirmar.** O hemograma (40304361) exigiu; a creatinina
(40301630) não. A tela que aparece é "Autorização de Procedimentos - ANEXO
PENDENTE", com os procedimentos que precisam. Limite: 2.3MB, só
jpeg, jpg e pdf. O upload é PrimeFaces
(pesquisa_autorizacao_senha_imagem:…_input), responde "Documento adicionado
com sucesso" e mostra a miniatura.
7. Com anexo, o desfecho é ANÁLISE, não autorização. A tela final diz
*"Sua solicitação está em análise, gentileza acompanhe o retorno no relatório
de pendências"* e a senha sai mascarada (*****). Quem automatizar não pode
ler isso como negativa nem como senha.
8. O número da guia não tem coluna. Ele vem no atributo title da célula do
procedimento — title="E 304529670 dep.lib. false" — e repetido no tooltip
da senha. Raspar a tabela pelo texto visível perde o identificador.
O ciclo do Savi tem QUATRO passos, não dois
Esta é a correção mais cara da nota, e ela desmonta o que estava escrito aqui
antes ("o cancelamento opera sobre senha emitida"). Medido em 21/10/2026 na
conta da Indalab:
1. elegibilidade elegibilidade_autorizacao.faces o beneficiário pode
2. autorização autorizacao_procedimento.faces nasce a SENHA (ou vai para análise)
3. EXECUÇÃO execucao_procedimento.faces a senha vira atendimento realizado
4. cancelamento cancelar_autorizacao.faces desfaz a EXECUÇÃO
Senha emitida e não executada fica em EXECUÇÃO PENDENTE e não gera
produção. A prova é um par do mesmo beneficiário, do mesmo exame, no mesmo dia:
| Senha | Guia | Sessões | Tela de execução | Tela de cancelamento |
|---|---|---|---|---|
AR0199848 | 304416778 | 0 de 1 | achada, pronta para executar | "Prestador sem autorizações para cancelamento" |
AR0211735 | 304418266 | 1 de 1 | achada, já executada | aparece, ATIVO, executada 21/10 08:29 |
Ou seja: a mensagem "sem autorizações para cancelamento" **não é falta de
permissão nem senha inexistente** — é não haver lançamento a desfazer. E não
existe tela para cancelar solicitação em análise: ela fica lá até a operadora
responder.
#### Executar (execucao_procedimento.faces)
Senha * ──[Pesquisar]──► preenche formulario:guia (guia da OPERADORA) e mostra
usuário, tempo de plano, prestador, procedimento,
Sessões Autorizadas e Sessões Realizadas
Qtde. * ──[Confirmar]──► #ModalResultadoExecucaoProcedimento
Uma senha por execução. O Savi não tem lista de procedimentos aqui: cada
exame do mesmo pedido sai com senha própria (medido: AR0199846, AR0199848,
AR0211735, AR0211883… todas do mesmo beneficiário, no mesmo dia).
O par Sessões Autorizadas / Sessões Realizadas é a ÚNICA fonte de "esta
senha já foi usada?" — e é o que impede o conector de lançar o atendimento
duas vezes.
O título do modal de resultado é fixo ("Execução de Autorização Pendente")
e não diz nada sobre o desfecho; quem diz é a faixa interna, "Procedimento
Autorizado" em verde. Classificar pelo título daria sucesso até na negada.
#### Duas paredes na execução que não são bug
- •Token do beneficiário (
#ModalAutenticacaoToken): código de 7 dígitos
enviado ao celular do paciente. Há "Autorizar sem token", mas exige escolher
justificativa (21 a 27: paciente internado, urgência, instabilidade de
sistemas, beneficiário se negou, coleta domiciliar, material enviado por
terceiros, não possui celular) e marcar uma declaração de que se conferiu
o documento do beneficiário. Declaração é de gente: o conector para e avisa.
- •Biometria (
#ModalBiometria,#ModalBiometriaFacial, modais de
responsável): exige leitor ou câmera na ponta. Idem.
Os dois modais já existem no HTML desde o carregamento — testar presença dá
falso positivo; o teste é de visibilidade.
#### Cancelar (cancelar_autorizacao.faces)
senha OU código do usuário ──[Pesquisar]──► tabela com checkbox por linha
colunas: Selecionar | Procedimento | Senha | Usuário | Qtde Real |
Dt Execução | Situação
[Cancelar] ──► #ModalCancelamento "As senhas selecionadas serão canceladas.
Deseja prosseguir ?" ──[Sim]──►
#ModalCancelamentoMotivo (formMotivo:idMotivo, TEXTO LIVRE obrigatório)
──[Confirmar]──► #ModalCancelamentoRetorno
Sem linha marcada, abre #ModalCancelamentoSelecione ("Selecione pelo menos
uma autorização para cancelar"). Pesquisar sem senha e sem usuário devolve
"Preencha o Usuário ou a Senha" — a competência e o intervalo de dias sozinhos
não bastam.
Não há campo de número de guia nesta tela, e a tabela não mostra guia: **o
cancelamento é pela SENHA**. Mandar 304548146 aqui não acha nada.
#### "Autorização → Consulta" não é consultar autorização
É Autorização de Consultas — autorizar consulta médica, irmã da tela de
Procedimento, com codigoConsulta (00010014 - CONSULTA EM CONSULTORIO) e
queixa obrigatória. Quem procurar ali a consulta de status perde tempo: o
status mora nos relatórios de Pendências e Produção.
Status: onde cada coisa aparece
| Situação | Onde |
|---|---|
ANALISE OPERADORA | Relatório de Pendências |
SENHA PENDENTE, SENHA PENDENTE DE ATIVAÇÃO, EXECUÇÃO PENDENTE, PROCEDIMENTO INDEFERIDO | Relatório de Pendências (filtro "Situações") |
Autorizado, com senha AN… | Relatório de Produção |
O Relatório de Produção traz, por procedimento: data de execução, usuário,
CRM UF + nome do solicitante, código e descrição, urgência, qtde autorizada e
realizada, data da autorização, nº da guia e senha. É a fonte natural
para CHECK_AUTH_STATUS — e, de quebra, é de onde se tira um CRM válido.
A execução real de 21/10/2026
| Guia | 304529670 |
| Beneficiário | FABIO PINTO HOFFMANN — 0E3IW000002003 (elegível: 59 anos, 7 anos de plano, regulamentado SIM) |
| Solicitante | 11648 CRM — EDSON ANDRE STAKONSKI *(substituto: o da guia não existe na base)* |
| Executante | LABORATORIO DE ANALISES CLINICAS T.W.A LTDA |
| Procedimentos | 40301630 creatinina · 40304361 hemograma |
| Anexo | a própria guia SP/SADT em PDF |
| Desfecho | ANÁLISE OPERADORA, senha ***, não cancelável** |
O conector clinipam-savi (21/10/2026)
O Savi ganhou conector próprio — clinipam-savi, separado do
clinipam-hapvida porque são sistemas distintos, com credenciais distintas
(CPF do operador aqui, CNPJ no portal do prestador). Declara e implementa
VALIDATE_CREDS, CHECK_ELIGIBILITY, REQUEST_AUTH e CHECK_AUTH_STATUS.
O captcha deixou de ser bloqueio. Ele é resolvido pelo solver que a casa já
tinha (antibot/captcha-solver.ts), que falava só com captcha de token e
ganhou solveImageCaptcha (ImageToTextTask).
A escolha do provedor começou errada nesta sessão — a proposta foi ler a imagem
com o próprio Claude. O ogmma-juridico já tinha medido a pergunta num
captcha quase igual (TJMG, 110×40px, 5 alfanuméricos):
| Provedor | Acerto por chamada | Custo | Latência |
|---|---|---|---|
| CapSolver | ~98% | $0,0005 | 10-20s |
| Claude Haiku 4.5 | ~25-30% | $0,004 | 2s |
| Tesseract local | ~26% | $0 | 1s |
Serviço especializado ganha em acerto e em preço. O LLM ficou de reserva.
Medição no Savi, 21/10/2026 — 5 logins completos, 7 captchas consumidos:
5/5 entraram, ~71% de acerto por imagem, 200-800ms por chamada (bem mais
rápido que no TJMG). E o erro do CapSolver aqui tem padrão: ele devolve **letra
onde o Savi escreveu dígito** (379s, o139, 70s8). Como o alfabeto do
portal é numérico, um mapa letra→dígito recupera a maioria — 379s virou
3795 e entrou. Isso só vale porque o alfabeto é numérico; noutro portal o
mesmo mapa estragaria resposta certa.
#### Três armadilhas que só apareceram ao automatizar
1. waitForNavigation no login queima 60s a cada erro. O sucesso navega
para /pages/home.faces; a recusa re-renderiza a mesma página por ajax.
Esperar navegação transforma duas tentativas em dois minutos. Espere pelo
desfecho — URL mudou OU modal apareceu.
2. Recarregar só a imagem não basta. Depois de um código recusado, trocar a
imagem e reenviar foi recusado 3 em 3 vezes: a página carrega ViewState e
captchatoken já gastos. Com goto na tela de login, entra.
3. \s dentro de template literal vira s. O page.evaluate recebe uma
string, e /\s+/g escrito com uma barra só compila para /s+/g — que casa
a letra S. O parser do relatório devolveu guia vazia e situação vazia por
isso, com as linhas corretas na mão. Dentro do template, \\s.
#### Exercitado em produção, pelo conector
VALIDATE_CREDS → {"valid":true} (captcha resolvido sozinho)
CHECK_ELIGIBILITY → FABIO PINTO HOFFMANN, 59 anos, 7 anos de plano, regulamentado
CHECK_AUTH_STATUS → guia 304529670, status 2 "Em análise na operadora"
REQUEST_AUTH está implementado e foi percorrido à mão (foi assim que a
304529670 nasceu), mas não foi disparado pelo conector: cada execução cria
um pedido de verdade e, em análise, ele não é cancelável. Falta uma rodada com
o aval de quem opera.
A conta da Indalab, e as três coisas que ela mostrou (21/10/2026)
O primeiro acesso usado foi o do LabVW. Com o da INDALAB (CPF
06587366988, operador JANICE DEBARBA / 154866) apareceram três coisas que o
outro escondia — e as três quebram quem generalizou do primeiro prestador:
1. Operador com mais de uma empresa para numa tela antes de entrar.
O login passa e o Savi NÃO vai para /pages/: mostra "Olá! Janice — Selecione
a empresa para continuarmos". O conector lia isso como recusa. As opções não
têm texto: são logos, e o que identifica cada uma é o arquivo
img/loginEmpresaPlanoHtmlUx/carrocel_<id>.png. A Indalab vê duas —
carrocel_9 (CLINIPAM) e carrocel_14. Escolher pela POSIÇÃO entraria na
operadora errada no dia em que o carrossel mudar de ordem, e entrar na
operadora errada não falha: só cria autorização no lugar errado.
2. A exigência de anexo é por PRESTADOR, não por procedimento.
No LabVW, a creatinina (40301630) passou sem anexo e só o hemograma exigiu. Na
Indalab, a mesma creatinina foi barrada. Não existe lista de
"procedimentos que exigem documento" que sirva para os dois — o jeito é mandar
o pedido médico sempre que houver.
3. Cinco falhas seguidas desativam a conexão. É proteção do produto
(isActive vai a false), e ela disparou durante a medição. Quem for depurar
contra o portal vai esbarrar nisso e ler "Integracao desativada" como se fosse
erro de credencial.
#### Dois defeitos nossos que o portal denunciou de um jeito enganoso
| O que o erro dizia | O que era | |
|---|---|---|
| "Savi não aceitou o captcha em 3 tentativas" | Três leituras bastavam em 97,6% dos casos; caímos nos 2,4%. Agora são cinco (~0,2% de não entrar), e a leitura bruta vai no log | |
| "Savi recusou o anexo e segue exigindo documento" | O anexo nunca subiu. A espera pelo upload era `/Documento adicionado com sucesso | Excluir/ no document.body` — e *Excluir* é o nome de uma COLUNA da tabela de procedimentos, já na tela. A condição era verdadeira antes do upload começar |
A espera certa é pela miniatura dentro de #panel_autorizacao_senha_imagem:
medido, ~2s depois de escolher o arquivo o painel ainda diz "Nenhum imagem
encontrada" (está só em espera) e por volta de 4s a imagem aparece.
#### O ciclo, rodado PELA PRODUÇÃO na conta da Indalab
clinipam-hapvida VALIDATE_CREDS SUCCESS (faturamento, login por CNPJ)
clinipam-hapvida FETCH_RETURNS SUCCESS 0 arquivos na janela — mas é sucesso de verdade,
com as duas metades relatadas
clinipam-savi VALIDATE_CREDS SUCCESS captcha resolvido sozinho + escolha de empresa
clinipam-savi CHECK_ELIGIBILITY SUCCESS FABIO PINTO HOFFMANN, 59 anos, regulamentado
clinipam-savi REQUEST_AUTH PARTIAL guia 304548146 criada, com o pedido médico anexado
clinipam-savi CHECK_AUTH_STATUS SUCCESS 304548146 em ANALISE OPERADORA
REQUEST_AUTH fica PARTIAL, não SUCCESS, porque a guia saiu *em
análise*. É a convenção do executor para desfecho pendente — a mesma da
Orizon. Não é falha: é a operadora não ter decidido ainda.
As duas conexões ficaram cadastradas para a empresa INDALAB, em convênios
separados — CLINIPAM (faturamento) e CLINIPAM — portal Savi (autorização).
São dois portais da mesma operadora, e a chave única é (empresa, convênio,
método, ambiente): sem o segundo convênio, a segunda conexão não cabe. É o
mesmo arranjo que o Santa Isabel já usa no SC Saúde.
EXECUTE_PREAUTH e CANCEL_GUIDE no conector (21/10/2026)
Implementados em executar-procedimento.ts e cancelar-autorizacao.ts. O que
foi exercitado contra o portal de produção, e o que não:
| Caminho | Medido |
|---|---|
| login → pesquisa de senha na execução | ✔ AR0199848 → guia 304416778, 0 de 1; AR0211735 → guia 304418266, 1 de 1 |
| guarda de dupla execução | ✔ executePreauth em senha já executada devolveu JA_EXECUTADA sem confirmar nada |
| login → pesquisa na tela de cancelamento | ✔ a executada devolve 1 linha ATIVO; a pendente devolve 0 |
| recusa medida do cancelamento | ✔ cancelled: false com a frase do portal |
| Confirmar da execução | ✘ não disparado |
| Confirmar do cancelamento | ✘ não disparado |
As duas escritas que faltam não dependem de acesso: dependem de uma senha
descartável. As únicas senhas executáveis na conta são de pacientes reais da
Indalab, e executar ou cancelar uma delas mexeria no faturamento do cliente.
Fechar o ciclo exige criar uma autorização nossa que saia com senha na hora
(REQUEST_AUTH com exame que não cai em análise), executá-la e cancelá-la em
seguida — nessa ordem, porque sem execução não há o que cancelar.
Falta também expor EXECUTE_PREAUTH na API pública: o despacho interno
(executor + DTO de execução) foi criado junto, mas o recurso
public-api/recursos/autorizacao ainda não tem rota para ela.
O ciclo rodado até o fim contra produção (22/10/2026), e onde ele para
Pedido NOSSO, criado para ser descartável: Glicose (40302040), sem anexo,
no mesmo beneficiário das medições anteriores. A escolha não foi aleatória — as
duas senhas antigas do prestador (AR0199848, AR0211735) eram de Glicose e
tinham senha, enquanto a Creatinina de 21/10 exigiu documento e caiu em
análise. O palpite se confirmou:
REQUEST_AUTH 40302040 GLICOSE JEJUM
guia 304557120
senha AR0938134 ← autorizada NA HORA, sem análise
Confirmado, então, o que faltava no ciclo: autorização na hora existe neste
prestador, e o que manda é o procedimento, não o canal.
#### A tela volta EM BRANCO, e isso custou um PARTIAL falso
Depois do Confirmar, o Savi não mostrou tela de confirmação nenhuma: devolveu
o formulário de Autorização de Procedimento zerado ("PENDÊNCIAS DO DIA: 0 /
AUTORIZAÇÕES DO DIA: 0"). O lerDesfecho lê o texto da tela; sem texto, caiu
em "Desfecho não reconhecido" → PARTIAL. A autorização existia, com senha.
O número da guia só apareceu porque havia um plano B que varre o relatório de
pendências — e era na mesma linha desse relatório que estava a senha,
ignorada. Corrigido: a tela é o caminho rápido, o relatório é a fonte. Quando a
tela não traz desfecho, a linha decide (desfechoDaLinha).
#### A sexta situação: senha emitida com situação que não casa nenhuma das cinco
A linha de pendências da 304557120 veio com senha: AR0938134 e a célula de
situação não casando ANALISE OPERADORA, SENHA PENDENTE,
EXECUCAO PENDENTE, SENHA PENDENTE DE ATIVACAO nem
PROCEDIMENTO INDEFERIDO. O fallback do CHECK_AUTH_STATUS era "2 — em
análise": o conector respondia que a operadora ainda não tinha decidido sobre
uma autorização que já tinha senha, e respondia isso com SUCCESS.
Regra nova, em statusDaSituacao: situação conhecida manda; situação
desconhecida com senha é autorizado (1); sem senha segue pendente (2).
Indeferido não vira autorizado por ter senha ao lado.
Fica em aberto se a célula vem vazia do portal ou se o parser lê a célula
errada nesse relatório — ver a lista do que ainda não foi medido.
#### A segunda Glicose do mesmo paciente quase devolveu a senha da primeira
Com um pedido já existente no relatório do mês, a busca pela linha da
solicitação nova fica ambígua: o relatório de pendências não guarda o
número da guia do PRESTADOR, só o da operadora, e duas Glicoses do mesmo
beneficiário ficam idênticas aos olhos do parser. O find pegava a primeira —
isto é, devolveria a senha do pedido ANTERIOR como desfecho do novo, com
SUCCESS.
Resolvido lendo o relatório antes de preencher o formulário e guardando as
guias que já existiam para aqueles procedimentos. Depois do Confirmar, a
linha nossa é a que não estava lá. Se sobrar mais de uma candidata nova, ou se
nenhuma for nova e houver várias, o conector recusa escolher e o desfecho
fica pendente: ler o desfecho do pedido errado é pior do que dizer "não sei
qual é".
A primeira versão dessa regra ainda tinha um buraco, e ele apareceu na hora:
"nenhuma guia nova, mas uma candidata só → devolve ela". O segundo pedido de
Glicose não criou guia nenhuma — o relatório seguiu com as mesmas duas
linhas, 304548146 (Creatinina, ANALISE OPERADORA) e 304557120 (Glicose,
senha AR0938134) — e a única candidata que sobrou era a do pedido anterior.
O conector devolveu SUCCESS jurando autorização com a senha de antes. Linha
conhecida é linha de OUTRO pedido: agora a candidata única só vale se ela
também não estava lá antes.
#### Por que o segundo pedido não criou guia: DUPLICIDADE
Com o conector passando a guardar o que o portal diz, a terceira tentativa
respondeu:
Existe um procedimento 40302040 - GLICOSE JEJUM, PENDENTE lançado em
22/10/2026, verifique seu relatório de pendências.
Então o Savi recusa pedido repetido enquanto o anterior está pendente —
mesmo beneficiário, mesmo procedimento. E recusa do jeito mais enganoso
possível: a mensagem aparece numa tela que, no mais, é o formulário em branco,
sem nada que diga "não criei". Sem reconhecer a frase, o desfecho era "não sei".
Agora é desfecho determinado: Duplicidade — já existe solicitação pendente,
com o procedimento e a data na mensagem, e authorized: false. A consequência
operacional importa mais que a célula: **REQUEST_AUTH não fica verde
repetindo o mesmo exame no mesmo paciente**. Precisa de procedimento diferente
ou de beneficiário diferente.
E a frase do portal não sai mais de tela.slice(0, 180), que entregava
"Menu CLINIPAM CLIN. PARAN. DE ASSIST. LTDA…" e nada mais: sai da vizinhança do
botão Fechar, que é onde os modais do Savi terminam. Cuidado com a tentação
de pegar "a última frase antes do ponto" — a razão social do cabeçalho tem
pontos e vence a mensagem.
#### O verde saiu com Colesterol total, e o anexo é por PROCEDIMENTO
Como a duplicidade bloqueia repetir o mesmo exame, o pedido que fechou a
operação foi outro: Colesterol total (40301605), mesmo beneficiário, sem
anexo.
REQUEST_AUTH 40301605 COLESTEROL TOTAL
guia 304572731
senha AR1101045 ← autorizada na hora
Conferido por leitura independente (CHECK_AUTH_STATUS na guia nova devolveu a
mesma senha, mesmo procedimento) — e a senha é diferente da anterior, o que
prova que a regra da "linha nova" escolheu a linha certa.
Com três exames medidos, o padrão fica claro: **a exigência de anexo é por
procedimento, não por prestador nem por canal.**
| Procedimento | Anexo | Desfecho |
|---|---|---|
| 40302040 GLICOSE JEJUM | não exige | autorizado na hora, senha |
| 40301605 COLESTEROL TOTAL | não exige | autorizado na hora, senha |
| 40301630 CREATININA | exige solicitação médica | vai para ANALISE OPERADORA |
Quem for escolher exame para teste: use bioquímica simples. E quem for
interpretar um PARTIAL de REQUEST_AUTH em produção: o desfecho "em análise"
pode ser consequência do anexo, não da operadora estar devendo resposta.
#### EXECUTE_PREAUTH: a parede é física, e é definitiva
Com senha nossa em mãos, o Confirmar da execução foi disparado — o passo
que faltava desde 21/10. O que o Savi respondeu:
ModalBiometria "Captura para Verificação Biométrica .... Aguarde ...."
botões visíveis na tela inteira: Pesquisar, Confirmar, Cancelar, #cancelar
Um único caminho: cancelar. Não existe "executar sem biometria", nem
justificativa, nem token alternativo nesta tela — diferente do ModalAutenticacaoToken,
que ao menos oferece "Autorizar sem token" com declaração assinada.
E, importante: depois de dois Confirmar, Sessões Realizadas continuava
0 de 1. O modal não registra nada enquanto espera o leitor, então a recusa
do conector não deixa execução pendurada nem risco de atendimento em dobro.
Consequência prática, e não é defeito de conector: neste prestador
EXECUTE_PREAUTH não fecha por robô. Depende de leitor de digital na ponta
— é operação com humano no meio. O conector faz a parte dele (acha a senha,
confere sessões, preenche a quantidade, clica e recusa com o motivo do portal).
#### Não existe desfazer autorização no portal do prestador (medido em 22/10/2026)
Pergunta que apareceu com as senhas que criamos: dá para cancelar a
AUTORIZAÇÃO, não a execução? Varridos os quatro lugares onde ela poderia estar:
| Onde | O que respondeu |
|---|---|
| Autorização → Cancelar | AR1101045 → 0 linhas + "Prestador sem autorizações para cancelamento." A tela só lista EXECUÇÕES |
Ativação de Senhas (ativacaoSenha.faces) | tem Ativar Senha e CANCELAR (#formulario:cancela2), mas com o beneficiário CARREGADO o Exibir responde "Não existem dados para a pesquisa realizada" — as nossas senhas não entram ali, porque estão em EXECUÇÃO PENDENTE e não em SENHA PENDENTE DE ATIVAÇÃO. O CANCELAR pertence àquele fluxo |
| Relatório de Pendências | nenhuma ação por linha: só os textos da situação e da senha, sem link de cancelar ou estornar |
| Autorização → Consulta | é autorizar CONSULTA médica, não mexer em autorização (já anotado acima) |
Então a senha emitida e não executada não tem botão de desfazer para o
prestador. O que resta é humano: o "Atendimento via chat" do rodapé e as
MENSAGENS PENDENTES, que são troca com a operadora. Também não medimos se a
senha vence sozinha, nem em quanto tempo.
Vale lembrar o efeito prático: senha não executada **não vira produção
faturável**. O resíduo é um registro de autorização, não dinheiro.
#### A grade de pendências, coluna por coluna — e a situação que vem VAZIA
Medido em 22/10/2026 lendo cada td:
0 Data Autorização | 1 Usuário | 2 Médico Solicitante/Executante
3 Procedimento | 4 Qtde Autorizada | 5 Qtde Pendente
6 Situação Atual | 7 Senha
| Linha | col 6 (Situação Atual) | col 7 (Senha) |
|---|---|---|
Creatinina 304548146 | ANALISE OPERADORA ! | ***** (mascarada) |
Colesterol 304572731 | vazia | AR1101045 |
Glicose 304557120 | vazia | AR0938134 |
Quando a senha sai, o Savi não escreve situação nenhuma. A célula é vazia de
verdade — não é o parser errando. Em análise ele escreve ANALISE OPERADORA !
(com o ! do ícone de exclamação, span.icon-exclamacao) e mascara a senha com
*****; autorizado, ele preenche a senha e deixa a situação em branco.
Então a regra que vale é a do desempate: senha preenchida é autorização, e o
rótulo honesto é "Autorizado — senha emitida", porque o portal não deu nome a
esse estado nessa tela.
Hipótese descartada, para ninguém repetir. Antes disso eu havia concluído
que situação e senha moravam na mesma célula e que o parser falhava por
comparar por igualdade. Errado: o dump que me levou a isso lia
title/classNamedos elementos quando não havia texto, e devolveu
"EXECUÇÃO PENDENTE" de um atributo — eu li atributo e chamei de célula. O
reconhecimento por inclusão ficou (serve para o ANALISE OPERADORA !, que
tem o ! grudado), mas ele não era a causa do rótulo genérico, e o
commit que afirmou isso está corrigido aqui.
O número da guia, esse sim, vive em atributo: `span[title="E 304572731 dep.lib.
false"]` na célula do PROCEDIMENTO. É de lá que o conector tira a guia — a tela
não mostra o número em texto em lugar nenhum.
#### CANCEL_GUIDE: nada a cancelar, de novo
Como a execução não entrou, a senha segue 0 de 1 — e a tela de cancelamento só
lista EXECUÇÕES. Não foi disparado hoje: devolveria a mesma recusa medida em
21/10 ("Prestador sem autorizações para cancelamento") e acenderia a célula de
vermelho por um comportamento correto.
| Passo | 22/10/2026 |
|---|---|
REQUEST_AUTH Glicose sem anexo | ✔ autorizado na hora, senha AR0938134 |
| leitura do desfecho na tela | ✘ tela em branco → corrigido pelo relatório |
CHECK_AUTH_STATUS da guia nova | ✔ roda — mas respondia "em análise" para autorizada; corrigido |
Confirmar da execução | ✔ disparado → ModalBiometria, sem alternativa |
| execução registrada | ✘ e nem deveria: 0 de 1 depois de dois cliques |
CANCEL_GUIDE | — não disparado: sem execução, não há o que cancelar |
O que ainda NÃO foi medido
- ☐O desfecho da análise das guias 304529670 (LabVW) e 304548146 (Indalab).
- ☐Qual é o TEXTO da situação na linha de pendências de uma senha emitida —
o parser devolveu vazio em 22/10. Ou o portal não preenche a célula, ou o
parser lê a célula errada neste relatório. A regra nova não depende disso
(senha é o desempate), mas o rótulo que aparece para o usuário, sim.
- ☐Se existe beneficiário SEM biometria exigida na execução — o cabeçalho do
prestador diz "Digital ativada", e a exigência pode ser por beneficiário.
É o que decide se EXECUTE_PREAUTH fecha por robô em ALGUM caso.
- ☐O
Confirmardo cancelamento continua não disparado: exige uma execução,
que exige a biometria.
- ☐O domínio de motivos do
formMotivo:idMotivo— é texto livre, mas não se
sabe se a operadora espera algum padrão.
- ☐
SUBMIT_BATCHpelo portal do prestador (/import-xml): declarado,
nunca executado — nem aqui nem em nenhuma outra operadora. Na Indalab
a rota responde "Sem Permissão".
- ☐Ativação de Senhas (
ativacaoSenha.faces) e Internação/PQA. - ☐A biometria: o cabeçalho mostra "Digital ativada / Facial inativa / Token
inativo". Não foi exigida em nenhum passo desta sessão — mas os modais
existem e podem aparecer na execução de outro prestador.
- ☐Autorização de Consulta (tela separada, para consulta médica).
A tela de solicitação, medida campo a campo (30/10/2026)
Sessão de leitura pura na conta da INDALAB (CPF 06587366988, JANICE
DEBARBA / 154866), operadora CLINIPAM. Nada foi confirmado: a sonda parou
antes do Confirmar, que é o que escreve. Browser próprio via CDP — não pelo
executor —, então consecutiveFailures não foi tocado.
Os nove passos, e os dois que o conector pula
O manual oficial do portal (rodapé do login, arquivo/Manual-SAVI.pdf, seção
3.2, p. 11 — 27 páginas, escaneadas, sem camada de texto) lista o fluxo, e
ele bate com o medido:
| # | Passo do manual | Campo | O conector faz? |
|---|---|---|---|
| 1 | código da carteira | formulario:codigo_beneficiario (maxlength 14) + Pesquisar | sim |
| 2 | tipo de atendimento eletivo ou urgência | modal ModalEletivoUrgencia | NÃO |
| 3 | prestador | formulario:prestador (select) | NÃO (aceita o default) |
| 4 | CRM do solicitante | crmExecutante (maxlength 6) + conselho + Pesquisar | sim |
| 5 | queixa/diagnóstico | formulario:diagnostico (maxlength 100, texto livre) | sim |
| 6 | código do procedimento | codigo_procedimento (maxlength 8) | sim |
| 7 | confirmar o procedimento | formulario:adicionar | sim |
| 8 | confirmar a quantidade e/ou excluir | formulario:dataTable:N:j_idt188 | NÃO |
| 9 | confirmar a autorização | formulario:j_idt242 | sim |
O caráter da solicitação é um MODAL, e fechá-lo decide por nós
Ao voltar da pesquisa do beneficiário, o Savi abre #ModalEletivoUrgencia
("Caráter da Solicitação", botões Eletivo e Urgência). O select
formulario:tipo_consulta está disabled — o modal é o único caminho.
Medido: clicar Urgência grava tipo_consulta = S; o default é N
(ELETIVA). O fecharModais() do conector roda logo depois de
carregarBeneficiario e mata esse modal com jQuery sem responder — então
toda solicitação nossa sai ELETIVA, e AuthorizationRequestContext.careCharacter
('1' eletiva, '2' urgência) nunca chega ao portal. Hoje careCharacter
só aparece na fixture do teste; nenhum arquivo do conector o lê.
Não é hipotético que importe: eletiva e urgência têm prazo e auditoria
diferentes na operadora.
A quantidade existe, é editável, e vai sempre 1
A linha do procedimento adicionado tem seis colunas; a segunda é um input
formulario:dataTable:<i>:j_idt188, value="1", maxlength=2, só dígitos,
com postback no change. O conector nunca a toca, então
procedures[].quantity é descartado em REQUEST_AUTH — pedir 2 sessões
autoriza 1. (Em EXECUTE_PREAUTH a quantidade É escrita, em
formulario:qtde; a assimetria é só do pedido.)
As outras colunas: selePrinciapl (checkbox "Proc. Principal", marcado no
primeiro), excluir, btnVincular (abre modal_aviso_porte_anestesico) e
Upload.
As listas, todas mapeáveis — e pequenas
| Campo | Valores |
|---|---|
tipo_consulta | N = ELETIVA, S = URGÊNCIA (disabled; só pelo modal) |
prestador | uma opção na Indalab: 214603124 = LABORATORIO DE ANALISES CLINICAS INDALAB LTDA |
conselho | CRM, COREN, CRAS, CREFITO, CRF, CRFA, CRN, CRO, CRP, CRV, OUT — 11, e o CONSELHO_TISS de utils.ts cobre as 11 |
formModalAutenticacaoToken:justificativaToken | 01…07 → rótulos 21 a 27 (paciente internado … não possui celular) |
formulario:medico nos relatórios | é o mês de referência, MM/AAAA, 16 meses para trás |
O prestador ter uma opção só é o motivo de o conector nunca o escolher não
ter quebrado. Num prestador com várias unidades, a solicitação sai na unidade
que o Savi escolher — e, como na escolha de operadora, entrar na unidade
errada não falha: só cria autorização no lugar errado.
TUSS: sim no que importa, mas o catálogo é um superconjunto
Pergunta respondida com três medições, não com leitura de código:
1. A produção real usa TUSS. Relatório de Produção da Indalab, 10/2026:
21 de 21 linhas com procedimento 40xxxxxx; 15 códigos distintos, e
15 de 15 existem na nossa tuss_items com tableNumber = 22.
2. O portal aceita código que não é TUSS. 28040481 — "HEMOGRAMA COMPLETO
(ERITROGRAMA+LEUCOGRAMA + AVALIACAO DE PLAQUETAS)" — não existe em
nenhuma das tabelas da nossa base TUSS, e o Adicionar o aceitou na lista.
3. A busca do portal mistura tabelas. ModalPesquisaProcedimento
(lupa ao lado do código, link formulario:linkModalProcedimento, campo
pesquisa_modal_form:procedimento) para "HEMOGRAMA" devolve 6 linhas de
três famílias: 40304361/40304957 (TUSS), 28040015/28040481/28041151
(fora do TUSS) e 29000044 HEMOGRAMA - USINA (2817) (TABELA MEDICAL2 1205),
que diz a tabela proprietária no próprio rótulo.
Ou seja: mandar TUSS está certo — é o que a operadora liquidou 21 vezes
neste prestador —, mas não é verdade que o Savi "é TUSS". O catálogo de busca
é maior que o conjunto aceito, e maior ainda que o TUSS.
A busca também lista o que a tela recusa: 29000044 aparece no resultado e,
no Adicionar, volta **"Procedimento não encontrado. Verifique um outro
código."**. Não use o modal de busca como prova de que um código serve.
Duas recusas diferentes, e uma delas é cega
| Código | Mensagem do portal |
|---|---|
31005128 (colecistectomia, TUSS 22 legítimo) | "O procedimento 31005128 deve ser solicitado através do menu de Solicitações." |
99999999 (não existe em lugar nenhum) | a mesma frase, com o número trocado |
29000044 (está na busca, fora do contrato) | "Procedimento não encontrado. Verifique um outro código." |
O Savi não distingue "código inexistente" de "código que não cabe nesta
tela". Quem ler a primeira frase como roteiro ("então mande por Solicitações")
vai mandar lixo para outra fila.
O conector hoje percebe a recusa só pelo contador (`adicionados.length !==
procedures.length`) e devolve "Savi aceitou N de M procedimentos" — a frase do
portal, que é o único dado útil aqui, fica no #ModalMensagens e se perde.
Vale ler lerMensagemModal dentro de adicionarProcedimento.
Cuidado ao consertar: a espera do adicionarProcedimento é
body.innerText.indexOf(codigo) >= 0, e **a modal de recusa contém o
código** ("O procedimento 99999999 …"). A espera dá positivo em caso de
recusa; quem segurar o fluxo é o contador, depois.
O solicitante que o próprio laboratório usa: CRM 999999
Nas 21 autorizações de 10/2026 da Indalab, o solicitante é o mesmo:
999999 / CRM / SC — MEDICO TRANSCRICAO CLINIPAM SC.
Medido na tela de autorização: 999999 + CRM resolve para "MEDICO
TRANSCRICAO CLINIPAM SC"; 15751 (o CRM da guia de teste) segue devolvendo
"CRM não encontrado. Tente novamente.".
Isso derruba a maior fonte de falha do REQUEST_AUTH neste portal — não é
preciso que o CRM da requisição exista na base da Clinipam, porque o
laboratório já opera com o médico de transcrição da operadora. **É decisão de
quem opera**, não default de código: usar o transcritor é uma declaração sobre
quem pediu o exame. O lugar disso é cadastro da conexão, como o
motivoAusenciaToken.
O que o DOM da tela esconde e o conector nunca encontrou
Modais presentes em autorizacao_procedimento.faces, todos fora do caminho
percorrido até hoje:
| Modal | O que é |
|---|---|
ModalResultadoAutorizacaoProcedimento | resultado, com Mais Procedimentos e Finalizar |
ModalResultadoAutorizacaoSenhaPendente | "Autorização de Procedimentos - SENHA PENDENTE" |
panel_guia_senha_prestador | "Favor informar a guia/autorização da prestação de serviço" — Procedimento, Número guia, Confirmar |
pesquisa_modal_form_cid | busca de CID por descrição |
modal_pesquisa_atendimento_siga | etiqueta para anatomopatológico ("Continuar sem etiqueta") |
modal_aviso_porte_anestesico / modal_lista_porte_anestesico | ato anestésico |
ModalResponsaveisObrigatorio | terapia: exige biometria de responsável |
ModalEmpresasPlanoAlterar / ModalAlterarLocalAtendimento | trocar operadora / local |
ModalFalhaAutorizacaoProcedimento | "Falha na Autorização de Procedimento. Por favor, tente novamente." |
Dois merecem correção de afirmação nossa:
1. **panel_guia_senha_prestador é um campo para o número de guia do
prestador.** O chaveConciliacao.porque do conector diz que "a tela de
solicitação não tem campo para número de guia do prestador". O campo existe
no DOM desta tela. Não está medido sob que condição ele abre (o id
sugere a execução de senha) — mas a afirmação atual é mais forte do que a
medição sustenta.
2. O CID. A armadilha nº 5 diz "Diagnóstico é texto livre, não CID. Não
procure a tabela: não tem". O campo diagnostico continua sendo texto
livre — isso segue verdade — mas existe um modal de busca de CID nesta
mesma tela. Onde ele é usado, não se sabe.
O card de empresa TEM texto, e ninguém tinha olhado o alt
A seção da conta da Indalab diz que as opções da tela "Selecione a empresa"
"não têm texto: são logos". O alt da imagem traz a razão social:
carrocel_9.png alt="CLINIPAM CLIN. PARAN. DE ASSIST. LTDA"
carrocel_14.png alt="NOTRE DAME INTERMEDICA SAUDE S A"
(E confirma, de lado, que carrocel_14 é a Notre Dame — não ficava escrito em
lugar nenhum.) Escolher por carrocel_9 continua certo; casar também pelo
alt é um segundo critério de graça, e é o que protege se a operadora trocar
o arquivo do logo.
Semântica dos dois relatórios, do manual (p. 16)
- •Produção — "as senhas que estão executadas, ou seja, **que já podem ser
faturadas**".
- •Pendências — "as senhas que estão pendentes, com restrições e/ou que não
foram executadas. São senhas aguardando execuções e/ou liberações."
E, da seção 3.3: senha liberada depois de uma restrição **tem que ser
executada** para virar produção. É a mesma leitura que o conector já faz; agora
tem fonte.
O primeiro REQUEST_AUTH disparado pelo CONECTOR (30/10/2026) — e o que ele revelou
Até aqui REQUEST_AUTH da Clinipam só tinha sido percorrido à mão. Em
30/10/2026 ele foi disparado pela produção, por POST /v1/autorizacoes:
beneficiário 0E3IW000002003 FABIO PINTO HOFFMANN
procedimento 40311210 ROTINA DE URINA caráter ELETIVO, qtde 1
solicitante CRM 999999 MEDICO TRANSCRICAO CLINIPAM SC (sem CBO)
guia SAVI301030A
O pedido não foi criado. E nós dissemos que foi.
| O que respondemos | O que o portal mostrava |
|---|---|
execução SUCCESS | — |
situacao: EM_ANALISE, "Em análise na operadora" | nenhuma linha do 40311210 no relatório de pendências |
| "AUTORIZAÇÕES DO DIA" ainda em 20, o mesmo número de antes do disparo | |
| os pendentes do beneficiário seguiam sendo os três de 21 e 22/10 |
O resultSummary diz a verdade que a API escondeu:
statusLabel: "Desfecho não reconhecido". O Savi devolveu o **formulário em
branco** depois do Confirmar, localizarNoRelatorio não achou linha nova, e
o fallback de lerDesfecho respondia pending: true, status: '2' — e '2' é
EM_ANALISE. Afirmava estado da operadora para dizer que não tinha lido
nenhum.
Consertado emb45ecafd:outcomeUnreadableviraINDETERMINADA, que é
situação própria e continua na fila de reconsulta. O mesmo padrão estava
em Orizon Autorize, Bradesco Senha Web e SC Saúde Atendimento.
#### Tela em branco depois do Confirmar é AMBÍGUA — e essa é a armadilha
Corrigido mais abaixo: "tela em branco" era leitura cega — innerText não
mostra valor de <input>. Veja "é BIOMETRIA".
Em 22/10 a tela voltou em branco e o pedido tinha sido criado (senha
AR0938134, guia 304557120 — ela está lá no relatório até hoje). Em 30/10 a
tela voltou em branco e nada foi criado.
Então a tela em branco não distingue os dois casos, e a única fonte é o
relatório. Quando o relatório também não traz linha nova, não há resposta — e
é isso que INDETERMINADA passou a dizer.
#### Hipótese medida e DERRUBADA: não foi o modal de caráter
A suspeita óbvia era a mudança do mesmo dia (a5fef77c), que passou a
responder #ModalEletivoUrgencia em vez de fechá-lo à força: o botão
Eletivo é submit de um form próprio (formSelecaoEletivoUrgencia), e um
POST completo poderia zerar o formulario.
Medido no portal, 30/10/2026:
ANTES do clique codigo=0E3IW000002003 nome=FABIO PINTO HOFFMANN tipo=N modal=aberto
DEPOIS do clique codigo=0E3IW000002003 nome=FABIO PINTO HOFFMANN tipo=N modal=fechado
O formulário não é zerado. A causa da não-criação segue desconhecida e
precisa de outra rodada controlada.
- ☐Por que o Confirmar de 30/10 não criou nada. Candidatos não medidos:
algum modal condicional que não apareceu no DOM da sonda (etiqueta de
anatomopatológico, ato anestésico), ou validação silenciosa do portal.
- ☐Se
Finalizar(noModalResultadoAutorizacaoProcedimento) é necessário
— segue sem nunca ter sido clicado por nós.
#### O que o mesmo disparo PROVOU
- •A solicitação foi aceita sem CBO (
profissionalSolicitante.cboausente).
Antes de 30/10 o schema a recusaria. GET /v1/operadoras/340782/capacidades
devolve pedidoExige: ["indicacaoClinica"] — sem cbo.
- •
CRM 999999resolve como solicitante pelo conector, não só à mão. - •O caminho inteiro roda: login com captcha, escolha de empresa, beneficiário,
caráter, solicitante, diagnóstico, procedimento e Confirmar, em ~93 s.
O anexo do balcão nunca chegava à operadora (30/10/2026)
A tela de autorização aceita até 10 arquivos — "tudo o que o paciente trouxe" — e
nenhum deles saía do Miydas. Medido lendo a cadeia inteira:
authorization-desk.service.ts:87
const { documentos, beneficiario, numeroGuiaPrestador, ...pedido } = d;
r = await this.autorizacoes.criar(u, { ...pedido, ... }) ← sem documentos
await this.completar(..., documentos) ← depois, só liga no NOSSO banco
E AuthorizationAttachment não era construído em lugar nenhum do código: três
conectores liam context.attachments (Clinipam Savi, Amil, Bradesco Senha Web) e
nenhum chamador o preenchia.
Para a Clinipam isso é a diferença entre guia criada e guia recusada: o Savi só
revela a exigência DEPOIS do Confirmar, na tela "ANEXO PENDENTE". A guia 304548146
(21/10) só nasceu porque o pedido médico foi anexado à mão.
Corrigido: o pedido carrega attachmentIds (ids de DocumentoAutorizacao) e o
executor resolve os bytes na hora de chamar o conector —
services/anexos-da-autorizacao.ts.
Por que ids e não os arquivos: o contexto trafega serializado em
portal_executions.referenceId. Dez pedidos médicos em base64 são dezenas de MB
numa coluna de banco, relidos a cada tentativa. O SUBMIT_DOCUMENT manda base64 ali
porque é UM XML de NF-e; pedido médico é foto.
#### Três decisões que não são óbvias
1. Carteirinha e documento do paciente ficam de fora. O balcão fotografa tudo
junto de propósito, mas o campo do portal é "anexo de solicitação médica":
mandar a carteirinha ali sobe dado pessoal como se fosse pedido clínico e ocupa
a vaga do documento que a operadora quer. Vão PEDIDO_MEDICO e OUTRO.
2. A ordem do pedido é preservada, não a do banco — o primeiro anexo é o que os
portais de um arquivo só vão levar.
3. Falha de leitura derruba o pedido ANTES de escrever na operadora. Seguir sem
o anexo cria guia presa em "ANEXO PENDENTE", e o conector recusaria pedindo o
documento que nós TÍNHAMOS — mandando o atendente procurar um papel que já
estava no sistema.
#### Limite de formato e tamanho — metade já estava resolvida
A primeira versão desta seção dizia que "um print em PNG passa no balcão e é recusado
pelo conector". Errado, e vale registrar por quê: o upload da tela passa por
reduzir-imagem.ts, que converte TODA imagem para **JPEG de até 1600px no lado
maior, qualidade 0,85** antes de enviar. PNG e WEBP nunca chegam como PNG e WEBP, e
uma foto de celular de 5 MB vira algo em torno de 300 KB.
O que sobra é o PDF, que a redução não toca: um laudo escaneado de 5 MB passava no
upload (o teto do balcão é 10 MB) e seria recusado pelo Savi, que aceita 2,3 MB, com o
navegador já aberto na operadora.
Resolvido declarando o limite no conector (limitesDeAnexo, com os números impressos
na própria tela do Savi) e levando-o até o balcão pelo mesmo caminho das exigências de
campo: agora o arquivo fora do limite vira pendência ANTES do envio, com o motivo
pronto ("laudo.pdf: 5.1 MB, e o limite desta operadora é 2.3 MB").
RESPONDIDO: por que o Confirmar não criava nada — é BIOMETRIA (30/10/2026)
A pergunta aberta desde o primeiro disparo. Medida replicando a sequência exata do
conector na sonda, parando antes do Confirmar:
codigo_beneficiario 0E3IW000002003 nomeUsuario FABIO PINTO HOFFMANN
tipo_consulta N (eletiva) prestador 214603124
conselho/crm CRM / 999999 medico MEDICO TRANSCRICAO CLINIPAM SC
diagnostico EXAMES DE ROTINA linha 40311210 ... Qtde 1
modais abertos nenhum Confirmar visível só formulario:j_idt242
Estado impecável. O Confirmar então abre #ModalBiometria — *"Captura para
Verificação Biométrica … Aguarde … Cancelar"* — e fica em long-poll (uma série de
202 sem fim). O pedido NÃO é criado.
O modal carrega um script que fala com https://app.hapvida.com.br/wsbiohap e com um
agente local na porta 8021:
paramContexto = 'https://app.hapvida.com.br/wsbiohap'; paramPorta = 8021;
paramCdPessoa = '216935574'; paramApp = 'SAVIMTL';
paramInfAd = 'Local-154866|Operador-06587366988';
É o instalador do rodapé do login ("Instaladores", "Tutorial - Instalação Biometria").
Sem leitor de digital na máquina, não há guia. Cancelado pelo botão #cancelar
(fechaCaptura()), e o relatório seguiu com as mesmas três linhas de 21 e 22/10.
Isto é configuração POR PRESTADOR, não da operadora: o cabeçalho mostra "Digital
ativada / Facial inativa / Token inativo".
Correção de 31/10/2026 — a frase anterior desta nota estava errada. Ela dizia que
as guias de 21-22/10 nasceram "por outro acesso". Não nasceram. O texto de tela
guardado daquele dia é `JANICE DEBARBA / 154866, LABORATORIO DE ANALISES CLINICAS
INDALAB LTDA` — o mesmo operador e o mesmo prestador de hoje, pela mesma conexão
(cmvil3rly). Então a exigência de digital foi **ligada do lado da Clinipam entre 22 e
30/10**, e não é diferença de acesso.
#### A afirmação anterior desta nota estava ERRADA, e o motivo vale mais que a correção
A nota dizia que o Savi "devolveu o formulário EM BRANCO depois do Confirmar". Não
devolveu. document.body.innerText NÃO mostra o value de <input> — o
details.tela trazia só os rótulos ("Código do Usuário * Nascimento Idade …"), e isso
foi lido como formulário zerado.
O formulário estava cheio o tempo todo. A leitura cega mandou procurar bug de ViewState
onde havia um modal de biometria por cima.
Corrigido: lerTela passa a concatenar os valores dos campos. E a espera depois do
Confirmar passa a terminar também quando uma parede aparece — antes gastava os 30 s
inteiros olhando para um modal que nunca ia embora.
#### As quatro paredes, agora reconhecidas pelo conector
| Modal | O que o portal quer |
|---|---|
ModalBiometria | digital do beneficiário num leitor local |
ModalBiometriaFacial | biometria facial numa câmera |
ModalAutenticacaoToken | token de 7 dígitos do app do beneficiário |
ModalResponsaveisObrigatorio | biometria de responsável, cadastrada na central |
O conector fecha o modal (ele fica em long-poll; deixá-lo aberto pendura a sessão) e
para com o motivo por extenso, dizendo que o pedido não foi criado.
#### O que isso significa para o produto
REQUEST_AUTH na Clinipam não se automatiza neste prestador. A Indalab faz ~20
autorizações por dia no balcão porque tem o leitor e o paciente na frente. Automatizar
exige um prestador com a identificação desligada, ou um caminho que a operadora não
oferece neste portal.
- ☐Confirmar com a Clinipam se a exigência de digital pode ser desligada para
pedidos sem o paciente presente (coleta domiciliar, material de terceiros) —
o Savi tem essas justificativas para o TOKEN, mas não foi visto equivalente
para a digital.
- ☐Medir no acesso do LabVW, que em 21/10 criou guia sem esbarrar nisso.
O que ficou aberto nesta sessão
- ☐O
Confirmaré terminal? O manual (p. 12) diz que após a confirmação "será
gerada uma senha de procedimento", sem citar Finalizar, e as guias
304529670 e 304548146 nasceram sem ele. Mas Mais Procedimentos e
Finalizar existem no modal de resultado e nunca foram clicados por
nós. Só uma solicitação real fecha isso.
- ☐Quando abre o
panel_guia_senha_prestador, e se ele aceita o nosso
número de guia — é o que decidiria chaveConciliacao.
- ☐Onde o modal de CID é usado nesta tela.
- ☐Se o
prestadorcom mais de uma opção existe em algum prestador nosso. - ☐O que a operadora paga quando o pedido vai em
28xxxxxxem vez de TUSS.
Recurso de glosa: /disallowance mapeado (22/10/2026)
A tela. /disallowance lista os processos com glosa em aberto:
`Recursar | N° do Processo | Protocolo | Data do Protocolo | Mês Produção |
Liberação Dem. de Pagamento | Valor da Glosa | Status | Liberação Carta
Resposta | Carta Resposta`. O "Recursar" é um link por linha para
/suspension-appeal-new/{processo} — e deep-link não funciona: cai no
login, porque o SPA usa o primeiro segmento da URL como host do tenant. Tem que
ser clique de dentro.
O formulário lista os ITENS glosados, um por procedimento:
`Status | Usuário | Código do Item | Descrição | Qtd. Faturada | Valor Faturado
| Valor Pago | Qtd. Glosada | Valor Glosa | Saldo | Valor Recurso* | [toggle] |
Glosa | Anexos | Justificativa* | Ações`, com um Enviar no fim. Por linha:
#appeal é um toggle de 5x5 ("este item vai no recurso", bate com appeal no
JSON), #appealValue recebe o valor e #note a justificativa (máx 500). Os
ids se REPETEM em todas as linhas — nada pode ser buscado por id solto.
A API por trás, que é de onde o conector lê:
/v2/suspensions?processNumber=X status, valor e allowedSuspensionAppeal
/v2/suspensions/X/header canAppeal, suspensionStatus
/v2/suspensions/X/items?limit=50 itens: userCode, itemCode, balance, errors,
appeal, appealDisabled, denied
/v2/suspensions/X/totalizer saldo e valor já recursado
Processo inexistente devolve HTTP 400 com "O processo não foi encontrado ou
não pertence ao prestador logado" — é NOT_FOUND, e o executor marca FALHA (a
mesma regra do CHECK_STATUS, pelo mesmo motivo).
Duas coisas que mudam o que dá para prometer
Quem autoriza recursar é a operadora, e ela não diz por quê. Das 4 glosas
em aberto da Indalab em 22/10/2026, só uma tinha
allowedSuspensionAppeal: true na listagem — e é por esse campo que a tela
decide mostrar o link "Recursar":
| Processo | Mês | Valor | allowedSuspensionAppeal | canAppeal (header) |
|---|---|---|---|---|
| 2660741859 | 08/2026 | R$ 16,00 | true | true |
| 2660632996 | 07/2026 | R$ 80,80 | false | true |
| 2660533625 | 06/2026 | R$ 46,00 | false | não medido |
| 2660437794 | 05/2026 | R$ 30,00 | false | não medido |
Os dois campos se contradizem no 2660632996, e os itens dele vêm com
appealDisabled: false, denied: false e saldo inteiro. Quem manda na tela é o
da listagem: sem ele, não há link para clicar, e deep-link cai no login.
O motivo é PRAZO, e a regra está publicada no FAQ do portal (aba "Recurso
de glosa", lida em 22/10/2026):
"As solicitações de Recurso de Glosa serão feitas, exclusivamente, por meio do
nosso Portal do Prestador […] na aba 'Glosa' […] e **o recurso deve ser
apresentado em até 30 dias após a liberação do demonstrativo de pagamento**."
Conferido contra releaseOfPaymentStatementDate dos quatro processos, a regra
explica todos:
| Processo | Liberação | Dias até 22/10 | allowedSuspensionAppeal |
|---|---|---|---|
| 2660741859 | 25/09/2026 | 27 | true |
| 2660632996 | 26/08/2026 | 57 | false |
| 2660533625 | 20/07/2026 | 94 | false |
| 2660437794 | 19/06/2026 | 125 | false |
A janela é calculável: liberação do demonstrativo + 30 dias. O
FETCH_GLOSA_REPORT já captura releaseOfPaymentStatementDate, então dá para
avisar ANTES de vencer em vez de descobrir depois — é o que transforma essa
operação em dinheiro.
Duas ressalvas do dado:
- •
/v1/deadline-expiration, que a tela chama, devolvecontent: []. O prazo
não vem pela API; vem do FAQ e do contrato.
- •O header do 2660632996 diz
canAppeal: trueenquanto a listagem dizfalse.
Incoerência do portal: quem manda na tela (e no conector) é a listagem.
- •O FAQ também diz que o prazo para a operadora RESPONDER "está previamente
estabelecido em seu contrato" — esse não está em lugar nenhum do portal.
O que isso significa na prática: o contestável hoje é R$ 16,00 de R$ 172,80,
e os outros R$ 156,80 venceram sem ninguém olhar. O conector recusa o que a tela
recusa; o valor está em agir dentro dos 30 dias.
O portal recursa ITEM, e o item se identifica pela CARTEIRA. O processo
2660741859 tem duas linhas do MESMO procedimento (40301591, COLESTEROL LDL),
R$ 8,00 cada, para beneficiários diferentes (0E60W000004014 e
0E6VF000001007). Código do procedimento não basta para escolher a linha, e
escolher errado é recursar dinheiro de outro paciente. Por isso
AppealContext.guides[].beneficiaryCard passou a existir, e por isso o conector
recusa quando o item casa com mais de uma linha sem carteira.
O que o conector recusa antes de escrever
Processo que o portal não conhece · janela fechada · item sem justificativa ·
justificativa acima de 500 caracteres · valor acima do saldo da glosa · item
bloqueado (appealDisabled/denied) · item ambíguo sem carteira.
O formulário de recurso, medido campo a campo (22/10/2026)
A primeira tentativa de envio real falhou com Enviar disabled, timeout de
30s e nenhuma pista. O que estava acontecendo:
| Achado | Consequência |
|---|---|
O toggle #appeal já preenche o valor com o saldo da linha (R$ 0,00 → R$ 8,00) | só se digita valor em recurso PARCIAL |
fill() não entra em #note — o componente só registra com eventos de teclado | a justificativa ficava vazia, e é obrigatória |
Enviar só habilita com valor e justificativa em toda linha marcada | o sintoma do campo vazio era um timeout mudo |
Digitação real (pressSequentially + Tab) preenche e habilita o Enviar | é o caminho que funciona |
O portal salva rascunho no servidor. Depois de marcar e digitar, sem enviar
nada, /v2/suspensions/{p}/items já devolvia appealValue: 8 e o note
digitado nos dois itens, e o totalizador passou a mostrar appealedValue: 16.
O que NÃO muda sem o Enviar é appeal (segue false) e o status (segue "Não
recursado"). Ou seja: dá para preencher e abandonar — e o que ficou lá é o que
a próxima pessoa vai ver no formulário.
O primeiro recurso enviado (22/10/2026) — e o passo que faltava
R$ 16,00 contestados, processo 2660741859, dois itens de COLESTEROL (LDL) de
R$ 8,00. O laboratório confirmou que o LDL foi por dosagem direta, o que
torna a glosa ("existe outro procedimento principal pago que invalida este")
contestável. Status dos itens: Não recursado → Em Análise;
valorRecursado: 16, suspensionStatus: 7.
O Enviar não envia sozinho. Depois dele abre um diálogo de confirmação, e
é o Confirmar dele que muda o status. Sem esse clique o portal grava
appealed: 8 por item e PARA ali — o totalizador mostra R$ 16,00 "recursados" e
o status segue "Não recursado". Quem olhar só o totalizador jura que enviou.
A sequência inteira, medida:
toggle #appeal → preenche o valor com o saldo
digitar #note → pressSequentially + Tab (fill não entra)
Enviar → habilita só com valor e justificativa
└ diálogo → Confirmar ← sem isto, nada acontece
status → Não recursado → Em Análise
A armadilha que custou duas execuções: o overlay do diálogo intercepta
cliques, e o logout do conector batia nele — timeout de 30s DEPOIS de a tela ter
feito o que devia, com a execução marcada FAILED. E procurar o diálogo por
offsetParent !== null não funciona: ele é position: fixed, e fixed tem
offsetParent nulo. O diálogo estava na tela o tempo todo enquanto o dump
dizia que não havia nenhum.
O que ainda NÃO foi medido aqui
- ☐O número de PROTOCOLO do recurso: mesmo depois de enviado, a API devolve
protocolNumber: 0 nos itens e a coluna Protocolo da grade segue vazia.
Ou ele aparece quando a operadora responde, ou não existe.
- ☐A resposta da operadora:
hasSettlementLettere a coluna "Carta
Resposta" seguem vazias. É o que vai dizer se os R$ 16,00 voltam.
(replyLetterId: 4942220 já existe no JSON — então ele não é sinal
de que a carta saiu.)
- ☑~~Por que o header do 2660632996 diz
canAppeal: true~~ — respondido
abaixo, em "canAppeal não é a janela".
- ☑~~Os 4 botões de ícone por linha~~ — são dois, não quatro: o link
para /suspension-appeal-new/{processo} e um botão sem href. Medido em
22/10/2026.
- ☐Anexo no recurso: o campo
attachmentsexiste por item e veio[]
nos dois itens recursados. O fluxo de anexar não foi percorrido.
O que não foi encontrado NO PORTAL DO PRESTADOR
Varridas as 9 rotas do menu (/medical-production, /import-xml,
/import-invoice, /manual-typing, /disallowance,
/report-payment-statements-consolidated, /procedure-registration, /faq,
/change-password), não há tela de elegibilidade nem de autorização.
Isso continua verdadeiro para portalprestador.clinipam.com.br — e é por isso
que o conector declara as operações de autorização como não suportadas. O que
mudou é que agora se sabe PARA ONDE apontar: o Savi, acima.
Envio de NF: o documento que segura o pagamento (22/10/2026)
/import-invoice é o SUBMIT_DOCUMENT da Clinipam. Vale dizer de novo, porque
o nome engana: o documento aqui é FISCAL, não clínico. Não é o
tissEnvioDocumento (laudo, pedido, comprovante). É o XML da NF-e que fecha um
processo de faturamento já analisado.
Enquanto a nota não entra, o processo fica em processStatusId = 18
(AguardandoEnvioNf), e o portal bloqueia o ícone do relatório da guia —
type: "blocked", cursor proibido, tooltip "Processo bloqueado". O dinheiro
não anda. Por isso a operação mora aqui e não em algum anexo de guia.
O contrato
POST api/v5/uploads/invoice, multipart/form-data:
| Campo | Obrigatório | Observação |
|---|---|---|
File | sim | o XML da NF-e |
ProcessesIds | sim | repetido, um por processo (o portal aglutina até 50 numa nota só) |
HasChanged | não | booleano; só no fluxo de nota declarada |
IdentifierNumber | não | número da nota |
IssueDate | não | ISO |
VerificationCode | não | código de verificação da NFS-e |
ProcessesIds é o id da LINHA, não o processNumber. Os dois vêm lado a
lado em /v4/process-portal/without-invoice e são números diferentes. Mandar o
número do processo é o erro natural de quem lê só a tela. No bundle do SPA:
const Ru = D.map(Number); // índices das linhas marcadas
for (const pe of Ru) ca.push(_[pe].id); // ProcessesIds
Sucesso é corpo VAZIO. O endpoint devolve [] quando aceita e um **array de
mensagens** quando recusa — a tela escreve "O XML importado não está de acordo
com o padrão. Verifique os erros abaixo". Logo, **lista não-vazia é recusa,
inclusive com HTTP 200**: quem olhar só o status code declara sucesso em cima de
nota rejeitada. Mesma família de defeito do CHECK_STATUS desta mesma semana.
As duas paredes
1. Janela de 1 a 7. GET /v3/invoices/check-valid-period devolve
```json
{"content":{"isValidDate":false,"messages":[
{"description":"entre os dias 1 e 7.","type":1},
{"description":"Envio de NF não permitido nesta data. Verifique o período acima.","type":2}]}}
```
fora dela. Em 22/10 estava fechada. O portal não enfileira: o botão
"Enviar" nem habilita. (Atenção ao mock do próprio SPA, que diz "entre os
dias 01 e 05" — é mock, não é a regra da Clinipam. A regra é a resposta da
API.)
2. A listagem cobre 120 dias. A tela avisa: "A exibição da listagem está
restrita ao período 120 dias". Processo mais velho não aparece, e sem a
linha não há id para mandar.
Hipótese medida e derrubada
GET /v2/process-portal/exists-without-invoice respondeu
{"existsProcessPortalWithoutInvoice": true} enquanto
/v4/process-portal/without-invoice respondia {"content":[]} — com
limit/offset, com startProductionPeriod, com initialProductionMonth, e
com o filtro de período preenchido na tela. A flag alimenta o aviso da home e é
calculada sem a janela de 120 dias. Ela não promete que a lista tem
linha. Não trate true como "existe processo para mandar nota".
GET /v1/invoices/reuse/count devolveu 0 no mesmo dia.
Fica de fora, de propósito
- •Aglutinação.
DocumentSubmissionContextcarrega um identificador, e o
conector manda um ProcessesIds.
- •Nota declarada (
POST api/v2/declared-invoice/send, corpo
{invoice:{identifierNumber, issueDate, amount, verificationCode}, processesIds})
— é para declarar a nota sem o XML.
- •Reuso de nota já enviada (
POST api/v1/invoices/reuse, corpo
{invoiceId, processNumbers}).
- •
IssueDate. O SPA faz uma coisa estranha com ela: substitui
hora/minuto/segundo pela hora de AGORA antes do toISOString(), para o fuso
-03 não empurrar a data um dia para trás. Como a data já vem dentro do XML e
o campo é opcional, o conector não a manda — **quem for mandar precisa
repetir a gambiarra.**
Ainda não medido
- ☐Um envio real. Em 22/10 não dava: fora da janela e sem processo
pendente na lista. A célula de SUBMIT_DOCUMENT segue vermelha até um
envio entre os dias 1 e 7.
- ☐Que erros o
/v5/uploads/invoicedevolve de fato (CNPJ divergente, valor
divergente, XML fora do padrão). O conector repassa o texto do portal sem
interpretar.
- ☐
GET api/v2/invoices/historic?processNumber=X— o fluxo de status da
nota por processo. Existe, não foi usado.
O extrato de utilização não existe em NENHUM dos dois portais (22/10/2026)
FETCH_UTILIZATION estava declarado como "não mapeado" nos dois conectores, o
que quer dizer "ninguém procurou". Procurou-se. Os dois menus, inteiros:
portalprestador.clinipam.com.br — Contas Médicas (Produção Médica,
Produção | Demonstrativo, Relatório de Demonstrativos, Envio de NF, Recurso de
Glosa), Ajuda, Alterar Senha. É um portal de faturamento; não há tela de
beneficiário nele.
Savi — Laudos Médicos (Pesquisar), Biometria (Elegibilidade, Escaneamento de
Digital), Elegibilidade Beneficiário, Autorização (Consulta, Procedimento,
Executar, Cancelar), Relatório (Produção, Pendências, Protocolo, Prorrogação de
Internação, Medicamento de Alto Custo, OPME), Demonstrativo de Produção,
Honorários, Solicitações (Internação/PQA), Ativação de Senhas, Perfil.
A tentação é olhar "Relatório > Produção" e achar que resolve. Não resolve: os
relatórios do Savi são da produção do prestador — o que esta clínica fez —,
não do histórico do beneficiário na operadora, que é o que
FETCH_UTILIZATION pede (e que pode incluir atendimento feito por outro
prestador). São perguntas diferentes.
Duas rotas do Savi que ninguém tinha aberto e que também não são isso:
- •
pages/autorizacao/consulta/autorizacao_consulta.faces— é **autorizar uma
consulta médica**, irmã da autorização de procedimento (tem seleção de
beneficiário, de médico e de local, e o mesmo modal de token). Não é
"consultar autorizações".
- •
pages/laudo/pesquisa_laudos.faces— "Cadastro/Consulta de Laudo Médico",
busca por senha. Colunas: Usuário, Senha, Procedimento, Data Autorização.
A declaração nos dois conectores saiu de "não mapeado" para o que foi medido.
Depois do primeiro recurso: o que só dava para ver com um enviado (22/10/2026)
Recursar cria um processo
Esta é a descoberta que muda o acompanhamento. O 2660741859, depois do envio:
{"processNumber":2660741859,"processStatusId":29,"processStatus":"Em Análise",
"protocolNumber":736504,"protocolDate":"2026-10-22T13:39:19",
"complementProcessNumber":2660930153,"complementProtocolNumber":736504,
"replyLetterId":4942220,"hasSettlementLetter":false,
"allowedSuspensionAppeal":true,"difference":16.00}
O recurso gerou o processo complemento 2660930153, e é ELE que carrega o
protocolo e o status "Em Análise". O processo ORIGINAL continua em
processStatusId: 2. Isso explica a incoerência anotada ontem: o
/header responde pelo original (processStatusId: 2) e a listagem responde
pelo complemento (29). Não era cache.
No nível do item, protocolNumber continua 0 — o protocolo é do
processo, não do item. Quem procurar o protocolo em /items não acha.
canAppeal não é a janela de recurso
Os quatro processos em aberto, lidos nas duas fontes ao mesmo tempo:
| Processo | allowedSuspensionAppeal (listagem) | canAppeal (header) | Dias desde a liberação |
|---|---|---|---|
| 2660741859 | true | true | 28 |
| 2660632996 | false | true | 58 |
| 2660533625 | false | true | 95 |
| 2660437794 | false | true | 126 |
canAppeal veio true nos quatro, inclusive no de 126 dias. Ele parece
dizer "este TIPO de processo admite recurso", não "a janela está aberta". Quem
bate com a regra dos 30 dias é allowedSuspensionAppeal, da listagem.
O checkAppealStatus usava canAppeal na mensagem e como fallback de
janelaDeRecursoAberta — e por isso anunciava "(janela de recurso aberta)"
para três processos vencidos. Corrigido: a janela sai só da listagem, e sem
a linha ela é null ("desconhecida"), nunca "aberta".
header.suspensionStatus só aparece (veio 7) em processo recursado. Nos três
não recursados vem vazio.
O protocolo não está na tela
Depois de confirmar, o portal não escreve o protocolo em lugar nenhum. O
conector raspava /protocolo\D{0,12}(\d{4,})/ do corpo da página — que casa
com qualquer número de quatro dígitos à vista. Agora ele relê
/v2/suspensions?processNumber= e usa o protocolNumber de lá; 0 é "ninguém
recursou", não "protocolo zero". Sem protocolo na API, o conector não devolve
protocolo: é com esse número que alguém vai cobrar a operadora.
/v2/invoices/historic quer o processo
O 400 de antes era falta de parâmetro, não falta de permissão. Com
?processNumber=:
{"id":1453542,"paymentAmount":1626.62,"paymentDate":"2026-09-30T00:00:00",
"statusFlow":[{"invoiceStatusId":10,"description":"Enviado"},
{"invoiceStatusId":20,"description":"Processando"},
{"invoiceStatusId":40,"description":"Pendente Associação"},
{"invoiceStatusId":60,"description":"Associado"},
{"invoiceStatusId":80,"description":"Pagamento Realizado","message":"Nota fiscal foi paga"}]}
É o ciclo de vida da nota fiscal por processo — 10 Enviado, 20 Processando,
40 Pendente Associação, 60 Associado, 80 Pagamento Realizado. Também explica
por que a lista de pendentes de NF está vazia: as notas da Indalab já estão
associadas e pagas.
A grade de glosa, como ela é hoje
Colunas: Recursar · N° do Processo · Protocolo · Data do Protocolo · Mês
Produção · Liberação Dem. de Pagamento · Valor da Glosa · Status · Liberação
Carta Resposta · Carta Resposta.
Por linha há dois controles, não quatro: o link para
/suspension-appeal-new/{processo} e um botão sem href. A nota anterior
falava em quatro ícones — estava errada.
limit=100 cegou o prazo de recurso da operadora inteira (22/10/2026)
O achado mais caro desta rodada, e ele estava escondido atrás de uma célula
verde.
GET /v3/payment-statement/guide-items?limit=100 responde HTTP 400:
{"Content":null,"Notifications":[{"Message":"O parâmetro 'limit' deve ser menor ou igual a 50."}]}
Com limit=50, responde 200 com 50 itens. O fetch-returns.ts pedia 100 e
tinha if (resp.status() !== 200) break — a recusa virava lista vazia, e
o buildHapvidaCsv montava um CSV só com o cabeçalho: 16 linhas, 1 KB.
A cadeia inteira, medida em produção
1. FETCH_RETURNS gera DemonstrativoPagamento-{processo}.csv sem nenhuma
linha de item;
2. o importador recusa: 12 de 12 arquivos em
INBOX_ERRO_PROCESSAMENTO, fase PARSING, mensagem "Nenhuma guia extraida
do documento" — 9 de 01/08/2026 e 3 de 21/10/2026, todos OGGMA_CONNECT,
todos com ~1 KB;
3. demonstrativos_pagamento tem zero linhas para o registro 340782
(tem 17 de ANÁLISE, nenhuma de PAGAMENTO);
4. sem demonstrativo de pagamento, a guia conciliada fica sem
dataLiberacaoDemonstrativo;
5. e essa data é o relógio do prazo de recurso de glosa.
Ou seja: um número errado numa querystring cegou o prazo de recurso da
Clinipam inteira. As 11 guias com glosa da operadora seguem sem relógio até o
FETCH_RETURNS rodar de novo com a correção.
E a célula estava verde
FETCH_RETURNS registrou SUCCESS: a execução baixou, nomeou e guardou
arquivos. Ela não tinha como saber que os arquivos estavam vazios — ninguém
perguntou. Terceira vez nesta semana que o mesmo formato de defeito aparece
na Clinipam: **um fallback mudo (break, "primeira linha da grade", "pendente
quando a coluna está vazia") transformando uma recusa do portal em resposta
confiante.**
O teto é do gateway, não da rota
Os mesmos 50 já estavam documentados em recursar-glosa.ts para
/v2/suspensions ("o teto do portal é 50 por página — o mesmo que já custou
uma execução verde e vazia quando foi ignorado"). Ou seja: a lição já estava
escrita, num arquivo vizinho, e o defeito seguia num arquivo que ninguém
reabriu. Vale para QUALQUER rota paginada desta API.
Correção
- •
TETO_DA_PAGINA = 50; - •não-200 vira exceção, não lista vazia — quem chama já trata por processo
e perde um demonstrativo, não a execução;
- •processo concluído sem nenhum item não gera arquivo: CSV só com
cabeçalho é lixo que o importador recusa para sempre.
Pendente
- ☐Rodar
FETCH_RETURNSna Clinipam depois da correção e conferir se os 12
processos viram DemonstrativoPagamento de verdade.
- ☐Os 12 arquivos presos no inbox continuam em
INBOX_ERRO_PROCESSAMENTO.
Eles não se consertam sozinhos — ou são reprocessados a partir de um
arquivo novo, ou ficam lá.
O verde de FETCH_PAYMENT é de OUTRO cliente (22/10/2026)
Continuando a caçada do parágrafo anterior — por que a Clinipam não tem
nenhuma linha em demonstrativos_pagamento —, o rastro levou para um lugar
que a matriz não mostra.
FETCH_PAYMENT do clinipam-hapvida tem 241 execuções, todas SUCCESS. E
todas as 241 são da ESADI, não da Indalab. A da ESADI baixa de verdade
(DemonstrativoConsolidado-*); a da Indalab nunca rodou.
E se rodasse, não baixaria nada. A tela /report-payment-statements-consolidated
da Indalab diz, com todas as letras:
"Não existem dados a serem mostrados nesta grid. Assim que novos registros
forem gerados, eles serão exibidos nesta seção."
e GET /v1/payment-statement/consolidated?offset=0&limit=50 responde
{"notifications":[]} — sem content. Não é recusa nem filtro: não existe
relatório consolidado nessa conta, porque **ninguém nunca clicou em "Criar
Relatório"**. O conector, por decisão explícita, não gera:
canRequestReport: true, e mesmo assim ele só baixa o que já foi emitido.
O que isso significa para o prazo de recurso
A Indalab não pode ter demonstrativos_pagamento da Clinipam pelo caminho
atual, e portanto suas 11 guias com glosa não têm
dataLiberacaoDemonstrativo. O relógio do prazo existe — a operadora publica
releaseOfPaymentStatementDate em /v2/suspensions, e o
checkAppealStatus agora devolve isso em details.liberacaoDemonstrativo —
mas ele não chega na GuiaConciliacao. Ligar as duas pontas é trabalho que
ainda não foi feito.
A lição sobre a própria matriz
Uma célula é verde por CONECTOR, somando todos os clientes. Verde pode
querer dizer "funciona para um cliente" — e, do lado do cliente que importa
agora, nunca ter rodado. A matriz responde "o conector já conseguiu?", não "o
conector consegue para este prestador?". Quem for olhar a cobertura de um
cliente específico não pode usar a cor.
Pendências que saem daqui
- ☐Gerar um relatório consolidado na conta da Indalab (é escrita no portal
e enfileira processamento — decisão humana, não agendamento).
- ☐Ou trazer
releaseOfPaymentStatementDatede/v2/suspensionspara a
GuiaConciliacao, que é o caminho sem efeito colateral no portal.
- ☐Os 12 CSVs vazios seguem em
INBOX_ERRO_PROCESSAMENTO. Eles vieram da
época em que FETCH_RETURNS ainda chamava connector.fetchReturns;
hoje o executor usa as duas metades (fetchAnalysis + fetchPayment) e
nem passa por lá. A correção do limit guarda o caminho para os
conectores que só têm fetchReturns — e para quando este voltar.
O menu MUDA com o prestador — e todo o mapeamento foi feito num só (22/10/2026)
Erro de método, não de código, e ele invalida parte do que está escrito acima.
Duas contas da Clinipam, lado a lado:
Indalab (81007866000126) | ESADI (02741897000130) | |
|---|---|---|
| Itens de menu | 6 | 10 |
/medical-production | ✅ | ✅ |
/report-payment-statements-consolidated | ✅ (grade vazia) | ✅ (3 relatórios CONCLUÍDO) |
/disallowance | ✅ | ✅ |
/import-invoice | ✅ | ✅ |
/import-xml "Envio de Produção" | não aparece | ✅ abre normal |
/manual-typing "Envio Manual" | não aparece | ✅ |
/procedure-registration "Cadastro de Procedimento" | não aparece | ✅ |
Ou seja: "varri as rotas do menu" queria dizer "varri o menu de um prestador". Tudo
que esta nota afirma sobre "o portal não tem X" precisa ser lido como "a conta
que eu usei não tem X". A conclusão de FETCH_UTILIZATION sobrevive — no menu
de 10 itens também não há tela de beneficiário, é faturamento de ponta a ponta
— mas agora com a evidência certa.
E resolve a dúvida do SUBMIT_BATCH: o "Sem Permissão" do /import-xml é
perfil da Indalab, não limite do portal nem do conector. Na ESADI a tela
abre inteira, com upload, grade de lotes e a janela "entre os dias 1 e 7".
/manual-typing — Digitação Manual, nunca mapeada
É um SUBMIT_BATCH sem XML: em vez de subir o lote TISS, o prestador
digita as guias no portal e submete. Para quem não tem sistema que gera TISS,
é o único caminho de faturamento.
- •Listagem:
GET /v2/batches/{personCode}?&limit=50&offset=0(devolveu
{"content":[]} na ESADI — ninguém digitou nada ainda)
- •Grade: Nº Protocolo · Mês de Referência · Data Criação · Tipo processo ·
Layout · Descrição · Qtde. Senhas · Valor Total · Status · Data Submissão ·
Ações
- •Filtros:
keyword(nº ou descrição), tipo de processo,referenceMonth
(mm/aaaa), creationDate, layout, batchStatus, sentDate
- •Dois botões: Criar protocolo e Acompanhar Submissões — e este último
aponta para /import-xml. As duas telas convergem: o protocolo digitado
vira lote e é acompanhado junto com os enviados por XML.
Não foi aberto o "Criar protocolo": é escrita na conta do cliente.
/procedure-registration — Cadastro de Procedimento
- •
GET /v1/procedures?offset=0&limit=50→{"content":[]}na ESADI - •Grade: Código · Procedimento · Tabela · Valor
- •Botões: "Cadastrar Procedimento" e "Cadastro Massivo de Procedimentos"
É a tabela de preços do prestador dentro da operadora. Nenhuma operação do
catálogo TISS corresponde a isso — não é SUBMIT_DOCUMENT nem
SUBMIT_BATCH. Fica registrado como capacidade existente e sem operação
equivalente.
Pendência
- ☐Decidir se
/manual-typingentra como caminho alternativo do
SUBMIT_BATCH. É escrita, e o fluxo de "Criar protocolo" não foi
percorrido.
Duas fontes do portal discordam sobre de quando conta o prazo de recurso
Achado de 22/10/2026 que **contradiz o que esta nota afirma em "Prazos
contratuais"**, e que não vou resolver escolhendo uma.
O banner da própria tela /disallowance diz:
"FIQUE ATENTO AO PRAZO MÁXIMO CONTRATUAL PARA SOLICITAÇÃO DE RECURSO DE
GLOSA!
**1º recurso: prazo iniciado a partir da liberação do Demonstrativo de
Análise de Contas**
Réplica: prazo iniciado a partir da liberação da Carta Resposta"
O FAQ do mesmo portal diz "até 30 dias após a liberação do **demonstrativo de
pagamento**". E a coluna da grade, bem abaixo do banner, chama-se "Liberação
Dem. de Pagamento" — que é o releaseOfPaymentStatementDate da API.
Três superfícies, duas regras. Consequências diretas:
1. o GuiaConciliacao.dataLiberacaoDemonstrativo foi preenchido (36.102
guias, 22/10/2026) a partir do demonstrativo de pagamento. Se a regra
do banner valer, o relógio está começando tarde demais, e guias marcadas
como "ainda dá tempo" podem estar vencidas;
2. aparece um segundo prazo que não existia em lugar nenhum: a réplica,
contada da liberação da Carta Resposta. O recurso de glosa tem dois
rounds, e só o primeiro está modelado.
- ☐Perguntar à operadora qual das duas vale, pelo chat do portal.
- ☐Modelar a réplica.
O recurso foi ACEITO e a execução ficou vermelha (22/10/2026)
Segundo recurso enviado de verdade, agora na conta da ESADI (CNPJ
02.741.897/0001-30), processo 2660774069 — a única glosa com
allowedSuspensionAppeal: true que existia nas duas contas naquele dia.
| campo | valor |
|---|---|
| processo | 2660774069 |
| item | 1314929234 — 10101012, consulta em consultório |
| carteira | 3010Q032119003 |
| glosa | AUTORIZACAO NAO EXISTE OU CANCELADA, TIPO ATEND INCOMPATIVEL SERVICO EXECUTADO |
| valor | R$ 85,00 (saldo integral) |
| liberação do demonstrativo | 25/09/2026 — 28 dias, dentro dos 30 |
O portal aceitou. Releitura da API logo depois:
processStatus saiu de "Não recursado" para "Em Análise",
protocolNumber: 736783, protocolDate: 2026-10-22T21:57:12,
complementProcessNumber: 2660930860, replyLetterId: 4947822, e o item com
appealed: 85, appealValue: 85 e a justificativa gravada em note.
Confirma de novo o que o recurso anterior já tinha mostrado: **recursar cria um
processo complemento**, e é ele que carrega o protocolo.
E a execução terminou FAILED
CONNECTOR_ERROR
elementHandle.click: Timeout 30000ms exceeded.
<div data-state="open" aria-hidden="true" class="fixed inset-0 z-50 bg-black/80 …">
intercepts pointer events
O erro é do logout, não do recurso. A cadeia:
1. confirmarEnvio clica o Confirmar e o portal faz o que tem que fazer;
2. o diálogo continua aberto — o overlay Radix (position: fixed,
data-state=open, aria-hidden=true) fica cobrindo a tela;
3. toda operação deste conector chama doLogout num finally;
4. o Sair está atrás do overlay, e o doLogout usava
page.$(sel) + elementHandle.click() — sem teto de tempo próprio, 30s até
estourar;
5. exceção lançada dentro de finally substitui o valor de retorno. O
AppealResult com o protocolo foi jogado fora e virou CONNECTOR_ERROR.
Essa armadilha já estava ESCRITA no comentário de recursar-glosa.ts desde a
primeira tentativa — descrita e não corrigida. Documentar não conserta.
Vermelho em operação que deu certo é a pior mentira que esta base conta.
Vermelho em coisa quebrada manda consertar. Vermelho em coisa que funcionou
manda recursar de novo — e recurso em duplicidade é problema com a
operadora, não economia de trabalho.
O conserto
- •
fecharDialogoAberto()emutils.ts: acha o overlay por
div[data-state="open"][aria-hidden="true"], clica Fechar/OK/Entendi se
houver, senão Escape, e espera o overlay sair. Até 3 tentativas. **Não
lança** — fechar diálogo é higiene.
- •
confirmarEnviochama ele depois de confirmar, para não deixar a tela suja
para quem vier em seguida.
- •
doLogoutreescrito: fecha o diálogo antes, usalocator.clickcom
teto de 5s, engole falha de clique, e sempre limpa o
@hapvida:userLogged do localStorage e navega para /login. A sessão
termina com ou sem clique — o clique no Sair é cosmético.
- •
logout-nao-derruba.test.tsprende as três coisas: clique preso não vira
exceção, o diálogo fecha ANTES do Sair, e sem diálogo não se aperta
Escape à toa.
O que fica em aberto
- •A célula
SUBMIT_APPEALsegue vermelha na matriz, e corretamente: a
execução falhou. O conserto só aparece no próximo recurso, e **não há outra
glosa com janela aberta** nas duas contas hoje — as outras seis estão com
allowedSuspensionAppeal: false. Não dá para forçar: reenviar no 2660774069
seria réplica, não recurso, e ele já está "Em Análise".
- •O mesmo
finallyexiste em todos os conectores RPA. Só o da Clinipam foi
corrigido. amil, bradesco-saude, unimed-blumenau, sulamerica,
scsaude-credencia, clinipam-savi e mediservice têm doLogout próprio e
o mesmo padrão try { … } finally { await this.doLogout() }. Nenhum foi
medido com diálogo aberto na saída. Não medido ≠ não acontece.
- •O
replyLetterId: 4947822apareceu junto com o protocolo. É a Carta
Resposta — a peça de onde sai o prazo de réplica, que continua sem modelo
aqui. Agora existe um id concreto para ir atrás.
Protocolar não é registrar (23/10/2026)
No dia seguinte ao recurso 736783, a pergunta foi "por que enviar recurso de
glosa ainda é um problema?". A resposta saiu da medição, não da impressão.
O que estava medido
| medida | valor |
|---|---|
conectores que declaram SUBMIT_APPEAL | 5 |
execuções SUBMIT_APPEAL com SUCCESS em toda a história | 0 |
linhas em recursos_lote | 0 |
linhas em recurso_lote_guias | 0 |
| glosa com prazo EXPIRADO | 11.767 guias · R$ 379.110,81 |
| glosa sem data de liberação | 1.476 guias · R$ 122.369,44 |
| glosa DENTRO do prazo | 505 guias · R$ 5.117,83 |
Os dois recursos protocolados em 22/10 (736504 na Indalab, 736783 na ESADI)
existiam só na tela da operadora. Nada no Miydas sabia deles.
As três coisas que faltavam, e o que cada uma custava
1. Gravar. Sem recursos_lote, a mesma glosa podia ser recursada de novo —
recurso em duplicidade é problema com a operadora, não economia. E
GlosaTemplate.taxaAceite não tinha de onde ser calculado.
2. Procurar. O agendador só agenda busca de retorno
(portal-scheduler.service.ts monta job de fetchReturnsCron e nada mais).
Nenhuma varredura olhava para allowedSuspensionAppeal: true. As duas
glosas recursadas em 22/10 foram achadas porque alguém foi olhar.
3. Saber a hora. Ver a seção seguinte.
O relógio do recurso tinha uma fonte só, e ela não cobre a glosa
dataLiberacaoDemonstrativo só se alcança casando a guia com um demonstrativo
de pagamento. Mas a glosa é declarada no retorno de análise, que é
outro documento. Medido em produção:
| operadora | guias sem data | têm guias_pagamento que case | demonstrativos de pagamento no banco |
|---|---|---|---|
| Unimed Brusque 348244 | 838 | 3 | 2.032 |
| Unimed Blumenau 334561 | 567 | 0 | 876 |
| SC Saúde 757444 | 58 | 0 | 0 |
| Porto Seguro 000582 | 27 | 11 | 10, todos com dataEmissao nula |
| Clinipam 340782 | 12 | 0 | 0 |
A Clinipam e o SC Saúde não têm UM demonstrativo de pagamento importado.
Não é o parser: é que o pagamento nunca foi buscado (ou nunca cobriu essas
guias). Enquanto isso, 2.172 demonstrativos de análise da Brusque, 805 da
Blumenau e 20 da Clinipam estavam no banco com a data de emissão preenchida.
Hipótese que caiu: *"glosa total não entra em demonstrativo de pagamento"*.
Falsa. Das 838 da Brusque sem data, 827 têm valor liberado > 0 — foram
pagas em parte. O problema não é a natureza da glosa, é que o documento de
pagamento não foi casado.
O backfill recupera 1.332 das 1.476 (R$ 71.422,42 de glosa). Das
recuperadas, 21 guias / R$ 864,22 ainda estão dentro da janela — o resto
expirou. Ler o relógio certo não devolve dinheiro: devolve a verdade de que
já era tarde.
As 144 que sobram não têm relógio nenhum: SC Saúde e Porto Seguro publicam
retorno de análise sem data de emissão. Para essas a varredura responde
SEM_RELOGIO, que é uma confissão, não um prazo.
As três falhas de SUBMIT_APPEAL são ANTERIORES ao conserto (23/10/2026)
SUBMIT_APPEAL tem três execuções em produção, todas FAILED. Olhando a
matriz, parece operação quebrada. Olhando o relógio, não é.
| execução | createdAt (UTC) | hora de Brasília | erro |
|---|---|---|---|
cmvjqw7qq0029p41p5s6nrvr9 | 22/10 16:18 | 22/10 13:18 | page.click — o Enviar ficou disabled |
cmvjre43p0001jv1yzhmlwh7c | 22/10 16:32 | 22/10 13:32 | elementHandle.click — overlay interceptando |
cmvk9einy000bn51yjtmviuf3 | 23/10 00:56 | 22/10 21:56 | elementHandle.click — overlay interceptando |
Os consertos: aa1c0a73 (a justificativa precisa ser DIGITADA — mata a
primeira) e d862c680, commitado às 22:02:52 BRT de 22/10 (o logout no
finally — mata as outras duas). A última falha é de **21:56 BRT, seis
minutos antes** do commit que a resolve.
portal_executions grava em UTC (SHOW timezone → UTC no container
ogmma-revenue-postgres). Ler 00:56 como madrugada de hoje foi o que me fez
afirmar que o recurso "continuava quebrado depois do conserto". Não continuava:
ele não roda desde então.
A hipótese que caiu: "o conserto não cobriu este caminho"
Medida e descartada. git merge-base --is-ancestor dizia que d862c680 era
ancestral do commit em produção — verdade, e irrelevante: diz que o código
*estava* lá quando OLHEI, não quando a execução RODOU.
De onde vinha o elementHandle.click, que não existe no código
O label do Playwright é por API, e nenhum clique do recurso usa
ElementHandle: medido em 1.58.2 (e em patchright 1.61, o mesmo),
locator.click reporta locator.click, page.click reporta page.click, e
só ElementHandle.click reporta elementHandle.click. Procurar o handle na
árvore de hoje não achava nada porque ele tinha sido removido — estava no
doLogout ANTERIOR a d862c680:
const parent = await el.evaluateHandle(el => el.closest('button, a, …') ?? el);
await parent.asElement()?.click(); // sem teto → 30s
git show d862c680^:…/login.ts mostra isso. **Erro de produção se lê contra o
código que rodou, não contra o HEAD.** Em 22/10 o grep no HEAD custou meia
hora e deu "não existe".
O que mudou agora
clicarOuExplicar() em utils.ts, usada nos três cliques do recurso (o
Recursar da grade, o Enviar e o Confirmar): fecha o diálogo antes quando
o alvo está FORA dele, clica com teto de 15s em vez dos 30s do padrão, e
traduz "intercepts pointer events" em CLINIPAM_CLIQUE_BLOQUEADO_POR_DIALOGO.
O Confirmar é a exceção que justifica o parâmetro: ele mora DENTRO do
diálogo, e fechá-lo antes cancelaria o envio.
Isso não prova o recurso. SUBMIT_APPEAL segue sem uma execução verde: o
envio que a operadora aceitou (processo 2660774069, protocolo 736783) foi o de
22/10, que terminou FAILED pelo logout. Provar exige uma glosa com
allowedSuspensionAppeal: true e autorização para escrever na conta do
cliente.
A execução "que falhou" foi a que enviou (confirmado em 23/10/2026)
CHECK_APPEAL_STATUS no processo 2660774069, rodado hoje pelo caminho normal
(execução cmvl7u9v20001pd1pe09qdbg8, SUCCESS em 17s):
{ "protocoloRecurso": 736783, "dataDoProtocolo": "2026-10-22T21:57:12",
"processoComplemento": 2660930860, "valorRecursado": 85, "saldo": 85,
"portalStatus": "Em Análise", "janelaDeRecursoAberta": true }
A execução cmvk9einy000bn51yjtmviuf3 começou 21:56:19 BRT e estourou ~21:57:45.
O protocolo nasceu às 21:57:12, no meio dela. O recurso de R$ 85,00 entrou,
está "Em Análise" na operadora, e a execução que o enviou está FAILED na
nossa base — o overlay do logout de novo, agora com data e hora provando.
Dois efeitos que a matriz não mostra:
1. SUBMIT_APPEAL está vermelho em cima de um envio que deu certo. O
vermelho é do transporte, não do negócio.
2. recursos_lote da ESADI está vazio, e guias_conciliacao não tem
NENHUMA guia com protocolo 2660774069. Esse recurso foi montado à mão, sem
guia nossa por trás — então registrarRecurso() devolveria null de todo
jeito, por desenho (recurso que não casa com guia não vira lote órfão).
Não há o que recuperar aqui, mas fica o aviso: recurso enviado fora do
fluxo de conciliação não aparece em lugar nenhum do nosso lado.
E o caminho portal→API da Clinipam funciona hoje: login, listagem e leitura
de recurso em 17 segundos, pelas credenciais de produção.
28/10/2026 — os dois JSON que baixávamos e ninguém lia
O conector baixa duas telas que o portal não publica como arquivo: a de Glosa
(/v2/suspensions) e a de previsão de crédito (/v6/medical-files/search).
Serializamos as respostas como JSON desde agosto. Medido em produção em
27/10/2026:
| Arquivo | Qtd | Estado |
|---|---|---|
RelatorioGlosas-clinipam-*.json | 250 | INBOX_PENDENTE_IDENTIFICACAO |
PrevisaoCredito-clinipam-*.json | 251 | INBOX_PENDENTE_IDENTIFICACAO |
DemonstrativoPagamento-*.csv | 12 | INBOX_ERRO_PROCESSAMENTO |
A causa dos dois primeiros era uma linha: hapvidaPlugin.identify() recusava
.json antes de qualquer outra regra. 501 arquivos, nove meses de dado,
barrados por um return null.
O CSV não está vazio — ele não tem itens
Os 12 CSV têm o cabeçalho da tabela de itens e nenhuma linha abaixo dele.
O portal exporta o processo com a composição financeira e sem detalhamento. São
~1 KB com três números que não existem em nenhum outro documento da operadora:
Processo;Valor Faturado;... 2660372287;8.744,12;...
PCC (PIS/COFINS/CSLL);IRRF;INSS;ISS;Total Débitos;Valor Líquido
406,60;131,16;0,00;0,00;537,76;8.206,36
São quatro tributos, não três nem seis: a Clinipam agrega PIS, COFINS e CSLL
numa linha (PCC). Entre o bruto e o que cai na conta há R$ 537,76 — o leitor
ignorava o bloco inteiro, devolvia confidence: 0, e o validador reprovava como
falha crítica por "Nenhuma guia extraída".
O que cada tela dá que o demonstrativo não dá
- •Glosa:
allowedSuspensionAppealé a operadora dizendo se a **janela de
recurso continua aberta** — melhor que os 30 dias que o Revenue estimava por
convenção. E protocolNumber nessa tela é o protocolo DO RECURSO, não do
processo (o 2660774069 recebeu o 736783 ao sair de "Não recursado" para "Em
Análise"). Confundir os dois amarraria a conta ao número do recurso dela.
- •Previsão de crédito:
processForecastPayment+paymentDatepor
processo. Não existe transação TISS para isso. Virou tabela própria
(previsoes_credito) — previsto junto de realizado contaminaria a
conciliação bancária.
O valor glosado NÃO virou linha de glosa
difference do relatório de Glosa é o mesmo dinheiro que o demonstrativo de
análise já trouxe item a item. Gravá-lo como glosa de nível protocolo somaria
duas vezes em qualquer agregação. Ele descreve o protocolo
(valorGlosaProtocolo); o que é inédito — situação e janela — vai para
situacaoProtocolo e extraFields.
O PDF consolidado — o leitor existia, a identificação não
DemonstrativoConsolidado-<uuid>.pdf é o mesmo demonstrativo de pagamento em
PDF, e o leitor do leiaute já estava escrito. O que faltava era a regra de nome:
o plugin só conhecia DemonstrativoPagamento-<n>, e o conector salva o download
com o nome que o portal dá. Dois arquivos ficaram parados por isso.
Conteúdo não serve para confirmar PDF na triagem: a amostra são os primeiros
8 KB do binário, onde não há texto para procurar. A decisão é pelo nome.
Lido à mão, o arquivo de 08/12/2025–07/01/2026 dá 44 itens e R$ 29.477,37 contra
R$ 30.327,37 declarados no cabeçalho — R$ 850,00 de diferença, uma linha de
serviço que o regex de item não casa. O leitor avisa (TOTAL_MISMATCH) em vez de
publicar total plausível, e isso continua aberto: achar a linha exige
comparar o texto extraído com o PDF renderizado, página a página.
O bloco de Tributos do PDF (PCC, IRRF, INSS, ISS + Total Débitos + Valor
Líquido) passou a ser lido — são os mesmos quatro do CSV, e é a diferença entre
o Valor Bruto e o que cai na conta.
31/10/2026 — envio real pela tela do Miydas, e o que ele derrubou
Pedido real disparado pela tela de nova autorização, não por sonda:
beneficiário 0E3IW000002003 (INDALAB), hemograma 40304361 (tabela 22),
indicação "EXAMES DE ROTINA", solicitante vindo do padrão do convênio
(Edson Andre Stakonski · CRM 11648/SC · CBO 225125). Guia do prestador
2610310001, autorização cmvwb7oll0tgvls25sjqvh8xc.
Desfecho: #ModalBiometria de novo, e a guia NÃO foi criada. 61 s de
execução, FAILED. Com isso cai a hipótese de que a parede fosse do caminho
de ANEXO PENDENTE: aqui não houve anexo nenhum, e o Confirmar abriu a captura
de digital do mesmo jeito.
Isso fecha a pergunta aberta de 22/10 em metade: na INDALAB a digital é exigida
na solicitação, não só na execução. O que segue aberto é se ela é por
beneficiário ou do prestador inteiro — a mesma credencial autorizou na hora em
22/10 (glicose, AR0938134) e foi barrada agora. Os dois pedidos têm a mesma
carteirinha, o que enfraquece "é por beneficiário"; a diferença conhecida é o
procedimento.
Três defeitos nossos que só apareceram porque o envio foi pela tela
1. O conselho do solicitante travava o envio. O pedido guarda em
extraFields o conselho já convertido para o domínio TISS ('06'), e dali
saem os médicos recentes e o padrão do convênio — mas o <select> da tela
trabalha com a sigla. '06' não casa com opção nenhuma, o campo fica vazio e
o botão não sai de "Resolva o que falta acima". Número, UF e CBO apareciam
preenchidos; o conselho, não. O atalho "Recentes" estava quebrado do mesmo
jeito, desde antes dos padrões.
2. O motivo da parede não chegava ao balcão. O conector escrevia a frase
certa — "exige a digital do beneficiário … o pedido NÃO foi criado … precisa
ser feita no balcão, com o paciente presente" — mas lançava SaviError, e o
executor só preserva o código de quem é AppError. Virava CONNECTOR_ERROR,
caía na regra de fundo e o atendente lia **"A operadora não respondeu ou
respondeu fora do padrão. Consulte o suporte do Miydas"**. A mensagem mais
errada possível: ninguém precisava do suporte, precisava do paciente. Agora é
IDENTIFICACAO_PRESENCIAL, classe DADOS (não repete, não conta contra a
saúde da conexão).
3. A tela de envio nunca aprendia o desfecho. O 201 do POST é o aceite do
pedido, não o resultado: volta PROCESSANDO. A linha da guia mostrava só o
que veio no POST e ficava em "enviada · Enviando à operadora" para sempre
— a guia falhou aos 61 s e quem estava no balcão não soube. Agora a linha
acompanha a autorização até o desfecho e imprime o motivo.
Junto, o rótulo vermelho deixou de ser "Não foi possível falar com a
operadora": falamos com ela: ela é que não criou a guia.
O que isto NÃO prova
Que a Clinipam nunca autoriza por robô. Prova que nesta credencial, hoje,
o Confirmar da solicitação pede digital. A pergunta para a operadora continua
a mesma: a digital pode ser dispensada quando o paciente não está presente
(coleta domiciliar, material de terceiros)?
4. O print da falha era a tela de login — em todos os conectores
Procurando a resposta da operadora para esta recusa, o único artefato do portal
guardado foi o screenshotUrl da execução. Decodificado: **a tela de login do
Savi**, com captcha novo. 1,29 MB de nada, seis vezes.
O print de falha (RN09) é tirado pelo *executor*, depois que a operação estoura.
Mas toda operação de RPA encerra a sessão num finally { await this.doLogout() }
— então a foto sempre chegava depois do logout. Não era defeito da Clinipam nem
do Savi: eram 16 conectores com o mesmo finally.
E havia mais duas pernas do mesmo defeito, que juntas tornavam o recurso inútil
de ponta a ponta:
- •O print não ia para o S3. Só o
fetch-workerconstruía o executor com
storage. Autorização, elegibilidade e validação de credencial passam pelos
workers de *submit* e *status*, que não passavam — e todo print deles caía no
fallback data:image/png;base64,… dentro do Postgres: 62 MB medidos em
portal_executions + portal_execution_steps.
- •E não aparecia na tela. A tela de execução só renderiza
http(s)
(isSafeUrl). Nem o data: nem o s3://bucket/key passam por esse filtro, e
getSignedUrl() existia sem nenhum chamador. Ou seja: **nunca houve caminho
em que alguém visse o print de uma falha de RPA.**
Corrigido em 31/10/2026: doLogout() passou a ser método da RPAConnectorBase
— fotografa e só então chama o onLogout() do conector —, o storage ganhou
default no executor, o fallback base64 foi removido (perder diagnóstico é mais
barato que engordar a linha com algo que ninguém lê) e o getById assina o
s3:// antes de responder. O teste rpa/tela-antes-do-logout.test.ts lê o fonte
dos 16 e reprova quem redeclarar doLogout(): a regressão é silenciosa, só
aparece na recusa seguinte.
Os 62 MB antigos continuam no banco. São todos tela de login — não vale nada
além do espaço que ocupam.
#### Provado em produção no mesmo dia
Terceiro envio real (guia 2610310003, 31/10 13:44), mesma parede de biometria,
mesmo IDENTIFICACAO_PRESENCIAL. O print guardado agora é **a tela de
Autorização de Procedimento do Savi**, logada como JANICE DEBARBA / 154866,
com o pedido inteiro visível: beneficiário, CRM 11648, diagnóstico e o
40304361 - HEMOGRAMA COM CONTAGEM DE PLAQUETAS na grade. Antes do conserto,
essa mesma falha gravava a tela de login.
Detalhe que só o print mostra: a barra de identificação fica no alto à direita
(reconhecimento facial, digital e [TOKEN] em vermelho), e o cabeçalho avisa
VOCÊ POSSUI 1 MENSAGENS PENDENTES. Nada disso aparecia em lugar nenhum do
Miydas.
A conexão seguiu com consecutiveFailures = 0: IDENTIFICACAO_PRESENCIAL é
classe DADOS, então a parede não conta contra a saúde do canal — que é o
comportamento desejado, já que o canal funcionou.
Os 78 prints antigos (39 execuções + 39 passos) foram migrados para o S3, na
mesma convenção de chave do executor, em vez de apagados: 46,7 MB de PNG real,
zero falhas, e agora visíveis pela tela de execução.
5. O HTTP 400 do Portal Prestador NÃO é senha errada
Medido em 31/10/2026, na conexão da Clínica da Saúde do Aparelho Digestivo
(CNPJ 02.741.897/0001-30):
| Execuções boas | 1.069 |
Recusas de login (HTTP 400 "Usuário ou senha inválidos") | 100 |
| Recuperadas na tentativa seguinte | 99 |
| Perda definitiva | 1 (03/08, FETCH_GLOSA_REPORT, 3 tentativas em 3 min) |
| Ritmo normal | ~16 coletas/dia, 0 a 3 recusas |
O portal recusa a MESMA credencial em ~10% das tentativas e aceita nas outras.
Exemplo completo, 30/10: 21:00:00 falhou, 21:01:06 falhou, 21:03:11
passou. A instabilidade dura minutos.
Hipótese descartada: sessão concorrente. Medidas as 15 recusas mais
recentes contra execuções sobrepostas na mesma conexão — zero em todas.
As coletas são agendadas de 15 em 15 minutos e nunca se cruzam.
O custo real não era o dado perdido — era a leitura. A recusa virava
CONNECTOR_ERROR genérico carregando o texto da operadora, e o histórico se
lia como "senha vencida há três meses". Faltou um clique para a integração ser
desligada. O caminho de credencial inválida (marcar INVALID, avisar o dono,
parar de repetir) existia e esta recusa nunca o alcançava.
Conserto. O conector lança LOGIN_RECUSADO, que não afirma causa nenhuma,
e o executor decide pelo histórico da conexão (services/recusa-de-login.ts):
- •login bem-sucedido nas últimas 24h →
PORTAL_INSTAVEL: repete, não acusa a
credencial, não conta como queda de canal;
- •nenhum →
LOGIN_FAILED: não repete, marca a credencial e avisa o dono.
A janela é 24h porque as coletas rodam de 6 em 6 horas — cobre quatro ciclos.
A mensagem guardada mantém o que a operadora disse e acrescenta a conclusão
marcada como nossa, para o próximo leitor não repetir o erro.
Cuidado ao mexer: chamar a recusa de LOGIN_FAILED direto no conector pararia
as repetições (RN03) e transformaria as 99 recuperações em 99 falhas.
31/10/2026 — o XML da Indalab não tem versão, e por isso a Clinipam dela não existe no Miydas
Medição feita no portal com a credencial da Indalab (CNPJ 81.007.866/0001-26),
cobrindo as três telas do ciclo de pagamento: /medical-production,
/report-guide/{findId} e /statement-payment/{findId}.
O achado que paga a sessão
O XML de DEMONSTRATIVO_ANALISE_CONTA gerado hoje para a Indalab **não traz
versaoPadrao nem Padrao** no <ans:cabecalho>. O cabeçalho inteiro é:
<ans:identificacaoTransacao>
<ans:tipoTransacao>DEMONSTRATIVO_ANALISE_CONTA</ans:tipoTransacao>
<ans:sequencialTransacao>888353</ans:sequencialTransacao>
<ans:dataRegistroTransacao>2026-10-31</ans:dataRegistroTransacao>
<ans:horaRegistroTransacao>14:45:08</ans:horaRegistroTransacao>
</ans:identificacaoTransacao>
detectTissVersion procura em três lugares (cabecalho.Padrao,
cabecalho.versaoPadrao, identificacaoTransacao.Padrao) e no
xsi:schemaLocation da raiz. Nenhum existe aqui. parseTiss lança
TISS_UNKNOWN_VERSION com candidates: [], e o tiss-xml.handler cai no
extrator legado — que salva totais em inbox_files e **não chama
dispatchCanonical**.
Consequência medida em produção, mesma data:
| ESADI | Indalab | |
|---|---|---|
inbox_files DEMONSTRATIVO_ANALISE (Clinipam) | 844 | 12 |
tiss_transactions (Clinipam) | 579, versão 3.05.00, última em 31/10 | 0 |
guias_conciliacao registroANS 340782 | 503 (36 com glosa, R$ 20.142,74) | 0 |
O leiaute difere por PRESTADOR, não por data. A ESADI tem transação criada
em 31/10/2026 com versão 3.05.00 detectada; o arquivo da Indalab baixado no
mesmo dia não tem versão nenhuma. Mesma operadora, mesmo portal, mesmo dia.
Então: a Indalab tem 2.312 guias e R$ 571,20 de glosa lidos e jogados fora.
O arquivo fica INBOX_DISTRIBUIDO — o status mente, porque distribuição
canônica nunca aconteceu.
Não é hipótese: o teste foi rodar parseTiss sobre o arquivo real
(DemonstrativoPagamento-2660851374-4863105.xml, 368 KB, baixado em
31/10/2026) e depois o TissXmlGenericHandler inteiro. O primeiro lança; o
segundo devolve 253 guias certas e zero código de glosa.
O extrator legado acerta o dinheiro e perde o motivo
Rodado sobre o arquivo real:
summary: { totalGuides: 253, totalItems: 253,
totalBilled: 2518.98, totalPaid: 2416.98, totalGlosa: 102 }
guias com totalGlosa > 0: 14
itens com glosaCode preenchido: 0
Os valores batem com o portal ao centavo. O motivo não sai, e a causa é uma
linha de tiss-xml.handler.ts (~l.250):
glosaCode: safeStr(det.codigoGlosa), // ← procura no detalhe
glosaDescription: safeStr(det.descricaoGlosa),
Na Clinipam a glosa mora em det.relacaoGlosa, e os campos se chamam
ansCodigo / ansDescricao / tipoGlosa:
<ans:detalhesGuia>
…
<ans:relacaoGlosa>
<ans:valorGlosa>8.00</ans:valorGlosa>
<ans:tipoGlosa>3202</ans:tipoGlosa>
<ans:ansCodigo>3202</ans:ansCodigo>
<ans:ansDescricao>COBRANÇA DE ITEM INCLUSO NO PROCEDIMENTO PRINCIPAL</ans:ansDescricao>
</ans:relacaoGlosa>
</ans:detalhesGuia>
Sem código de glosa não há template de recurso, não há taxaAceite, e não há
como separar glosa recorrível de glosa justa.
valorProcessado na Clinipam é o valor GLOSADO
Em item sem glosa: valorInformado 30.70, valorProcessado 0.00,
valorLiberado 30.70. Em item glosado: valorInformado 8.00,
valorProcessado 8.00, valorLiberado 0.00. No rodapé do protocolo:
valorInformadoProtocolo 2518.98
valorProcessadoProtocolo 102.00 ← igual ao valorGlosaProtocolo
valorLiberadoProtocolo 2416.98
valorGlosaProtocolo 102.00
Quem calcular glosado = informado − processado acha R$ 2.416,98 de glosa num
processo que teve R$ 102,00. O extrator legado escapa porque lê
valorGlosaGuia direto — mas o campo totalPaid dele cai em
valorLiberado ?? valorProcessado, e a ordem é o que o salva. Inverter mataria.
qtdExecutada vira .0000 quando o item é glosado
Literalmente .0000 — sem o zero à esquerda. Nas 14 guias glosadas, todas.
Nas 239 restantes, 1.0000. O resultado no normalizado é quantity: 0 em item
que foi executado. O XLSX do mesmo processo traz Qtd Faturada 1,00 e
Qtd Pago 0,00, que é a leitura correta.
dataInicioFat não é início de faturamento — é previsão de pagamento
<ans:dataInicioFat>2026-11-20</ans:dataInicioFat> em todas as 253 guias, e
20/11/2026 é exatamente a coluna "Previsão Pagamento" da tela. Campo que mente
pelo nome.
O XML declara utf-16 e chega em UTF-8
<?xml version="1.0" encoding="utf-16"?> com bytes UTF-8 — sem BOM, sem NUL. O
sanitizador do handler já corrige (ENCODING_FIXED + NAMESPACE_STRIPPED nos
warnings), mas parser que respeite a declaração quebra. A nota antiga dizia
"vem em UTF-16"; hoje, para este prestador, não vem. Checar os dois.
O XML TEM os tributos — a tabela das três fontes estava errada
resumoFinanceiro carrega o que se dizia existir só no XLSX/CSV/PDF:
<ans:impostos>
<ans:pis-cofins-csll>0</ans:pis-cofins-csll>
<ans:irrf>0</ans:irrf> <ans:inss>0</ans:inss> <ans:iss>0</ans:iss>
<ans:totalDebitos>0</ans:totalDebitos> <ans:totalCreditos>0</ans:totalCreditos>
<ans:valorFinalReceber>2416.98</ans:valorFinalReceber>
</ans:impostos>
<ans:notaFiscal>
<ans:competencia>2026-09-01</ans:competencia>
<ans:previsaoPagamento>2026-11-20</ans:previsaoPagamento>
<ans:numero>5326</ans:numero>
</ans:notaFiscal>
O extrator legado devolve liquidacao: null — nada disso é lido. O número da
NF (5326) é a ponte com SUBMIT_DOCUMENT, e hoje ela não existe.
31/10/2026 — as rotas das duas telas que ninguém tinha mapeado
/report-guide/{findId} — Relatório da Guia
A lista das guias enviadas do processo, sem nada de glosa. Colunas: Guia,
Carteira, Data Atendimento, Senha, Valor da Guia. Rodapé: Gerar PDF, Excel, CSV
— sem XML.
GET /v2/medical-files/header?id={findId}
→ { id: 4863105, findId, processNumber: 2660851374,
productionDate, productionValue: 2518.98, amountGuides: 253 }
GET /v2/medical-files?id={processPortalId}&limit=20&offset=0
→ [{ id, documentCode, userCode, passwordCode, attendanceDate, guideValue }]
GET /v1/medical-files/export-report?id={findId}&type=csv|xlsx|pdf
/v2/medical-files/header resolve o processPortalId num GET. A nota de
21/10 dizia que ele "não está em nenhuma coluna da tabela" e vinha de escutar o
SignalR ou de /v6/medical-files/search. Vem daqui, direto, pelo findId que
já está no link da tela.
/statement-payment/{findId} — Demonstrativo de Análise de Contas
Duas tabelas: "Demonstrativo de Serviços Executados" (item a item, com Valor
Faturado / Pago / Glosa) e "Discriminativo dos Erros / Correções" (só os
glosados, com Justificativa). Rodapé: Gerar PDF, Excel, CSV, XML.
GET /v3/payment-statement/header/{findId}
GET /v3/payment-statement/guide-items?offset=0&limit=20&id={processPortalId}
GET /v3/payment-statement/guide-items-error?offset=0&limit=20&id={processPortalId}
GET /v1/payment-statement/export-report?id={findId}&type=xml|csv|pdf|xlsx
/header traz o fechamento financeiro completo: reportedAmount,
analyzedAmount, difference, bruteAmount, discount, grantedCredit,
invoiceAmount, `taxes{tax, withholdingIncomeTax, socialSecurityContribution,
serviceTax, totalAmountDebits}` e os dados bancários do prestador.
guide-items-error é a glosa em texto, com procedureCode e message — sem
código ANS. Para o código, XML ou XLSX.
Três convenções de nome diferentes, e reportType não é 2 para tudo
Medido pedindo os três e conferindo o download de cada um:
| Documento | Nome do arquivo | reportType |
|---|---|---|
| Demonstrativo XML | DemonstrativoPagamento-{processo}-{processPortalId}.xml | 2 |
| Demonstrativo XLSX | DemonstrativoPagamento-{processo}.xlsx — sem o id | 2 |
| Relatório de Guias | Guias-{processo}-{findId}.csv | 1 |
O cruzamento, com o mesmo token e o mesmo reportType=2:
DemonstrativoPagamento-2660851374.xlsx → 200, 29.394 bytes
DemonstrativoPagamento-2660851374-4863105.xlsx → 200, 0 bytes
DemonstrativoPagamento-2660851374-4863105.xml → 200, 368.104 bytes
DemonstrativoPagamento-2660851374.xml → 200, 0 bytes
Nome errado devolve exatamente o que a geração inacabada devolve: 200 com
zero byte. Duas afirmações antigas caem com isso:
- •"
type=excelé inválido; os aceitos são xml, csv, pdf" — o parâmetro é
xlsx, e funciona. O botão "Gerar Excel" chama
export-report?id=…&type=xlsx.
- •"
reportType=2é o único que devolve conteúdo; 1 e 3 vêm vazios" — 1 é o
tipo do relatório de guias. Vinha vazio porque se pedia um demonstrativo
com ele.
O SignalR não precisa ser escutado: está no localStorage
O portal grava as notificações de geração em
localStorage["notifications-{CNPJ}-{tenantId}"]:
[{"id":"{findId}-Demonstrativo de Pagamento (XML)","status":"COMPLETED",
"report":{"name":"DemonstrativoPagamento-2660851374-4863105.xml","type":2}}]
Nome do arquivo e reportType prontos, com o estado da geração. É o caminho
mais curto que existe para "está pronto, e se chama assim" — e dispensa tanto
derivar nome quanto abrir WebSocket.
O XLSX por processo é o documento mais rico da operadora
24 colunas, e duas que não existem em mais lugar nenhum por processo:
Tipo Servico; Servico; Data Autorizacao Pagamento; Data Atendimento; Guia;
Autorizacao; Cod Usuario; Cod Rede; Rede; Cod Ato; Tipo Ato; Cod Procedimento;
Procedimento; Qtd Faturada; Qtd Pago; Qtd Glosada; Valor Faturado; Valor Pago;
Valor Glosado; Cód. Motivo (operadora); Motivos Glosa; Codigo ANS;
Descricao ANS; Observação
Linha glosada real do processo 2660851374:
… 40301591 COLESTEROL (LDL) | 1,00 | 0,00 | 0 | 8,00 | 0,00 | 8,00
| 392 | EXISTE OUTRO PROCEDIMENTO PRINCIPAL PAGO QUE INVALIDA ESTE
| 3202 | COBRANÇA DE ITEM INCLUSO NO PROCEDIMENTO PRINCIPAL
392 (operadora) ao lado de 3202 (ANS), por processo — a nota dizia que
esse par só existia no consolidado, que a Indalab não tem. E a quantidade sai
certa (1,00), onde o XML traz .0000.
Cabeçalho do XLSX, acima dos itens: Processo, Valor Faturado, Valor Analisado,
Valor da Glosa, Valor Bruto, Desconto, Crédito Concedido, Bonificação, Valor
Bruto NF; Competência, Previsão Pagamento, Tipo Processo, Nota Fiscal; e o
bloco PCC/IRRF/INSS/ISS/Total Débitos/Valor Líquido.
"Valor Analisado" significa coisas diferentes em fontes diferentes. No
XLSX vale 2.518,98 (= faturado); na tela e em /v3/payment-statement/header
(analyzedAmount) vale 2.416,98 (= líquido). O XLSX chama de "Valor
Bruto" o que a API chama de "analisado". Casar os dois pelo rótulo inventa
R$ 102,00.
Campos com padding de espaços
" 009852548", " 2", " 99".
Guia, Tipo Servico, Cod Ato e Qtd Glosada vêm alinhados à direita com espaços.
Sem trim() o número da guia não casa com nada.
A dedup não está segurando
Os 12 arquivos da Indalab são 3 processos baixados 4 vezes cada
(2660533625, 2660632996, 2660741859 — em 22, 22, 24 e 27/10). O XML é
regenerado a cada pedido, com sequencialTransacao e dataRegistroTransacao
novos, então o hashSHA256 muda sempre. Dedup por hash não vê documento
repetido aqui — confere com o que já estava escrito sobre a chave ser o
protocolo.
E o processo 2660851374 (09/2026, R$ 2.518,98, o maior em aberto) **nunca
foi baixado** — apareceu na listagem de hoje e não está no inbox.
O que ficou aberto
- ☐Por que o XML da ESADI tem
versaoPadraoe o da Indalab não. O que se
mediu é que diferem no mesmo dia; não se mediu se é perfil, tipo de
prestador (providerType, isFullInvoice) ou data de cadastro.
- ☐Se o XLSX por processo existe para a ESADI com as mesmas 24 colunas.
- ☐Se
/v2/medical-files(guias do processo) pagina além de 50, como as
outras rotas.
- ☐O
/report-guide/87d9cefc-b189-415e-8d7a-a9e6f2db2345citado na abertura
da sessão não está entre os 4 processos da janela de 120 dias — é de
competência anterior, e não foi medido.
6. A autorização pelo Savi JÁ CRIOU GUIA — e o que mudou foi do lado deles
Pergunta respondida em 31/10/2026 medindo, não lembrando: o conector **criou guias de
verdade** na Clinipam, pela mesma conexão que hoje bate na parede da digital.
| nosso pedido | quando | guia na operadora | procedimento |
|---|---|---|---|
MYD211026B | 21/10 21:14 | 304548146 (em análise) | 40301630 CREATININA |
MYD221026A | 22/10 09:28 | 304557120 · senha AR0938134 | 40302040 GLICOSE |
MYD221026D | 22/10 11:00 | 304572731 · senha AR1101045 | 40301605 COLESTEROL |
Confirmado perguntando ao portal, não ao nosso banco. A consulta de status da
304572731 devolveu: data 22/10/2026, usuario 0E3IW000002003 FABIO PINTO HOFFMANN,
solicitante 11648 CRM EDSON ANDRE STAKONSKI, procedimento 40301605 COLESTEROL T…,
senha AR1101045. Bate item a item com o que foi pedido.
MYD221026B aponta para a mesma 304557120 de MYD221026A — e isso é coerente, não
leitura errada: mesmo beneficiário e mesmo procedimento, e o Savi recusa pedido repetido
mostrando a guia que já existe (ver a seção do pedido repetido).
Estado por operação, medido no histórico da conexão:
| operação | estado |
|---|---|
| login / elegibilidade | funciona |
| solicitar autorização | bloqueada pela digital desde 30/10 |
| consultar status | funciona — 77 execuções boas, a última em 31/10 |
A pergunta para a Clinipam ficou mais precisa: não é "o robô consegue autorizar?" —
ele conseguiu, três vezes. É "a exigência de digital foi ligada para o prestador 154866
entre 22 e 30/10; ela pode ser desligada, ou vale só com o paciente no balcão?"
31/10/2026 — o que foi consertado, e o que o conserto revelou
Cinco mudanças, nesta ordem, porque a primeira sozinha teria sido pior que o
defeito.
1. Versão presumida: o documento passa a chegar ao domínio
detectTissVersion presume 3.05.00 quando a mensagem é TISS reconhecível
(tem mensagemTISS e um tipoTransacao legível) e não declara versão nenhuma.
Fica em WARN. XML de outra origem continua estourando — ali não há o que
presumir.
Não é chute: é a versão que a mesma operadora declara para o outro prestador, e
é o que a estrutura do arquivo é.
2. A base do cálculo de glosa virou o LIBERADO
Esta é a parte que não podia faltar. Com a versão destravada e o fallback como
estava, o canônico somava R$ 2.518,98 de glosa no processo 2660851374 —
253 de 253 itens marcados — num processo que teve R$ 102,00.
O fallback calculava informado − processado, e aqui valorProcessado é o
valor GLOSADO. Item pago integralmente vem assim:
valorInformado 30.70 · valorProcessado 0.00 · valorLiberado 30.70
informado − liberado é a definição de glosa em qualquer operadora — "liberado"
é o que ela vai pagar, e isso não é ambíguo em lugar nenhum. valorProcessado
fica como segunda escolha, para documento que só traz ele.
Depois da mudança: 14 itens glosados, soma R$ 102,00, igual ao portal.
A perda estava escondida atrás do defeito anterior. Enquanto parseTiss
estourava, ninguém via que o parser inventaria a glosa. Consertar um sem o
outro teria gravado R$ 2.416,98 de glosa falsa na primeira coleta.
3. O motivo da glosa, nos dois leitores
relacaoGlosa usa ansCodigo/ansDescricao, e os dois leitores procuravam
codigoGlosa/descricaoGlosa. 14 glosas com código ANS no arquivo, 0 no
normalizado.
O canônico já lia o código por tipoGlosa — faltava a descrição, que só
existe em ansDescricao. O extrator legado não lia nenhum dos dois: a glosa
mora dentro de detalhesGuia, e ele olhava o nível errado.
4. qtdExecutada .0000 não vira mais zero
Item com valor informado e quantidade zero é contradição. Agora fica ausente
— "não se sabe" é verdade, zero não era. O XLSX do mesmo processo mostra que a
operadora põe a quantidade PAGA no campo da executada (Qtd Faturada 1,00,
Qtd Pago 0,00).
5. O XLSX passou a ser coletado, e os dois códigos foram desembaralhados
O leitor das 24 colunas já existia (dem-pagamento-xlsx.handler) e punha o
código PROPRIETÁRIO (392) em glosaCode, que é o campo do código da ANS,
descartando as colunas Codigo ANS e Descricao ANS. Duas consequências, as
duas caladas: o cruzamento com a Tabela 38 nunca casava — 392 não existe lá — e
o número com que se fala com a operadora no recurso sumia.
NormalizedItem ganhou glosaOperatorCode. O contrato de análise já sabia
recebê-lo (AnalysisGlosa.operatorCode → Glosa.codigoOperadora, coluna que
existe e que a API pública já devolve). Era o único elo que faltava.
Medido sobre o arquivo real: 253 guias, R$ 2.518,98 / 2.416,98 / 102,00, 14
itens glosados com os dois códigos e quantidade 1.
6. resumoFinanceiro passou a ser lido
Tributos (PCC, IRRF, INSS, ISS), totalDebitos, totalCreditos,
valorFinalReceber, e a nota fiscal com competência, previsão de pagamento
e número. Vai para extraFields do demonstrativo, em string — JSON com
float é o que a regra de dinheiro do projeto proíbe.
A previsão diz quando o dinheiro chega; o número da NF é a ponte com
SUBMIT_DOCUMENT, porque nesta operadora é a nota que segura o pagamento.
Nenhum dos dois existe em outro campo TISS.
7. Dedup por nome, porque o hash nunca repete
O portal regera o documento a cada pedido, com sequencialTransacao e
dataRegistroTransacao novos. O hashSHA256 muda sempre.
Passou a usar existingFileNames, que o executor já fornece e que outros quatro
conectores já usam. Os dois formatos são decididos em separado: processo que já
tem XML precisa do XLSX sem rebaixar o XML.
Limite conhecido, não medido: reanálise do mesmo processo não é rebaixada
por esta via. Se a operadora reemitir um demonstrativo com valores novos sem
mudar o número do processo, só uma sincronização inicial o traz.
A coleta automática da Indalab não roda — e não é dedup
Procurando por que o processo 2660851374 (09/2026, R$ 2.518,98, o maior em
aberto) nunca foi baixado, o rastro deu em outro lugar.
Todas as execuções da Indalab na Clinipam são MANUAIS. Em
portal_executions, triggeredBy é user:… em todas as 19 desde o cadastro em
21/10/2026. Nenhuma de sistema. A última FETCH_ANALYSIS foi em 24/10,
disparada à mão.
A ESADI, no mesmo conector, tem 39 FETCH_ANALYSIS com SUCCESS, a última
hoje às 15:00, de 6 em 6 horas.
O que foi medido e descartado como causa:
| Hipótese | Medição que a derrubou |
|---|---|
| conexão desativada | isActive = t, autoSyncEnabled = t, credentialStatus = VALID |
| contador de falhas estourado | consecutiveFailures = 0 |
| config apagada | deletedAt nulo |
| job nunca agendado | os 4 jobs repetíveis existem no Redis: scheduler:fetch:cmvil2me40003oicr37mqlnnr:{FETCH_ANALYSIS,FETCH_PAYMENT,FETCH_GLOSA_REPORT,FETCH_PAYMENT_SCHEDULE} |
| fila travada ou execução órfã | portal-fetch: 0 em espera, 0 ativos, 0 falhos, 15 agendados. Nenhuma execução RUNNING presa |
| próximo disparo perdido | agendado para 01/11 às 03:00 (delayed = 1793512800000), coerente com o cron |
Ou seja: **a configuração está certa, o job existe, a fila está limpa, e mesmo
assim não disparou em nenhum dos últimos 6 dias.** A causa não foi encontrada.
Duas diferenças entre os dois prestadores, nenhuma delas provada como causa:
- •o cron da Indalab é
0 3 * * *(uma vez por dia, de madrugada); o da ESADI é
0 */6 * * * (quatro vezes). Um job que falhe em disparar numa janela tem
três outras chances no mesmo dia na ESADI e nenhuma na Indalab.
- •o container da API reinicia com frequência — estava de pé havia 30 minutos
quando isto foi medido. Se um restart atrasar o disparo das 3h, na Indalab o
dia inteiro se perde.
O que fazer a seguir
- ☐Confirmar se job repetível atrasado é recuperado depois de restart do
worker, ou se o disparo perdido se perde. É a hipótese mais barata de
testar e a que explica os dois sintomas.
- ☐Enquanto não se souber, pôr a Indalab no mesmo cron da ESADI
(0 */6 * * *): não é conserto, é reduzir a janela de perda de 24h para
6h.
- ☐Verificar quantos outros prestadores estão com cron de uma vez ao dia e
sem execução automática. clinipam-savi, unimed-blumenau da Indalab e
unimed-brusque da T.W.A estão todos em 0 3 * * *.
31/10/2026 — a validação em produção, e o que ela mostrou que falta
Deploy do commit c4bb5901, e FETCH_ANALYSIS disparada à mão para a Indalab
(triggeredBy: script:validacao-clinipam-2026-10-31). SUCCESS em 45,5 s.
{"totalAvailable": 3, "totalNew": 4, "totalDuplicated": 0,
"fileNames": ["DemonstrativoAnaliseConta-2660851374.xml",
"DemonstrativoPagamento-2660851374.xlsx",
"DemonstrativoPagamento-2660741859.xlsx",
"DemonstrativoPagamento-2660632996.xlsx"]}
Quatro arquivos de três processos, e a composição é a prova de que a dedup por
formato funciona: um XML só — o do 2660851374, único que faltava — e os
três XLSX, inclusive dos dois processos cujo XML já estava no inbox. Nenhum
re-download (totalDuplicated: 0), onde antes os três voltariam inteiros.
O que entrou no domínio
| antes | depois | |
|---|---|---|
tiss_transactions (Clinipam, Indalab) | 0 | 1, DEMONSTRATIVO_ANALISE_CONTA, versão 3.05.00 |
guias_conciliacao registroANS 340782, Indalab | 0 | 253, 14 com glosa, R$ 102,00 |
glosas com código ANS para a Indalab na Clinipam | 0 | 14, código 3202, R$ 102,00 |
demonstrativos_pagamento (dos XLSX) | — | 3 |
Os totais do inbox batem com o portal nos quatro arquivos:
DemonstrativoAnaliseConta-2660851374.xml 253 guias 2.518,98 / 2.416,98 / 102,00
DemonstrativoPagamento-2660851374.xlsx 253 guias 2.518,98 / 2.416,98 / 102,00
DemonstrativoPagamento-2660741859.xlsx 129 guias 1.626,62 / 1.610,62 / 16,00
DemonstrativoPagamento-2660632996.xlsx 260 guias 6.360,83 / 6.280,03 / 80,80
O código proprietário da operadora AINDA NÃO CHEGA à tabela de glosas
Medido logo depois: **`select count(*) from glosas where "codigoOperadora" is
not null` devolve 0** — em toda a base, não só na Clinipam.
O 392 é lido corretamente pelo leitor do XLSX e sobe até
AnalysisGlosa.operatorCode. O que não acontece é o resto do caminho: o XLSX é
identificado como DEMONSTRATIVO_PAGAMENTO (a regra de nome é
DemonstrativoPagamento-\d+), e segue pelo pagamento-return-distributor, que
grava demonstrativos_pagamento e não cria linha em glosas. As 14 glosas
que existem vieram do XML de análise, que só tem o código da ANS.
Então, do item do XLSX, o que esta sessão entregou de fato:
- •✅ o código da ANS parou de ser contaminado pelo proprietário. Antes o
392
ia para glosaCode e o cruzamento com a Tabela 38 falhava calado. **Este era
o defeito, e está corrigido.**
- •✅ o leitor extrai os dois códigos, as duas descrições e a quantidade certa.
- •❌ o
392não chega aGlosa.codigoOperadora, porque o documento que o traz
não desemboca nessa tabela.
O que fazer a seguir
- ☐Decidir por onde o XLSX deve entrar. Ele é o MESMO processo do XML de
análise — mesmo número, mesmas 253 guias, mesmos R$ 102,00 —, e hoje
vira um demonstrativo_pagamento paralelo. Ou ele compõe a análise
existente (e aí o 392 entra nas glosas que já estão lá), ou continua
sendo um segundo documento que repete o mesmo dinheiro em outra tabela.
**A segunda opção é a de hoje, e ela conta o mesmo valor duas vezes em
qualquer agregação que some as duas tabelas.** Medir isso antes de
qualquer relatório que cruze as duas.
- ☐Se compuser: o par (ANS 3202, operadora 392) por item é a chave, e
apagarAnalisesSuperadas já tem a mecânica de documento que substitui
outro.
7. O demonstrativo de pagamento entrava SEM protocolo, e duplicava
Medido em 31/10/2026 na conexão da Indalab:
| na base | real | inflado | |
|---|---|---|---|
| Demonstrativos de pagamento | 6 linhas · R$ 20.347,00 | 4 · R$ 12.456,35 | R$ 7.890,65 |
| Demonstrativos de análise | 13 linhas | 4 | ~3× |
Duas linhas da coleta de 31/10 eram cópia exata das de 28/10 (`1.626,62 /
1.610,62 / 16,00 e 6.360,83 / 6.280,03 / 80,80`).
A causa não era o numeroDemonstrativo — superados.ts já documenta que
ele não identifica documento. Era o protocolo, que é a chave de verdade, e
que não chegava: dem-pagamento-xlsx.handler.ts lia o processo em
getRow(8), col A, e a linha 8 do arquivo real é vazia. O bloco mora assim:
linha 9 : Processo | Valor Faturado | Valor Analisado | Valor da Glosa | Valor Bruto
linha 10 : 2660851374 | 2.518,98 | 2.518,98 | 102,00 | 2.416,98
linha 12 : Competência | Previsão Pagamento | Tipo Processo | Nota Fiscal
linha 13 : 01/09/2026 | 20/11/2026 | | 5326
Toda guia saía com protocolNumber vazio, apagarPagamentosSuperados não tinha
par (protocolo, data) para casar, e cada coleta reinseria tudo. O mesmo erro
desligava calado a validação de total: headerValorFaturado também lia a linha 8.
O teste que existia concordava com o defeito — montava a planilha com o bloco
na linha 8 e não afirmava o protocolo. Por isso o conserto busca pelo rótulo,
não por número de linha, e o novo teste roda o bloco nas linhas 8, 9 e 10.
Sem o bloco, o documento entra mesmo assim (perdê-lo seria pior) mas emite
PATTERN_NOT_FOUND — é o estado em que a duplicata volta.
Não usar "Previsão Pagamento" como data de crédito. É previsão, não
liquidação, e a identidade do pagamento é (protocolo, data de CRÉDITO). Com o
protocolo preenchido e a data nula, o dedup já casa — cada demonstrativo da
Clinipam cobre um processo só.
31/10/2026 — XML e XLSX NÃO são o mesmo conteúdo, e a diferença custa a competência
Comparados os 253 itens dos dois arquivos do processo 2660851374, chave
guia|procedimento, depois de normalizar o padding e os zeros à esquerda.
O que é idêntico
253 chaves nos dois, nenhuma exclusiva de nenhum deles. Valores item a item
(informado, pago, glosa): zero divergências. Código ANS da glosa: zero.
Carteirinha: zero. Totais: R$ 2.518,98 / 2.416,98 / 102,00 nos dois.
O que difere
| Campo | XML | XLSX |
|---|---|---|
| quantidade | .0000 nos 14 glosados | 1,00, com Qtd Pago 0,00 |
| data de atendimento | 2026-09-01 nas 253 | 9 datas reais: 02, 10, 11, 15, 16, 22, 25, 28 e 30/09 |
Cód. Motivo (operadora) | não tem | 392 |
Cod Rede/Rede, Tipo Ato | não tem | PREFERENCIAL/CREDENCIADA, PACOTE |
Data Autorizacao Pagamento | não tem | 27/10/2026, único |
| tributos e valor líquido | tem (resumoFinanceiro) | tem (cabeçalho) |
O XML achata dataRealizacao para o dia 1º da competência. Um único valor
em 253 itens. A data real do atendimento existe no XLSX, na tela e na API — e
em nenhum lugar do XML.
O que isso destapou: 342 guias com data no futuro
guias_conciliacao, dataExecucao > now(), por operadora:
340782 (Clinipam) 342 guias min 2026-11-20 max 2026-11-20
(nenhuma outra operadora da base)
Clinipam, distribuição por mês de dataExecucao:
2026-11 → 342 2026-10 → 42 2026-09 → 96
2026-07 → 54 2026-06 → 119 2026-05 → 89 2026-03 → 14
A cadeia inteira, medida:
1. o XML traz <ans:dataInicioFat>2026-11-20</ans:dataInicioFat> nas 253 guias
— e 2026-11-20 é a previsaoPagamento declarada no mesmo arquivo;
2. parseGuiaAnalise mapeia `dataRealizacao ?? dataInicioAtendimento ??
dataInicioFat para datas.inicioAtendimento`. A guia não tem
dataRealizacao nesse nível (ela mora no item), então cai no terceiro;
3. dem-analise-distributor grava em GuiaAnaliseConta.dataInicioFat;
4. dataDaGuia() prefere dataInicioFat a descer até o item — regra certa
quando o campo diz o que promete;
5. guias_conciliacao.dataExecucao = 2026-11-20.
Resultado: atendimento de setembro na competência de novembro, num mês que nem
começou. Erra o fechamento mensal, o gráfico por período e qualquer prazo
contado a partir da execução.
A nota já dizia, desde a primeira medição do dia, que dataInicioFat é a
previsão de pagamento. O que faltou foi seguir o campo até quem o consome.
Saber que um campo mente não basta: é preciso ver quem acredita nele.
O conserto
Quando dataInicioFat é **igual à previsaoPagamento do mesmo
resumoFinanceiro**, a data é descartada e dataDaGuia() desce sozinha até
dataRealizacao do item.
Não é heurística — é o documento se contradizendo. Uma das duas datas mente, e
sabe-se qual: atendimento no futuro não existe, pagamento previsto sim. A regra
é inerte quando as datas diferem e quando não há resumo financeiro, e os dois
casos têm teste.
Só foi possível escrever porque o resumoFinanceiro passou a ser lido horas
antes. Antes não havia com o que comparar.
O que o conserto NÃO resolve
dataRealizacao do XML também é achatado — 2026-09-01 nas 253. Ele põe a
guia no mês certo, não no dia certo.
- ☐O dia real só existe no XLSX (
Data Atendimento, 9 valores distintos) e
em /v2/medical-files (attendanceDate, com hora). Se algum relatório
precisar do dia, a fonte tem de ser uma dessas duas — nunca o XML.
- ☐Verificar se outras operadoras achatam
dataRealizacaodo mesmo jeito. A
Clinipam foi a única com data no FUTURO, mas "todas no dia 1º" é um
defeito mais silencioso e não foi procurado em ninguém.
O reprocessamento (31/10/2026)
17 arquivos reenfileirados, zero guias com data no futuro em toda a base
em menos de um minuto. Total intacto: 756 guias antes e depois.
mês de dataExecucao | antes | depois |
|---|---|---|
| 2026-11 | 342 | 0 |
| 2026-10 | 42 | 0 |
| 2026-09 | 96 | 438 |
| 2026-08 | 0 | 42 |
| 2026-07 / 06 / 05 | 54 / 119 / 89 | 54 / 119 / 89 |
| 2026-03 | 14 | 7 |
| 2026-02 | 0 | 7 |
As 342 de novembro foram para setembro (96 + 342 = 438); as 42 de outubro, para
agosto; as 14 de março se dividiram entre fevereiro e março. **A data falsa
estava sempre cerca de dois meses à frente da competência real** — coerente com
ela ser a previsão de pagamento.
guias_analise_conta.dataInicioFat ficou nulo em todas as guias da Clinipam,
que é o efeito pretendido: não há data de atendimento no nível da guia neste
leiaute, e deixar nulo é o que faz dataDaGuia() descer até o item.
Selecionar o que reprocessar quase deu errado
O primeiro critério — "arquivos com TissTransaction viva" — devolveu **580
arquivos para 10 processos. TissTransaction é 1:1 com o arquivo e não** é
apagada quando o demonstrativo é superado; só o DemonstrativoAnaliseConta é.
Enfileirar os 580 concorrentemente deixaria a ordem ao acaso, e
apagarAnalisesSuperadas faz vencer o último a processar: daria para
ressuscitar um demonstrativo velho por cima do novo.
O critério certo parte do outro lado — dos demonstrativos que existem hoje,
subindo até o arquivo que originou cada um. 22 vivos, 17 reprocessáveis.
O script simula por padrão e só escreve com --executar. Foi essa simulação
que mostrou os 580 antes de qualquer dano.
O que a conferência final mostrou de novo
A Indalab tem quatro demonstrativos de análise, e eles não são iguais:
| processo | profundidade | guias | origem |
|---|---|---|---|
| 2660851374 | A (item + motivo de glosa) | 253 | DemonstrativoAnaliseConta-*.xml |
| (sem número) | B (item, sem motivo) | 260 | sem inboxFile ligado |
| (sem número) | B | 189 | sem inboxFile ligado |
| (sem número) | B | 129 | sem inboxFile ligado |
Os três de profundidade B têm numeroDemonstrativo nulo e nenhum arquivo
de origem rastreável, e seus valores (6.360,83 · 2.194,72 · 1.626,62) são os
dos processos 2660632996, 2660533625 e 2660741859.
- ☐Descobrir por onde eles entraram. Hipótese não verificada: o
analise-return-distributor, que recebe NormalizedReturn de qualquer
handler — o que incluiria os XLSX coletados horas antes. Se for isso, o
mesmo processo existe duas vezes no domínio, uma vez como análise B e
outra como demonstrativos_pagamento.
- ☐Entender por que só as 253 guias do 2660851374 chegaram a
guias_conciliacao. As 578 guias dos três demonstrativos B estão em
guias_analise_conta e não atravessaram para a conciliação.
31/10/2026 — as três pendências, fechadas
1. A coleta nunca disparou porque o agendamento não tinha payload
A causa estava na estrutura do job no Redis, e aparece lado a lado:
ESADI scheduler:fetch:cms984hr6…:FETCH_ANALYSIS
pattern 0 */6 * * * tz America/Sao_Paulo ic 361 data {…}
Indalab scheduler:fetch:cmvil2me4…:FETCH_ANALYSIS
pattern 0 3 * * * tz America/Sao_Paulo
↑ sem `ic`, sem `data`
ic é o contador de iterações. **Ausente = nunca disparou, nem uma vez, em dez
dias.** A ESADI, no mesmo conector e no mesmo Redis, estava em 361.
Um agendamento sem data dispara no horário e não tem o que entregar ao
worker. E o sync não o consertava: ele só comparava o pattern, que estava
certo — então o job quebrado era preservado indefinidamente.
A causa, no código: queue.add(nome, dados, { repeat, jobId }). jobId
customizado junto de repeat é a combinação que o BullMQ não suporta, porque
cada iteração precisa do próprio id. O agendamento nasce com o cron certo e sem
os dados. Está assim desde o commit original do scheduler; a ESADI escapou por
ter sido criada antes, com outra versão da biblioteca.
Conserto: upsertJobScheduler na criação (não aceita jobId, idempotente
por construção) e getJobSchedulers na leitura — getRepeatableJobs **não
devolve o payload**, que era justamente o que faltava, e sai na v6.
precisaRecriar ficou como função pura testada e derruba agendamento sem
payload mesmo com o cron certo.
Nenhuma tela acusou nada por dez dias, porque "o agendamento existe" era
verdade. A matriz de automações também não: ela lê execuções com SUCCESS, e
as execuções manuais tinham sucesso. Verde por um caminho que o cliente não
usa — o mesmo erro de leitura já registrado em "o verde de FETCH_PAYMENT é
de outro cliente".
- ☐Varrer os outros canais:
clinipam-savi,unimed-blumenauda Indalab e
unimed-brusque da T.W.A foram criados depois e podem ter o mesmo
defeito. O conserto os recria sozinho na próxima sincronização, mas vale
conferir iterationCount em cada um.
2. O XLSX entra como ANÁLISE, e leva o código da operadora junto
Ele é o mesmo documento que o XML daquele processo — medido item a item. Como
DEMONSTRATIVO_PAGAMENTO ele criava um registro paralelo e o mesmo dinheiro
passava a existir em duas tabelas. Como DEMONSTRATIVO_ANALISE vai pelo
distributeAnaliseReturn, que compõe, e leva o 392 para
Glosa.codigoOperadora.
O conector passa a salvá-lo como DemonstrativoAnaliseConta-{processo}.xlsx:
o nome diz o que o arquivo é, não como o portal o chama.
E ele NÃO substitui o XML — medido antes de decidir:
processo 2660533625 (só em /v2/suspensions) | |
|---|---|
| XML | 274.696 bytes |
| XLSX | 0 bytes |
A geração do XLSX exige o findId, e /v2/suspensions não o devolve. Para
processo histórico o XLSX é inalcançável. Os dois formatos continuam sendo
coletados.
3. Os três demonstrativos sem origem vieram do FETCH_RETURNS
Criados em 27/10/2026 às 13:20:10–12, com tissTransactionId nulo — um
minuto depois do FETCH_RETURNS manual das 13:19:19 do mesmo dia. Vêm do
CSV que aquela operação sintetiza de guide-items, que entra pelo
analise-return-distributor sem transação TISS.
A hipótese anterior caiu: não são os XLSX coletados em 31/10 — eles são
quatro dias mais velhos que o primeiro XLSX.
Fica a consequência: FETCH_RETURNS produz análise de profundidade B (item
sem motivo de glosa) para o mesmo processo que FETCH_ANALYSIS traz em
profundidade A. Os dois caminhos continuam ativos no mesmo conector.
- ☐Decidir se
FETCH_RETURNSainda deve rodar nesta operadora. Ele existia
quando o XML não chegava ao domínio; agora chega, e com motivo de glosa.
O id de /v2/suspensions é o processPortalId
Medido no processo 2660533625:
DemonstrativoPagamento-2660533625-4542650.xml → 200, 274.696 bytes ← id de suspensions
DemonstrativoPagamento-2660533625-0.xml → 200, 0 bytes ← o que o código tentava
O mapa de /v6/medical-files/search não ajuda aqui: processo que só aparece em
suspensions, por definição, não está naquela listagem. Era por isso que
processo histórico nunca entrava — o conector tinha o número, o arquivo existia
do outro lado, e ele pedia pelo nome errado.
viewPaymentStatement declara se o demonstrativo existe
/v6/medical-files/search traz viewGuidesReport e viewPaymentStatement por
processo. Medido: false no processo "Em análise", true nos concluídos.
O conector não precisou do campo — ele raspa a tela, e o link
/statement-payment/ só aparece quando a flag é verdadeira, então o filtro por
statementUuid já cobre o caso. **Fica registrado para quando a listagem vier
da API em vez da tela**, que é o caminho mais estável.
O conserto do agendamento deixou órfãos, e removeJobScheduler não os pega
Depois do deploy, cada nome aparecia duas vezes no Redis: um agendamento
novo com payload e um antigo sem.
removeJobScheduler(nome) usa o id da API de Job Schedulers — que é o nome que
se passa ao upsertJobScheduler. O agendamento legado foi criado por
queue.add(nome, dados, { repeat }), e ali a chave é derivada (hash de
nome + pattern + tz), não o nome. Então a remoção não casava com nada e o
antigo sobrevivia.
Os cinco órfãos (quatro da Indalab na Clinipam, um do scsaude-credencia)
foram removidos à mão, por removeRepeatableByKey(key), com a key vinda de
getRepeatableJobs() — a API deprecada é a única que ainda a devolve.
Estado final: 16 agendamentos, todos com payload, zero sem.
Não virou código de migração de propósito. A criação nova não produz órfãos,
então seria código permanente para um caso que não volta. O que fica é esta
nota: **se um dia aparecer agendamento duplicado por nome, a remoção tem de
ser pela key da API antiga.**
A auditoria que o conserto permitiu
Contar data e ic em todos os agendamentos encontrou um segundo cliente
afetado, que não estava no radar de ninguém:
| iterações | estado | agendamento |
|---|---|---|
| 0 | sem payload | Indalab · clinipam-hapvida (4 operações) |
| 0 | sem payload | scsaude-credencia · FETCH_PAYMENT |
| 361 / 360 | ok | ESADI (clinipam, unimed-blumenau-soap) |
| 67 | ok | T.W.A · unimed-brusque |
| 40 / 9 | ok | Indalab · unimed-blumenau |
Vale repetir essa contagem depois de cadastrar conexão nova: iterationCount
zerado por mais de um ciclo do cron é agendamento que não dispara.
O XLSX entrou como análise — e o código da operadora chegou
Os nove arquivos foram re-triados (não reprocessados: o tipo e o leitor são
decididos na triagem, e retryProcess reusa os que já estão gravados).
glosas com codigoOperadora preenchido: antes 0 → depois 56
par medido: codigoGlosa 3202 · codigoOperadora 392
A primeira tentativa falhou, e o jeito como falhou importa. O conector
passou a salvar o XLSX como DemonstrativoAnaliseConta-{n}.xlsx, e a
execução voltouSUCCESScomtotalNew: 0— não baixou nada. O XLSX desta
operadora é determinístico: hash idêntico a cada geração (a1d6feda… no
arquivo de manhã e no que já estava no inbox), ao contrário do XML, que traz
sequencialTransacaoedataRegistroTransacaonovos. O arquivo renomeado
era pulado pela dedup por hash, e os nove já gravados nunca seriam
reclassificados. A regra passou a mapear o nome do portal.
Mas 96% do dinheiro glosado tem código que não cruza com a ANS
Medido logo depois, e é o achado que sai daqui:
| glosas | valor | |
|---|---|---|
| código simples, cruza com a Tabela 38 | 27 | R$ 793,37 |
| código composto, NÃO cruza | 29 | R$ 19.149,80 |
O XLSX achata várias glosas do mesmo item numa linha, e as quatro colunas
de motivo viram listas paralelas separadas por vírgula:
Codigo ANS 1818, 1602, 3184
Cód. Motivo (operadora) 43, 109, 329
Descricao ANS COBRANCA DE PROCEDIMENTO QUE EXIGE AUTORIZACAO PREVIA, TIPO DE ATENDIM…
Motivos Glosa PROCEDIMENTO REALIZADO NECESSITA AUTORIZACAO, ESPECIALIDADE CONSULTA N…
O leitor guarda a string inteira como um código só. "1818, 1602, 3184" não
existe na Tabela 38, então motivoGlosaTussItemId fica nulo em 29 de 56 — e é
onde está quase todo o dinheiro.
O pareamento é posicional, e isso está PROVADO, não suposto. Dois registros
trazem os mesmos três códigos em ordens diferentes, e os pares se mantêm:
3210, 3142, 5035 ↔ 330, 96, 95
5035, 3142, 3210 ↔ 95, 96, 330
- ☐Separar os códigos por vírgula e criar uma glosa por posição. A descrição
não precisa ser separada junto: o distribuidor já enriquece pela Tabela
38 quando há código ANS, então o texto oficial vem de lá. **Cuidado com a
descrição mesmo assim** — ela é texto livre e pode conter vírgula, o que
quebraria a contagem; o código, sendo numérico, não tem esse risco.
- ☐Confirmar se o XML traz esses mesmos itens com várias
relacaoGlosa
separadas. No processo 2660851374 o máximo medido foi **1 glosa por
item** (239 itens com zero, 14 com uma), então a comparação precisa de um
processo da ESADI, onde os compostos aparecem.
31/10/2026 — o Savi NÃO imprime a guia, e o menu inteiro diz isso
PRINT_GUIDE → naoOferecidas, com medição.
O que foi varrido: os 19 destinos do menu, abertos um por um com a sessão da
Indalab (JANICE DEBARBA / 154866, CLINIPAM). O menu é hamburger e os grupos são
href="#"; expandindo todos, os destinos reais são:
Laudos Médicos → Pesquisar /pages/laudo/pesquisa_laudos.faces
Biometria → Elegibilidade /pages/biometria/elegibilidade.faces
Biometria → Escaneamento de Digital /pages/biometria/escaneamento.faces
Elegibilidade Beneficiário /pages/autorizacao/elegibilidade/elegibilidade_autorizacao.faces
Autorização → Consulta /pages/autorizacao/consulta/autorizacao_consulta.faces
Autorização → Procedimento /pages/autorizacao/procedimento/autorizacao_procedimento.faces
Autorização → Executar /pages/autorizacao/execucao/execucao_procedimento.faces
Autorização → Cancelar /pages/autorizacao/procedimento/cancelar_autorizacao.faces
Relatório → Produção /pages/relatorio/relatorio_producao.faces
Relatório → Pendências /pages/relatorio/relatorio_pendencia.faces
Relatório de Protocolo /pages/relatorio/relatorio_protocolo.faces
Relatório de Prorrogação Internação /pages/relatorio/relatorio_prorrogacao_internacao.faces
Relatório de Medicamento Alto Custo /pages/relatorio/relatorio_medicamento_alto_custo.faces
Relatório de OPME /pages/relatorio/relatorio_pendencia_opme.faces
Demonstrativo de Produção /pages/encerramento/encerramento.faces
Honorários /pages/honorarios/honorario_pesquisa.faces
Solicitações Internação/PQA /pages/autorizacao/solicitacao/solicitacao.faces
Ativação de Internação / Cirurgia /pages/ativasenha/ativacaoSenha.faces
Mensagens pendentes /pages/solicitacao/pendentes.faces
(Três destinos a mais que o mapa de 21/10: os relatórios de Prorrogação de
Internação, de Medicamento de Alto Custo e de OPME, e a tela de mensagens.)
Os dois "Imprimir" do portal imprimem a LISTAGEM
Existem, e são só estes dois: nos relatórios de Produção e de
Pendências, como <a class="btn btn-small btn-warning">Imprimir</a> com
mojarra.jsfcljs(...,'_blank'). Clicado, baixa relatorio_producao.faces —
60.255 bytes de PDF cujo conteúdo é:
Relatório de Produção
Prestador CNPJ: 81.007.866/0001-26 Nome: LABORATORIO … INDALAB LTDA
Período: 1/10/2026 à 31/10/2026 Serviço: EXAMES Rede: CURITIBA E REGIAO63
Data Execução | Usuário | Médico Solicitante/Executante | Procedimento | …
É a listagem de produção do mês, não a guia de um pedido. Imprimir relatório não
é imprimir guia.
A tela de Execução mostra a guia inteira e não imprime
Pesquisando a senha AR1101045 em execucao_procedimento.faces, a tela abre
com usuário (0E3IW000002003 - FABIO PINTO HOFFMANN), tempo de plano,
prestador, procedimento (40301605 - COLESTEROL TOTAL), sessões autorizadas e
realizadas — tudo o que uma guia tem — e nenhum controle de impressão. O
único PDF da página é o link "Manual Savi" no rodapé (11 MB, manual do portal).
"Autorização → Consulta" NÃO consulta autorização
Armadilha de nome, medida: a tela é "Autorização de Consultas" — autorizar
uma *consulta médica*, com Queixa e Especialidade obrigatórios. Não é consulta
de autorização existente. O mapa de menu de 21/10 escrevia "Autorização →
Consulta" e eu li como tela de consulta; perdi uma passada nisso. **O Savi não
tem tela de consulta de guia emitida** — o que existe são os relatórios.
Armadilha de sonda, não do portal
fecharModais chama $('.modal').modal('hide'), e a **home não carrega o
plugin modal do Bootstrap** — window.jQuery(...).modal is not a function
derrubou a primeira varredura antes do primeiro clique. Em tela de inventário,
fechar modal é higiene: .catch(() => undefined).
E: nunca clicar em tudo que tem href="#" para expandir menu. "Sair" é um
deles, e a segunda passada desta sonda deslogou a si mesma no meio da
varredura.