Ogmma Revenue
Voltar para a matriz

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

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.

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.xmlportal (telas, PDFs, APIs)
origem/tiss/process (TISS3 legado)prestadores.portosaude.com.br
nº de lote5022070 (7 dígitos)0021789058, LOTEAP19666626
nº de guia2666793 (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-details faz a ponte: ele devolve internal_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-invoices como 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)

dadofonteobservação
motivo da glosafrom-batch (JSON) e PDF de glosasJSON traz motivo com todos os valores zerados — {requested:0, glossed:0, released:0} em 352 ocorrências
valor glosado por itemsó o PDF de glosasúnica fonte item a item da operadora
valor por lotelist-batchesglossed_value é o número de conferência mais confiável que temos
valor por guiaPDF de pagamento (campos 48/49/50)profundidade de GUIA, sem código de procedimento
data do crédito, bancoPDF de pagamentofecha o ciclo do dinheiro
XML de envionão existeo 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 (10 e 0 produzem 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ÃO seguido 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 SANTANDER nã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 ISO 2026-01-16.
  • •Valores: ponto é decimal (R$ 179.65 é cento e setenta e nove).
  • •Zero às vezes sai R$ 0.00, às vezes R$ 0.

Rotas do portal — o que aprendemos apanhando

Base: https://wwws.portoseguro.com.br/go-saud-jdig-prestador-api/v1

rotachaveobservação
POST /demonstratives + input_ruleintervalo de dataslista os demonstrativos
POST /demonstratives + protocols:[{id}]id do Salesforcedevolve {name, data} com o PDF em base64. Mesma rota, chave diferente — foi o que fez o PDF parecer inacessível
GET /litigation/from-batchnúmero do protocolopassar o id do Salesforce devolve 500. Chave OPOSTA à de cima
POST /fetch-batch-detailsinternal_code + provider_codeo 403 que atribuímos a permissão era nome de parâmetro errado
GET /medical-invoicing/batch/list-batchesISO 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_PAYMENT aparece 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).

conectormétodousuárioestado medido
porto-saude-portalRPA/HTTPCPF 319.635.098-38login FALHA
porto-saude-soapwebservice00024911_WSfunciona

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 undefined e 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_profissional foi 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 browserresultado
GET /authorization/const/cbo?filter=clinic200
GET /authorization/const/516915/procedures?…200
POST /authorization/health-card200
GET /authorization/const/request-data?councilType=06&uf=SC&councilNumber=27285200

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

alvoresultado
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-prestador301 → /portal-prestador/ (é a entrada real, a que o fallback de browser usa)
https://wwws.portoseguro.com.br/go-saud-jdig-prestador-api/v1no ar, responde o login
https://www.saudeportomed.com.br/tiss3/services/4.01.00/*.asmx?wsdlWSDL OK (produção)
https://hml.portoseguro.com.br/tiss3/services/4.01.00/*.asmx?wsdlWSDL 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

rotamétodoobservação
/publicauth/loginPOST{username, password, recaptchaToken, recaptchaAction:"LOGIN"} — exige reCAPTCHA
/publicauth/refresh-tokenPOSTrenova sem captcha; o token dura 1h

Autorização — catálogos (tudo GET)

rotaparâmetrosdevolve
/authorization/const/initial-data—domínios iniciais da tela
/authorization/const/care-type—tipos de atendimento
/authorization/const/contracted-regimenlegacyCode, dataAtendimentoregimes do contrato do prestador (no Santa Isabel, só 2 - Atendimento Externo)
/authorization/const/cbofilter (≥2 chars){id, name} — id é o código CBO
/authorization/const/cidfilterCID-10
/authorization/const/{providerCode}/proceduresver abaixode-para pronto — ver abaixo
/authorization/const/list-medicinesmedicineNamemedicamentos
/authorization/const/request-dataparamsdados de uma solicitação
/authorization/const/pdforigem=Salesforce&id=PDF da autorização
/authorization/const/print-legacyauthorizationNumberimpressã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&regimeContratado=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)

rotacorpoobservação
/authorization/{providerCode}/sadtguia SP/SADT completacria a solicitação; header New-Index
/authorization/{providerCode}/elegibility-check{dados_gerais:{carteirinha_beneficiario, regime_atendimento, procedimento_…}, dados}elegibilidade
/authorization/{providerCode}/consultfiltrosconsulta eletiva; header New-Index
/authorization/{providerCode}/internacao / /hospitalizationguiainternaçã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}arquivoanexo
/authorization/const/intervalar-anexo—anexo intervalar
/authorization/sf/read-attachmentnomeArquivolê 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)

campovalores
tipo_atendimento01 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_autorizacao1 Autorização prévia · 2 Pelo prestador executante
regime_de_atendimentovem de contracted-regimen (Santa Isabel: só 2)
carater_do_atendimento1 Eletivo · 2 Urgência/Emergência
tipo_de_consulta1 Primeira · 2 Retorno · 3 Pré-natal · 4 Por encaminhamento · AUDITORIA · PREVENTIVA
indicador_de_acidente0 Trabalho · 1 Trânsito · 2 Outros · 9 Não acidente
conselho_profissional01 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-operator e resend-batch-to-operator merecem 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.

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