Porto Seguro — notas e observações
Conectores:porto-saude-portal(RPA/HTTP),porto-saude-soap(webservice)
Registro ANS: 000582 (Porto Seguro Saúde) · 417491 (Portomed)
Última revisão: 2026-10-20
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.
São DOIS sistemas, com numerações que não conversam
Este é o fato mais importante da Porto, e o que mais custou a descobrir.
comprovante .ret.xml | portal (telas, PDFs, APIs) | |
|---|---|---|
| origem | /tiss/process (TISS3 legado) | prestadores.portosaude.com.br |
| nº de lote | 5022070 (7 dígitos) | 0021789058, LOTEAP19666626 |
| nº de guia | 2666793 (7 dígitos) | 0018870795, GUIAAP24057917 |
Zero interseção entre os dois conjuntos. Medido em 22 guias do comprovante
contra 66 do portal: nenhum número em comum, nenhum lote em comum.
Consequência prática: o valor por item que vem do PDF de glosas não concilia
com o envio, porque a chave de conciliação inclui o número da guia. Não é
problema de de-para de procedimento — esse já está resolvido.
O que precisa ser checado
- ☐Perguntar à Porto qual campo do XML de envio gera o
guiaPrestador
que ela exibe no portal. Se ela ecoa o numeroGuiaPrestador enviado,
então o 2666793 do comprovante não é o que enviamos — e o defeito está
no que o TISS3 devolve, não na conciliação. Cabe no e-mail de
conectividade que ainda não foi enviado.
- ☐Medir se
fetch-batch-detailsfaz a ponte: ele devolveinternal_code
de 10 dígitos e os procedimentos do lote. Se esse código aparecer do
lado de 7 dígitos em algum campo, é o de-para que falta.
O que já foi descartado como ponte
- •Carteirinha. O envio guarda 16 dígitos e o PDF 14, e em parte dos casos o
PDF é prefixo do envio (48811174000004 → 4881117400000422). Mas só 5 de 12
casam, e 42 das 55 guias do lado da análise não têm carteira nenhuma.
- •
list-invoicescomo fonte de envio. Cobre 4 de 27 guias, nenhum lote
LOTEAP*, e — decisivo — 0 de 66 guias trazem itens. Não serve para
conciliação item a item.
- •(data + código + valor). Em exames de rotina o mesmo trio se repete entre
pacientes no mesmo dia. Match errado é pior que nenhum: vira glosa atribuída
ao paciente errado.
O resumo dos documentos não é confiável — vale o detalhe
Aparece nos dois demonstrativos, e sempre na mesma direção: o cabeçalho
erra, o detalhe acerta.
Demonstrativo de glosas, lote LOTEAP19929232:
cabeçalho "VALOR DE GLOSAS" 48,78
soma dos itens 57,54 ← confere com list-batches
Demonstrativo de pagamento, mesmo lote:
campo 19/20 (resumo) liberado 167,93 glosa 48,78
soma dos campos 49/50 liberado 159,17 glosa 57,54 ← confere
Os dois parsers publicam a soma do detalhe e guardam o declarado em
meta.extra como conferência, emitindo TOTAL_MISMATCH quando divergem.
Não "conserte" isso trocando para o valor do cabeçalho. Ele é o errado.
Onde cada informação existe (e onde NÃO existe)
| dado | fonte | observação |
|---|---|---|
| motivo da glosa | from-batch (JSON) e PDF de glosas | JSON traz motivo com todos os valores zerados — {requested:0, glossed:0, released:0} em 352 ocorrências |
| valor glosado por item | só o PDF de glosas | única fonte item a item da operadora |
| valor por lote | list-batches | glossed_value é o número de conferência mais confiável que temos |
| valor por guia | PDF de pagamento (campos 48/49/50) | profundidade de GUIA, sem código de procedimento |
| data do crédito, banco | PDF de pagamento | fecha o ciclo do dinheiro |
| XML de envio | não existe | o portal nomeia o arquivo, nenhuma rota o serve. O .ret.xml é o comprovante de recebimento, não o envio |
Armadilhas de leitura já pagas
Todas foram encontradas rodando contra os 22 lotes, não contra um PDF.
Um arquivo passando não é evidência.
PDF de glosas — o texto chega sem colunas
pdf-parse cola as células: 04/12/202528050720TIROXINA…R$ 24.82R$ 0.0010.
- •Os valores saem da linha
Total da Guia, não da linha do item. É a única
sem quantidade grudada. Na linha do item, R$ 4.38R$ 010 é R$ 0 de glosa com
as quantidades 1 e 0 coladas — lia-se R$ 10,00, e eram 11 itens assim num
único lote: R$ 110,00 de glosa inventada.
- •A quantidade não é lida, de propósito. É ambígua (
10e0produzem o
mesmo 100) e contraditória (item glosado sai com Qtd Informada 0).
- •O motivo vem na linha abaixo do nome do exame, só quando há glosa.
- •**Lote sem glosa traz o bloco
CARTÃOseguido direto do cabeçalho das
colunas**, sem linha de beneficiário. 15 dos 22 lotes. Isso é corpo vazio,
não falha.
PDF de pagamento — leiaute ANS de campos numerados
Bem mais dócil: pares NN - Rótulo / valor. Mas:
- •
0033 - BANCO SANTANDERnão é um campo. Já virou o "campo 33", inventado
e sobrescrevendo o seguinte. O número do campo tem no máximo 3 dígitos.
- •Rótulos colam quando o valor é vazio:
46 - Senha47 - Tipo de Pagamento
numa linha só, em todos os blocos de guia dos 22 lotes.
- •Títulos de seção vazam para o valor se não terminarem a leitura — o CNES
saía como "2522144 DADOS PAGAMENTO".
- •Lote não pago traz o bloco de guia inteiro vazio, com todos os rótulos
colados. Ausência de dado, não leiaute mudado.
Formatos que divergem dentro da mesma operadora
- •Datas: PDF de glosas usa
dd/mm/aaaa; PDF de pagamento usa ISO2026-01-16. - •Valores: ponto é decimal (
R$ 179.65é cento e setenta e nove). - •Zero às vezes sai
R$ 0.00, às vezesR$ 0.
Rotas do portal — o que aprendemos apanhando
Base: https://wwws.portoseguro.com.br/go-saud-jdig-prestador-api/v1
| rota | chave | observação |
|---|---|---|
POST /demonstratives + input_rule | intervalo de datas | lista os demonstrativos |
POST /demonstratives + protocols:[{id}] | id do Salesforce | devolve {name, data} com o PDF em base64. Mesma rota, chave diferente — foi o que fez o PDF parecer inacessível |
GET /litigation/from-batch | número do protocolo | passar o id do Salesforce devolve 500. Chave OPOSTA à de cima |
POST /fetch-batch-details | internal_code + provider_code | o 403 que atribuímos a permissão era nome de parâmetro errado |
GET /medical-invoicing/batch/list-batches | ISO completo (.000Z) | data em dd/mm/aaaa devolve lista vazia sem erro |
POST /medical-invoicing/demonstrative/account-analysis | — | inútil: devolve o formulário da ANS em branco, mesmo sha256 para qualquer entrada, inclusive corpo vazio |
Login: uma sessão por vez, sempre
O portal bloqueia após 5 tentativas. fetchReturns dispara listarLotes e
listarGuias num Promise.all; sem deduplicação de login os dois logavam
juntos, o segundo invalidava o token do primeiro (a API respondia **200 com uma
string** no lugar do array) e gastavam 2 das 5 tentativas por sync.
Já corrigido em garantirSessao, com teste que falha sem o conserto. **Não
remova essa guarda.**
Estado da conciliação (2026-08-01)
guias de conciliação 27 integral 14 · glosa 13 (R$ 981,72)
itens 342 GLOSA_PARCIAL 124 · SEM_MATCH_ENVIO 218
de-para de procedimento 87 cobertura total dos códigos do retorno
Os 124 pareados vêm do from-batch, cujas guias usam a numeração de 7 dígitos e
sempre casaram. Os 218 sem par vêm do PDF — trouxeram valor real, com um
identificador de guia que o envio não conhece. É o problema do topo desta nota.
Dívida técnica conhecida
- ☐288 chaves de conciliação foram reescritas por script direto no banco
quando o de-para foi completado. Funcionou e é reversível (a chave é
derivada), mas o certo é o distribuidor gravá-la já canônica na ingestão.
Itens novos já nascem certos.
- ☐17 lotes sem XML poderiam ser importados via
fetch-batch-details
(21 de 22 respondem, ~879 itens).
- ☐
FETCH_PAYMENTaparece como IMPLEMENTADO na matriz, não PRODUÇÃO: o selo
verde vem do histórico de execuções e a operação só rodou por script, fora
do executor. Fica verde no primeiro sync agendado.
Estado das credenciais (medido em 20/10/2026)
Duas conexões em produção, as duas do Laboratório Santa Isabel, as duas com
autoSyncEnabled = false (nada roda sozinho — e é o que impede o portal de
queimar as 5 tentativas em retry).
| conector | método | usuário | estado medido |
|---|---|---|---|
porto-saude-portal | RPA/HTTP | CPF 319.635.098-38 | login FALHA |
porto-saude-soap | webservice | 00024911_WS | funciona |
Prestador: código 00024911, CNPJ 04540010000170, registro ANS 000582.
O nomeContratado já está preenchido na conexão SOAP
(LABORATORIO SANTA ISABEL DE ANALISES CLINICAS LTDA) — o CONEXAO_INCOMPLETA
da solicitação de autorização, registrado em 28/09, não vale mais.
A senha do portal morreu — e o conector não percebe
POST /publicauth/login com a credencial guardada responde hoje:
HTTP 222
{"message":"Não foi possível efetuar o login"}
222 é 2xx. fetch().ok é verdadeiro, o if (!resp.ok) de login() não
dispara, e a sessão é montada com token: undefined. Consequências medidas:
- •
validateCredentials()devolve `{valid: true, 'Autenticado no portal da
Porto Saude'}` — sem perfil, porque não veio nenhum. É por isso que o banco
ainda diz credentialStatus = VALID (última checagem 30/07/2026).
- •As chamadas seguintes saem com
Authorization: Bearer undefinede falham
longe da causa — a mesma família do "200 com uma string" já documentada aqui.
**O conserto é no login(): tratar resposta sem access_token como falha de
autenticação, não só !resp.ok.** Status fora de 200 não serve de guarda nesta
operadora.
A senha NÃO caiu. Medido no mesmo dia: a credencial guardada é byte a byte a
que entra no portal pelo browser. O que mudou foi o login:
{"username":"...","password":"...","recaptchaToken":"0cAFcWeA7eHz…","recaptchaAction":"LOGIN"}
POST /publicauth/login agora exige reCAPTCHA Enterprise no corpo. Sem o
token, a resposta é o 222 acima — a mensagem genérica esconde que o problema é
o captcha, não a senha.
Consequência para o conector: o caminho HTTP direto não loga mais sozinho.
O token só existe com o JS da página executando (grecaptcha.enterprise.execute
com a action LOGIN), então o login passa obrigatoriamente pelo browser do
fallback; depois disso o Bearer serve para as chamadas HTTP normais. Some-se a
isso o reese84 (Imperva ADR) em cookie e localStorage, que o host da API
também avalia.
Primeira solicitação de autorização real (20/10/2026)
Guia 404481722026, beneficiária da carteirinha 48811174000004,
hemograma 28040481, pelo portal (não pelo webservice). Resultado: Negado,
por 1612 Serviço não pode ser realizado no local especificado +
1214 Credenciado não habilitado a realizar o procedimento. Ou seja: o
caminho técnico funciona ponta a ponta; a negativa é de credenciamento, não
de formato.
Dois efeitos colaterais que valem saber antes de repetir:
- •O CRM informado não existia na base da Porto, e **concluir criou um cadastro
novo de profissional lá** (o portal avisa, mas segue).
- •O
nome_profissionalfoi enviado duplicado ("LIDIA FERRAZLIDIA FERRAZ")
porque o campo foi limpo no DOM sem limpar o estado do formulário e o texto
novo concatenou. O portal não validou isso. Em RPA, **limpar campo é
fill(''), nunca el.value = ''** — o React mantém o valor antigo.
Quanto de browser o conector precisa (medido, 20/10/2026)
Só o login. Token obtido no browser de uma máquina, usado por curl de
dentro do container de produção em outra:
| chamada do EC2, com o Bearer do browser | resultado |
|---|---|
GET /authorization/const/cbo?filter=clinic | 200 |
GET /authorization/const/516915/procedures?… | 200 |
POST /authorization/health-card | 200 |
GET /authorization/const/request-data?councilType=06&uf=SC&councilNumber=27285 | 200 |
Sem browser, sem cookie reese84, sem headers de anti-bot além de
Origin/Referer. O Imperva protege o portal; o host da API só quer o
Bearer. Ou seja: o desenho do PortoPortalApiClient continua certo — o que
mudou é que login() não pode mais ser um POST direto.
Desenho que decorre disso:
1. browser headless abre o portal, faz login (o JS da página gera o
recaptchaToken com action LOGIN), e devolve access_token + refresh_token;
2. todo o resto — catálogos, health-card, /sadt, faturamento — é HTTP puro,
com o Bearer, de onde for;
3. o access_token dura 1h (expires_in: 3600).
refresh-token dispensa o captcha (medido 20/10, do EC2):
POST /publicauth/refresh-token
{"user_id":79422,"provider_code":"516915","refresh_token":"…","user_stats":{}}
→ 200 {"access_token":"…"} e o token novo chama a API normalmente
user_stats aceita {} — a SPA manda telemetria de dispositivo ali.
Por isso garantirSessao tenta renovar ANTES de subir browser: cada login
gasta uma das 5 tentativas. Quanto dura o refresh_token continua sem medida,
então a falha dele é caminho normal no código, não erro.
A armadilha do patchright: evaluate não vê window.grecaptcha
Custou um deploy. A primeira versão gerava o token ela mesma, com
grecaptcha.enterprise.execute dentro de page.evaluate — funciona num
Chrome comum e falha no nosso: o patchright roda evaluate em contexto
isolado, e de lá o window da página principal não existe.
O sintoma engana: medido no container, a página abre, o Imperva emite cookie,
enterprise.js baixa e executa, o formulário está lá — e mesmo assim
typeof window.grecaptcha é "undefined". O erro que chega é
"grecaptcha.enterprise ausente", que parece bloqueio de WAF e não é.
Quem gera o token é a própria SPA. Preenchemos o formulário e
CAPTURAMOS a resposta do POST /publicauth/login — o mesmo padrão que
portal-rpa.fallback.ts já usava nas telas de faturamento. Vale para
qualquer coisa que dependa de objeto global da página: no patchright, não
tente alcançá-lo pelo evaluate.
Estado depois da correção (deploy dbb8365, 20/10/2026)
validateCredentials rodando pelo conector dentro da produção:
{"valid":true,"message":"Autenticado como LAB SANTA ISABEL DE ANALISESCLINICAS S/S LTDA (codigo 00024911)"}
sessao: userId=79422 providerCode=516915 refresh=3680 chars
apos renovar: token mudou=true | lotes recebidos=0
Links conferidos no mesmo dia
| alvo | resultado |
|---|---|
https://prestadores.portosaude.com.br (raiz) | 404 — não é entrada de nada; o portalUrl gravado na conexão é só rótulo |
https://prestadores.portosaude.com.br/portal-prestador | 301 → /portal-prestador/ (é a entrada real, a que o fallback de browser usa) |
https://wwws.portoseguro.com.br/go-saud-jdig-prestador-api/v1 | no ar, responde o login |
https://www.saudeportomed.com.br/tiss3/services/4.01.00/*.asmx?wsdl | WSDL OK (produção) |
https://hml.portoseguro.com.br/tiss3/services/4.01.00/*.asmx?wsdl | WSDL OK (homologação) |
Mapa da API do portal (medido em 20/10/2026, navegando o portal)
Base: https://wwws.portoseguro.com.br/go-saud-jdig-prestador-api/v1
Cabeçalhos: Authorization: Bearer <access_token>, Origin/Referer do portal,
e New-Index: 0|1 nas rotas de autorização (ver abaixo).
Limite medido na resposta: x-ratelimit-limit: 50, x-ratelimit-reset: 30 —
são as 50 requisições a cada 30s que o conector já respeita.
Dois códigos de prestador, e eles NÃO são intercambiáveis
O perfil devolvido no login traz legacy_code e provider_code. A SPA usa:
- •
provider_code→ no path do POST de solicitação; - •
legacy_code(00024911) → no corpo (legacyCode) e nas rotas de consulta
de catálogo e de regime.
Trocar um pelo outro é o tipo de erro que volta como 403/500 sem dizer o motivo.
Autenticação
| rota | método | observação |
|---|---|---|
/publicauth/login | POST | {username, password, recaptchaToken, recaptchaAction:"LOGIN"} — exige reCAPTCHA |
/publicauth/refresh-token | POST | renova sem captcha; o token dura 1h |
Autorização — catálogos (tudo GET)
| rota | parâmetros | devolve |
|---|---|---|
/authorization/const/initial-data | — | domínios iniciais da tela |
/authorization/const/care-type | — | tipos de atendimento |
/authorization/const/contracted-regimen | legacyCode, dataAtendimento | regimes do contrato do prestador (no Santa Isabel, só 2 - Atendimento Externo) |
/authorization/const/cbo | filter (≥2 chars) | {id, name} — id é o código CBO |
/authorization/const/cid | filter | CID-10 |
/authorization/const/{providerCode}/procedures | ver abaixo | de-para pronto — ver abaixo |
/authorization/const/list-medicines | medicineName | medicamentos |
/authorization/const/request-data | params | dados de uma solicitação |
/authorization/const/pdf | origem=Salesforce&id= | PDF da autorização |
/authorization/const/print-legacy | authorizationNumber | impressão do legado |
/authorization/provider/credential | {campo}={valor} | credencial do prestador |
#### O de-para operadora↔TUSS existe pronto na API
GET /authorization/const/516915/procedures?filter=hemograma:
[{"codigoEvento":"28040481","codigoTuss":"40304361","codigoEventoApresentado":"40304361",
"descricao":"HEMOGRAMA COM CONTAGEM DE PLAQUETAS OU FRAÇÕES (…)","tabelaPreco":22,
"isRadio":false,"isQuimio":false,"isPackage":false,
"isObrigatorioAnexo":false,"isEventoSeriado":false}]
codigoEvento é o código interno da Porto (o de 8 dígitos que aparece nos
demonstrativos); codigoTuss é o da ANS. **Os 87 pares do de-para montados à
mão saem daqui**, e as flags (isQuimio, isRadio, isObrigatorioAnexo,
isEventoSeriado) dizem de antemão qual formulário extra a guia vai exigir.
O path aceita o legacy_code (00024911) e responde 200, mas **a SPA usa o
provider_code (516915) com o conjunto completo de parâmetros** — e é essa
chamada que filtra por contrato, plano e CBO:
?filter=hemograma&codigoOperadora=<id Salesforce do beneficiário>&modulo=
&dataAtendimento=2026-10-20®imeContratado=2&tipoFormulario=&tipoEvento=
&planCode=&convenio=Porto+Saúde&processo=1&cbo=225125
Chamar pelo legacy_code sem esses parâmetros devolve o catálogo cru. Não é a
mesma pergunta, ainda que as duas respondam 200.
#### request-data é a busca do profissional — e 214 significa "não achei"
GET /authorization/const/request-data?councilType=06&uf=SC&councilNumber=27285
devolveu HTTP 214 para um CRM que a Porto não conhece, e a tela então
oferece criar o cadastro. É a mesma armadilha do 222 do login: 2xx que
quer dizer falha. Qualquer cliente que teste só resp.ok vai achar que achou
o profissional.
Autorização — operações (POST)
| rota | corpo | observação |
|---|---|---|
/authorization/{providerCode}/sadt | guia SP/SADT completa | cria a solicitação; header New-Index |
/authorization/{providerCode}/elegibility-check | {dados_gerais:{carteirinha_beneficiario, regime_atendimento, procedimento_…}, dados} | elegibilidade |
/authorization/{providerCode}/consult | filtros | consulta eletiva; header New-Index |
/authorization/{providerCode}/internacao / /hospitalization | guia | internação |
/authorization/health-card | {cpf, carteirinha} | busca do beneficiário |
/authorization/validate-hospitalization | {carteirinha, …} | valida internação |
/authorization/update-status | — | atualiza status |
/authorization/add-attachment/{id} | arquivo | anexo |
/authorization/const/intervalar-anexo | — | anexo intervalar |
/authorization/sf/read-attachment | nomeArquivo | lê anexo do Salesforce |
/authorization/list-xml/{id} | — | XML da guia |
New-Index vem de initial-data: é "1" quando o tipo de código 29 está
qualified, "0" caso contrário. Não é constante — ler, não chutar.
#### Busca do beneficiário
POST /authorization/health-card com {"cpf":"","carteirinha":"48811174000004"}
devolve health_cards[] com codigoOperadora/codigo (id Salesforce),
ansOperadora, contrato, tipoDependente, dataNascimento, nomePlano,
tipoAcomodacao, situacaoCartao, dataEmissaoCartao e nomeANS (o nome do
beneficiário vem em nomeANS — o campo nome vem vazio).
#### Corpo do POST /sadt — medido em envio real (20/10/2026)
POST /authorization/516915/sadt (o path leva o provider_code):
{
"beneficiario": { "carteirinha": "48811174000004", "uuid": "", "cpf": "…", "ansOperadora": "000582" },
"dados_atendimento": {
"data_atendimento": "2026-10-20", "data_solicitacao": "2026-10-20", "data_autorizacao": "2026-10-20",
"beneficiario_internado": false, "atendimento_recem_nascido": false,
"numero_guia_principal": "", // obrigatório SE beneficiario_internado = true
"tipo_atendimento": "05", "etapa_da_autorizacao": "2",
"regime_de_atendimento": "2", "regime_contratado": "",
"carater_do_atendimento": "1", "tipo_de_consulta": "4",
"indicador_de_acidente": "9", "opme": false
},
"dados_solicitante": {
"codigo_operadora": "516915", // provider_code, NÃO o legacy_code
"conselho_profissional": "06", "numero_conselho": "27285",
"nome_profissional": "…", "uf": "SC",
"cbo": "Médico clínico", "codigo_cbo": "225125",
"executante_diferente_solicitante": false, "phone": "", "email": ""
},
"procedimentos": [{
"codigo": "28040481", "quantidade": 1,
"name": "HEMOGRAMA COM CONTAGEM DE PLAQUETAS OU FRAÇÕES (…)",
"tabelaPreco": 22, "tipoValores": "",
"isObrigatorioAnexo": false, "isRadio": false, "isQuimio": false, "isEventoSeriado": false
}],
"cids": [], "observacao_clinica": "", "indicacao_clinica": "", "anexos": [],
"handleBeneficiario": "", // veio VAZIO e o envio passou
"legacyCode": "00024911", // legacy_code no corpo
"cancelPreviousClaim": ""
}
Repare: o procedimento vai com o objeto inteiro do catálogo, não só
{codigo, quantidade} — a validação da tela exige esses dois, mas o que sai
na rede é o item como veio de /procedures.
#### Resposta do /sadt — 200 não quer dizer autorizado
{
"autorizacao": {
"autorizado": false, "status": "3",
"codigo_autorizacao": "404481722026", "claimCode": "404481722026",
"claimId": "a2wU600000OuA3hIAF",
"procedimentos": [{
"codigo_procedimento": "28040481", "status": "Negado",
"quantidade_solicitada": 1, "quantidade_liberada": 0,
"motivos_negacao": [
{ "motivo": "1612 Serviço não pode ser realizado no local especificado" },
{ "motivo": "1214 Credenciado não habilitado a realizar o procedimento" }
]
}]
},
"additional-infos": { "solicitacao_duplicada": false, "evento_duplicado": false, "Procedimentos": [{ "Status": "Negado", "codigoProcedimento": "28040481" }] },
"regime": "2", "autorizacao_criada": true,
"codigo_autorizacao": "404481722026", "data_verificacao": "2026-10-20",
"pdf": "", "id_sf_autorizacao": ""
}
autorizacao_criada: true com autorizado: false é o caso normal de negativa
— a guia existe, com número, e está negada. O conector precisa ler
autorizacao.autorizado e procedimentos[].status, nunca o HTTP.
solicitacao_duplicada / evento_duplicado dizem quando a Porto reconheceu
reenvio — útil para idempotência.
#### Domínios da guia SP/SADT (valores aceitos pela tela)
| campo | valores |
|---|---|
tipo_atendimento | 01 Remoção · 02 Pequena Cirurgia · 03 Outras Terapias · 04 Consulta · 05 Exame Ambulatorial · 08 Quimioterapia · 09 Radioterapia · 10 TRS · 13 Pequeno atendimento · 22 Telessaúde · 23 Exame |
etapa_da_autorizacao | 1 Autorização prévia · 2 Pelo prestador executante |
regime_de_atendimento | vem de contracted-regimen (Santa Isabel: só 2) |
carater_do_atendimento | 1 Eletivo · 2 Urgência/Emergência |
tipo_de_consulta | 1 Primeira · 2 Retorno · 3 Pré-natal · 4 Por encaminhamento · AUDITORIA · PREVENTIVA |
indicador_de_acidente | 0 Trabalho · 1 Trânsito · 2 Outros · 9 Não acidente |
conselho_profissional | 01 CRESS · 02 COREN · 03 CRF · 04 CREFONO · 05 CREFITO · 06 CRM · 07 CRN · 08 CRO · 09 CRP · 10 Outros · 11 CRBio · 12 CRBM · 13 CREF · 14 CRMV · 15 CRTR |
Faturamento (mesmo host, já parcialmente usado pelo conector)
/medical-invoicing/: batch/create, batch/list-batches, batch/cancel-drafted,
batch/remove-invoices, batch/list-attachment/{id}, list-invoices,
list-pre-invoices, list-invoice-items, list-beneficiary, invoice/{id},
fetch-invoice-pdf/{id}, post-commercial-invoice, update-invoice-status,
send-batch-to-operator, resend-batch-to-operator, professional/requesting.
send-batch-to-operatoreresend-batch-to-operatormerecem medição: se
transmitirem lote, o portal faz o que a nota de envio diz que só a importação
manual faz. Não afirmar nada sobre elas antes de medir.
Autorização pelo webservice (TISS 4.01.00) — estado em 28/09/2026
- •Elegibilidade pelo webservice já rodou em produção (Laboratório Santa Isabel).
Solicitação, consulta de situação e cancelamento nunca rodaram.
- •O XML dos três passa no XSD 4.01.00 oficial (teste de contrato
autorizacao-xsd.contrato.test.ts). O cancelamento NÃO passava: mandava só a
guia da operadora, e o XSD exige numeroGuiaPrestador — corrigido.
- •A solicitação exige "Nome do contratado" na conexão (vai no
contratadoSolicitante); a conexão do Santa Isabel não tem. Sem ele, o pedido
falha antes de sair (CONEXAO_INCOMPLETA).
- •Senha em MD5 hex minúsculo (a Unimed usa maiúsculo).
O que ainda precisa ser checado
- ☐Primeira solicitação real: formato da resposta, senha, número da guia.
- ☐Se a Porto localiza o cancelamento pela guia do prestador ou da operadora (vão as duas).
Segurança
- •Credenciais só em
/home/ubuntu/ogmma-revenue/.env.production(chmod 600).
Nunca commitadas, nunca em script versionado.
- •Todo trabalho contra o portal roda dentro do container de produção, para
que a credencial não saia do servidor.
- •PHI: os PDFs contêm nome de beneficiário e carteirinha.
docs/unimed/e
docs/tiss/ são gitignored; amostras aqui são anonimizadas ou mascaradas.
- •A senha do portal está pendente de rotação desde que foi colada em sessão.
Em 20/10/2026 ela já não autentica — ver "Estado das credenciais" acima.
31/10/2026 — impressão de guia: menu varrido sem achar, grade não exercida
PRINT_GUIDE segue naoSuportadas, e a declaração diz exatamente até onde se
mediu.
O menu Autorização, inteiro (sessão real do Santa Isabel, prestador
00024911):
Verificação de Elegibilidade · Consulta Eletiva · SP/SADT · Internação ·
Prorrogação · Pesquisar Solicitações · Condicionamento · Lote Anexo ·
Consultar Plano · Home Care · Remoção · Quimioterapia - Alteração de Data ·
Prazos de Análise
Nenhum item de impressão ou 2ª via. Os três do topo são Página Inicial,
Autorização (/portal-prestador/autorizacao) e Faturamento.
Os chunks públicos do Next.js (54 arquivos, 3,9 MB, baixados do
index.html) não têm feature de impressão: as 8 ocorrências de print são
@media print de CSS, há um ícone printer da biblioteca de ícones e uma
lista de senhas comuns com a palavra "printer" dentro. Os PDFs que aparecem são
os manuais (docs/Ajuda-Portal.pdf, manuais_finais/*.pdf) e um helper
genérico data:application/pdf;base64 usado pelo visualizador. Vale como
pista, não como prova — o portal é App Router e carrega o chunk de cada rota
só quando navega, então as telas autenticadas não estão nesses arquivos.
O que FALTA, nomeado: a tela Autorização tem o painel *"Acompanhe o
status de suas solicitações"* com filtros (Data Inicial, Data Final, Nº Guia
Prestador, Autorização, Carteirinha, Tipo Solicitação, Status da Solicitação) e
o botão Aplicar, limitado a 100 resultados. A **grade de resultado não foi
exercida**: os campos de data são MUI e não aceitaram preenchimento pela sonda
em quatro tentativas (value = não sobrevive ao render do React; os ids são
#_r_h_, #_r_i_, #_r_j_, autogerados e instáveis). As ações POR LINHA do
resultado seguem sem ninguém olhar — e é ali que um "imprimir" estaria.
Cuidado ao retomar: 5 tentativas de login malsucedidas bloqueiam, com 5
minutos de intervalo mínimo (Manual TISS da operadora). O login funcionou de
primeira nas quatro passadas de hoje, com pressSequentially (campo MUI não
habilita o botão com fill()).
Recurso de glosa: o portal TEM, e a matriz dizia que não (medido 02/11/2026)
A linha "Recurso de glosa | não medido" desta nota era honesta; o que o
conector declarava não era. Ele dizia *"Recurso de glosa é feito pelo
webservice"* — uma afirmação sobre a operadora que ninguém tinha verificado,
e que é falsa. O portal tem a tela inteira.
Onde fica
Faturamento → Acompanhamento → Recursos
/portal-prestador/faturamento/acompanhamento/recurso-glosa ← lista
└ Visualizar Recurso
/portal-prestador/faturamento/recurso-glosa/solicitar/appeal
A tela se chama "Solicitar Recurso de Glosa" — é criação, não só consulta.
A API, que é REST e já é a mesma que o conector usa
Base https://wwws.portoseguro.com.br/go-saud-jdig-prestador-api/v1
(a mesma de /litigation/from-batch), namespace litigation/disallowance_appeals:
GET /litigation/disallowance_appeals/search
?provider=&peg=&status=&receipt_date=
&start_payment_date=&end_payment_date=&resource_number=
&daysLeft=0&totalAmount=0&litigatedAmount=0
GET /litigation/disallowance_appeals/info?disallowance_number=a2wU600000HSVDcIAP
O disallowance_number é id de Salesforce (a2wU600000HSVDcIAP), não o
protocolo que a tela mostra. Não dá para chamar essa API do navegador: CORS
recusa a partir de prestadores.portosaude.com.br. O conector chama direto,
com o bearer de /publicauth/login, como já faz nas outras rotas.
Regras do formulário, que a própria tela declara
- •Guia/item com mais de uma glosa aparece mais de uma vez, uma por glosa.
- •O formulário traz TODAS as glosas do protocolo de faturamento.
- •O prestador deve justificar TODAS as glosas de um item — não dá para
recursar uma glosa e ignorar a outra do mesmo item.
- •Os valores exibidos não correspondem ao demonstrativo e servem só de guia
durante o preenchimento. A tela diz isso com todas as letras.
- •O valor recursado final não é a soma do que aparece: há cálculo interno
que considera sobreposição de glosas. Conferir nosso total contra o da tela
vai divergir por desenho.
- •Anexo: 4 MB por documento.
- •O recurso é agrupado por motivo de glosa (acordeões
1817,1714…) —
mesmo modelo do TMS da GEAP e do compositor do Miydas.
O que impede implementar o envio hoje
O cabeçalho traz "Dias restantes", e o único recurso da conta do Santa
Isabel (protocolo de recurso 0022923843, faturamento 0018870785, R$ 273,37,
pagamento 08/07/2026) está Expirado e com status "Não Enviado" — ou
seja, alguém montou e nunca enviou, e agora não dá mais.
Sem protocolo dentro do prazo não há como capturar o POST de envio, e inventar
o payload mandaria recurso errado para a operadora. O que destrava: um
protocolo de faturamento com glosa e prazo correndo.
Repare no desperdício que a tela denuncia: um recurso pronto, de R$ 273,37,
que expirou sem ser enviado. É exatamente o buraco que o Miydas fecha.