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 configurar o CadBenef Online no sistema Plano de Saúde (Protheus), 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, que garantem identificação segura em mensagens ou transações. Após obter o certificado no formato
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
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas