Árvore de páginas

Versões comparadas

Chave

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


CONTEÚDO

  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 configurar o CadBenef Online no sistema Plano de Saúde (Protheus) é necessário realizar , siga os seguintes 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.

...

Image Added

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

...

exige o uso de certificados digitais do tipo ICP-Brasil

...

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

...

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:

...

Dica
titleEndpoint


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

Nota

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.

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 com o valor .T..

  2. 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
Informações
titleCustomizaçã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