ЕСОЗ - публічна документація

Workshop по проєкту “Облік призначення та видачі медичних виробів”

Запис: https://drive.google.com/file/d/1vwo3QHSCshX6rm3506qWBfMWuiSL4YLe/view?usp=sharing

МЕМО/ теми що розглядалися та обговорювалися на зустрічі:

  1. Вступ

Документація

RC-кандидати документації на Confluence

 

Мета

Метою цього документу є окреслити основні зміни в функціональності, що забезпечуватиме облік призначень та видачі медичних виробів в Електронній системі охорони здоров’я.

Документ не є покроковою інструкцією до впровадження функціоналу на боці МІС. Розробка функціоналу повинна відбуватися згідно документації (специфікацій та апіарію) та технічних вимог до МІС. 

 

Глосарій

Properties - характеристики медичного виробу

Заклад охорони здоров’я - заклад, який надає медичні послуги та аптечний заклад.

Device Request - призначення медичного виробу. Термін “Призначення” уніфіковано та застосовано для усіх типів призначень, в тому числі і тих, що звуться “рецептом”.

Решта термінів та скорочень, що зустрічаються в цьому документі, є загальноприйнятою термінологією та визначеннями в ЕСОЗ.

  1. Особливості документації

Документація, що передана в рамках проекту “Облік призначення медичних виробів” містить частину опису функціональності, що буде реалізована в рамках проекту “Облік обладнання”. Таким чином, функціональність, згідно переліку нижче, відсутня на середовищах, не буде відображена в ТВ та не буде доступна до розробки МІС на даному етапі проекту.

  1. Процеси обліку призначення та видачі медичних виробів (виділення фіолетового кольору)

  2. Посилання на device та device_association в supporting_info

    1. Device request data model (опис поля supporting_info)

    2. Device dispense data model (опис поля supporting_info)

    3. Prequalify Device request (валідації - п.13, опис параметрів запиту і відповіді в API)

    4. Create Device request (валідації - п.8, опис параметрів запиту і відповіді в API)

    5. Submit Encounter Package (валідації - п.8, опис параметрів запиту і відповіді в API)

  3. Посилання на device в details.device

    1. Device dispense data model (опис поля details.device)

  4. Посилання на device в процесі обліку видачі в закладі охорони здоров'я в details.device

    1. Submit Encounter Package (валідації - п.11, опис параметрів запиту і відповіді в API)

  5. Пошук запису про облік визачі за device_id пошуковим параметром (зверну увагу, що device_id використовується також і для пошуку device_definition)

    1. Get device dispenses by search params in patient context (опис параметрів запиту і відповіді в API)

    2. Get Device dispenses by search params (опис параметрів запиту і відповіді в API)

  6. Отримання деталей запису про облік видачі з device в details.device

    1. Get Device dispense details (опис параметрів відповіді в API)

 

 

  1. Особливості функціоналу, що доступний МІС до реалізації

Призначення плану лікування з типом “медичний виріб”

  1. Лікар за бажанням або у разі вимог налаштувань медичнної програми (care_plan_required) створює план лікування та відповідне призначення плану лікування (далі - активність) із типом “медичний виріб”

  2. Активність може створюватися за програмою (у випадку реімбурсації медичних виробів) та без неї

  3. Активність може бути виписана як на тип медичного виробу, так і на модель медичного вирообу з урахуванням відповідних обмежень налаштування медичної програми (device_request_allowed_code_types)

  4. Залишкова кількість призначених виробів в активності (remaining_quantity) вираховується при подальшому створенні призначень медичних виробів. Зворотного перерахунку при позначенні призначень помилковими або відкликань призначення не відбувається

Призначення медичних виробів

  1. Призначення медичних виробів  (далі - призначення) відбувається за програмою та без неї.

    1. особливості створення призначення за програмою

      1. обліковуються лише в рамках процесів реімбурсації медичних виробів та містять спеціальні умови згідно налаштувань медичних програм

      2. завжди містить кількість медичних виробів (details.quantity)

      3. наявна можливість призначити: тип (code) чи модель медичного виробу (device_definition) - визначається налаштуваннями програми device_request_allowed_code_types

      4. перед створенням призначення є можливість перевірити валідність запиту методом PreQualify Device request. Така перевірка повинна виконуватися обов’язково.

    2. особливості створення  призначення  без програми

      1. може не містити кількості медичних виробів за рішенням лікаря 

      2. можливість призначити: тип чи модель медичного виробу - визначається за рішенням лікаря

      3. відсутній контроль за призначенням того ж медичного виробу за один курс лікування

    3. при створенні призначень за програмою та без неї лікар 

      1. обов’язково визначає взаємодію, в рамках якої створено призначення (encounter) 

      2. за необхідності посилається на активність та план лікування, на основі якої створюється поточне призначення (based_on)

      3. за необхідності визначає причину (обгрунтування) створення призначення (reason): діагноз (condition), діагностичний звіт (diagnostic report)  або  спостереження (observation)

      4. за необхідності визначити пріоритет призначення (priority) з довідника device_request_priority

      5. за необхідності визначити додаткову інформацію, необхідну виконавцю призначення (supporting_info)

      6. за необхідності визначає рекомендований заклад-виконавця призначення (performer)

      7. за необхідності визначає конкретні характеристики виробу (parameter)

  2. Після створення призначення лікар має можливість: 

    1. відкликати призначення у випадку, якщо воно втратило необхідність (в такому разі призначення переходить в статус revoked, а пацієнт отримує відповідне інформування згідно логіки, що описана нижче)

    2. позначити призначення помилковим, обов’язково зазначивши причину помилковості із словника device_request_mark_in_error_reasons (в такому разі призначення переходить в статус entered_in_error)

      1. причому позначити призначення помилковим можна і тоді, коли воно знаходиться в статусах completed та revoked

    3. завершити призначення у випадку, якщо воно створювалось без кількості (в такому разі призначення переходить в статус completed) - дія доступна як лікарю так і фармацевту

