GEAP — notas e observações
Portal: sisgeap.geap.com.br/portalprestador/ · ANS 323080 (GEAP Autogestão em Saúde, CNPJ 03.658.432/0001-82)
Conector RPA: geap-portal (desde 31/10/2026) — login OIDC no navegador, operações pela
API REST do portal. ImplementaVALIDATE_CREDS,FETCH_ANALYSIS,FETCH_PAYMENTe
FETCH_RETURNS (as duas metades num login só).
Medido em 31/10/2026 no prestador SOLIM LABORATORIOS (Aracaju/SE), código GEAP
22006869, com credencial do cliente. Só o login e o inventário de telas foram
medidos — nada foi exercitado além de entrar.
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 da GEAP. O portal tem
Comunicados e Manuais no menu, que é onde procurar primeiro.
O login é OIDC, não um formulário do portal
sisgeap.geap.com.br/portalprestador/ redireciona para
login.geap.com.br/account/signin, um IdentityServer com **Authorization Code +
PKCE** (code_challenge_method=S256), client_id=geap.portal.internet.prestador,
redirect_uri=.../portalprestador/login-callback, e scopes nomeados por número
(openid profile 1064_S 1064_I 1064_U 1064_D 37_E 16_E).
Consequências para quem for escrever o conector:
- •Dois campos, rotulados "Código Geap ou CPF" e "Senha". O campo aceita as duas
coisas; a credencial da Solim é um CPF (11 dígitos), não o código do prestador.
Ou seja: o login não é o 22006869 que o portal mostra no cabeçalho depois de
entrar — esse é o código do prestador, outro dado.
- •O botão Entrar nasce
disablede só habilita depois que os dois campos têm
conteúdo. RPA que clicar antes de preencher clica em nada e não recebe erro.
- •A volta é
.../login-callback?code=…&state=…&session_state=…. Há, portanto, a
possibilidade de falar com a API por token em vez de tela — não medido, mas é
o caminho que o próprio portal usa, e o menu lateral tem um item Webservice.
- •Quem logou cai numa SPA (Angular Material, ícones
material-iconscomo texto).
O cabeçalho traz SOLIM LABORATORIOS - 22006869: é daí que se confere quem o
portal diz que somos.
O que o portal oferece (inventário do menu, nada exercitado)
| Área | Itens |
|---|---|
| Faturamento TISS | Portal TISS (upload de XML), Portal TISS - Recurso, Geração de Remessa - Guias Digitadas SISGEAP |
| Retorno / acompanhamento | Relatório de Guias, Relatório de Remessas, Relatório Recurso de Glosa, Acompanhamento de Guias, Auditoria Digital |
| Financeiro | Extrato Financeiro, Nota Fiscal |
| Cadastro | Cadastro Prestador, Atualização Cadastral, Ficha Cadastral |
| Paciente | Consultar Beneficiário |
| Outros | TUSS, Exame Ocupacional, Programas Assistenciais, SAP (atendimento ao prestador), Webservice |
Nada disso está medido: é a lista de rótulos do menu, e rótulo não é operação.
"Relatório de Remessas" pode ser o desfecho do envio ou só um extrato de
protocolos — achar o protocolo não é saber o desfecho — medir antes de assumir.
Onde cada documento mora de verdade (navegado em 15/11/2026)
O inventário acima é rótulo de menu. Dois deles foram abertos e o que está
dentro é isto:
| Documento | Item do menu | Dentro da tela |
|---|---|---|
| Análise de conta (item a item) | Relatório de Guias | tela "Relatório de Guias Quitadas" |
| Pagamento (fecha o mês) | Financeiro → Extrato Financeiro | /portalprestador/ExtratoFinanceiro |
NÃO é "Acompanhamento de Guias", e o nome do endpoint engana. O relatório é
pedido por AcompanhamentoGuias/RelatorioGuiasQuitadasExcel, o que leva direto
para o item de menu errado: "Acompanhamento de Guias" é uma consulta por
Nº do Lote / Nº do Documento / Situação, com botão PESQUISAR, e não gera
relatório nenhum. Custou duas afirmações erradas antes de alguém abrir a tela.
Filtros do "Relatório de Guias Quitadas", na ordem da tela:
Guias Quitadas · Glosadas (vem "NÃO" por padrão) · Ano de Quitação ·
Mês de Quitação · Guia do Contratado · Protocolo · N° do Envio ·
Ano Entrega · Mês Entrega · Cliente
Botões: GERAR RELATÓRIO EXCEL, GERAR RELATÓRIO XML, LIMPAR FILTROS.
O XML nunca foi medido — não se sabe se traz o mesmo conteúdo do xlsx.
A FILA ESTÁ NA PRÓPRIA TELA, logo abaixo dos filtros: colunas
Nome Relatório | Status | Início Processamento | Fim Processamento | Ações,
com botão ATUALIZAR LISTA. Abrir a tela já dispara ContratadoAnexo/list.
Não é preciso ir a outro lugar buscar o arquivo, e a nota anterior afirmava o
contrário.
O aviso de espera é da própria GEAP, escrito na tela: *"Os arquivos podem durar
cerca de 20 minutos para serem gerados. Por favor aguarde!"*
MAS NA PRÁTICA NÃO DEMORA ISSO — quem usa o portal todo dia corrigiu em
15/11/2026: basta clicar em ATUALIZAR LISTA e o resultado já aparece. Os 20
minutos são o teto que a GEAP se dá, não o tempo típico. Duas consequências:
- •os 10 minutos de
ESPERA_MAXIMA_MSdo conector são folga, não aperto — não
há motivo para aumentá-los só por causa do aviso da tela;
- •a fila não se atualiza sozinha. O
ContratadoAnexo/listé pedido no
clique, não em polling do portal: quem fica olhando a tela sem clicar em
ATUALIZAR LISTA vê "Nenhum registro" para sempre e conclui que falhou.
E o pedido vazio aparece na fila com o nome Nenhum registro encontrado. e
status Finalizado. Mais uma forma da mesma mentira já documentada: "Finalizado"
não quer dizer "tem dado".
Duas coisas que o portal avisou sozinho
- •Capa de Lote mudou em 02/10/2026. Comunicado em modal no login: depois do
upload do XML, a Capa de Lote passa a refletir o *status de processamento*, e
aparece "Em processamento" enquanto as críticas rodam. O resultado se consulta
em Portal TISS → TISS → 2ª Via Recibo de Entrega. Isto é exatamente a
separação entre transmissão e processamento:
o upload responder não quer dizer que o lote foi aceito.
- •Recibo de Entrega de Arquivo mudou a partir da competência 09/2026 — outro
comunicado, conteúdo não lido por inteiro.
A SPA fala com uma API REST própria
Medido em 31/10/2026: a tela não raspa HTML de servidor — ela chama
https://apicore.geap.com.br/portalprestador/v1/... com o **Bearer do
IdentityServer** no header, e o token fica em
sessionStorage['oidc.user:https://login.geap.com.br:geap.portal.internet.prestador'].
Endpoints vistos: Autenticacao/AutenticacaoPortal, Pesquisa/PrestadorPesquisa,
PrestadorFichaCadastral/*, Ajuda/ComunicadosPortalPrestador,
ExtratoFinanceiro/ExtratoFinanceiroDemonstrativo,
AcompanhamentoGuias/RelatorioGuiasQuitadasExcel, ContratadoAnexo/list.
Todos recebem nroContratado=22006869.
Um conector aqui deve falar REST, não clicar. Os ids dos inputs da SPA são
gerados por render (f_<uuid>), então seletor por id não sobrevive a recarga —
o que resta na tela é aria-label.
Extrato financeiro: histórico muito mais longo do que a tela admite
GET ExtratoFinanceiro/ExtratoFinanceiroDemonstrativo?nroContratado=&mes=&ano=
devolve 16 linhas: Valor Bruto Prestação Serviço, Acertos de Faturamento (D e
C), Valor Base Cálculo, IRRF, ISS, INSS Retido, CSLL, COFINS, PIS, Pensão
Alimentícia, Valor Líquido, Acertos a Débito, Acertos a Crédito, Valor
Creditado, Incide Base IR.
O seletor de ano da tela oferece 2019 a 2026. A API não respeita esse
limite: medido mês de junho ano a ano, veio dado real de **2000, 2010, 2012,
2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023, 2024** e 2026 —
uma série coerente com o crescimento do laboratório (R$ 2.297 em 2000,
R$ 31.786 em 2021, R$ 355.989 em set/2026). Então **o histórico financeiro da
GEAP alcança no mínimo 2000**, e quem se limitar ao combo da tela perde 19 anos.
Mas a API nunca diz "não existe". Todo pedido responde HTTP 200,
code: 77700, "Operação realizada com sucesso" — inclusive ano=1950,
ano=2030, mes=13, que voltam as 16 linhas zeradas. Período sem
movimento é indistinguível de período inválido: ambos são zero. out/2026
também veio zerado no dia 31/10, porque o crédito do mês ainda não tinha saído.
Zero aqui é "não sei", não "não recebeu".
Relatório de guias: assíncrono, e o parâmetro de período TEM DOIS NOMES
O relatório por guia (que é o que mais se aproxima de análise de conta: traz
quitação e glosa) não responde na hora. RelatorioGuiasQuitadasExcel só
ENFILEIRA: a tela avisa "os arquivos podem durar cerca de 20 minutos", e o
resultado aparece em ContratadoAnexo/list, com nmeProcessamento
(Processando → Finalizado) e o desFiltro que o gerou. Um conector precisa
pedir, soltar, e voltar depois — o waitingUntil de PortalExecution serve.
Na conta da Solim essa fila já tinha 86 itens do próprio cliente.
A armadilha, medida isolando uma variável por envio:
| Parâmetros | Resultado |
|---|---|
mes:6;ano:2021;somenteGlosadas:2 | relatorio_guia_quitada840986.xlsx — COM dados |
mes:6;ano:2021;somenteGlosadas:0 | relatorio_guia_quitada840998.xlsx — COM dados |
mesRef:6;anoRef:2021;somenteGlosadas:0 | .xml — "Nenhum registro encontrado" |
mesRef:6;anoRef:2021;somenteGlosadas:2 | .xml — "Nenhum registro encontrado" |
Mesmo mês, mesmo prestador, mesmo tpoRelatorio. A variável que decide é o
nome do parâmetro de período: mes/ano traz o dado, mesRef/anoRef
volta vazio. E mesRef/anoRef é o que o botão "Gerar Relatório Excel" da
própria tela envia — foi o primeiro pedido que fiz, por ela, e voltou vazio.
somenteGlosadas foi descartado como causa: 0 e 2 trazem dado com mes/ano.
Ou seja: vazio nesta tela não é ausência de dado na GEAP. Há guia de
junho/2021 — o histórico por guia alcança pelo menos 2021. Quem medir pela tela
conclui o contrário.
Primeira varredura em produção (01/11/2026)
Conector ligado no prestador SOLIM, competência 09/2026, pelo worker de
produção:
| Operação | Desfecho | Tempo | O que trouxe |
|---|---|---|---|
| VALIDATE_CREDS | SUCCESS | 32s | login OIDC |
| FETCH_ANALYSIS | SUCCESS | ~200s | 16.397 itens, 1.231 guias, 38 protocolos, 418 glosas de item |
| FETCH_PAYMENT | SUCCESS | 24s | extrato de 09/2026 com as seis retenções |
Os números do relatório importado são idênticos aos medidos no xlsx baixado
à mão (R$ 427.793,31 apresentados, R$ 396.243,95 calculados, R$ 31.549,36
glosados), e as 418 glosas entraram com vínculo até o item.
O relógio é o limite, não o alcance. Um mês custou 219 segundos, porque o
relatório entra numa fila da operadora antes de existir. Com os 10 minutos de
OPERATION_TIMEOUTS, o initialSync pega 3 meses; histórico maior se pede mês
a mês. O primeiro FETCH_RETURNS falhou pela metade do pagamento por outro
motivo, já corrigido: a sessão do IdentityServer sobrevive ao nosso logout, o
portal volta direto para a área logada e o segundo login esperava um formulário
que não aparece.
As duas fontes medem recortes diferentes — e isso ainda não foi explicado
Para a mesma competência 09/2026:
| Fonte | Valor |
|---|---|
| Relatório de guias quitadas (apresentado) | R$ 427.793,31 |
| Extrato financeiro (valor bruto) | R$ 355.989,42 |
| Extrato financeiro (valor creditado) | R$ 316.296,61 |
Diferença de R$ 71.803,89 entre os dois "brutos". Não é erro de parsing: os
dois números vêm do que a operadora respondeu, e foram conferidos contra a tela.
A hipótese mais provável é que o filtro do relatório é **mês de quitação da
guia e o extrato é mês de competência financeira** — recortes que não
coincidem quando a baixa de uma guia cai num mês e o crédito em outro. Não
medido: ninguém comparou guia a guia entre as duas fontes ainda. Até alguém
fazer, não somar nem subtrair uma da outra.
A conciliação fecha no centavo (01/11/2026)
Rodado o motor de conciliação na Solim sobre a competência 09/2026:
1.231 guias criadas, e a classificação sozinha reproduz o xlsx:
| Situação | Guias | Informado | Liberado | Glosa |
|---|---|---|---|---|
| Conciliado automático | 1.017 | 339.596,58 | 339.596,58 | — |
| Glosa parcial | 110 | 61.266,02 | 56.647,37 | 4.618,65 |
| Glosa total | 104 | 26.930,71 | 0,00 | 26.930,71 |
| Soma | 1.231 | 427.793,31 | 396.243,95 | 31.549,36 |
Os três totais somam exatamente o que a operadora apresentou. É a primeira
operadora deste projeto em que a conciliação nasce completa a partir do
retorno — porque o relatório traz valor apresentado, valor calculado e glosa
por item, e não só o agregado da guia.
Todas as 1.231 entraram com conciliadoSemEnvio = true: a Solim não importou
lote de envio nenhum, então não há o outro lado para casar. O valor aqui é o
julgamento da operadora organizado, não a comparação com o que foi enviado.
O fetchReturns do conector não é o caminho que roda
Vale saber antes de otimizar a coisa errada. O fetchReturns da
GeapPortalConnector existe e diz, no comentário, que faz as duas metades com
um login só. Só que o executor nunca o chama: quando o conector tem
fetchAnalysis e fetchPayment, portal-executor.service.ts escolhe
rodar as duas metades separadas, de propósito, para que uma quebrada não
esconda a outra (é de lá que vem o resultSummary.metades que apareceu na
execução PARTIAL). Então cada metade entra pelo seu próprio
doLogin() — a economia que o comentário promete não acontece hoje.
Na prática isso ficou barato por causa do jaLogado(): a sessão do
IdentityServer sobrevive, o segundo doLogin() reconhece que já está dentro e
não refaz o OIDC. Antes dele, era justamente esse segundo login que estourava
esperando um formulário que não aparece.
O backfill de 2023 a 2026, e os quatro consertos que ele cobrou (01/11/2026)
Varridos 45 meses (01/2023 a 10/2026, pulando 09/2026 que já estava
importado). 45 execuções SUCCESS, nenhuma falha de conector — e ainda assim
seis arquivos de 45 não chegaram ao banco. Execução verde não é entrega; o que
mede entrega é o status do inbox.
| Meses com relatório de guias | 27 |
| Meses com extrato financeiro | 39 |
| Meses com planilha só de cabeçalho | 15 |
| Meses que estouraram a transação | 3 |
O que estava quebrado, em ordem de descoberta:
1. .xlsx não é prova de dado — 15 meses voltaram com planilha de 244
bytes. O conector mandava para o inbox, o handler não achava guia, o arquivo
morria em INBOX_ERRO_PROCESSAMENTO. Hoje temLinhaDeDado devolve null,
como no .xml sem nome.
2. A transação de 120s não cabia — as três MAIORES competências (11/2025,
05/2026, 07/2026) morreram em INBOX_ERRO_DISTRIBUICAO com "Transaction
already closed", enquanto 09/2026, menor, passava. A diferença era carga de
máquina.
3. A distribuição inseria linha por linha — era a causa de (2). Trocado por
createMany em lotes de 500. Depois do conserto, 07/2026 entrou com **2.729
guias e 39.264 itens**, que é 2,4× o maior mês já importado antes.
4. Erro de distribuição não tinha caminho de volta — retry-process
respondia NOT_RETRYABLE, porque a porta aceitava só
INBOX_ERRO_PROCESSAMENTO. O arquivo mais fácil de recuperar era o único
sem saída.
UMA LINHA POR MOTIVO, não por item — e a conferência que não conferia nada
O achado mais caro da varredura, porque inflava dinheiro e passou pela primeira
medição sem acusar.
A planilha repete o item inteiro uma vez por motivo de glosa. Medido no arquivo
de 04/2026, guia 2538769 — quatro linhas, duas delas itens de verdade:
| Linha | Nº Item | Nº Serviço | Qtd | Valor Informado Item | Valor Glosado Item | Justificativa |
|---|---|---|---|---|---|---|
| 1 | 1 | 40601269 | 1 | 32,19 | 32,19 | 1714 |
| 2 | 2 | 40601196 | 6 | 836,76 | 836,76 | 1423 |
| 3 | 2 | 40601196 | 6 | 836,76 | 836,76 | 1714 |
| 4 | 2 | 40601196 | 6 | 836,76 | 836,76 | 1807 |
As linhas 2, 3 e 4 são o MESMO item: mesmo sequencial, mesmo procedimento, mesma
quantidade, mesmo valor. Muda só o código da justificativa. E a própria planilha
declara, repetido em toda linha, que a guia apresentou R$ 868,95 — que é
32,19 + 836,76, o item contado UMA vez.
Criávamos um item por linha. Resultado na guia: R$ 2.542,47 de informado e de
glosa, numa guia de R$ 868,95.
Duas coisas tiveram de ser consertadas, não uma. Juntar as linhas num item
só arrumou o informado e não tocou na glosa, porque cada motivo ainda carregava
o valor cheio. A coluna "Valor Glosado Item" é o valor do ITEM, repetido em cada
linha de motivo: o dinheiro entra no primeiro motivo, e do segundo em diante a
linha acrescenta a razão, não o valor.
Efeito em 04/2026, o mês medido:
| antes | depois | |
|---|---|---|
| Itens | 19.259 | 19.203 |
| Informado | R$ 485.199,86 | R$ 478.548,21 |
| Glosa | R$ 115.774,42 | R$ 109.122,77 |
A diferença é a mesma nas duas linhas (R$ 6.651,65) porque os itens duplicados
eram integralmente glosados.
#### Depois do conserto: 26 dos 27 meses fecham com fonte independente
Medição de 01/11/2026, lendo os 27 arquivos direto do S3 e somando o que a GEAP
declara por guia (colunas Valor Informado e Valor Calculado da GUIA),
sem passar pelo nosso handler:
27 arquivos | 13.669 guias
informado declarado ......... R$ 4.725.233,10
calculado declarado ......... R$ 3.570.361,56
glosa declarada ............. R$ 1.154.871,54
Vinte e seis meses batem no centavo com o que está gravado. **Um não bate, e
não é bug nosso:** 07/2026 tem cabeçalho de documento R$ 1.202.234,14 contra
R$ 1.064.832,72 somados das guias. A diferença, R$ 137.401,42, vem inteira de
sete linhas sem número de guia do contratado — item sem guia identificada,
que o arquivo traz com o valor da guia em branco. Conferido: o arquivo de
07/2026 não tem UMA linha duplicada (39.264 chaves distintas em 39.264 linhas),
então o conserto do multi-motivo corretamente não mexeu nele.
Consequência para quem lê números da GEAP: a camada das guias é a confiável.
O valorInformadoGeral do demonstrativo é soma de itens e carrega o que não
tem guia. Em 07/2026 isso é 11% do mês.
#### A conferência tautológica — o jeito de não repetir este erro
A primeira medição deste conector declarou "os números batem com o xlsx baixado
à mão". Batiam, e não provavam nada: valorInformadoGeral e valorGlosaGeral
do demonstrativo são somados dos itens pelo próprio handler
(somar(todosItens...)). Comparar o total com a soma dos itens sempre fecha —
é a mesma conta duas vezes.
A conferência que vale usa fonte independente dentro do arquivo: as colunas
Valor Informado e Valor Calculado da GUIA, que a operadora preenche. A
glosa declarada é a diferença entre elas. Depois do conserto, em 04/2026:
glosa somada por nós, item a item ..... R$ 109.122,77
glosa declarada pelas guias ........... R$ 109.122,77
Centavo a centavo. Antes, a nossa soma estava R$ 6.651,65 acima do que a
operadora declara — e nenhum total interno acusava.
Para a próxima operadora: se o total do documento é calculado por nós, ele
não serve de prova. Procure no arquivo um número que a operadora tenha escrito e
que seja derivável do que você montou por outro caminho.
Um mês pode APAGAR outro: supersede por protocolo não serve aqui
Descoberto ao reler os 27 arquivos, e é o risco mais sério que a varredura
expôs.
apagarAnalisesSuperadas (superados.ts) apaga o demonstrativo anterior cujos
protocolos estão todos cobertos pelo documento novo. A premissa é que o mesmo
protocolo pertence ao mesmo documento — verdadeira para operadora que publica
por remessa. Falsa para a GEAP, cujo relatório é recortado por mês de
quitação: dois meses diferentes podem conter o mesmo protocolo, cada um com as
guias quitadas naquele mês.
Medido: os protocolos 15535162 e 15535209 aparecem em 02/2026 e em 03/2026.
E na releitura, o documento de 03/2024 foi apagado pela leitura de 04/2024,
que cobre os protocolos dele — 13 guias e R$ 3.101,81 que desapareceram sem
nenhum erro em lugar nenhum. Restaurado relendo 03/2024 por último.
Não consertado. superados.ts é compartilhado por todas as operadoras e
existe para resolver uma duplicação real e medida (Unimed Brusque, 548
protocolos virando 2.192 demonstrativos). Mexer na regra sem rever as três
guardas dela é trocar um estrago por outro. O caminho provável é a identidade do
documento incluir o recorte (a competência), não só os protocolos.
Enquanto não for consertado: ao reler vários meses da GEAP, confira ao final
que cada arquivo ainda tem demonstrativo —
inbox_files sem linha em analise_fontes_documento é mês apagado.
Quinze meses sem UMA linha de quitação — e com dinheiro no extrato
Este é o achado que fica aberto, e é o mais importante da varredura.
Meses em que o relatório de guias quitadas voltou com planilha só de cabeçalho:
**06/2023, 09/2023, 05/2024, 06/2024, 07/2024, 09/2024, 10/2024, 11/2024,
01/2025, 02/2025, 07/2025, 12/2025, 01/2026, 08/2026 e 10/2026**.
Não é transitório: 01/2025 foi re-pedido depois do backfill e voltou vazio de
novo. E não é ausência de movimento — o extrato financeiro dos mesmos meses tem
dinheiro:
| Mês | Extrato bruto | Relatório de guias |
|---|---|---|
| 06/2023 | R$ 123.220,05 | vazio |
| 01/2025 | R$ 177.463,44 | vazio |
| 02/2025 | R$ 156.319,24 | vazio |
| 07/2025 | R$ 264.228,86 | vazio |
A leitura que sobra é a que a seção dos dois brutos já levanta: **o relatório é
por mês de QUITAÇÃO da guia e o extrato é por competência financeira do
crédito**, e os dois recortes não coincidem. Um mês pode creditar guias quitadas
noutro mês e, portanto, não ter nenhuma quitação própria.
O que impede de confirmar: o extrato da GEAP é profundidade F — fecha o mês
e não desce a guia. Não há como pegar uma guia do crédito de 01/2025 e achá-la
no relatório de outro mês, porque o crédito não nomeia guia. Confirmar isso
exige outra fonte, não estas duas. Até lá, **os 15 meses contam como "sem
quitação declarada", não como "sem receita"** — e qualquer soma que trate o
relatório de guias como a receita do mês vai estar errada nesses 15.
Três meses consecutivos vazios (05, 06 e 07/2024) e depois mais três
(09, 10 e 11/2024) pesam a favor do recorte: falha aleatória não faz sequência.
Re-pedir um mês NÃO relê o arquivo — e isso atrapalha conserto de leitor
Registro das duas conclusões erradas que tive antes de medir, porque as duas
mudariam o que alguém faz.
Primeiro achei que re-pedir duplicaria itens, pela composição
(acharComplementar). Não duplica: aquele ramo só roda para fonte que declara
ser METADE de um retorno (papel === 'FULL' ? null : ...), e o relatório da GEAP
é role: 'FULL'.
Depois achei que re-pedir substituiria o documento, via
apagarAnalisesSuperadas. Também não: o conector nem baixa de novo.
fetchAnalysis monta o nome do arquivo a partir do período
(geap-guias-quitadas-AAAA-MM.xlsx) e pula a competência cujo nome já está em
options.existingFileNames, de propósito, para não pagar a fila da operadora
por nada. Medido em 01/11/2026: 16 execuções de re-pedido responderam
"analise": "0 arquivo(s)", todas SUCCESS, sem trazer nada. O extrato
financeiro chega a baixar e aí cai na dedup por SHA-256
(totalDuplicated: 1), porque o nome dele não é derivável do período da mesma
forma.
Consequência prática, e é a que importa: depois de consertar o LEITOR, mandar
o conector buscar de novo não serve de nada — o arquivo certo já está no S3, e o
que precisa rodar outra vez é o handler. O caminho é
POST /import-inbox/:id/retry-process.
Lacuna do produto, não medida como bug ainda: esse endpoint recusa arquivo
em INBOX_DISTRIBUIDO (ver podeReprocessar), e a recusa é certa como padrão —
reler fonte que é metade de um retorno acrescenta itens. Mas não existe caminho
para "o leitor mudou, releia o que já entrou", que é uma operação normal depois
de consertar parser. Em 01/11/2026 isso foi feito virando o status no banco
antes de chamar o endpoint, nos 27 arquivos, depois de conferir num deles que o
resultado batia com a medição à mão (19.203 itens, R$ 478.548,21,
R$ 109.122,77).
Glosa e recurso: onde cada coisa mora (medido em 01/11/2026)
Ver a glosa
| Onde | O que dá | Estado |
|---|---|---|
| Relatório de Guias | item a item, com valor glosado, código e grupo do motivo | já automatizado (FETCH_ANALYSIS) |
| Acompanhamento de Guias | consulta SÍNCRONA por Nº do Lote / Nº do Documento / Situação | medido, não implementado |
| Auditoria Digital | — | não aberto |
Acompanhamento de Guias é a única consulta de andamento que **não passa pela
fila** — responde na hora, por
GET /portalprestador/v1/AcompanhamentoGuias/AcompanhamentoGuias?parameters=nroContratado:X;situacao:N;&pageSize=&pageNumber=.
Colunas: `Guia · Guia Contratado · Lote/Doc. · Cartão · Valor Calculado ·
Situação · Mês/Ano. situacao:1` = "Em Revisão" (a Solim não tinha nenhuma).
O resto do domínio de situação não foi lido — o seletor é Angular Material e
não abre por script.
Executar o recurso — e NÃO é na SPA
Portal TISS - Recurso → Recurso de Glosa abre **outro sistema, em outro
host**: www2.geap.org.br/digitaTiss/DT001_GUIA_18.aspx, uma aplicação
ASP.NET antiga ("Framework.Web 3.7.1.1 / DigitaTiss.Net.Application.dll"),
intitulada GUIA DE RECURSO DE GLOSAS.
É um CRUD, não um formulário de envio: Novo (Alt-N) cria a guia de recurso,
Listar (Alt-L) pesquisa as existentes. A pesquisa filtra por Situação da
Guia, Data de Emissão (≥), Remessa, Nº Guia Prestador, Nº Guia Operadora e
Senha da Autorização.
O ciclo de vida está no próprio seletor de situação, e é o mapa do
processo:
Guia em edição → Guia pronta para cobrança → Guia anexada à remessa, com
Guia Devolvida e Guia Cancelada como desfechos.
Depois da guia pronta, os dois passos seguintes estão na SPA:
Portal TISS - Recurso → Geração de remessas para cobrança e
Portal TISS - Recurso → Envio de Arquivo.
#### ERRADO: "a Solim não tem nenhuma guia de recurso cadastrada"
Esta nota afirmava isso. Era o filtro da tela, não a base. A tela de
Procurar nasce com Data de Emissão da Guia preenchida com uma data recente
(02/10/2026 na primeira medição, 01/11/2026 na segunda) e o filtro é ≥.
Clicar Listar sem tocar nesse campo esconde tudo o que veio antes.
Apagando o campo e listando de novo, em 01/11/2026:
Registros: 100/247
A Solim tem 247 guias de recurso de glosa na GEAP, de 13/05/2015 a
04/12/2024:
| Ano | Guias | Situação | Guias | |
|---|---|---|---|---|
| 2015 | 6 | Guia anexada à remessa | 215 | |
| 2016 | 7 | Guia em edição | 16 | |
| 2017 | 11 | Guia Devolvida | 13 | |
| 2018 | 8 | Guia Cancelada | 3 | |
| 2019 | 25 | |||
| 2020 | 83 | |||
| 2021 | 19 | |||
| 2022 | 9 | |||
| 2023 | 8 | |||
| 2024 | 71 |
Dois fatos que saltam da tabela e valem conversa com o cliente: **nada depois
de 04/12/2024 — quase dois anos sem recorrer pela GEAP — e 16 guias paradas
em "Guia em edição"**, que são recursos escritos e nunca enviados.
É a mesma armadilha do Filtro vazio não é resposta da operadora, agora com
filtro PRÉ-PREENCHIDO, que é pior: não há campo em branco para desconfiar.
#### A guia de recurso por dentro — e é o mesmo formulário da criação
Novo e Editar abrem a MESMA tela. Então ler um recurso antigo é ler o
formulário de criação. Campos, na ordem da tela:
| Campo | Observação |
|---|---|
Situação da Guia (+ link Alterar) | é por aqui que se promove em edição → pronta para cobrança |
| Data de Emissão da Guia \* · Remessa · Documento | remessa e documento são preenchidos pelo sistema |
| 1. Registro ANS \* | 323080 |
| 2. Nº Guia no Prestador · 3. Nome da Operadora \* · 4. Objeto do Recurso \* · 5. Nº Guia Operadora \* | objeto medido: Guia |
| 6. Código na Operadora \* · 7. Nome do Contratado \* | 22006869 / LABORATORIO DE PATOLOGIA CIRURGICA E CITOLOGIA LTDA |
| 13. Número Guia Prestador \* · 14. Número Guia Operadora \* · 15. Senha | NroGspContratado, NroGspPrincipal |
| 16. Código da glosa da guia | |
| 17. Justificativa (no caso de recurso integral da guia) | ObsRecursoGuia, máx. 150 caracteres |
| Linha de item: Data Atendimento \* · Data Final Período · Nº Serviço \* · Descrição · Valor Recursado \* · Grau de Participação · Justificativa Prestador | ObsPrestador, máx. 450 caracteres; botão Adicionar procedimento |
| 30. Valor Total Recursado (R$) \* |
Grau de Participação tem 14 valores: Anestesista, Auxiliar de Anestesista,
Auxiliar SADT, Cirurgião, Clínico, Consultor, Instrumentador, Intensivista,
Pediatra na sala de parto, Perfusionista, Primeiro a Quarto Auxiliar. Em todas
as amostras da Solim é 11 - Auxiliar de SADT.
Duas abas no topo da guia: Histórico de Situação e Anexar Documentos.
#### Armadilha: o campo 17 está guardando o MOTIVO da glosa, não a justificativa
O campo se chama "Justificativa (no caso de recurso integral da guia)". O que
está escrito nele, nas amostras medidas, é o texto da glosa:
NÚMERO DA GUIA INVÁLIDO (4x) · NÚMERO DE GUIA INVÁLIDO (2x) ·
CPF/CNPJ INVÁLIDO. · NÚMERO DA CARTEIRA INVÁLIDO ·
CBO-S (ESPECIALIDADE) NÃO AUTORIZADO A REALIZAR O SERVIÇO. ·
CBO-S (ESPECIALIDADE) NÃO AUTORIZADO A REALIZAR O CÓDIGO
Quem for ler esse campo esperando argumentação vai achar motivo de glosa. A
argumentação de verdade está no Justificativa Prestador de cada item.
#### O repertório de justificativas da Solim (30 recursos amostrados, 2015–2024)
Quatro textos de prateleira cobrem a esmagadora maioria dos itens:
| Vezes | Texto |
|---|---|
| 87 | Conforme contratualizado entre as partes, tabela vigente, pedido médico, laudo e autorizado junto ao convênio. Desta forma, solicito revisão e pagamento. Segue anexo documentação comprobatória. |
| 48 | Procedimento foi faturado conforme solicitação médica, CBO correto e tabela contratual vigente. Diante do exposto, pedimos deferimento do valor glosado. Segue documentação comprobatória. |
| 28 | Cobrado conforme contratualizado entre as partes, tabela vigente, pedido médico, laudo e autorização. Desta forma, solicito revisão e pagamento. Segue anexo documentação comprobatória. |
| 20 | Pedimos deferimento do valor glosado, procedimento realizado conforme pedido médico, laudo e autorizado na senha:*nnn* e guia:*nnn*. |
As variantes desses quatro (com/sem ponto final, "CBO" trocado por "CNPJ",
espaço duplo) aparecem mais ~25 vezes — são o mesmo texto redigitado, não
textos diferentes.
E há uma cauda de argumentos escritos à mão, que é onde está o valor:
- •Duplicidade: "Exame colhido em dias diferenciados, o que desvalida
duplicidade." · "Foram realizados os exames de Hemograma e contagem de
plaquetas, que na Tabela GEAP é precificado pela mesma codificação:
4.03.04.36-1, o que desvalida duplicidade."
- •CBHPM, capítulo e tabela: "PD múlti frag. biópsias acondicionados no
mesmo frasco de acordo c/ o cap IV – tab 4.2 CBHPM deve ser remunerado no
40601196 e multiplicado por frasco." · "...de acordo com o capitulo III –
tabela 3.5 da CBHPM deve ser remunerado no código 4.06.01.25-0..."
- •Contagem de material: "Foram encaminhadas para analise SEIS frascos
contendo DEZOITO lâminas da tireoide..." · "DEZOITO frascos contendo
fragmentos de próstata, em sua totalidade 30 fragmentos..."
- •Protocolo clínico: "Procedimento realizado em jejum e após 02 horas do
desjejum do paciente, conforme prescrição médica."
- •Falha própria admitida: "...no momento da entrega da fatura, não tínhamos
ciência da necessidade de envio das guias SADT pelo site da operadora..."
Para um gerador de recurso assistido por IA, isto é o conjunto de treino: o
texto genérico é o default do faturista, e o texto específico é o que o caso
pedia. A diferença entre os dois é exatamente o que vale automatizar.
#### Histórico de Situação e Anexos
Histórico de Situação abre DT002_GUIA_LOG_SITUACAO.aspx?NroGsp={id} — **GET
simples**, com Situação da Guia · Justificativa · Data e hora. Exemplo da
guia 4867194970:
Guia anexada à remessa | Remessa Gerada | 04/06/2024 13:14:00
Guia pronta para cobrança | | 04/06/2024 00:00:00
Guia em edição | | 04/06/2024 00:00:00
Anexar Documentos abre UploadDocumentos.aspx?NroGsp={id} e lista
# · Data de Cadastro · Tipo do Arquivo · Nome do Arquivo. Regras escritas na
própria tela: só PDF, e **a soma de todos os arquivos não pode passar de
25 MB**.
#### A listagem e a leitura são automatizáveis sem navegador
A paginação é GET:
GET /digitaTiss/DT001_GUIA_18.aspx?Transaction=FormList&LineStatus=
&FilterOrderBy=&FilterOrderByType=ASC&pagina={n}
100 linhas por página. A chave primária de cada linha sai do onclick do ícone
Editar (InputPrimaryKey('4867194970','4867194970')) e **é o Nº da Guia
Operadora**. Com ela, a guia inteira vem por POST na mesma URL, reaproveitando
o __VIEWSTATE da listagem:
POST /digitaTiss/DT001_GUIA_18.aspx
Transaction=FormEdit&NroGsp={chave}&Redirect=&LineStatus=
+ __VIEWSTATE / __EVENTVALIDATION da listagem
Foi assim que os 247 registros e as justificativas acima foram levantados. É
leitura: nada é gravado sem Salvar.
Acompanhar o recurso
Relatórios → Relatório Recurso de Glosa — mesma mecânica de fila do
relatório de guias, com os mesmos 20 minutos de aviso. Dois formatos:
Gerar Relatório Excel e Gerar Relatório XML (este último não existe no
relatório de guias e não foi medido).
Filtros: tipo (Guias Quitadas), Glosadas (padrão NÃO), Ano/Mês de
Quitação, Guia do Contratado, Protocolo, Nº do Envio, Ano/Mês Entrega,
Cliente.
E aqui sai a resposta de uma pergunta que estava em aberto nesta nota: a
fila deste relatório é a mesma ContratadoAnexo/list, filtrada por
nroTpoGsp:18 — é esse parâmetro que separa a fila do recurso da fila do
relatório de guias. Medido na requisição que a própria tela dispara:
GET /portalprestador/v1/ContratadoAnexo/list
?PageSize=99999&PageNumber=1
&Parameters=nroContratado:22006869;nroTpoGsp:18;
A Solim tem 12 execuções desse relatório no histórico (25/09 a 16/10/2026),
todas Finalizado e todas com nome "Nenhum registro encontrado.".
E isso NÃO quer dizer que ela nunca recorreu — quer dizer que não há
recurso no recorte pedido. Ela tem 247 guias de recurso cadastradas, a última
de 04/12/2024, e o relatório filtra por Ano/Mês de Quitação. Pedir meses de
2026 para um prestador que parou de recorrer em 2024 devolve vazio com toda
razão. Antes de concluir qualquer coisa de um "Nenhum registro encontrado.",
confira contra a listagem do digitaTiss com o campo de data APAGADO.
Material de apoio que a operadora publica
- •
Manual do Prestador - TMS - Recurso de Glosa—
geap.org.br/wp-content/uploads/Manual-do-Prestador-Recurso-de-Glosas.pdf
- •
Manual do Prestador - TMS(versão com recurso de glosa) - •
Manual Digita TISS Web (2ª Edição)—
www2.geap.org.br/pdf/prestador/Manual_do_Digita_TISS_WEB.pdf
- •Vídeo "RECURSO DE GLOSA ODONTOLÓGICA" no canal da GEAP
#### O manual de recurso descreve um sistema que a Solim NÃO tem
Lido em 01/11/2026. O Manual do Prestador - TMS - Recurso de Glosa não fala
do digitaTiss: fala do Sistema TMS / True Auditoria
(trueauditoria.com.br), acessado por `Portal Credenciado > Tiss > Recurso de
Glosas, com funções Abertura Parcial e Cancela solicitação`. O modelo dele
é outro:
- •objetivo do recurso por Conta ou por Evento (item/procedimento);
- •dentro de cada um,
Todas as guias/Um evento/Todos os eventos/
Motivo Glosa (recorrer em lote de tudo que levou o mesmo código);
- •parte-se sempre de uma remessa fechada que tenha glosa;
- •justificativa é obrigatória em toda guia/item selecionado — o manual diz
explicitamente que tentar enviar sem justificativa é recusado;
- •o processo pode ficar salvo em tela por até 15 dias para continuar depois;
- •cancelar exige a referência da abertura e a da remessa de origem, e depois do
cancelamento a remessa some da lista.
Esse menu não existe no portal da Solim. O menu dela (medido no mesmo dia)
tem `Portal TISS - Recurso → Geração de remessas para cobrança · Recurso de
Glosa · Envio de Arquivo, e Recurso de Glosa` abre o digitaTiss. Então a GEAP
tem (pelo menos) dois caminhos de recurso, e o manual que ela publica é do
caminho que este cliente não usa. Vale perguntar à operadora qual vale para
laboratório — e não implementar SUBMIT_APPEAL com base no manual sem
confirmar isso.
A GEAP TEM webservice — e ele é próprio, não o SOAP da ANS
Medido em 02/11/2026, sem credencial nenhuma: o host ws.geap.com.br existe e
responde. Não é suposição a partir do item "Webservice" do menu — é o servidor.
Como se mapeia um IIS sem documentação: 403 é "existe", 404 é "não existe"
O host é IIS 10 (Server: Microsoft-IIS/10.0, X-Powered-By: ASP.NET) atrás de
um F5 cujo pool se chama BIGipServer~Externa~pool_webservice. Ele recusa
listagem de diretório com 403.14, e caminho inexistente com 404. Essa
diferença é um oráculo: dá para mapear a árvore inteira sem autenticar.
A página de erro 403.14 ainda entrega o caminho físico:
Physical Path D:\PRODUCAO\Inetpub\wwwroot\WebServices\tiss\
Ou seja: a raiz do site é wwwroot\WebServices\, e tiss é uma pasta dentro
dela. É produção, não homologação.
O que existe lá
| Caminho | Resposta | O que é |
|---|---|---|
/tiss/ | 403.14 | pasta real, sem arquivo de serviço localizável |
/elegibilidade/ | 403.14 | pasta real |
/elegibilidade/elegibilidade.asmx | 200 | serviço vivo, WSDL aberto |
O WSDL se lê sem credencial:
targetNamespace http://www.geap.com.br/webservice/
operação VerificarElegibilidade(p_Key, p_Cartao, p_NroContratado, p_NroCNPJ)
soapAction http://www.geap.com.br/webservice/VerificarElegibilidade
Não é o TISS da ANS. O padrão normatiza tissSolicitacaoProcedimento e
companhia, em namespace da ANS; aqui o namespace é da GEAP e a operação tem
nome próprio em português. Quem for implementar não reaproveita o cliente SOAP
TISS — é integração proprietária.
Uma única operação, quatro bindings — e a chave é o único portão
O WSDL inteiro tem 142 linhas e uma operação. O que parece ser sete é a
mesma VerificarElegibilidade repetida nos quatro bindings que o ASP.NET gera
sozinho: ElegibilidadeSoap, ElegibilidadeSoap12, ElegibilidadeHttpGet e
ElegibilidadeHttpPost. Não há segunda operação escondida.
Dá para chamar sem envelope SOAP. O binding HTTP GET publica
<http:operation location="/VerificarElegibilidade"/> com urlEncoded, então
a chamada é uma querystring:
GET /elegibilidade/elegibilidade.asmx/VerificarElegibilidade
?p_Key=…&p_Cartao=…&p_NroContratado=…&p_NroCNPJ=…
O retorno é DataSet do ADO.NET, não tipo declarado: o schema traz
<s:element ref="s:schema"/><s:any/>. Quais campos a elegibilidade devolve só
se descobre chamando com chave válida — o WSDL não conta.
A chave é o único portão, e isso foi medido (02/11/2026, chave vazia,
cartão zerado):
HTTP 500, text/plain
System.Security.SecurityException: A chave informada é inválida para o WebService
at Elegibilidade.VerificarElegibilidade(String p_Key, Decimal p_Cartao, Int32 p_NroContratado, Decimal p_NroCNPJ)
Sem IP liberado, sem certificado, sem cabeçalho de origem: o serviço responde à
internet aberta e recusa só pela chave.
p_Key é chave de API. O serviço não usa certificado nem usuário/senha: o
primeiro parâmetro é uma chave. Onde se obtém essa chave é, quase certamente, o
item Webservice do menu do portal — que continua sem ser aberto.
Autorização NÃO foi encontrada no webservice
Varridos ~45 nomes plausíveis na raiz e dentro de /tiss/, pelo oráculo
403/404: autorizacao, autorizacoes, solicitacaoProcedimento,
solicitacaoAutorizacao, statusAutorizacao, cancelaGuia, senha, guia,
guias, procedimento, sadt, spsadt, lote, protocolo, recurso,
glosa, demonstrativo, faturamento, beneficiario, prestador, e as
variantes em CamelCase e maiúsculas. Só elegibilidade existe (e responde
também como /Elegibilidade/ e /ELEGIBILIDADE/ — o IIS não diferencia caixa).
Isso não prova que a GEAP não autoriza por webservice: prova que, se autoriza,
não é por nome óbvio neste host. O que falta medir, nesta ordem:
1. O item "Webservice" do menu do portal — é lá que a operadora publica o
que oferece e como pedir a p_Key. Precisa de login (credencial da Solim no
cofre).
2. Perguntar à operadora pelo SAP (atendimento ao prestador) do próprio portal.
Consequência para CHECK_ELIGIBILITY
A nota antiga dizia que o caminho da elegibilidade seria a tela
Paciente → Consultar Beneficiário. Existe caminho melhor: este webservice.
Um RPA que abre navegador para ler elegibilidade perde para uma chamada SOAP de
quatro parâmetros. Quem for implementar, comece pela chave.
O que ainda precisa ser checado
- •O login aceita código GEAP ou CPF: qual dos dois a operadora considera
oficial para automação, e se o CPF usado é de pessoa física (troca quando o
funcionário sai).
- •Se há MFA em algum momento (não apareceu neste login).
- •O item Webservice do menu: o que ele publica. Se houver webservice de
verdade, a operação não deve nascer só em RPA.
- •Se o upload de XML devolve protocolo na hora e onde fica o desfecho por guia.
- •Expiração da sessão e do token do IdentityServer.
- •~~O conteúdo do xlsx de guias~~ — medido em 31/10/2026: 35 colunas, item a
item, com código e grupo de glosa. Ver a seção do conector.
- •Onde a série do extrato financeiro realmente começa: 2000 responde, mas não
procurei o primeiro ano. 2005 veio zerado no meio de anos com dado, o que
mostra que zero não delimita o início.
- •~~
nroTpoGsp:18~~ — respondido em 01/11/2026: é o filtro da fila do
Relatório Recurso de Glosa. Ver a seção de glosa e recurso. tpoRelatorio
continua sem medição.
O conector, e as três armadilhas que ele contorna (31/10/2026)
rpa/geap/ — o navegador serve para o login OIDC e para emprestar o token; as
operações são chamadas REST na apicore. As três coisas que custaram medição:
1. A resposta do pedido de relatório MENTE
GET AcompanhamentoGuias/RelatorioGuiasQuitadasExcel responde sempre:
{"code":77700,"isSuccess":true,"resultData":null,
"messages":[{"title":"Nenhum registro encontrado para esta solicitação"}]}
…inclusive quando enfileira um relatório com 16.397 itens. Medido duas vezes no
mesmo dia: setembro/2026 deu essa mensagem e produziu o xlsx cheio; agosto/2026
deu a mesma mensagem e também produziu arquivo. Hipótese descartada: que a
mensagem distinguisse mês com e sem dado — ela não distingue nada.
O desfecho mora na fila (ContratadoAnexo/list): o item nasce Pendente com
nmeAnexo ".xml", passa por Processando e termina Finalizado. Aí o nome
decide: relatorio_guia_quitada<id>.xlsx tem dado; ".xml" sem nome é vazio.
Medido: de 30s a 1min20 por relatório, contra os "cerca de 20 minutos" que a
tela avisa.
2. isSuccess não é resposta sobre dado
Todo endpoint da apicore devolve code: 77700, isSuccess: true e "Operação
realizada com sucesso" — para ano=1950, ano=2030 e mes=13 também, com as
16 linhas do extrato zeradas. **Mês sem movimento é indistinguível de período
inválido.** Por isso o conector descarta extrato todo-zero antes de gravar: a
alternativa era ensinar o Revenue que a operadora fechou o mês em R$ 0,00.
3. O relatório é o dado mais profundo que recebemos de qualquer operadora
35 colunas, uma linha por ITEM de guia: guia do prestador (Guia Contratado) e
da operadora (Nº Guia), protocolo, lote, item, código do serviço, quantidade,
valor informado/previsto/calculado/glosado por item, e o motivo —
Justificativa (código da GEAP), Justificativa Padrão, Texto Glosa e
Grupo Glosa. É depth: 'A' no contrato de análise.
Medido no prestador SOLIM:
| Competência | Itens | Guias | Protocolos | Informado | Calculado | Glosado |
|---|---|---|---|---|---|---|
| 09/2026 | 16.397 | 1.231 | 38 | R$ 427.793,31 | R$ 396.243,95 | R$ 31.549,36 (418 itens) |
| 06/2021 | 1.509 | 149 | 6 | R$ 31.652,70 | R$ 31.652,70 | R$ 0,00 |
As datas estão em MM/DD/YYYY. Prova: na coluna Data de Atendimento de
junho/2021, 805 das 1.509 linhas têm o SEGUNDO componente maior que 12 e
nenhuma tem o primeiro. A Data Baixa do mesmo arquivo é toda 06/01/2021 com
filtro de mês 6 — 1º de junho, não 6 de janeiro. Ler como dd/mm inverteria
silenciosamente toda data cujo dia é ≤ 12.
Glosa de Cabeçalho é da guia e vem repetida em cada item dela. Gravá-la
por item multiplicaria uma glosa só pelo número de itens da guia.
E É NELA QUE MORA O MOTIVO DE METADE DO DINHEIRO. Medido em 01/11/2026: no
arquivo de julho/2026, 14.376 dos 15.131 itens glosados (R$ 401.667,00 de
R$ 479.677,18 — 83,7%) têm Valor Glosado Item > 0 e nada em
Justificativa, Justificativa Padrão, Texto Glosa e Grupo Glosa. O motivo
está só no cabeçalho, e em 13.924 deles é o mesmo: `3052 - DOCUMENTACAO
INCOMPLETA, INCORRETA OU AUSENTE`.
Consequência no banco: 25.578 glosas de item (R$ 696.139,04, 60,28% do valor)
com tipoMotivo = 'FREE_TEXT' e todos os campos de motivo nulos. Não é a
operadora que omite — é o handler que não propaga. Quem for agregar glosa da
GEAP por motivo precisa do fallback "motivo do item, senão o da guia"; com
ele, 99,6% do valor passa a ter motivo. Ver
docs/recurso-de-glosa/00-diagnostico-solim.md.
O mês do filtro é o de QUITAÇÃO, não o de atendimento. O relatório de
junho/2021 traz baixa em 01/06 e atendimentos de 26/01 a 23/03 — três meses
antes. Varrer por competência de atendimento perderia justamente as guias que
demoraram a ser pagas.
O rastro que a sonda deixa
Pedir relatório escreve na conta do cliente: cada pedido vira um item na
fila dele, visível na tela, e a conta da SOLIM já tinha 86 itens dos pedidos do
próprio prestador antes de a gente chegar. Sete pedidos foram feitos nas
medições de 31/10/2026. Não há como pedir sem deixar rastro.
Download
GET ContratadoAnexo/get-anexo/{ideContratadoAnexo} devolve o xlsx. O id é o
ideContratadoAnexo da fila — não o guidIdentificadorArquivo, que também vem
na listagem e não serve para baixar.
A GEAP tem DOIS portais, e o recurso de glosa mora no outro (medido 01/11/2026)
Esta é a correção mais cara desta sessão: passei horas recursando no sistema errado.
| digitaTiss | TMS / True Auditoria | |
|---|---|---|
| Endereço | www2.geap.org.br/digitaTiss | geap.topsaude.com.br/PortalCredenciado |
| Caminho | Sisgeap → Recurso de Glosa | Sisgeap → Portal TISS (SSO automático) |
| Recurso | guia a guia, digitada à mão | Conta / Evento × Múltiplas / Motivo de Glosa |
| Justificativa | 150 (guia) / 450 (item) | 2000 |
| Manual | "Manual Digita TISS Web (2ª ed.)" | "Manual do Prestador - TMS - Recurso de Glosa" |
Os dois estão listados em *Manuais* dentro do Sisgeap. Os dois funcionam. **O recurso de
verdade é o do TMS** — o digitaTiss é o legado, e é nele que estão as 16 guias paradas em
"Guia em edição" desde 2024.
Por que o digitaTiss recusava o item com Msg(77701)
Duas causas somadas:
1. Sistema errado. O item vivia no TMS.
2. Nível da glosa. A guia 2614918 tinha glosa de CABEÇALHO (3052). O campo 17 diz
literalmente "Justificativa (no caso de recurso integral da guia)" — glosa de guia
se recursa inteira, por esse campo, sem grid de itens. Comparei com o recurso
4867194970, que a Solim abriu e funcionou: campos 16 e 17 VAZIOS, item na grid.
O meu: campo 16 = 3052, campo 17 pré-preenchido, item recusado. A GEAP estava certa.
O bug de data do próprio portal da GEAP
Abertura Parcial → escolher a remessa → o JS deles escreve em REF_NR_ORIGEM o valor
"9/1/2026 1": data em formato US com um " 1" grudado. O endpoint
POST /PortalCredenciado/HomePortalCredenciado/RecursoGlosa/ObterAjusteGlosas
parseia em pt-BR e devolve 500:
The parameters dictionary contains a null entry for parameter 'mes_ano_ref' of
non-nullable type 'System.DateTime'
Resultado: a opção "Motivo de Glosa" não carrega nada na UI deles, e a tela diz
"Não há itens de glosas para esta NR informada" — que mede o bug deles, não a operadora.
Contorno medido: escrever 01/09/2026 em REF_NR_ORIGEM antes de disparar o
change. Aí carrega: 206 ocorrências, 5 motivos distintos, 196 itens na grid.
E o contorno esbarra na contradição deles
O MESMO campo é lido duas vezes, por validações que discordam:
- •
ObterAjusteGlosasquer a competência da remessa (passada) — senão 500. - •
SalvaRecursoGlosa(a execução) trata o mesmo valor como data de solicitação e
recusa: *"Data de solicitacao nao pode ser anterior que a data corrente."*
Com o valor deles: 500 na busca. Com o valor correto: recusa na execução. **A abertura
por Motivo de Glosa para competência passada parece inviável como o portal está hoje.**
Isso precisa ir para o suporte da GEAP (21034321) — não é coisa que se conserta do lado
de cá. Nada ficou gravado: ListarTempRecurso voltou vazio depois da recusa.
Dois vocabulários de glosa
O dropdown de motivo usa código interno do TMS; o item carrega o código TISS:
MOTIVO_GLOSA.value = 716
ItemTissGlosas[0].GLOSA = 1707 // mesma descrição
Ambos: "Não existe informação sobre a tabela que será utilizada na Valoração. Verifique o
Contrato do Prestador". Não trate 716 e 1707 como glosas diferentes. Os outros vistos:
563, 873, 982, 983.
O achado que vale dinheiro: R$ 276.371,00 que o Miydas não enxerga
Numa única remessa (NR 178250595, ref 09/2026):
- •196 itens, 29 guias, R$ 276.371,00, todos no motivo 1707
- •a guia
11469672desse lote não existe no nosso banco - •o motivo
1707não aparece no Pareto que levantamos (3052, 1714, 2714, 1423)
E o cabeçalho da remessa diz "Valor Glosado 3.853,10" — que não bate com a soma dos itens.
Duas réguas que não conversam, e nenhuma delas é a nossa.
Consequência: nossa ingestão da GEAP está cega para um canal inteiro de glosa. O
diagnóstico de R$ 1,15 milhão que montamos mede só o que chega pelo demonstrativo. Antes
de prometer taxa de recuperação à Solim, é preciso descobrir de onde sai o dado do TMS
(Demonstrativos → Demonstrativo de Recurso de Glosa) e se ele é a mesma coisa.
Descartado, para não refazer
- •Mexer no campo 17 do digitaTiss para "corrigir" o texto pré-preenchido. Não é erro
do faturista: o portal preenche com a descrição da glosa de cabeçalho. É assim mesmo.
- •Procurar
SUBMIT_APPEALno digitaTiss. Existe, mas é o caminho legado e exige
gerar remessa + enviar arquivo depois. O TMS executa direto.
- •
9/1/2026sem o" 1". Também devolve vazio — o servidor lê dd/MM/yyyy, então
isso vira 9 de janeiro. Só 01/09/2026 funciona.
Avisos de execução
Esta seção é LIDA PELO SISTEMA. Cada item vira um aviso no pacote de execução
que o faturista abre ao lado do portal (avisos-da-nota.ts). Escreva aqui só
o que a pessoa precisa saber ANTES de abrir o portal, senão perde a viagem.
- •O recurso de glosa fica no TMS (
geap.topsaude.com.br), não no digitaTiss. Caminho: Sisgeap → Portal TISS → Recurso de Glosa → Abertura Parcial. - •Glosa de CABEÇALHO se recursa pelo campo 17 do digitaTiss ("recurso integral da guia"), sem grid de itens. Tentar adicionar item devolve Msg(77701).
- •Medido em 01/11/2026: no TMS, a opção "Motivo de Glosa" não carrega nada por bug de data do próprio portal, e a tela mente dizendo "Não há itens de glosas para esta NR".
- •Medido em 01/11/2026: a execução recusa competência passada com "Data de solicitacao nao pode ser anterior que a data corrente". Abertura por motivo para mês fechado parece inviável hoje — é caso de ligar para 21034321.
- •O código do dropdown é interno do TMS e não é o código TISS: 716 no menu é 1707 no item. Mesma glosa.
- •No digitaTiss, a tela de Procurar nasce com a Data de Emissão preenchida e filtra por ">=": apague o campo para ver o histórico.
- •No digitaTiss, criar a guia NÃO envia. Ela fica em "Guia em edição" até gerar remessa e enviar arquivo — há 16 paradas assim desde 2024.
O protocolo do recurso no TMS (medido 01/11/2026, implementado)
SUBMIT_APPEAL fala JSON com o TMS, não preenche formulário. A sequência:
Endpoint (/HomePortalCredenciado/RecursoGlosa/…) | Papel |
|---|---|
BuscarNrsParaRecurso | remessas da competência que têm glosa |
ObterAjusteGlosas | motivos de glosa daquela remessa |
ListarRecursoItem | os itens, com COD_TS_CONTA e COD_TS_ITEM |
AtualizaDadosCheck | um POST por item — marca, valoriza, justifica |
SalvaRecursoGlosa | a capa |
ExecutaAbertura | abre o recurso de fato |
AtualizaDadosCheck recebe `{ objeto: { COD_TS_CONTA, COD_TS_NR, MES_ANO_REF,
COD_TS_ITEM, JUSTIFICATIVA, IND_INSERIR, VALOR_TOTAL_RECURSO, VALOR_TOTAL_ACEITO } }`.
IND_INSERIR é 0 para incluir e 9 para tirar — não é booleano.
COD_TS_ITEM vai nulo quando o objetivo é G (conta).
MES_ANO_REF tem DOIS formatos, e mandar "o certo" quebra
Esta é a armadilha que custou a sessão inteira, e a correção óbvia é o defeito.
O portal escreve no campo REF_NR_ORIGEM o valor "9/1/2026 1" — data em
formato US com um " 1" grudado. Medido, variando uma coisa por envio:
| valor | ObterAjusteGlosas | ExecutaAbertura |
|---|---|---|
9/1/2026 1 (o do portal) | 500 — DateTime não-anulável nulo | passa da validação de data |
01/09/2026 (dd/MM) | 200, lista os motivos | "Data de solicitacao nao pode ser anterior que a data corrente" |
9/1/2026 (sem a hora) | — | mesma recusa de data |
2026-09-01 (ISO) | — | passa da validação de data |
Dois endpoints do MESMO portal leem o MESMO campo com parsers diferentes.
Normalizar para um formato só reprova em um dos dois, sempre. Por isso o
conector carrega bruto e civil separados e dá a cada chamada o que ela
aceita. Não "conserte" isso sem medir de novo.
E 9/1/2026 é setembro, não janeiro: é US. Ler como pt-BR joga a
competência oito meses para trás e a busca volta vazia — que é a falha mais
cara, porque parece "a operadora não glosou".
Outros fatos do TMS
- •O limite da justificativa do item é 500, do
maxlengthdo editor da
grade. Não confundir com os 450 do digitaTiss: é outro sistema.
- •
SalvaRecursoGlosasozinho não envia nada. Ele responde
{"sucesso":true,"msg":"Registro atualizado com sucesso"} e só grava a capa.
Quem abre o recurso é ExecutaAbertura. Ler o sucesso do primeiro como envio
é o erro fácil aqui.
- •A sessão do SSO expira e devolve 404 em todas as rotas, não 401. Medido:
cerca de uma hora. O token é de uso único e vem do clique em "Portal TISS" no
Sisgeap — deep-link não autentica.
- •
codPrestadorTs(ex.:17216) é um id interno do TopSaúde, renderizado
dentro da tela de Abertura Parcial. Não é o CNPJ nem o código GEAP, e não dá
para pedir ao chamador.
- •O portal zera o valor silenciosamente quando ele passa da glosa da linha.
O conector confere antes de escrever, senão o recurso sai com valor diferente
do pedido sem ninguém notar.
Descartado
- •Mandar a competência num formato só, "normalizado". Reprova num dos dois
endpoints, sempre. Foi o que fez o teste em produção falhar na primeira vez.
- •Guardar a sessão do TMS entre execuções. O token é de uso único; o salto
tem de ser refeito.
R$ 3,7 milhões aparecem como "não recebido" porque a data de baixa foi para a camada errada (03/11/2026)
A tela de fechamento mostrava R$ 4.862.072 "sem crédito identificado" na GEAP
— 13.666 guias, nenhuma com data de pagamento. Não é dinheiro sumido nem
operadora inadimplente: é um elo que o motor de conciliação não faz.
A cadeia, medida
| Fato | Número |
|---|---|
| Guias GEAP na conciliação | 13.666 |
…com dataPagamento | 0 |
Protocolos na camada de ANÁLISE com dataProtocolo (= Data Baixa) | 763 de 763 (100%) |
| Guias cujo protocolo casa com um desses | 13.665 (99,99%) |
Linhas em pagamento_por_data para a GEAP | 0 |
E a conta fecha: informado R$ 4.862.648,93 = liberado R$ 3.707.762,98 + glosa
R$ 1.154.885,95 — a glosa bate com a que a tela já mostrava.
Por que acontece
1. O relatório guias quitadas (relatorio_guia_quitada*.xlsx, 27 arquivos
ingeridos) é lido por guias-quitadas-xlsx.handler.ts, que o classifica como
DEMONSTRATIVO_ANALISE — e está certo quanto ao conteúdo de glosa: é a
fonte mais profunda do projeto, item a item, com justificativa própria.
2. Esse mesmo arquivo traz Data Baixa por protocolo. O handler a lê e a
grava como protocolDate — mas na camada de análise.
3. conciliacao-engine.service.ts:351 escreve dataPagamento a partir de
guiaPag.protocolo.pagamentoPorData.dataPagamento e só de lá. Sem
GuiaPagamento, a data nunca chega na guia.
4. O único documento de PAGAMENTO que a GEAP nos dá hoje é o **extrato
financeiro mensal** (39 arquivos JSON, 02/2023→09/2026, R$ 5.857.563,58), que
é depth: 'F' por natureza — fecha dinheiro do mês e não tem guia. O
próprio handler documenta isso: *"a conciliação por guia vem do relatório de
guias quitadas, que é outro arquivo"*. O arquivo chegou; a ponte não foi
construída.
O conserto
O relatório de guias quitadas tem tudo que a camada de pagamento precisa:
Protocolo, Protocolo TMS/Lote, Nº Guia, Valor Calculado e Data Baixa.
O caminho certo é o handler emitir também a camada de pagamento
(DemonstrativoPagamento → PagamentoPorData → ProtocoloPagamento →
GuiaPagamento) a partir das mesmas linhas, em vez de o motor passar a aceitar
data de análise como pagamento — misturar julgamento e pagamento é a separação
que o schema mantém de propósito.
"Quitada" é quitação. O nome do relatório já dizia onde o dado deveria
entrar, e ninguém leu o nome.
Pista separada, NÃO confirmada: Clinipam
A Clinipam (340782) também mostra 100% sem crédito (756 guias, R$ 256.530), mas
a causa é outra: ela tem 978 linhas em guias_pagamento e nenhum
protocolo dessas linhas casa com o das guias conciliadas. É problema de
casamento de chave, não de camada. Não investigado.
Consertado em 04/11/2026
guias-quitadas-xlsx.handler.ts agora emite **rich.payment além de
rich.analysis** — o contrato sempre permitiu os dois (*"Um documento, dois
fatos; separá-los em dois arquivos seria mentir sobre a origem"*), e o worker
distribui cada um no seu passe.
Duas decisões que valem saber:
- •Protocolo sem
Data Baixanão entra na camada de pagamento, e o leitor
avisa. Crédito sem data é crédito que a conciliação não consegue usar; gravá-lo
trocaria "não sei" por "sei errado". Hoje os 763 têm data.
- •O valor pago é
Valor Calculado, nãoValor Informado. O informado é o
que pedimos; a diferença entre os dois é exatamente a glosa. Medido:
4.862.648,93 informado = 3.707.762,98 calculado + 1.154.885,95 glosa.
depth: 'C' — desce até a guia, não até o item, porque a camada de pagamento não
tem item por construção.
O backfill dos 27 arquivos já ingeridos é `src/scripts/reprocessar-analises.ts
323080 --executar: o distribuidor apaga por inboxFileId` antes de recriar, e a
conciliação roda no fim do processamento, então repetir é seguro.