Movimentação de Beneficiários – Unimed

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.

📝 Sumário

▪️ Objetivo

▪️ Funcionalidade

▪️ Configurações

▪️ Parâmetros

▪️ Permissões de Direitos

▪️ Operacionalização

⚙️ 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:

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:

Detalhes das configurações de integração

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.

Integração de Inclusão

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.

Integração de Alteração

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.

Integração de Exclusão

💻 Operacionalização

Para acessar a tela de movimentações de beneficiários, entre no Módulo PTU > Movimentação > Movimentação de beneficiário.

Nela, 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 vai listar apenas as transações dos últimos 10 dias, podendo alterar entre 20, 30 ou independente, se desejar. Temos também um botão chamado “Auto Consulta” que estará ativo assim que entrarmos na tela, onde a cada 5 segundos vai 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
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.

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

Voltar ao início