Видача медичних виробів 

  1. Видача медичних виробів може бути такими маршрутами:

    1. призначення створено за програмою → 

  1. вказання медичної програми є обов’язковим

  2. може здійснюватися лише в аптечному закладі

  3. в повному обсязі (тобто без можливості часткової видачі)

  4. аптечний заклад повинен мати діючу ліцензію з типом PHARMACY, договір про реімбурсацію з НСЗУ та провіжен на відповідну медичну програму

  5. перед погашенням застосовується перевірка можливості видачі медичних виробів за програмами реібмурсауції 

  6. можна зазначити лише модель медичного виробу, що доступна за медичною програмою

  7. потрібен код верифікації для здійснення видачі

  8. процес видачі є двоетапним - створення та підпис запиту, після чого призначення переходить в статус completed

  1. призначення створено без програми → 

    1. медична програма не вказується

    2. може виконуватися і в ЗОЗ, і в аптечному закладі

    3. можлива часткова видача, результатом якої є зменшення залишкової кількості медичних виробів в призначенні (remaining_quantity)

    4. перевірка можливості видавати медичні вироби за програмою не використовується

    5. можна зазначити і модель і тип медичного виробу

    6. видача здійснюється без коду верифікації

    7. процес видачі однокроковий - створення запиту, після чого статус видачі переходить в completed

  1. Видача медичних виробів в ЗОЗ має додаткові особливості

  1. реєструється в рамках пакету взаємодії з накладення КЕП

  2. може обліковуватися як на підставі призначення, так і без посилання на призначення

  3. може містити посилання на процедуру (part_of) та іншу додаткову медичну інформацію (supporting_info), що пов’язана із видачею медичних виробів

  4. обліковується

    1. як видача медичних виробів. В такому разі: 

      1. статус видачі встановлюється як completed

      2. змінюється залишкова кількість медичних виробів (remaining_quantity)

      3. статус призначення встановлюється як completed у випадку вичерпання усієї кількості медичних виробів

    2. так і не видача медичних виробі. В такому разі 

      1. статус видачі встановлюється як decline

      2. залишкова кількість медичних виробів не змінюється

      3. статус призначення не змінюється

  1. Запис про облік видачі медичного виробу може бути позначеним помилковим

    1. доступно як в ЗОЗ так і в аптечному закладі за допомогою методу

    2. в ЗОЗ додатково може обліковуватися в рамках скасування пакету взаємодії

    3. зазначається причина помилковості із словника device_dispense_mark_in_error_reasons

    4. запис не можна позначити помилковим, якщо він уже знаходиться в статусі entered-in-error або completed

    5. запис про видачу переходить в статус entered-in-error

  2. Фармацевт також може завершити призначення у випадку, якщо воно створювалось без кількості (в такому разі призначення переходить в статус completed)

  3. Наразі для отрмання записів про облік видачі медичних виробів застосовується метод Get Device dispenses by search params

    1. Разом з тим реалізовано інший метод для цього процесу: Get Device dispenses by search params in patient context, який буде використовуватися як ЗОЗ, так і аптечним закладом

    2. Перехід на новий метод буде забезпечено за таким алгоритмом:

      1. Включення функціоналу “Призначення медичних виробів” до ТВ

      2. Перетестування МІС в рамках функціоналу за проектом “Призначення медичних виробів”

      3. Реліз функціоналу на Прод

      4. Через 30 днів з дня релізу функціоналу на Прод старий метод буде Deprecated

  4. Доступ до отримання даних про видчу медичних виробів регулюється на рівні скоупів, а в окремих випадках на рівні АВАС правил

 

Налаштування медичних програм

  1. Додано нове налаштування device_request_allowed_code_types, яке визначає що можна вказати в призначенні: тип чи/та модель медичного виробу

  2. Проведено уніфікацію назв параметрів налаштувань для лікарських засобів та медичних виробів

    1. В рамках перехідного періоду значення параметрів будуть продубльовані.

    2. Через деякий час, старі параметри будуть недоступними користувачам, тому МІС необхідно врахувати нові назви параметрів у своїх процесах. 

    3. Послідовність кроків виведення старих параметрів програм буде наступна:

  1. Включення функціоналу “Призначення медичних виробів” до ТВ

  2. Перетестування МІС в рамках функціоналу за проектом “Призначення медичних виробів”

  3. Реліз функціоналу на Прод

  4. Через 30 днів з дня релізу функціоналу на Прод

 

 

Інформування пацієнта про операції з призначенням

  1. Пацієнт отримую СМС інформацію про створення, відкликання, позначення помилковим та завершення призначення.

  2. Логіка інформування пацієнта про створення призначення:

 

w/o medical program and DEVICE_REQUESTS_SMS_ENABLED = true

w/o medical program and DEVICE_REQUESTS_SMS_ENABLED = false

medical program

(request_notification_disabled = false)

medical program

(request_notification_disabled = true)

Пацієнт OTP

sms w/o code,

with request_number

printform w/o code, 

with request_number

sms with code,

with request_number

printform with code,

with request_number

Пацієнт OFFLINE

printform w/o code, with request_number

printform w/o code, with request_number

printform with code,

with request_number

printform with code,

with request_number

ЕСОЗ - публічна документація