Histórico da Página

Aviso

title	Beta

Funcionalidade em fase de testes.

CONTEÚDO

Visão Geral

Exemplo de utilização

Tela PLPTU001
1. Outras Ações / Ações relacionadas
Tela PLPTU001
1. Principais Campos e Parâmetros
Tabelas utilizadas
1. Configuração
2. Programa de Menu
3. Criando Lote de Envio
4. Status do Lote
  1. Consultar Status
5. Enviando Beneficiários
  1. Detalhes do Envio
    1. Mensagens de Erro
6. Exportar Erros
7. Compartilhamento de Risco
Tabelas utilizadas

Âncora
visao
visao

01. VISÃO GERAL

Essa integração permite enviar as movimentações de inclusão, alteração e exclusão dos beneficiários da Unimed para o Cadastro Nacional de Beneficiários (CadBenef), onde o envio dos dados dos beneficiários à Unimed do Brasil através do PTU A1300 deixará de existir.

Nesse novo processo, o compartilhamento de risco através do PTU A100 também deixará de existir, tendo em vista já incorporado por meio da mensagem de "Cadastro de Beneficiário", assim como o PTU A200, na mensagem "Retorno do Compartilhamento de Risco".

Vale lembrar que tais mudanças otimizarão o processo de cadastramento de beneficiários no intercâmbio, uma vez que os processos manuais serão extintos.

Âncora
utilizacao
utilizacao

02. EXEMPLO DE UTILIZAÇÃO

2.1 Configuração

Âncora
configuracao
configuracao

a. Configuração

Âncora
autenticacao
autenticacao

i.

...

Endpoint e Autenticação

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

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

Image Added

Informações

icon	false

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

Âncora
certificado
certificado

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), é nessecário necessário que o mesmo seja adicionado no servidor do protheus:

Dica

title	Diretório no RootPath

...

\cadbenef\certificados\meu_certificado.pfx

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

Informações

icon	false

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)

Âncora
endpoint_compartilhamento
endpoint_compartilhamento

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

title	Endpoint

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:

Dica

icon	false

Miscelanea

Unimed

Integrações

Decrição: CadBenef Online

Programa: PLPTU001

Módulo: Plano de Saúde

Tipo: Função Protheus

Âncora
criando_lote
criando_lote

c. Criando Lote de Envio

Na tela inicial, serão apresentados todos os lotes criados para integrar com o CadBenef Online - Unimed Brasil:

Image Added

Novo Lote, irá criar um lote de beneficiários para envio ao CadBenef:

Image Added

Aviso

icon	false

Tipo de Mov.: Informe de qual forma o sistema irá buscar os beneficiários no cadastro, sendo:

Cadastro Ativo: Beneficiários que tiveram inclusão no intervalo da data inicial e final informada no lote que estão sem data de bloqueio.
Cadastro Completo: Todos os beneficiários.
Mov. Periódica: Beneficiários que tiveram alterações/inclusões (BX1), via de cartão (BED), repasse, bloqueio e desbloqueio (BCA) no intervalo da data inicial e final informada no lote.
Somente Exclusão: Beneficiários que tiveram bloqueio no intervalo da data inicial e final informada no lote e que já foram enviados para o CadBenef.

Data Inicial: Data inicial do período em que o sistema irá considerar a busca dos beneficiários.

Data Final: Data final do período em que o sistema irá considerar a busca dos beneficiários.

Nota
Os demais campos serão utilizados para realização de filtros na busca dos beneficiários.

Confirmando a inclusão do lote, caso algum beneficiário seja encontrado conforme os dados informados, será apresentada uma mensagem de quantos beneficiários foram adicionados ao lote:

Dica

title	Lote incluído com sucesso!

O lote ficará com o status de

Estado

subtle	true
title	Recebido

ao finalizar a gravação.

Image Added

Informações

title	Customização

Para manipular query que busca os beneficiários para o lote, foi criado o seguinte ponto de entrada: PE PTU001QRY Manipula Query que Busca os Beneficiários do Lote - CadBenef Online

Âncora
status_lote
status_lote

d. Status do Lote

Os lotes poderão possuir os seguintes status:

Informações

icon	false

Estado

subtle	true
title	Recebido

