Faça sua busca aqui
Espaço exclusivo das Unimeds para consulta de artigos e tutoriais
Conecte-se com nosso ecossistema para oportunidades e parcerias
Fique por dentro das nossas novidades e conteúdos
Acompanhe o que é notícia do Unimed Lab, eventos e ações
Conheça o hub de inovação do maior sistema cooperativista de saúde do mundo
Conheça os produtos que disponibilizamos para o Sistema Unimed
Voltar
Olá!
Para viabilizar o uso das funcionalidades, é necessário integrar os serviços da sua Unimed às APIs dos aplicativos.
Os apps podem ser integrados com os mais diversos sistemas de gestão utilizados pelas Unimeds, permitindo assim o consumo dessas informações.
O intuito é disponibilizar dados em tempo real para os seus beneficiários e cooperados, por isso a necessidade de integração com os sistemas de gestão.
Atenção, time de TI: o aplicativo trabalha com troca de informações no formato JSON, e é necessário que a Unimed construa endpoints para que a comunicação seja realizada.
Confira abaixo a visão macro das integrações nativas dos aplicativos e, na sequência, as formas de integração das demais funcionalidades de acordo com o seu sistema de gestão.
LOGIN
Sempre que um usuário faz o login, é consultado o Cadbenef (PTU A1300). Nesta chamada é verificado: > Beneficiário existe no Cadbenef? > Beneficiário está ativo?
Em caso de negativo em um dos itens acima, o usuário não poderá efetuar login no aplicativo. Para resolução do problema, é necessário enviar uma nova carga do arquivo A1300 via CMB. Para evitar disparidade entre a contratação do plano e acesso ao aplicativo, recomendamos o envio frequente do arquivo.
A senha é gerenciada pelo Canal do Beneficiário, ou seja, beneficiários de Unimeds que utilizam este canal podem usar a mesma senha para logar no app.
O login do cooperado é baseado nas informações do arquivo A400 (mesmo arquivo que é disponibilizado no Guia Médico enviado via NovaCMB).
Quando o Guia Médico é atualizado, os logins são criados ou excluídos. Deste modo, não é necessário dar outra carga ou cadastrar manualmente.
A senha é gerenciada pelo AGI, ou seja, cooperados de Unimeds que utilizam o Canal do Cooperado podem usar a mesma senha para logar no app.
Os sistemas de gestão Cardio, SGU, Unimed HRP e Infomed Benner já possuem implementação dos serviços para integração com o App Unimed Cliente e o App Unimed Cooperado, portanto, Unimeds que utilizam esses sistemas de gestão devem seguir as orientações apresentadas e enviar um e-mail para a Estação Inova Portal com as seguintes informações:
Esses sistemas de gestão deverão:
>> Saiba para quais funcionalidades os sistemas Cardio, SGU, Unimed HRP e Infomed Benner possuem API de integração
Para as funcionalidades que o Cardio, SGU, Unimed HRP e Infomed Benner não possuírem integração, é possível utilizar outra solução que esteja nos padrões da documentação do Swagger.
Os serviços das funcionalidades devem ser implementados seguindo as especificações apresentadas no Swagger. O Swagger centraliza informações, descrição e requisitos de cada serviço por funcionalidade.
Exemplo:
Clicando sobre um dos serviços, será possível ver mais detalhes:
Clicando em “Modelo de Classes” você terá a especificação de cada campo do serviço em questão:
Requisitos
> A estrutura dos campos deve ser fiel ao detalhado no Swagger > Todos os campos são case sensitive > Os serviços devem possuir um IP (válido) ou URL com acesso à internet. Esses serviços deverão ser disponibilizados na porta 80, 443 ou 16030 e, preferencialmente, ser trafegado em HTTPS > A autenticação para acesso aos serviços deve ser realizada utilizando Usuário e Senha (basic authentication) ou Bearer Token > A comunicação é realizada via serviço REST – JSON > No header: Content-type deverá ser application/json; charset=utf-8 > Método GET é utilizado quando o aplicativo requisita a informação da Unimed > Método POST é quando o aplicativo envia uma informação para a Unimed
Por ser o mais simples, recomendamos que o primeiro serviço a ser desenvolvido seja Contatos. A ferramenta Postman é bem aceita nos testes. Antes de enviar o endpoint para integrar ao app, é possível realizar validação de comunicação e estrutura do JSON.
Importante ressaltar que algumas funcionalidades já possuem integração nativa, não precisando ser integradas aos sistemas de gestão.
UNIMED CLIENTE
Não depende de integração com a Unimed:
UNIMED COOPERADO
Após criar os serviços
Para que a integração seja efetivada, a Unimed deve enviar as seguintes informações:
1. URL de cada endpoint. Se o caminho do endpoint desenvolvido for diferente do Swagger, é necessário fazer um de/para informando de qual funcionalidade se trata.
Exemplo: Funcionalidade Contato Swagger: /api/Beneficiario/Contato Unimed: www.unimedxxxxx.coop.br/api/benef/unimed/contato
2. Usuário / Senha (basic Authentication) ou Bearer Token para autenticação
3. Liberar na Unimed o acesso para o range de IPs de nossos ambientes de Homologação e Produção
Homologação: 187.72.46.0/25 e 201.55.123.168/29 Produção: 200.143.34.192/26
Os testes sempre deverão ser feitos nos sistemas iOS e Android. O iOS é mais crítico em relação a falha de estrutura do JSON, enquanto o Android muitas vezes é mais flexível e consegue tratar problemas de estrutura.
Utilize os aplicativos de demonstração para realizar os testes.
Espero que este artigo tenha ajudado a compreender como funciona a integração dos aplicativos.
Veja também:
>> Implantação dos aplicativos: tudo o que você precisa saber >> Conhecendo o Gerenciador de Aplicativos >> Configuração de funcionalidades e parametrização técnica dos aplicativos
> Pesquise pelo que precisa aqui na Central de Ajuda, ou > Abra um chamado para nossa equipe em: Canal do Colaborador > Aplicativos > GIU > Sistema de Gestão de Demandas > Abertura de Chamados > Sistemas e Aplicações