Árvore de páginas

Versões comparadas

Chave

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

...

Informações
iconfalse

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

...

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
titleEndpoint

https://<url>:<porta>/totvsHealthPlans/unimed/cadbenef-online/v1/beneficiarios/compartilhamento-riscos

Âncora
menu
menu

b. Programa de Menu

...

Informações
titleCustomização

Para manipular query que busca os beneficiário pro 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

...

i. Consultar Status

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

Âncora
enviar_beneficiario
enviar_beneficiario

...

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

Notatip

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.

Informações
titleCustomizaçã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
titleAPI 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

...

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

...

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
languagec#
themeEmacs
titleExemplo de Request Body
linenumberstrue
collapsetrue
{
  "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
titleAPI 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)

...

titleNão Disponível

...

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
titleParâ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

...