Ao criar o lote.
Estado
subtle true
colour Blue
title Processando Envio
Quando estiver enviando os beneficiários para o CadBenef.
Estado
subtle true
colour Red
title Falha de Envio
Caso algum beneficiário tiver erro no envio.
Estado
subtle true
colour Green
title Finalizado com sucesso
Quando todos os beneficiários do lote forem enviados com sucesso.
Estado
subtle true
colour Yellow
title Finalizado Parcialmente
Quando houver beneficiários enviados com sucesso e nenhum com erro de envio.

Âncora
consultar_status
consultar_status

i. Consultar Status

O consultar status, será apresenta a quantidade de beneficiários, sendo:

Image Added

Âncora
enviar_beneficiario
enviar_beneficiario

e. Enviando Beneficiários

Existem duas formas de enviar o beneficiário para o CadBenef, sendo envio em lote, opção Enviar Lote ou acessando o Consultar Beneficiários do lote, na opção Enviar, onde será enviado somente o beneficiário posicionado.

Quando enviado o lote, o sistema irá processar o envio dos beneficiários de forma assíncrona, ou seja, o usuário não precisará esperar terminar o envio. Nesse momento, o lote ficará com o status

Estado

subtle	true
colour	Blue
title	Processando Envio

.

Âncora
detalhes_envio
detalhes_envio

i. Detalhes do Envio

Através do consultar beneficiários, será possível verificar os Detalhes de Envio de cada beneficiário para o CadBenef:

Image Added

Dica

Status: Corresponde ao status de envio do beneficiário, sendo:

Estado

subtle	true
title	Pendente de Envio

,

Estado

subtle	true
colour	Green
title	Envio Finalizado

,

Estado

subtle	true
colour	Red
title	Erro de Envio

.

Cd. Transac.: Código de Transação do PTU (esse código não irá repetir), através dele será possível consultar a transação no portal da Unimed Brasil referente ao CadBenef.

Msg. Envio: Json enviado pelo sistema para o CadBenef.

Msg. Resp.: Json de resposta do CadBenef.

Informações

title	Customização

Para alterar os dados (valores, obrigatoriedade e tipo) dos campos enviados para a API de movimentação cadastral do beneficiário, foi criado o ponto de entrada: PE PTU001JSN Altera os Dados dos Campos da API de Beneficiários - CadBenef Online

Para alterar a estrutura do objeto JSON com todos os dados já preparados para envio, utilizar o ponto de entrada: PE PTU001OBJ Altera o Json de Envio da API de Beneficiários - CadBenef Online

Nota

title	API Serviço de Movimentação Beneficiarios - Unimed Brasil

Para mais detalhes do swagger da api da Unimed Brasil, clique aqui!

Âncora
mensagem_erro
mensagem_erro

1. Mensagens de Erro

Quando o beneficiário estiver com o status

Estado

subtle	true
colour	Red
title	Erro de Envio

, será possível através das mensagens de erro, consultar com mais detalhes as críticas que o sistema encontrou ou que a Unimed Brasil retornou:

Image Added

Âncora
exportar_erro
exportar_erro

g. Exportar Erros

No botão Exportar Erros do lote, é possível obter todos os erros de envio dos beneficiários daquele lote:

Image Added

Selecione o tipo de impressão: Arquivo, Spool, Planilha (Padrão) e E-mail para exportar os erros do lote:

Image Added

Âncora
compatilhamento_risco
compatilhamento_risco

g. Compartilhamento de Risco

Custo Operacional ou Pós-Pagamento

A Unimed do Brasil irá validar o código do município de residência do beneficiário quando a origem enviar a movimentação cadastral. Caso seja identificado que a área de ação pertença a uma Unimed diferente da Unimed de origem da transação, o acionamento do Compartilhamento de Risco será realizado pela Unimed do Brasil.

Essa ação indicará que é um compartilhamento de risco, custo operacional ou pós-pagamento.

Bloco de código

language	c#
theme	Emacs
title	Exemplo de Request Body
linenumbers	true
collapse	true

