Movimentação de Beneficiários – Unimed

Owned by Solus - Editor, created
Last updated: set. 06, 2024 by Solus - Publicação
5 min read
Escrito por: K. S.

PTU/CONTAS

Objetivo

O objetivo deste manual é orientar sobre o fluxo de movimentações dos beneficiários de intercambio, descontinuando os processos de A1300, A100 e A200.

Funcionalidade

  • Enviar inclusão, alteração ou exclusão do beneficiário;

  • Enviar movimentações automaticamente pela rotina do sistema;

  • Permite analisar se houve sucesso ou falha no envio dos dados para a Unimed Brasil.

Configurações

Configurações/Requisitos

  • Para poder utilizar o recurso, precisamos fazer as configurações necessárias para utilizar as APIs: api_ptu e api_integraapis, que são as responsáveis por essa integração. Nessa tela, procuraremos as APIs api_integraapis e a api_ptu, deixar seu status como ativo e indicar seu devido endpoint com as portas 15370 para api_integraapis e a 15380 para a api_ptu.

 

Módulo ADM > Configurações > Cadastro de APIs:

msedge_BuqYVHx6lL.png

 

  • Após configurar a API, iremos fazer o cadastro de quatro integrações, onde três serão referentes às movimentações(Inclusão, alteração e exclusão) e a quarta é a que vai identificar qual tipo de movimentação que o beneficiário precisa ir.

Módulo Adm > Configurações > Cadastro de integrações:

image-20240726-140751.png

  • Como podemos ver na imagem acima, indicamos que seu tipo é API, o integrador é o Registra integração, o sistema de origem é Independente, o Fornecedor é o sistema Solus, e o serviço utilizado é o Integração de Beneficiários ao Cad Benef.

  • O campo Url pode ficar em branco nesse caso.

  • O fornecedor aqui é o PTU, onde o serviço utilizado é o Cadbenef - inclusão.

  • Nesse cadastro, também indicamos a url do serviço que podemos encontrar no manual de integração 9.0, onde contém os endpoints necessários para cada tipo de movimentação.

  • Continuando com o cadastro, vamos até a aba “Configurações API”, onde vamos indicar que o content type da requisição é JSON; seu método http é o POST, pois é o de inclusão, e o status code de resposta é o 201.

 

  • Depois disso, vá até a aba “Configurações Autenticação”, onde indicamos  a forma de autenticação necessária para as movimentações. Em nosso caso é Bearer Token(JWT), além disso, precisamos indicar qual a url utilizada para pegarmos o token, a chave no retorno da requisição em que teremos o token e o que indica o tempo de validade dele. Informamos também o método http utilizado para solicitá-lo (que em nosso caso é Post), e indicamos o Content-Type que esperamos de retorno, que é um Json.

  • O cadastro das movimentações tem, basicamente, os mesmos dados, onde as diferenças se resumem no serviço do fornecedor, no método http da request e no status code da resposta.

 

 

Operacionalização

Para acessar a tela “Movimentação de Beneficiários”, entre no Módulo PTU > Movimentação > Movimentação de beneficiário.

Também temos filtros de busca para auxiliar na listagem, podendo indicar a situação do registro, status e etc. De início, o sistema irá listar apenas as transações dos últimos 10 dias, podendo alterar entre 20, 30 ou independente, se desejar. O botão “Auto Consulta” estará ativo assim que entrarmos na tela, onde a cada 5 segundos irá consultar se teve alguma nova movimentação no período. Caso não queira, clique no botão para desativar e ativar esse recurso quando desejar.

Filtros

Descrição

Opções

Filtros

Descrição

Opções

Buscar por

Indica por qual forma deseja realizar a busca das transações.

  • Nome do beneficiário;

  • Código do beneficiário;

  • Código de controle do beneficiário;

  • Nome do titular;

  • Código do titular;

  • Empresa contratante.

Situação

Indica qual situação da transação deseja buscar.

  • Independente (todas as situações);

  • Sucesso;

  • Aguardando;

  • Erro de processo;

  • Erro de validação;

  • Erro da Unimed Brasil.

Tipo

Tipo da transação realizada.

  • Independente (todos os tipos);

  • Inclusão;

  • Alteração;

  • Exclusão.

Período

Período que deseja realizar a busca da transação.

  • Independente (qualquer período);

  • Últimos 10 dias;

  • Últimos 20 dias;

  • Últimos 30 dias..

Nome do beneficiário

Campo editável, no qual altera o nome do campo dependendo da consulta escolhida no campo “Busca por”.

  • Campo livre para digitar a informação conforme, o que deseja utilizar de específico para a busca.

Operação

Define qual operação da transação deseja realizar a busca.

  • Independente;

  • Movimentação Cadastral;

  • Compartilhamento de Risco.

 

Ao lado da caixa de filtros de pesquisa, encontraremos a caixa de opção para a transação ao qual selecionar. Selecionando um dos registros de transações realizadas, será possível abrir os detalhes do que foi enviado ou o histórico do que ocorreu na transação especifica.

Ao clicar no botão "Detalhes do envio", serão carregados os dados que foram enviado para a Unimed Brasil

Se o beneficiário tiver o compartilhamento de risco, não será preciso se preocupar em gerar um A100 ou A200, durante o envio ao CadBenef o sistema envia os dados referentes ao compartilhamento de risco. A Unimed Brasil repassará esses dados para Unimed destino e retornará se tiver sucesso ao fazer o compartilhamento.

Documentação elaborada com base na versão vigente do sistema.

Voltar ao início

Revisão textual: R. C., Jul 31, 2024 ; V. F., Sep 5, 2024