CONTEÚDO

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

01. VISÃO GERAL

Para configuração do CadBenef Online no Plano de Saúde (Protheus) é necessário realizar as configurações a seguir.

02. EXEMPLO DE UTILIZAÇÃO

Dados de Integração

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


Realize o preenchimento dos campos abaixo conforme descrição:

URL Token: Endpoint de homologação/produção disponibilizado pela Unimed Brasil para autenticação. (BA0_UBURL)
Exemplo: https://gateway-hml2.unimed.coop.br/oauth/v1/access-token

ID Token: Client ID solicitado previamente para Unimed Brasil. (BA0_UBCLID)

Secret Token: Secret ID solicitado previamente para Unimed Brasil. (BA0_UBCLSC)

URL CadBenef: Endpoint de homologação/produção do CadBenef-Online. (BA0_CDBURL)
Exemplo: https://gateway-hml2.unimed.coop.br/cadbenef-online/v1/beneficiarios

URL Vld.Tok.: Endpoint para validação do token na api do compartilhamento de risco. (BA0_URLVTK)
Exemplo: https://autenticacaoreversahml.unimed.coop.br/api/token

PFX CadBenef: O nome do certificado com extensão. (BA0_CDBPFX)

Pass CadBen.: Senha que será utilizada para a abertura da chave privada. Para uma chave privada que não possua senha, deve ser informada uma string vazia. (BA0_CDBPAS)



A Unimed Brasil utiliza certificados digitais do tipo ICP-Brasil que funcionam como uma identidade virtual que permite a identificação segura e inequívoca do autor de uma mensagem ou transação.

Portanto, é obrigatório a utilização de um certificado digital na integração com o CadBenef.

Obtido arquivo certificado com extensão .PFX (formato padrão do IIS - Internet Information Services), é necessário que o mesmo seja adicionado no servidor do Protheus:

\cadbenef\certificados\meu_certificado.pfx


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

Compartilhamento de Risco

Foi disponibilizado uma nova API no sistema para possibilitar que seja recebida as movimentações de compartilhamento de risco.

A Unimed Brasil irá consumir esse recurso para enviar o compartilhamento dos beneficiários em pré-pagamento (repasse) ou pós-pagamento (custo operacional) para o Protheus, portanto é necessário abrir um chamado na mesma passando o endpoint abaixo:


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

A API utiliza a validação de autenticação através Unimed Brasil, onde deverá ser informado o bearer o cookie gerado pela API token do GIU, e o sistema irá validar se os dados estão validos para autorizar o acesso.


A security do REST do ambiente precisa está desligado, para a API não utilizar a autenticação padrão do Protheus.

Caso a sua Unimed possua compartilhamento em pré-pagamento (repasse), é obrigatório realizar as seguintes configurações:

  1. Habilitar o repasse através do parâmetro MV_PLCBREP com o valor .T.

  2. Configurar o parâmetro MV_PLCBEMP com os dados do contrato que irá receber os beneficiários de repasse.

    O conteúdo do parâmetro deve ter a seguinte estrutura: codigoEmpresa-numeroContrato-versaoContrato-subcontrato-versaoSubcontrato-produto-versaoProduto

    Exemplo: 1008-000000000001-001-000000003-001-0001-001


Caso necessite escolher em qual contrato os beneficiários de repasse serão cadastrados no momento em que receber a requisição, utilize o ponto de entrada PE PTU001EMP Empresa/Contrato do Beneficiário de Repasse - CadBenef Online.

02. TABELAS UTILIZADAS