Unimed Brusque — notas e observações
Conector: unimed-brusque (RPA)
Registro ANS: 348244
Portal: https://operadora.unimedbrusque.com.br/PlanodeSaude
Última revisão: 2026-10-21
Prazos contratuais
| Prazo | Quanto | Conta a partir de | Fonte |
|---|---|---|---|
| Envio do lote | não medido | — | — |
| Pagamento | não medido | — | — |
| Recurso de glosa | não medido | — | — |
O valor operável fica emHealthPlan(submissionDeadlineDays,
paymentDeadlineDays,appealDeadlineDays), que é de onde o Monitoramento
calcula vencimento. Enquanto estiver "não medido" aqui, o cadastro está no
default de 30 dias — convenção, não declaração.
O portal guarda análise antiga — pelo menos até 2024-06
Este é o fato que mais mudou o que dá para fazer com a operadora, e ele estava
sendo assumido ao contrário.
Depois da primeira varredura (02/08/2026), a base só tinha demonstrativo de
análise a partir de protocolos de 2026-01, contra pagamento desde
2024-09. A leitura fácil era "o portal não retém análise antiga". Está errado.
Medido em 25/08/2026: uma execução FETCH_ANALYSIS por competência, de
2024-06 a 2026-09, trouxe 1.529 protocolos novos, todos com XML TISS
DEMONSTRATIVO_ANALISE_CONTA válido. 22 execuções, 22 SUCCESS, zero falha.
| Competência | Protocolos | Tempo |
|---|---|---|
| 2024-06 | 74 | 185s |
| 2024-12 | 62 | 164s |
| 2025-05 | 93 | 218s |
| 2025-09 | 89 | ~190s |
| 2026-08 (parcial) | 25 | — |
| 2026-09 (futuro) | 0 | — |
O que faltava não era retenção do portal: era janela de consulta. A
varredura de 02/08 usou intervalos largos e arbitrários e morreu no prazo antes
de descer o histórico (ver abaixo).
O filtro é por DATA DE PROTOCOLO, não por competência
A tela usa #dtInicio/#dtFinal, e o grid tem uma coluna "Mês comp" separada.
São coisas diferentes: pedir a competência 2025-06 devolveu 65 protocolos
datados de 2025-06 e 5 de 2025-07. O transbordo é inofensivo — dedup por
protocolo resolve — mas **não confie na competência do arquivo para montar
série temporal**; use protocolos_analise_conta.dataProtocolo.
A análise antecede o pagamento em cerca de um mês: protocolo analisado no mês M
é creditado em M+1. Uma lacuna em "pagamentos de 2026-01 sem análise" significa
que falta a análise de 2025-12.
Por que a varredura noturna morria — e a base ficou 23 dias parada
fetch-analysis e fetch-payment baixavam tudo o que a listagem mostrasse,
toda vez, ignorando options.existingFileNames.
A varredura automática roda sem referenceId. Sem ele, periodoPadrao devolve
os últimos 12 meses — que neste prestador são ~1.000 protocolos. Os 600s de
OPERATION_TIMEOUTS.FETCH_ANALYSIS estouram muito antes.
O resultado em 02/08/2026: três FETCH_ANALYSIS seguidos com `Timeout apos
600s, consecutiveFailures = 1, autoSyncEnabled` desligado — e a base do
LabVW parada de 02/08 a 25/08 sem ninguém perceber.
Corrigido em 25/08/2026: os dois fetch pulam antes de baixar, comparando
o nome do arquivo com existingFileNames. O nome mora em nomeArquivoAnalise
/ nomeArquivoPagamento (utils.ts), numa função só, porque o modo de falhar
é silencioso: se quem grava e quem compara divergirem, o pulo deixa de casar, a
varredura volta a baixar tudo, estoura o prazo, e **nenhum erro aponta para a
causa**. pular-ja-coletado.test.ts fixa o formato contra amostra real do banco.
Antes de ligar autoSyncEnabled em qualquer prestador desta operadora,
confirme que este pulo está no ar. Sem ele, o cron é uma máquina de timeout.
dataEmissao é o dia do DOWNLOAD, não do documento
O portal renderiza o demonstrativo no momento em que a gente baixa. O XML então
declara como emissão o dia da coleta.
Medido em 25/08/2026: 3.721 arquivos, correlação perfeita, zero exceção.
| Baixado em | <ans:dataEmissao> | Arquivos |
|---|---|---|
| 02/08/2026 | 2026-08-02 | 2.192 |
| 25/08/2026 | 2026-08-25 | 1.529 |
Não é defeito do parser — é o que o documento diz. E o efeito de recortar por
ela é silencioso: o número aparece, não dá erro, e está errado. Depois do
backfill de dois anos, o BI de glosas mostrava `glosadoMTD == glosadoYTD ==
R$ 122.424,73`, com a evolução de 12 meses reduzida a uma barra no mês da
importação.
As datas de negócio são:
| Camada | Use | Não use |
|---|---|---|
| Análise | protocolos_analise_conta.dataProtocolo | demonstrativos_analise_conta.dataEmissao |
| Pagamento | pagamento_por_data.dataPagamento | demonstrativos_pagamento.dataEmissao |
Corrigido em 25/08/2026 no BI de glosas, na listagem de pagamentos (filtro de
período e ordenação) e em guias-unificadas (emitidoEm, e o pagoEm que
usava a emissão como reserva e inventava crédito no futuro).
apps/api/src/modules/bi/eixo-de-tempo.test.ts trava a escolha de coluna.
Existe protocolo pago que o portal nunca analisa
Depois de varrer 2024-06 → 2026-09, sobraram 3 protocolos com pagamento e
sem nenhuma análise correspondente:
| Protocolo | Data protocolo | Crédito | Liberado |
|---|---|---|---|
| 179240 | 2025-01 | 2025-02-17 | R$ 17,83 |
| 201372 | 2025-12 | 2026-01-15 | R$ 5,32 |
| 214608 | 2026-06 | 2026-07-15 | R$ 32,86 |
R$ 56,01 no total — 0,003% do liberado. As três competências de protocolo
foram varridas; a tela de análise simplesmente não lista esses protocolos.
São valores de ajuste, não lotes de produção.
Não trate isso como lacuna de coleta. Nenhuma varredura vai trazê-los, pelo
mesmo motivo que "sem envio" não é atraso de conector: o documento não existe
do lado da operadora.
O lock de sessão exclusiva tem uma corrida
markRunning checa findRunningExclusiveByConfig e só depois grava RUNNING.
Não é atômico, e o fetch.worker roda com concurrency: 2.
Observado em 25/08/2026: as execuções de 2024-08 e 2024-09 começaram no
mesmo segundo (15:33:18.256 e 15:33:18.245), as duas RUNNING na mesma
config. Desta vez as duas passaram — mas o portal da Unimed **derruba a sessão
anterior quando o mesmo prestador loga de novo**, e o RPA faz login próprio a
cada metade. É falha intermitente esperando acontecer, e quando acontecer vai
parecer instabilidade do portal.
Ainda não corrigido. O conserto provável é tornar a transição condicional no
próprio UPDATE (WHERE status = 'QUEUED' mais um lock de config), em vez de
ler-e-depois-gravar.
totalDebitosPorData se repete em cada demonstrativo da mesma data
O débito é do crédito, não do documento — mas o XML o repete em todo
demonstrativo daquela data de pagamento. Em 15/07/2026 o valor 6.313,66 aparece
idêntico em todos.
Somar liquidoPorData ou valorLiquido entre demonstrativos dá −9,8 milhões
numa base cujo liberado real é R$ 1,8 milhão.
Para fechar o líquido, conte o débito uma vez por dataPagamento, nunca por
demonstrativo. O valorLiberadoGuia das guias não tem esse problema e é a base
segura para faturamento.
Miscelânea medida
- •O ZIP não deduplica por hash. O portal reempacota a cada download, então
o mesmo protocolo baixado duas vezes gera dois hashes diferentes — em
portal_return_files e em inbox_files. Na base de 02/08 isso deu 5.406
arquivos para 1.824 protocolos. O que salva é a dedup por protocolo lá na
frente: 2.316 documentos únicos viraram exatamente 1.768 DemonstrativoPagamento
+ 548 DemonstrativoAnaliseConta. A dedup que vale é a do protocolo.
- •A conciliação é dirigida pelo DAC. Todos os entry points de
ConciliacaoEngineService começam em demonstrativoAnaliseConta.findMany; o
pagamento entra por lookup da chave. Guia que só tem pagamento nunca
aparece na conciliação. É por isso que trazer a análise que faltava levou o
LabVW de 4.520 para ~15.000 guias conciliadas sem tocar em mais nada.
- •
fetchReturnsignorafilters.categories. Pedir sóanalisepelo
/import-inbox/sync-portal varre as duas metades assim mesmo. Para uma
metade só, use FETCH_ANALYSIS/FETCH_PAYMENT direto — o scheduler já faz
isso sozinho, porque descarta FETCH_RETURNS quando o conector declara as
granulares.
- •Envio não existe aqui. Como em toda operadora, o portal devolve
julgamento e não guarda o que o prestador mandou. As 4.520 guias originais do
LabVW estavam 100% conciliadoSemEnvio.
O menu é por PERMISSÃO — e o que medimos é o que este login vê
Remedido em 21/10/2026 com a credencial real do prestador, porque a
afirmação de 02/08 ("não há tela de X no menu") estava sendo repetida como se
fosse fato sobre a operadora.
O menu é idêntico ao de agosto: 8 itens de primeiro nível, 13 entradas
clicáveis. Busca no HTML do frame menuLateral por elegib, autoriza,
cancel, guia e solicita devolve zero ocorrência.
| Item | Função |
|---|---|
item_0 | Página inicial |
item_1 | Documentos TISS |
item_2 → subItem_2_1 | Upload de contas médicas (XML) → pls_montarTelaConsultaTISS.action |
item_2 → subItem_2_2 | Demonstrativo de retorno |
item_3 → subItem_3_1 | Visualizar comunicados |
item_4 | Alterar senha |
item_5 | Termo de uso / Aviso de privacidade |
item_6 | Configurações |
item_7 | Logoff |
O achado que muda a conclusão: o menu é montado por permissão. O mapa
menuItemId carrega só 4 chaves (inicial, P_CONTAS_MEDICAS,
P_COMUNICADOS, logoff), e carregarParametrosFuncao usa só dois ids de
função: 1249 (contas médicas) e 1331 (comunicados).
Ou seja: o que foi medido é o que esta credencial tem permissão de ver, não
o catálogo do portal. Não dá para concluir daqui que a Unimed Brusque não
oferece elegibilidade ou autorização — dá para concluir que o módulo não está
habilitado para este prestador. A distinção importa porque o desbloqueio pode
ser um pedido à operadora, não código nosso.
E o caminho provável não é o portal. Na Unimed Blumenau, que roda o MESMO
produto, elegibilidade, solicitação, consulta e cancelamento de autorização
estão todos no webservice (unimed-blumenau-soap), não no RPA do portal —
o RPA de lá só faz CHECK_AUTH_STATUS. Se a Brusque expõe o webservice TISS
padrão ANS, é por ali que essas operações entram, e o portal segue sendo só
retorno. Medir isso exige endpoint e credencial de webservice, que o prestador
precisa pedir à operadora.
As 4 operações declaradas, verificadas em produção
Rodadas em 21/10/2026, uma por vez, janela 2026-10-01..2026-10-21:
| Operação | Resultado | Duração |
|---|---|---|
VALIDATE_CREDS | SUCCESS | 36s |
FETCH_PAYMENT | SUCCESS — 0 novos | 54s |
FETCH_ANALYSIS | SUCCESS — 1 novo (prot222332), 0 duplicado | 67s |
FETCH_RETURNS | SUCCESS — primeira execução em produção, as duas metades | 100s |
O FETCH_RETURNS nunca havia rodado nesta conexão: o scheduler descarta a
composição quando o conector declara as granulares (ver "Miscelânea medida").
Rodou sob demanda e as duas metades vieram na mesma sessão, sem o
net::ERR_ABORTED que a execução em paralelo produzia.
O pulo do já-coletado funcionou: totalDuplicated: 0 com a base já varrida no
mesmo dia às 06:00/06:15. Como o ZIP não deduplica por hash, isso é o que
impede o reempacotamento de virar arquivo novo.
O que ainda precisa ser checado
- ☐
SUBMIT_BATCH— a tela existe (Contas médicas → Upload de contas médicas
XML, pls_montarTelaConsultaTISS.action) e não foi escrita. É escrita em
produção da operadora; precisa de combinação com o prestador antes de
testar.
- ☐Perguntar à operadora se há webservice TISS e se os módulos de
elegibilidade/autorização podem ser habilitados para este prestador. Hoje
a credencial só tem permissão para contas médicas e comunicados — as
quatro operações "não mapeadas" podem ser permissão, não ausência.
- ☐Medir até onde o histórico de análise realmente vai. 2024-06 foi o limite
do pedido, não do portal — voltou 74 protocolos, então tem mais atrás.
- ☐
FETCH_PAYMENT_SCHEDULE— o grid traz data de vencimento por lote. Nunca
foi avaliado como previsão de crédito, e o naoSuportadas diz isso.
31/10/2026 — não há módulo de autorização, logo não há guia para imprimir
PRINT_GUIDE → naoOferecidas, com medição.
O menu lateral inteiro (frame menuLateral, pls_menuEsquerdo.jsp), com a
credencial do LabVW:
Página inicial pls_montarDadosPrestador.action
Documentos TISS pls_montarDocumentacao.action
Contas médicas
» Upload de contas médicas (XML)
» Demonstrativo de retorno pls_montarTelaDemonstrativoPagamentoNovaTela.action
Comunicados
» Visualizar comunicados
Alterar senha pls_alterarSenha.jsp
Privacidade e segurança
» Termo de uso e privacidade
» Aviso de privacidade
Configurações
Logoff
Treze itens, nenhum de autorização, senha ou guia. Não é que a impressão esteja
escondida: a autorização não está aqui. Este portal, para este login, é
envio de conta e demonstrativo.
Isso confirma o que a seção "O menu é por PERMISSÃO" já dizia, agora com a
pergunta da impressão: o que foi varrido é o menu DESTA credencial. No Savi o
menu muda com o prestador (notas/hapvida.md, 22/10/2026), e credencial de outro
perfil pode ver mais. Se um dia a Unimed Brusque liberar autorização para este
login, a pergunta da impressão volta a zero.