top of page

Интеграция

СППВР ЭКФ в МИС

Памятка по интеграции Системы Поддержки Принятия Решений Электронный Клинический Фармаколог

в Медицинские Информационные Системы.

Спасибо, что помогаете интегрировать в вашу МИС СППВР ЭКФ и дать возможность врачам подбирать персонализированную фармакотерапию пациентам!

Интегрция ЭКФ в МИС

Для реализации интеграции вам будет необходим ключ, с помощью которого вы сможете обращаться к интеграционным методам и получать результат проверки взаимодействий внутри сформированного листа назначений. 

Если у вас еще нет выданного ключа, можете запросить его, заполнив заявку по ссылке:

https://www.ecp.umkb.com/ecp-run

в разделе “Оставить заявку”.

Логика

Логика взаимодействия

СППВР ЭКФ и МИС

Основные шаги, которые необходимо реализовать на уровне МИС: 

  • отправка запроса, содержащего сведения о фармакотерапии и пациенте

  • визуализация ответа с найденными внутри листа назначений предупреждениями

  • открытие iframe c интерфейсом СППВР ЭКФ

  • получение исправленной терапии пациента из iframe

Описание процесса

Step 1.

При добавлении каждого нового лекарственного средства МИС отправляет запрос к СППВР ЭКФ. Ответы системы необходимо отображать на мониторе врача таким образом, чтобы не отвлекать его от рабочего процесса.

Step 2.

В случае, если ответ системы содержит критическое предупреждение, то информацию необходимо выводить на экран в развернутом формате, автоматически открывая iframe с интерфейсом СППВР ЭКФ. 

Отображение интерфейса СППВР ЭКФ внутри МИС 

Step 3.

В случае, если ответ системы не содержит критических предупреждений , то ответы системы отображаются в интерфейсе МИС в виде виджета с индикацией уровня опасности. 

yellow

Виджет СППВР ЭКФ в интерфейсе МИС

Step 4.

При клике на виджет, раскрывается окно СППВР ЭКФ. При необходимости врач может более детально прочитать о предупреждении, редактировать лист назначения внутри интерфейса и повторно проверить назначения, нажав на кнопку «Проверить».

Проверка назначения

Step 5.

Закончив работу в интерфейсе СППВР ЭКФ, врач подтверждает свое окончательно принятое решение нажатием кнопки “Назначить”. При этом финальный лист назначения забирается обратно в ЭМК МИС.

Формат интеграции позволяет врачу, при клике на виджет СППВР ЭКФ, добавлять препараты или формировать новый лист назначения напрямую из интерфейса. И после формирования терапии, на этот раз используя интерфейс СППВР ЭКФ, нажав на кнопку «Назначить» данные о сформированной фармакотерапии передаются в МИС для загрузки в ЭМК.

API

Описание доступных интеграционных API

Интеграция системы помощи принятия врачебных решений Электронный клинический фармаколог в медицинскую информационную систему производится с помощью двух методов /Pharm/V2/Check и /Pharm/V2/NewTherapy. 

Все запросы должны быть отправлены методом POST. Все ответы приходят в формате JSON (если не указано другое). Для запросов и ответов используется один и тот же формат передачи данных. 

Внимание: приведённые ниже примеры описывают лишь структуру ожидаемых данных. Формат зависит от используемых для передачи запросов технологий. Во всех запросах должен присутствовать параметр key (ключ доступа). 

API №1:

Метод /Pharm/V2/Check используется на этапе формирования листа назначений и является песочницей для проверок. При добавлении каждого нового лекарственного средства МИС отправляет запрос по url адресу:

https://service.socmedica.com:9004/Pharm/V2/Check

В ответ метод возвращает ответ следующего вида:

{
    "alert": {
       "code": "string",
       "actionCode": 0,
       "title": "string",
       "message": "string",
       "level": "string",
       "sticky": true
   },
   "key": "string",
   "clinic": "string",
   "clinic_name": "string",
   "department": "string",
   "department_name": "string",
   "doctor": "string",
   "doctor_name": "string",
   "url": "string",
   "danger": 0,
   "caution": {
       "title": "string",
       "items": [
           null
       ]

   },
   "duplicate_drugs_allow": true,
   "return_subjects": true,
   "lang": "ru"
}

