CadBenef Online - Configuração

CONTEÚDO

Visão Geral
Exemplo de Utilização
1. Configuração de Dados de Integração
2. Compartilhamento de Risco
Tabelas utilizadas

01. VISÃO GERAL

Para configurar o CadBenef Online no sistema Plano de Saúde (Protheus), siga os passos abaixo:

02. EXEMPLO DE UTILIZAÇÃO

Configuração de Dados de Integração

Acesse o menu Operadora de Saúde (Rotina PLSA010) e selecione o código da Unimed do seu sistema.

Preencha os seguintes campos conforme a descrição:

URL Token: Endpoint de homologação/produção disponibilizado pela Unimed Brasil para autenticação.
Exemplo: https://gateway-hml2.unimed.coop.br/oauth/v1/access-token
(Campo: BA0_UBURL)
ID Token: Client ID previamente solicitado à Unimed Brasil.
(Campo: BA0_UBCLID)
Secret Token: Secret ID previamente solicitado à Unimed Brasil.
(Campo: BA0_UBCLSC)
URL CadBenef: Endpoint de homologação/produção do CadBenef-Online.
Exemplo: https://gateway-hml2.unimed.coop.br/cadbenef-online/v1/beneficiarios
(Campo: BA0_CDBURL)
URL Vld.Tok.: Endpoint para validação do token na API do compartilhamento de risco.
Exemplo: https://autenticacaoreversahml.unimed.coop.br/api/token
(Campo: BA0_URLVTK)
PFX CadBenef: Nome do certificado com extensão.
(Campo: BA0_CDBPFX)
Pass CadBen.: Senha para abertura da chave privada do certificado. Caso a chave não possua senha, informe uma string vazia.
(Campo: BA0_CDBPAS)

Certificado Digital

A Unimed Brasil exige o uso de certificados digitais do tipo ICP-Brasil, que garantem identificação segura em mensagens ou transações.

Após obter o certificado no formato .PFX (padrão IIS - Internet Information Services), adicione-o no servidor do Protheus no seguinte caminho:

`\cadbenef\certificados\meu_certificado.pfx`

Caso precise alterar o diretório padrão do certificado, utilize o parâmetro (SX6) MV_PLCBCER.

Compartilhamento de Risco

Foi disponibilizada uma nova API para receber as movimentações de compartilhamento de risco.

A Unimed Brasil utilizará essa API para enviar as informações de beneficiários nos regimes de pré-pagamento (repasse) ou pós-pagamento (custo operacional). Para ativar, abra um chamado informando o seguinte endpoint:

Endpoint

https://<url>:<porta>/totvsHealthPlans/unimed/cadbenef-online/v1

A API valida a autenticação via Unimed Brasil, utilizando o bearer token ou o cookie gerado pela API de token do GIU. O sistema verifica se os dados estão corretos antes de autorizar o acesso.

Autenticação

A Unimed Brasil não realiza autenticação específica por fornecedor, o que exige a utilização da autenticação padrão do Protheus. A partir da release 12.1.2410, não será mais possível desativar a segurança do AppServer, tornando obrigatória a configuração adequada da API para permitir o acesso.

Para que a API funcione sem a autenticação nativa do Protheus, é necessário desativar a segurança apenas no endpoint da API, garantindo o funcionamento correto:

Public=totvsHealthPlans/unimed/cadbenef-online/v1/beneficiarios/compartilhamento-riscos

Configuração - Seções URIs - Framework

Configurações de Pré-Pagamento (Repasse)

Se a Unimed opera com regime de pré-pagamento, configure:

Ativar repasse:
Configure o parâmetro MV_PLCBREP com o valor .T..
Dados do contrato:
Preencha o parâmetro MV_PLCBEMP com as informações do contrato no seguinte formato:
codigoEmpresa-numeroContrato-versaoContrato-subcontrato-versaoSubcontrato-produto-versaoProduto
Exemplo: 1008-000000000001-001-000000003-001-0001-001
- Código da Empresa: 1008
- Contrato: 000000000001
- Versão do Contrato: 001
- Subcontrato: 000000003
- Versão do Subcontrato: 001
- Produto: 0001
- Versão do Produto: 001

Customização

Caso seja necessário definir em qual contrato os beneficiários de repasse serão cadastrados ao receber a requisição, utilize o ponto de entrada: PE PTU001EMP Empresa/Contrato do Beneficiário de Repasse - CadBenef Online.

02. TABELAS UTILIZADAS

BA0: Operadoras de Saúde
SX6: Parâmetros do Sistema

Árvore de páginas