Escrito por: K. S.
⚙️ 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:
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 |
|---|---|---|
Buscar por | Indica por qual forma deseja realizar a busca das transações. |
|
Situação | Indica qual situação da transação deseja buscar. |
|
Tipo | Tipo da transação realizada. |
|
Período | Período que deseja realizar a busca da transação. |
|
Nome do beneficiário | Campo editável, no qual altera o nome do campo dependendo da consulta escolhida no campo “Busca por”. |
|
Operação | Define qual operação da transação deseja realizar a busca. |
|
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
Ao clicar no botão, podemos ver todos os envios e tentativas de envio que foram feitos para esse beneficiário, tendo também o tipo de tentativa como também a situação de cada um deles.
Quando pressionamos “F5” no registro posicionado ou damos um “duplo clique” no mesmo, a tela de detalhes do envio será apresentada, onde podemos ver os dados que tentamos ou enviamos.
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.
