Интеграция
СППВР ЭКФ в МИС
Памятка по интеграции Системы Поддержки Принятия Решений Электронный Клинический Фармаколог
в Медицинские Информационные Системы.
Спасибо, что помогаете интегрировать в вашу МИС СППВР ЭКФ и дать возможность врачам подбирать персонализированную фармакотерапию пациентам!
Для реализации интеграции вам будет необходим ключ, с помощью которого вы сможете обращаться к интеграционным методам и получать результат проверки взаимодействий внутри сформированного листа назначений.
Если у вас еще нет выданного ключа, можете запросить его, заполнив заявку по ссылке:
https://www.ecp.umkb.com/ecp-run
в разделе “Оставить заявку”.
Логика взаимодействия
СППВР ЭКФ и МИС
Основные шаги, которые необходимо реализовать на уровне МИС:
-
отправка запроса, содержащего сведения о фармакотерапии и пациенте
-
визуализация ответа с найденными внутри листа назначений предупреждениями
-
открытие iframe c интерфейсом СППВР ЭКФ
-
получение исправленной терапии пациента из iframe
Описание процесса
Step 1.
При добавлении каждого нового лекарственного средства МИС отправляет запрос к СППВР ЭКФ. Ответы системы необходимо отображать на мониторе врача таким образом, чтобы не отвлекать его от рабочего процесса.
Step 2.
В случае, если ответ системы содержит критическое предупреждение, то информацию необходимо выводить на экран в развернутом формате, автоматически открывая iframe с интерфейсом СППВР ЭКФ.
Отображение интерфейса СППВР ЭКФ внутри МИС
Step 3.
В случае, если ответ системы не содержит критических предупреждений , то ответы системы отображаются в интерфейсе МИС в виде виджета с индикацией уровня опасности.
Виджет СППВР ЭКФ в интерфейсе МИС
Step 4.
При клике на виджет раскрывается окно СППВР ЭКФ. При необходимости врач может более детально прочитать о предупреждении, редактировать лист назначения внутри интерфейса и повторно проверить назначения, нажав на кнопку «Проверить».
.jpg)
Проверка назначения
Step 5.
Закончив работу в интерфейсе СППВР ЭКФ, врач подтверждает свое окончательно принятое решение нажатием кнопки “Назначить”. При этом финальный лист назначения забирается обратно в ЭМК МИС.
Формат интеграции позволяет врачу, при клике на виджет СППВР ЭКФ, добавлять препараты или формировать новый лист назначения напрямую из интерфейса. И после формирования терапии, на этот раз используя интерфейс СППВР ЭКФ, нажав на кнопку «Назначить» данные о сформированной фармакотерапии передаются в МИС для загрузки в ЭМК.
Описание доступных интеграционных 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 визуализация проверок происходит следующим образом:
-
виджет ЭКФ окрашивается в цвет, соответствующий значению параметра danger;
-
окно с центром уведомлений предупреждает пользователя о конфликтах, обнаруженных внутри сформированной фармакотерапии согласно параметру caution с полной детализацией о том, какие именно препараты конфликтуют между собой, либо конфликтуют по типу взаимодействия.
-
при клике на виджет и уведомление пользователь может провалиться в интерфейс ЭКФ (открывается ссылка из параметра url) для более детального изучения информации о конфликтах
-
При подтверждении сформированной терапии с помощью нажатия кнопки «Подтвердить» в интерфейсе МИС, получая ответ от API /Pharm/V2/NewTherapy визуализация проверки происходит следующим образом. Появляется диалоговое окно с предупреждением о конфликтах, обнаруженных внутри сформированной фармакотерапии, согласно параметру caution с полной детализацией о том, какие именно препараты конфликтуют между собой, либо конфликтуют по типу взаимодействия. При том, у пользователя нет возможности скрыть диалоговое окно, необходимо подтвердить или отменить действие.
Весь сценарий выстроен таким образом, чтобы максимально удобно для врача и не отвлекая его внимания на лишние действия, предупредить о конфликтах в листе назначения, который он формирует и сопроводить процесс по доработке данного листа назначения.
-
Как узнать, когда забирать данные с ЭКФ в МИС (произошло назначение в ЭКФ)?Способы могут различаться в зависимости от используемого стека технологий МИС. Например, можно забрать данные при событии потери фокуса окна ЭКФ в МИС.