Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Aviso
titleBeta

Funcionalidade em fase de testes.

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. Compartilhamento de Risco
  3. Tabelas utilizadas


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:

Informações
iconfalse

URL Token: Endpoint de homologação/produção disponibilizado pela Unimed Brasil para autenticação. (BA0_UBURL)
Exemplo: https://gateway-hml.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://ua-gateway-hml.unimed.coop.br/cadbenef-online/v1/beneficiarios

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:

Dica
titleDiretó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:

Informações
iconfalse

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)


iii. Endpoint do Compartilhamento de Risco

Foi disponibilizado uma nova API para possibilitar que seja enviado 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 pós-pagamento (custo operaciona).

Dica
titleEndpoint

https://<url>:<porta>/rest/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:

Dica
iconfalse

(mais) Miscelanea

(mais) Unimed

(mais) Integrações

Decrição: CadBenef Online 

Programa: PLPTU001

Módulo: Plano de Saúde

Tipo: Função Protheus


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:

Aviso
iconfalse

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

  1. 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.
  2. Cadastro Completo: Todos os beneficiários.
  3. 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.
  4. 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
titleLote incluído com sucesso!

O lote ficará com o status de

Estado
subtletrue
titleRecebido
 ao finalizar a gravação.


d. Status do Lote

Os lotes poderão possuir os seguintes status:

Informações
iconfalse

Estado
subtletrue
titleRecebido
Ao criar o lote.

Estado
subtletrue
colourBlue
titleProcessando Envio
Quando estiver enviando os beneficiários para o CadBenef.

Estado
subtletrue
colourRed
titleFalha de Envio
Caso algum beneficiário tiver erro no envio.

Estado
subtletrue
colourGreen
titleFinalizado com sucesso
 Quando todos os beneficiários do lote forem enviados com sucesso.

Estado
subtletrue
colourYellow
titleFinalizado Parcialmente
Quando houver beneficiários enviados com sucesso e nenhum com erro de envio.


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 

Estado
subtletrue
colourBlue
titleProcessando 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: 

Nota

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

Estado
subtletrue
titlePendente de Envio
Estado
subtletrue
colourGreen
titleEnvio Finalizado
Estado
subtletrue
colourRed
titleErro 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.

1. Mensagens de Erro

Quando o beneficiário estiver com o status

Estado
subtletrue
colourRed
titleErro 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:

f. Compartilhamento de Risco

A Unimed do Brasil irá validar o código do município de residencia do beneficiário quando a origem enviar a movimentação cadastral. Caso 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 pela Unimed do Brasil.

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

No sistema, na rotina do Grupo Familiar/Beneficiários (PLSA124), opção do menu Interc. Hab. será possivel verificar os compartilhamentos de risco dos beneficiário. (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)

Aviso
titleNão Disponível

O compartilhamento de risco em pré-pagamento ou repasse não está 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