{
  "cabecalho": {
    "codigoControleTransacao": 12345678901234567000,
    "unimed": {
      "codigoUnimedOrigem": 999,
      "codigoUnimedDestino": 55
    },
    "dataGeracao": "2024-05-27T09:06:05-03:00"
  },
  "dadosEmpresaContratante": {
    "tipoContratoLocal": 1
  },
  "dadosBeneficiario": {
    "carteirinhaBeneficiario": "00011008000034016",
    "tipoCompartilhamentoRisco": "C",
    "dataInicioCompartilhamentoRisco": "2024-07-05",
    "dataFimCompartilhamentoRisco": "2024-10-05",
    "indicadorCompUB": true
    
  },
  "dadosPessoa": {
    "nomeCompletoBeneficiario": "FILIPE THALES RAFAEL PORTO",
    "dataNascimento": "1991-01-26"  
  }
}

Nota

title	API de Inclusão do Compartilhamento de Riscos - Unimed Brasil

Para mais detalhes do swagger da api da Unimed Brasil, clique aqui!

No sistema, na rotina do Grupo Familiar/Beneficiários (PLSA124), opção do menu Interc. Hab. Será possível verificar os compartilhamentos de risco dos beneficiários. (Processo realizado no antigo PTU A100 simplificado)

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

Image Added

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

title	Parâ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

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:

Image Added

Para repassar os beneficiários para outra unimed, antes de enviar o beneficiário é necessário realizar o seguinte preenchimento no cadatro do beneficiário (BA1):

Op. Destino (BA1_OPEDES) - Unimed Destino.
Data Repasse (BA1_DATREP) - Data do compartilhamento.
Carteirinha (BA1_LOCEMI) - indica se a geração da carteirinha será pela Unimed origem ou destino.
Prod.Interc. (BA1_PLAINT) - código do Plano de intercambio.

Âncora
tabelas
tabelas

03. TABELAS UTILIZADAS

BPW - CadBenef Online - Lote
BPY - CadBenef Online - Beneficiário
BA1 - Beneficiários
BTS - Vidas
BA3 - Famílias
BA0 - Operadora de Saúde
BG9 - Empresas
BQC - Subcontratos
BI3 - Produto Saúde

03. TELA XXXXX

Outras Ações / Ações relacionadas

...

04. TELA XXXXX

Principais Campos e Parâmetros

...

Card documentos

Informacao	Use esse box para destacar informações relevantes e/ou de destaque.
Titulo	IMPORTANTE!

...

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 1

Nova versão 66

Chave

CONTEÚDO

Âncoravisaovisao

01. VISÃO GERAL

Âncorautilizacaoutilizacao

02. EXEMPLO DE UTILIZAÇÃO

2.1 Configuração

Âncoraconfiguracaoconfiguracao

a. Configuração

Âncoraautenticacaoautenticacao

i.

Endpoint e Autenticação

Âncoracertificadocertificado

ii. Certificado Digital

Âncoraendpoint_compartilhamentoendpoint_compartilhamento

iii.

Endpoint do Compartilhamento de Risco

Âncoramenumenu

b. Programa de Menu

Âncoracriando_lotecriando_lote

c. Criando Lote de Envio

Âncorastatus_lotestatus_lote

d. Status do Lote

Âncoraconsultar_statusconsultar_status

i. Consultar Status

Âncoraenviar_beneficiarioenviar_beneficiario

e. Enviando Beneficiários

Âncoradetalhes_enviodetalhes_envio

i. Detalhes do Envio

Âncoramensagem_erromensagem_erro

1. Mensagens de Erro

Âncoraexportar_erroexportar_erro

g. Exportar Erros

Âncoracompatilhamento_riscocompatilhamento_risco

g. Compartilhamento de Risco

Custo Operacional ou Pós-Pagamento

Repasse ou Pré-Pagamento

Log

Âncoratabelastabelas

03. TABELAS UTILIZADAS

03. TELA XXXXX

04. TELA XXXXX

Âncora
visao
visao

Âncora
utilizacao
utilizacao

Âncora
configuracao
configuracao

Âncora
autenticacao
autenticacao

Âncora
certificado
certificado

Âncora
endpoint_compartilhamento
endpoint_compartilhamento

Âncora
menu
menu

Âncora
criando_lote
criando_lote

Âncora
status_lote
status_lote

Âncora
consultar_status
consultar_status

Âncora
enviar_beneficiario
enviar_beneficiario

Âncora
detalhes_envio
detalhes_envio

Âncora
mensagem_erro
mensagem_erro

Âncora
exportar_erro
exportar_erro

Âncora
compatilhamento_risco
compatilhamento_risco

Âncora
tabelas
tabelas