CONTEÚDO

  1. Visão Geral
  2. 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:

Cadastro dos 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


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

BA0 - Operadoras de Saúde

SX6 - Parâmetros do Sistema