Medical VM
Escrito por: S. S.
CONTROLADORIA
Objetivo
O objetivo deste manual é orientar sobre a integração com a plataforma “Medical Virtual Market”, que visa otimizar o processo de cotação de materiais e medicamentos para Operadoras de saúde, conectando-as a uma rede de fornecedores, visando reduzir custos e garantir cotações mais competitivas.
Funcionalidade
Enviar automaticamente solicitações de compra para a plataforma “Medical VM” via “APIs”;
Receber retorno dos pedidos de compra após o processo de cotação e aprovação de preços;
Monitorar a integração em uma tela dedicada, exibindo;
Verificar registros integrados;
Consultar status do processamento;
Receber retornos da plataforma;
Possibilita realizar interações manuais em casos específicos.
Configurações/Requisitos
Para utilização é preciso configurar a integração com o sistema “Medical VM”. Para isso, utilize o Módulo ADM > Configurações > Cadastro de integrações e cadastre as informações abaixo:
Login da plataforma do Medical VM disponibilizado pelo terceiro.
Senha da plataforma do Medical VM disponibilizado pelo terceiro.
Será necessário um login e senha no sistema Solus para acessar o Medical VM. Esse login o terceiro utilizará para gerar os tokens de permissão para se comunicar com a “API” Medical VM:
Módulo ADM
Criando o usuário para o Medical:
Vincule o login do Medical, recém-criado na “API Medical VM” (Módulo ADM):
Depois, precisará de uma solicitação de compra para ser integrada com o sistema Medical VM.
Obs. 1: o Medical precisa ser cadastrado na base deles, os produtos que serão integrados, portanto, antes de realizar qualquer integração, deve ser enviado para eles todos os produtos do qual poderá ser integrado futuramente (o produto será reconhecido no sistema Solus pelo seu código).
Obs. 2: o mesmo ocorre com os fornecedores que voltarão da aprovação da cotação no Medical, antes de aprovar qualquer ordem de compra no Medical, o operador deve cadastrar no Solus os fornecedores para o mesmo ser reconhecido (o fornecedor será reconhecido no sistema Solus pelo seu CNPJ).
Obs. 3: também será necessário enviar para o terceiro a lista de todas as formas de pagamentos cadastrada no sistema Solus, que o cliente deseja utilizar no Medical (a forma de pagamento será reconhecida no sistema Solus pela ID/PK). O cadastro de forma de pagamento fica no “Módulo Estoque > Cadastros > Cadastro compras > Condições de pagamento”, como mostra abaixo:
A integração foi realizada apenas no Módulo Estoque.
Parâmetros
Operacionalização
Caminho do recurso: Módulo Estoque > Compras > Solicitação de compra.
Módulo Estoque
Após realizar toda a configuração para a integração estar funcionando, segue abaixo como será o fluxo de integração:
Enviar uma solicitação de compra ao Medical VM:
Acessando a solicitação de compra que desejamos enviar para o Medical. Repare abaixo que existe o novo botão para integração –“Integrar solicitação com sistema terceiro”.
Caso a solicitação esteja configurada para passar por um fluxo de aprovação, o mesmo deverá ser aprovado primeiramente antes de continuar:
Não será descrito aqui como funciona o fluxo de aprovação, visto que é um fluxo já existente no sistema Solus.
Após isso, o operador responsável pela cotação, deverá clicar em “Marcar ciente” a solicitação:
Após clicar em “Marcar ciente” e aprovar o fluxo de aprovação, se for o caso, clique no botão “Integrar solicitação com sistema terceiro” de integração que estará liberado:
Após clicar, receberá a seguinte mensagem:
Conforme exibido acima, a solicitação está pendente para envio e será disparada automaticamente pelo sistema Solus em questão de alguns minutos.
Para monitorar as requisições, tanto de ida como volta com sistemas integrados, o operador que possui permissão de utilizar o “Módulo ADM > Configurações > Gerenciamento de integrações”, pode consultá-las pela tela abaixo:
Efetuamos a consulta da requisição enviada para o fornecedor Medical VM, conforme a legenda mostra, a comunicação foi realizada com sucesso:
Voltamos para a tela de solicitação de compra (Módulo Estoque), e veja que o status foi alterado:
Isso significa que a solicitação foi integrada com o sistema terceiro, portanto não será possível alterar mais nada nesta solicitação. Caso acesse o sistema da Medical, poderá visualizar que temos o pedido do produto solicitado para realizar a cotação:
Ainda no sistema da Medical será possível cancelar a solicitação:
A Medical não disponibiliza um serviço para cancelar, para podermos automatizar no Sistema Solus. Portanto, caso o pedido for cancelado no Medical, será necessário cancelar automaticamente no Sistema Solus, pela opção demonstrada abaixo:
Após cancelar no sistema Solus, a solicitação estará livre para alterações e pode seguir o fluxo normal da Solus ou ser integrada novamente ao Medical VM: