Histórico da Página

CONTEÚDO

1. Visão Geral
2. Exemplo de utilização
   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
3. 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

Âncora
configuracao configuracao

a. Configuração

Âncora
autenticacao autenticacao

i. Endpoint e Autenticação

...

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

...

Âncora
endpoint_compartilhamento endpoint_compartilhamento

iii. Endpoint do Compartilhamento de Risco

Foi disponibilizado uma nova Disponibilizado API para possibilitar que seja enviado a enviada a movimentação de compartilhamento de Risco para a Unimed Destino.

A Unimed Brasil que irá consumir esse recurso para enviar o compartilhamento dos beneficiários em pré-pagamento (repasse) ou pós-pagamento (custo operacionaoperacional), 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ão apresentados todos os lotes criados para integrar com o CadBenef Online - Unimed Brasil:

...

Âncora
status_lote status_lote

d. Status do Lote

Os lotes poderão possuir os seguintes status:

Âncora
consultar_status consultar_status

i. Consultar Status

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

Âncora
enviar_beneficiario enviar_beneficiario

e. Enviando Beneficiários

...

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 

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

Âncora
mensagem_erro mensagem_erro

1. Mensagens de Erro

Quando o beneficiário estiver com o status

Âncora
exportar_erro exportar_erro

g. Exportar Erros

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

Selecione o tipo de impressõaimpressão: Arquivo, Spool, Planilha (Padrão) , e E-mail etcImage Removedpara 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 residencia 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á realiado realizado pela Unimed do Brasil.

Essa ação será 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á possivel Será possível verificar os compartilhamentos de risco dos beneficiáriobeneficiários. (Processo realizado no antigo PTU A100 simplificado)

...

...

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.

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

...