Ogmma Revenue
Voltar para a matriz

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

PrazoQuantoConta a partir deFonte
Envio do lotenão medido——
Pagamentonão medido——
Recurso de glosanão medido——
O valor operável fica em HealthPlan (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ênciaProtocolosTempo
2024-0674185s
2024-1262164s
2025-0593218s
2025-0989~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/20262026-08-022.192
25/08/20262026-08-251.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:

CamadaUseNão use
Análiseprotocolos_analise_conta.dataProtocolodemonstrativos_analise_conta.dataEmissao
Pagamentopagamento_por_data.dataPagamentodemonstrativos_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:

ProtocoloData protocoloCréditoLiberado
1792402025-012025-02-17R$ 17,83
2013722025-122026-01-15R$ 5,32
2146082026-062026-07-15R$ 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.

  • •fetchReturns ignora filters.categories. Pedir só analise pelo

/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.

ItemFunção
item_0Página inicial
item_1Documentos TISS
item_2 → subItem_2_1Upload de contas médicas (XML) → pls_montarTelaConsultaTISS.action
item_2 → subItem_2_2Demonstrativo de retorno
item_3 → subItem_3_1Visualizar comunicados
item_4Alterar senha
item_5Termo de uso / Aviso de privacidade
item_6Configurações
item_7Logoff

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çãoResultadoDuração
VALIDATE_CREDSSUCCESS36s
FETCH_PAYMENTSUCCESS — 0 novos54s
FETCH_ANALYSISSUCCESS — 1 novo (prot222332), 0 duplicado67s
FETCH_RETURNSSUCCESS — primeira execução em produção, as duas metades100s

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.

Esta página é gerada de docs/operacoes-conectores/notas/unimed-brusque.md no repositório. Para corrigir ou acrescentar, edite o markdown — não a página.