Интеграция

ЭКФ в МИС

Памятка по интеграции Системы Поддержки Принятия Решений – Электронный Клинический Фармаколог (ЭКФ) в Медицинские Информационные Системы.

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

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

 

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

Что необходимо, чтобы начать интеграцию ЭКФ в МИС.

Прежде чем приступить к интеграции ЭКФ в вашу МИС, необходимо проверить актуальность лицензионного ключа, направив POST запрос по адресу с указанием ключа (в значение параметра “key”):

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

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

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

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

ЭКФ и МИС

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

Step 1.

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

Step 2.

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

Информационное окно ЭКФ

Step 3.

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

yellow

Предупреждения в интерфейсе МИСа

Step 4.

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

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

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 (временный токен авторизации).

 

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

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

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