Histórico da Página
CONTEÚDO
- Visão Geral
- Exemplo de Utilização
- Configuração de Dados de Integração
- Compartilhamento de Risco
- Tabelas utilizadas
01. VISÃO GERAL
Para configuração do configurar o CadBenef Online no sistema Plano de Saúde (Protheus) é necessário realizar a configuração.
...
, 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.
...
Preencha os seguintes campos conforme a descrição:
URL Token: Endpoint de homologação/produção disponibilizado pela Unimed Brasil para autenticação.
...
Exemplo:
...
https://gateway-hml2.unimed.coop.br/oauth/v1/access-token
(Campo: BA0_UBURL)ID Token: Client ID previamente solicitado
...
à 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:
...
https://gateway-hml2.unimed.coop.br/cadbenef-online/v1/beneficiarios
(Campo: BA0_CDBURL)URL Vld.Tok.: Endpoint para validação do token na
...
API do compartilhamento de risco.
...
Exemplo:https://autenticacaoreversahml.unimed.coop.br/api/token
(Campo: BA0_URLVTK)PFX CadBenef:
...
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 | ||
|---|---|---|
| ||
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 |
...
IIS - Internet Information Services), |
...
adicione-o no servidor do |
...
Protheus no seguinte caminho:
Caso |
...
precise alterar o diretório padrão do certificado, utilize o parâmetro |
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 | ||
|---|---|---|
| ||
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 | ||
|---|---|---|
| ||
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ções de Pré-Pagamento (Repasse)
Se a Unimed opera com regime de pré-pagamento, configure:
...
Ativar repasse:
Configure o parâmetroMV_PLCBREPcom o valor.T..Dados do contrato:
Preencha o parâmetroMV_PLCBEMPcom as informações do contrato no seguinte formato:codigoEmpresa-numeroContrato-versaoContrato-subcontrato-versaoSubcontrato-produto-versaoProdutoExemplo:
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 | ||
|---|---|---|
| ||
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

