Интеграция
ЭКФ в МИС
Памятка по интеграции Системы Поддержки Принятия Решений – Электронный Клинический Фармаколог (ЭКФ) в Медицинские Информационные Системы.
Перед Вами памятка по этапам интеграции ЭКФ в МИС и ответами на часто задаваемые вопросы, которые помогут сделать процесс интеграции быстрее и эффективнее.
Спасибо, что помогаете интегрировать в вашу Медицинскую Информационную Систему СППВР Электронный Клинический Фармаколог (ЭКФ) и дать возможность врачам подбирать персонализированную фармакотерапию пациентам!
Интеграция ЭКФ в МИС
Что необходимо, чтобы начать интеграцию ЭКФ в МИС?
Прежде чем приступить к интеграции ЭКФ в вашу МИС, необходимо проверить актуальность лицензионного ключа, направив POST запрос с указанием ключа (в значение параметра “key”) по адресу:
Если у вас еще нет выданного лицензионного ключа, можете запросить его, заполнив заявку на сайте ЭКФ:
https://www.ecp.umkb.com/ecp-run
в разделе “Оставить заявку”.
Логика взаимодействия
ЭКФ и МИС
Основные функции, которые необходимо интегрировать в МИС - проверка и запись листа назначения, получение ссылки на результаты проверки в веб-интерфейсе ЭКФ и актуальной терапии пациента. Данные функции представлены в следующем процессе:
Step 1.
Каждый сформированный врачом лист назначения в ЭМК (электронно-медицинской карте) вашего МИС может отправляться в систему ЭКФ для проверки на ошибки и совместимость. Ответы системы желательно отображать на мониторе врача таким образом, чтобы не отвлекать его от рабочего процесса.
Step 2.
В случае, если ответ системы содержит критическое предупреждение (danger - критический и высокий уровень опасности) >0.5 и ≤1, то информацию необходимо выводить на экран в развернутом формате, раскрывая веб-интерфейс ЭКФ. Например, главное информационное окно ЭКФ всплывает с правой части экрана внутри МИС.

Информационное окно ЭКФ
Step 3.
В случае, если ответ системы не содержит критических предупреждений (danger - критического и высокого уровня опасности), то ответы системы отображаются в интерфейсе МИСа в виде виджета с индикацией уровня опасности. Например, в правом нижнем углу экрана, в виде голубой иконки ЭКФ, или, в зависимости от уровня опасности в виде желтой иконки ЭКФ (соблюдать с осторожностью).

Предупреждения в интерфейсе МИСа
Step 4.
При клике на вкладку с индикацией, раскрывается главное информационное окно ЭКФ. При необходимости врач может более детально прочитать о предупреждении, редактировать лист назначения в самом интерфейсе ЭКФ и повторно проверить назначения, нажав на кнопку «Проверить».
.jpg)
Проверка назначения
Step 5.
Закончив работу в интерфейсе ЭКФ, врач подтверждает свое окончательно принятое решение нажатием кнопки “Назначить”. При этом финальный лист назначения забирается обратно в ЭМК МИС.
Уровень данной интеграции также позволяет врачу, при клике на вкладку «ЭКФ» в правом нижнем углу экрана, добавлять препараты или формировать новый лист назначения сразу из интерфейса ЭКФ. И после формирования терапии, на этот раз используя интерфейс ЭКФ, нажав на кнопку «Назначить» данные о сформированной фармакотерапии передаются в МИС для загрузки в ЭМК.

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

Каждая из них представлена в белом и прозрачном варианте, чтобы было удобно сжать и подстроить ее под ваш интерфейс МИС.
Описание доступных API ЭКФ
Для осуществления данной логики взаимодействия между системами МИС и ЭКФ предоставляются следующие API:
Все запросы должны быть отправлены методом POST. Все ответы приходят в формате JSON (если не указано другое). Для запросов и ответов используется один и тот же формат передачи данных.
Внимание: приведённые ниже примеры описывают лишь структуру ожидаемых данных. Формат зависит от используемых для передачи запросов технологий. Во всех запросах должен присутствовать параметр key (ключ доступа) и/или authkey (временный токен авторизации).
API №1:
“Назначение пациенту новой фармакотерапии с отменой всех предыдущих назначений с проверкой”:
https://service.socmedica.com:9004/Mis/NewTherapy
Данный API предназначен для назначения новой фармакотерапии пациенту, при этом все предыдущие назначения отменяются. В API ответ возвращает итоговое значение максимального уровня опасности (параметр danger) и URL-ссылку, по которой можно запросить результат проверки листа назначения в web-интерфейсе ЭКФ. По данному запросу система ЭКФ анализирует лист назначения и данные пациента, формирует предупреждения и соответствующие рекомендации.
Посмотреть детализацию результатов проверки листа назначения в веб-интерфейсе ЭКФ можно перейдя по ссылке URL в API №1.
На данном этапе запроса к системе, также можно использовать альтернативный API:
https://service.socmedica.com:9004/Mis/ActualAddTherapy , когда требуется добавление нового прапарата в лист назначения без отмены предыдущих сформированных назначений. При этом все предыдущие описанные правила вывода интерфейса соблюдаются.
API №2:
“Получение актуальной фармакотерапии по коду”:
https://service.socmedica.com:9004/Mis/ActualTherapy
Данный API предназначен для передачи актуальной фармакотерапии из системы ЭКФ обратно в МИС, например, после корректировки листа назначения в интерфейсе ЭКФ, когда врач кликнул на кнопку “Назначить”. На стороне МИСа необходимо добавить полученные данные в электронную медицинскую карту пациента. Тем самым осуществляется синхронизация данных между системами.
Чтобы понять, когда забирать данные с ЭКФ в МИС есть разные способы в зависимости от используемого стека технологий МИС. Например, можно забрать данные при событии потери фокуса окна ЭКФ в МИС/запуске сообщения в postMessage и тд.
Более детальное описание API, представленных выше, формат передачи данных, примеры запросов и ответов JSON доступны в Swagger по ссылке https://ecpapi.socmedica.com
А также там представлены дополнительные API для решения смежных задач.
Все запросы должны быть отправлены методом POST. Все ответы приходят в формате JSON. Для запросов и ответов используется один и тот же формат передачи данных.
Внимание: приведённые ниже примеры описывают лишь структуру ожидаемых данных. Формат зависит от используемых для передачи запросов технологий. Во всех запросах должен присутствовать параметр key (ключ доступа) и/или authkey (временный токен авторизации).
-
Как узнать, когда забирать данные с ЭКФ в МИС (произошло назначение в ЭКФ)?Способы могут различаться в зависимости от используемого стека технологий МИС. Например, можно забрать данные при событии потери фокуса окна ЭКФ в МИС.