Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

02. EXEMPLO DE UTILIZAÇÃO

...

a. Configuração

...

i. Endpoint e Autenticação

Acesse o menu Operadora de Saúde (PLSA010), do módulo Plano de Saúde (SIGAPLS), e seleciona o código da Unimed que deseja configurar a integração.

Clique em alterar e acesse a aba Integrações Unimed para preencher os seguintes campos:

Image Removed

Informações
iconfalse

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

...

ii. Certificado Digital

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:

Dica
titleDiretório no RootPath

\cadbenef\certificados\meu_certificado.pfx

No cadastro da operada de saúde (mesmo caminho da configuração acima do endpoint e autenticação), é necessário informar os dados do certificado:

Informações
iconfalse

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)

...

iii. Endpoint do Compartilhamento de Risco

Disponibilizado API para possibilitar que seja enviada a movimentação de compartilhamento de Risco para a Unimed Destino.

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

Dica
titleEndpoint

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

...

b. Programa de Menu

Para a integração do CadBenef foi desenvolvido um novo programa (rotina) de menu no seguinte caminho:

...

Nota

O código de transação do compartilhamento de risco, ficará gravado no campo Cd. Transac. (B5F_CODTRA)

Repasse ou Pré-Pagamento

Para habilitar o recebimento do compartilhamento de risco em repasse ou pré-pagamento na API, é necessário habilitar o parâmetro MV_PLCBREP com (.T.), e configurar no MV_PLCBEMP a empresa e contrato que os beneficiários de repasse serão cadastrados.

Nota
titleParâmetro MV_PLCBEMP

O conteúdo do parâmetro deve ser a seguinte estrutura: 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

...

iconfalse
titlePonto do Entrada

...




Log

Para analisar as comunicações recebidas pela api do compartilhamento de risco, foi criado o log unimed-cadbenef-api-risksharing.log que fica no diretório protheus_data/logpls:

...