Ogmma Revenue
Voltar para a matriz

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. Implementa VALIDATE_CREDS, FETCH_ANALYSIS, FETCH_PAYMENT e
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

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 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 disabled e 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-icons como 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)

ÁreaItens
Faturamento TISSPortal TISS (upload de XML), Portal TISS - Recurso, Geração de Remessa - Guias Digitadas SISGEAP
Retorno / acompanhamentoRelatório de Guias, Relatório de Remessas, Relatório Recurso de Glosa, Acompanhamento de Guias, Auditoria Digital
FinanceiroExtrato Financeiro, Nota Fiscal
CadastroCadastro Prestador, Atualização Cadastral, Ficha Cadastral
PacienteConsultar Beneficiário
OutrosTUSS, 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:

DocumentoItem do menuDentro da tela
Análise de conta (item a item)Relatório de Guiastela "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_MS do 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âmetrosResultado
mes:6;ano:2021;somenteGlosadas:2relatorio_guia_quitada840986.xlsx — COM dados
mes:6;ano:2021;somenteGlosadas:0relatorio_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çãoDesfechoTempoO que trouxe
VALIDATE_CREDSSUCCESS32slogin OIDC
FETCH_ANALYSISSUCCESS~200s16.397 itens, 1.231 guias, 38 protocolos, 418 glosas de item
FETCH_PAYMENTSUCCESS24sextrato 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:

FonteValor
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çãoGuiasInformadoLiberadoGlosa
Conciliado automático1.017339.596,58339.596,58—
Glosa parcial11061.266,0256.647,374.618,65
Glosa total10426.930,710,0026.930,71
Soma1.231427.793,31396.243,9531.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 guias27
Meses com extrato financeiro39
Meses com planilha só de cabeçalho15
Meses que estouraram a transação3

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:

LinhaNº ItemNº ServiçoQtdValor Informado ItemValor Glosado ItemJustificativa
1140601269132,1932,191714
22406011966836,76836,761423
32406011966836,76836,761714
42406011966836,76836,761807

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:

antesdepois
Itens19.25919.203
InformadoR$ 485.199,86R$ 478.548,21
GlosaR$ 115.774,42R$ 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êsExtrato brutoRelatório de guias
06/2023R$ 123.220,05vazio
01/2025R$ 177.463,44vazio
02/2025R$ 156.319,24vazio
07/2025R$ 264.228,86vazio

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

OndeO que dáEstado
Relatório de Guiasitem a item, com valor glosado, código e grupo do motivojá automatizado (FETCH_ANALYSIS)
Acompanhamento de Guiasconsulta SÍNCRONA por Nº do Lote / Nº do Documento / Situaçãomedido, 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:

AnoGuiasSituaçãoGuias
20156Guia anexada à remessa215
20167Guia em edição16
201711Guia Devolvida13
20188Guia Cancelada3
201925
202083
202119
20229
20238
202471

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:

CampoObservaçã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 · Documentoremessa 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. SenhaNroGspContratado, 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 PrestadorObsPrestador, 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:

VezesTexto
87Conforme 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.
48Procedimento 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.
28Cobrado 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.
20Pedimos 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á

CaminhoRespostaO que é
/tiss/403.14pasta real, sem arquivo de serviço localizável
/elegibilidade/403.14pasta real
/elegibilidade/elegibilidade.asmx200serviç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ênciaItensGuiasProtocolosInformadoCalculadoGlosado
09/202616.3971.23138R$ 427.793,31R$ 396.243,95R$ 31.549,36 (418 itens)
06/20211.5091496R$ 31.652,70R$ 31.652,70R$ 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.

digitaTissTMS / True Auditoria
Endereçowww2.geap.org.br/digitaTissgeap.topsaude.com.br/PortalCredenciado
CaminhoSisgeap → Recurso de GlosaSisgeap → Portal TISS (SSO automático)
Recursoguia a guia, digitada à mãoConta / Evento × Múltiplas / Motivo de Glosa
Justificativa150 (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:

  • •ObterAjusteGlosas quer 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 11469672 desse lote não existe no nosso banco
  • •o motivo 1707 nã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_APPEAL no digitaTiss. Existe, mas é o caminho legado e exige

gerar remessa + enviar arquivo depois. O TMS executa direto.

  • •9/1/2026 sem 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
BuscarNrsParaRecursoremessas da competência que têm glosa
ObterAjusteGlosasmotivos de glosa daquela remessa
ListarRecursoItemos itens, com COD_TS_CONTA e COD_TS_ITEM
AtualizaDadosCheckum POST por item — marca, valoriza, justifica
SalvaRecursoGlosaa capa
ExecutaAberturaabre 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:

valorObterAjusteGlosasExecutaAbertura
9/1/2026 1 (o do portal)500 — DateTime não-anulável nulopassa 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 maxlength do editor da

grade. Não confundir com os 450 do digitaTiss: é outro sistema.

  • •SalvaRecursoGlosa sozinho 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

FatoNúmero
Guias GEAP na conciliação13.666
…com dataPagamento0
Protocolos na camada de ANÁLISE com dataProtocolo (= Data Baixa)763 de 763 (100%)
Guias cujo protocolo casa com um desses13.665 (99,99%)
Linhas em pagamento_por_data para a GEAP0

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 Baixa nã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ão Valor 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.

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