Beta
Funcionalidade em fase de testes.
CONTEÚDO
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.
02. EXEMPLO DE UTILIZAÇÃO
a. Configuração
i. Endpoint e Autenticação
Acesse o menu Operadora de Saúde (PLSA010), do módulo Plano de Saúde (SIGAPLS), e seleciona o código da Unimed que deseja configurar a integração.
Clique em alterar e acesse a aba Integrações Unimed para preencher os seguintes campos:
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), é necessário que o mesmo seja adicionado no servidor do protheus:
Diretório no RootPath
\cadbenef\certificados\meu_certificado.pfx
No cadastro da operada de saúde (mesmo caminho da configuração acima do endpoint e autenticação), é necessário informar os dados do certificado:
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 pós-pagamento (custo operacional), portanto é necessário abrir um chamado na UB passando o endpoint abaixo:
Endpoint
https://<url>:<porta>/totvsHealthPlans/unimed/cadbenef-online/v1/beneficiarios/compartilhamento-riscos
b. Programa de Menu
Para a integração do CadBenef foi desenvolvido um novo programa (rotina) de menu no seguinte caminho:
c. Criando Lote de Envio
Na tela inicial, serão apresentados todos os lotes criados para integrar com o CadBenef Online - Unimed Brasil:
Novo Lote, irá criar um lote de beneficiários para envio ao CadBenef:
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:
Lote incluído com sucesso!
O lote ficará com o status de RECEBIDO ao finalizar a gravação.
Customização
Para manipular query que busca os beneficiário pro lote foi criado o seguinte ponto de entrada: PE PTU001QRY Manipula Query que Busca os Beneficiários do Lote - CadBenef Online
d. Status do Lote
Os lotes poderão possuir os seguintes status:
i. Consultar Status
O consultar status apresenta a quantidade de beneficiários no lote por status, sendo:
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 PROCESSANDO 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:
Status: Corresponde ao status de envio do beneficiário, sendo: PENDENTE DE ENVIO, ENVIO FINALIZADO, 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.
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
API Serviço de Movimentação Beneficiarios - Unimed Brasil
Para mais detalhes do swagger da api da Unimed Brasil, clique aqui!
1. Mensagens de Erro
Quando o beneficiário estiver com o status 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:
g. Exportar Erros
N No botão Exportar Erros do lote, é possível obter todos os erros de envio dos beneficiários daquele lote:
Selecione o tipo de impressão: Arquivo, Spool, Planilha (Padrão) e E-mail para exportar os erros do lote:
g. Compartilhamento de Risco
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.
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)
O código de transação do compartilhamento de risco, ficará gravado no campo Cd. Transac. (B5F_CODTRA)
Não Disponível
O compartilhamento de risco em pré-pagamento ou repasse não estará disponível nesse projeto.
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