МИС | ECP

The clinical decision support system "Electronic Clinical Pharmacologist" takes into account specific patient peculiarities, history of a patient and drug interactions. It helps healthcare providers save time and facilitate their work

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

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

Скачать сценарий интеграции

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

Логика взаимодействия ЭКФ и МИС

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

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

Часто задаваемые вопросы

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

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

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

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

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

Логика

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

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

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

отправка запроса, содержащего сведения о фармакотерапии и пациенте
визуализация ответа с найденными внутри листа назначений предупреждениями
открытие iframe c интерфейсом СППВР ЭКФ
получение исправленной терапии пациента из iframe

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

Step 1.

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

Step 2.

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

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

Step 3.

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

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

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:

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

https://disk.yandex.ru/d/DCAlhwnFp3XtiA

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

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 с полной детализацией о том, какие именно препараты конфликтуют между собой, либо конфликтуют по типу взаимодействия. При том, у пользователя нет возможности скрыть диалоговое окно, необходимо подтвердить или отменить действие.

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

Рекомендации

FAQ

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

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

Написать