Histórico da Página

CONTEÚDO

1. Visão Geral
2. Exemplo de utilização
3. Tela PLPTU001
   1. Outras Ações / Ações relacionadas
      
4. Tela PLPTU001
   1. Principais Campos e Parâmetros
      
5. Tabelas utilizadas
6. 1. Configuração
      1. Endpoint e Autenticação
      2. Certificado Digital
      3. Endpoint do Compartilhamento de Risco
   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
7. 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.

...

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 RemovedImage Added

...

Â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:

...

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

...

Â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 pós-pagamento (custo operacional), portanto é necessário abrir um chamado na UB passando o endpoint abaixo:

Âncora
menu menu

b. Programa de Menu

Para a integração do CadBenef foi desenvolvido um novo programa (rotina) de menu no seguinte caminho:

...

Âncora
criando_lote criando_lote

c. Criando Lote de Envio

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

Image RemovedImage Added

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

Image RemovedImage Added

...

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

Image Removed

...

Image Added

Âncora
status_lote status_lote

d. Status do Lote

Os lotes poderam poderão possuir os seguintes status:

...

Âncora
consultar_status consultar_status

i. Consultar Status

O botão consultar status , apresenta a quantidade de beneficiários no lote por status, sendo:status

Image Addedsubtle

Â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 botão 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ário beneficiários de forma assíncrona, o ou seja, o usuário não precisará esperar terminar o envio. Nesse momento, o lote ficará com o status 

...

Âncora
detalhes_envio detalhes_envio

i. Detalhes do Envio

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

Image Removed

Image Added

03. TELA XXXXX

Outras Ações / Ações relacionadas

...

04. TELA XXXXX

Principais Campos e Parâmetros

Âncora
mensagem_erro mensagem_erro

1. Mensagens de Erro

Quando o beneficiário estiver com o status

Image Added

Âncora
exportar_erro exportar_erro

g. Exportar Erros

N 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

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.

{
  "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"  
  }
}

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)

Image Added

Â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

...

...