В данном ответе МИС необходимо использовать 3 параметра:

  • Параметр url содержит в себе ссылку для открытия интерфейса ЭКФ с проверкой фармакотерапии.

  • Параметр danger содержит в себе числовое значение от -1 до 1, означающее уровень критичности конфликта в сформированном назначении. С помощью значения этого параметра система понимает в какой момент нужно автоматически открыть iframe ЭКФ, а в каком случае просто окрасить виджет с логотипом ЭКФ в цвет, определяющий уровень конфликта.

  • Параметр caution позволит визуализировать типы взаимодействий, найденные в рамках сформированной фармакотерапии.

Логика отображения проверок СППВР ЭКФ в зависимости от значения параметра danger:

Исходные файлы для виджета СППВР ЭКФ с разными цветовыми индикациями доступны по ссылке:

Каждая из них представлена в белом и прозрачном варианте, чтобы было удобно сжать и подстроить ее под ваш интерфейс МИС.

API №2:

“Назчение фармакотерапии с записью в ЭМК пациента”:

https://service.socmedica.com:9004/Pharm/V2/NewTherapy

При формировании назначения, то есть подтверждении сформированной фармакотерапии следует направить запрос на API /Pharm/V2/NewTherapy. Структура запроса и ответа аналогичны как в методе /Pharm/V2/Check, разница заключается в том, что данный метод запишет назначенную фармакотерапию в Электронной медицинской карте.

API №3:

"Возврат актуальной фармакотерапии пациента”:

https://service.socmedica.com:9004/Mis/ActualTherapy

Метод позволяет получить актуальную фармакотерапию пациента по его коду в том случае, если пользователь корректировал ее и назначил в интерфейсе СППВР ЭКФ.

Чтобы понять, когда забирать данные с СППВР ЭКФ в МИС есть разные способы в зависимости от используемого стека технологий МИС. Например, можно забрать данные при событии потери фокуса iframe СППВР ЭКФ в МИС/запуске сообщения в postMessage и тд.

Более детальное описание API, представленных выше, формат передачи данных, примеры запросов и ответов доступны по ссылке https://ecpapi.socmedica.com

А также там представлены дополнительные API для решения смежных задач.

Рекомендации по визуализации

При формировании листа назначений внутри МИС, получая ответ от API /Pharm/V2/Check визуализация проверок происходит следующим образом:

img1.png
  • виджет ЭКФ окрашивается в цвет, соответствующий значению параметра danger;
     

  • окно с центром уведомлений предупреждает пользователя о конфликтах, обнаруженных внутри сформированной фармакотерапии согласно параметру caution с полной детализацией о том, какие именно препараты конфликтуют между собой, либо конфликтуют по типу взаимодействия.

img2.png
  • при клике на виджет и уведомление пользователь может провалиться в интерфейс ЭКФ (открывается ссылка из параметра url) для более детального изучения информации о конфликтах

img3.png
  • При подтверждении сформированной терапии с помощью нажатия кнопки «Подтвердить» в интерфейсе МИС, получая ответ от API /Pharm/V2/NewTherapy визуализация проверки происходит следующим образом. Появляется диалоговое окно с предупреждением о конфликтах, обнаруженных внутри сформированной фармакотерапии согласно параметру caution с полной детализацией о том, какие именно препараты конфликтуют между собой, либо конфликтуют по типу взаимодействия. При том, у пользователя нет возможности скрыть диалоговое окно, необходимо подтвердить или отменить действие.

Весь сценарий выстроен таким образом, чтобы максимально удобно для врача и не отвлекая его внимания на лишние действия, предупредить о конфликтах в листе назначения, который он формирует и сопроводить процесс по доработке данного листа назначения.

Рекомендации
  • Как узнать, когда забирать данные с ЭКФ в МИС (произошло назначение в ЭКФ)?
    Способы могут различаться в зависимости от используемого стека технологий МИС. Например, можно забрать данные при событии потери фокуса окна ЭКФ в МИС.
FAQ

Оставьте заявку

Данную памятка подготовила команда разработчиков ЭКФ - врачи и IT-специалисты, чтобы вы могли быстро и эффективно интегрировать наш продукт в вашу МИС.

Если вы не смогли найти ответ на свой вопрос, напишите нам и мы обязательно свяжемся с вами!

bottom of page