Linha Microsiga Protheus

Árvore de páginas

Versões comparadas

Versão antiga 20

changes.mady.by.user Vinicius Queiros Teixeira

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Vinicius Queiros Teixeira

Gravado em

Chave

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

...

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

01. VISÃO GERAL

Para configuração do configurar o CadBenef Online no sistema Plano de Saúde (Protheus) é necessário realizar as configurações a seguir., 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.


Realize o preenchimento dos campos abaixo conforme Preencha os seguintes campos conforme a descrição:

  • URL Token: Endpoint de homologação/produção disponibilizado pela Unimed Brasil para autenticação.

...


  • Exemplo:

...

...

  • à 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:

...

...

  • API do compartilhamento de risco.

...

...

  • 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)


Dica
titleCertificado Digital


A Unimed Brasil utiliza exige o uso de 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.

, que garantem identificação segura em mensagens ou transações.

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

\cadbenef\certificados\meu_certificado.pfx

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

Compartilhamento de Risco

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

A Unimed Brasil irá consumir esse recurso para enviar o compartilhamento dos beneficiários em utilizará essa API para enviar as informações de beneficiários nos regimes de pré-pagamento (repasse) ou pós-pagamento (custo operacional) para o Protheus, portanto é necessário abrir um chamado na mesma passando o endpoint abaixo. Para ativar, abra um chamado informando o seguinte endpoint:

Dica
titleEndpoint


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

Autenticação
Aviso
title
Nota

A API utiliza valida a validação de autenticação através do GIU da autenticação via Unimed Brasil, onde deverá ser informado 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.

A security do REST do ambiente precisa está desligado.

...

Aviso
titleAutenticaçã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:

  1. Ativar repasse:
    Configure o parâmetro MV_PLCBREP

    Habilitar o repasse através do parâmetro MV_PLCBREP 

    com o valor .T.


    Configurar

    .

  2. Dados do contrato:
    Preencha o parâmetro MV_

    PLCBEMP 

    PLCBEMPcom

    os dados do contrato que irá receber os beneficiários de repasse.

    O conteúdo do parâmetro deve ter a seguinte estrutura: 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
Informações
titleCustomização


Caso necessite escolher seja necessário definir em qual contrato os beneficiários de repasse serão cadastrados no momento em que 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