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

RC-[UPD] Процеси роботи з призначеннями медичних виробів

Owned by Oleksandr Zhuk (SoE eHealth)
Feb 05, 2024
16 min read

Мета

Створення призначення з видачі медичних виробів (далі - призначення) — це процес створення лікарем замовлення, на основі якого виконується видача медичних виробів пацієнту. Процес передбачає перелік методів та контролів для правильного тлумачення вказаного в призначенні замовлення лікаря.
Нижче наведені ключові моменти, на яких побудовано процес створення призначення та які є важливими для забезпечення правильного відпуску медичних виробів:

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

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

    1. Призначення медичних виробів може бути частиною призначення плану лікування.

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

    3. Призначення, можуть бути створені за медичною програмою реімбурсації. Такі програми мають спеціальні умови призначення та видачі медичних виробів відповідно до налаштування програми Medical program settings.

    4. Пацієнт отримує номер призначення та код погашення (за наявності медичної програми та відповідних налаштувань) в залежності від методу аутентифікації:

      1. OTP, через смс-код на вказаний номер телефону

      2. OFFLINE (або на вимогу пацієнта), через друковану форму.

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

  4. Пацієнт може звернутися до працівника медичного закладу за повторним отриманням смс-повідомлення з номером призначення та кодом погашення (за наявності медичної програми та відповідних налаштувань). Повторне отримання SMS повідомлення за призначенням.

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

    1. Співробітник може помітити призначення як помилкове, якщо воно не перебуває у позначеному як помилкове стані. Позначення призначення помилковим

    2. Співробітник може скасувати призначення, якщо в ньому більше немає потреби. Скасування призначення

    3. Співробітник може завершити призначення, якщо призначення не містить кількості і в ньому більше немає потреби. Завершення призначення.

Концептуальна схема бізнес-процесів

DeviceRequests.drawio.png

Source:

Перевірка відповідності призначення вимогам медичних програм

Схема бізнес процесу

Source:

Опис бізнес процесу

Крок

Опис

Крок

Опис

1

Здійснити пошук пацієнта

Search for a person v3

Користувач:

  1. Виконує пошук пацієнта

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Наявність відповідного скоупу

    2. Користувач не заблокований

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  3. Повертає перелік пацієнтів

2

Отримати перелік типів медичних виробів

Get dictionaries v2

Користувач:

  1. Виконує пошук типу медичного виробу з використанням необхідних пошукових параметрів

    1. Назва класифікатора (name = device_classification_type)

    2. Код (value_code)

    3. Опис (value_description)

    4. Статус (is_active)

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Наявність відповідного скоупу

    2. Користувач не заблокований

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  3. Повертає перелік типів медичних виробів

3

АБО

4

Отримати перелік моделей медичних виробів

Get Device definitions

Користувач:

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

    1. Назва (name)

    2. Тип назви (name_type)

    3. Тип (classification_type)

    4. Статус (is_active)

    5. Номер моделі (model_number)

    6. Медична програма (medical_program_id)

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Наявність відповідного скоупу

    2. Користувач не заблокований

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  3. Повертає перелік моделей медичних виробів

5

Заповнити дані призначення

 

Користувач:

  1. Обирає та заповнює необхідну інформацію:

    1. Пацієнта (subject)

    2. Посилання на призначення плану лікування (activity), на основі якого створюється поточне призначення (based_on)

      1. Тільки одне посилання

    3. Намір призначення (intent)

    4. Тип (code) або посилання на запис реєстру медичних виробів (code_reference)

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

    5. Кількість медичних виробів, які потрібно отримати пацієнтові за призначенням (quantity)

    6. Період лікування, на який виписується призначення (occurrence_period)

    7. Посилання на взаємодію (encounter)

    8. Причину (обґрунтування) створення призначення (reason)

    9. Працівника, що є ініціатором призначення (requester)

    10. Дату створення призначення (authored_on)

    11. Пріоритет призначення (priority)

    12. Конкретні параметри виробу (parameter)

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

    14. Заклад, який рекомендований лікарем як виконавець призначання (performer)

    15. Медичну програму, в рамках якої виписується призначення (program)

6

Обрати медичну програму

Search Medical programs

Користувач:

  1. Виконує пошук медичної програми з указанням необхідних пошукових параметрів (тип програми Медична програма з видачі медичних виробів (DEVICE))

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Наявність відповідного скоупу

    2. Користувач не заблокований

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  3. Повертає перелік медичних програм

7

Перевірити відповідність призначення вимогам медичних програм

RC-[UPD] PreQualify Device requestarchived

Користувач:

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

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Наявність відповідного скоупу

    2. Користувач не заблокований

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

    1. Пацієнта (subject)

      1. є активним та не неверифікованим

    2. Посилання на призначення плану лікування (activity), на основі якого створюється поточне призначення (based_on)

      1. є запланованим або в роботі (status IN (scheduled, in progress))

      2. відноситься до того ж пацієнта (subject)

      3. посилання має бути обов'язковим, якщо вказана медична програма та атрибут налаштування care_plan_required = true (в такому випадку є можливість послатись тільки на призначення плану лікування)

      4. вид призначення плану лікування (kind) має Призначення з видачі медичних виробів (device_request)

      5. тип (code) або модель (code_reference) призначення повинен співпадати з типом (product_codeable_concept) або моделлю (product_reference) призначення плану лікування (activity)

      6. одиниці вимірювання (quantity.code) призначення повинен співпадати з одиницями вимірювання (quantity.code) призначення плану лікування (activity)

      7. залишкова кількість в призначенні плану лікування (розраховується як різниця між кількістю в призначенні плану лікування мінус сума всіх кількостей всіх призначень, які створені на основі нього) не менша кількості, що вказана у призначенні (quantity)

      8. період призначення плану лікування (activity.scheduled.period) має охоплювати період призначення (occurence_period)

        1. у випадку, коли графік призначення плану лікування (activity.scheduled) заданий часом (activity.[].scheduled_timing) перевіряється входження в період (activity.bounds_period)

        2. у випадку, коли графік призначення плану лікування (scheduled) заданий періодом (activity.[].scheduled_period) перевіряється входження в період (activity.scheduled_period)

        3. в інших випадках перевірка здійснюється з періодом плану лікування такого призначення (care_plan.period)

      9. наявність та значення (у разі наявності) медичної програми повинно співпадати (program)

    3. Перевіряє намір призначення (intent)

      1. відповідає значенню зі словника device_request_intent

    4. Тип (code) або посилання на запис реєстру медичних виробів (code_reference)

      1. при вказанні медичної програми

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

      2. активний статус (is_active = true)

      3. при вказанні типу (code) та наявності медичної програми має бути хоча б одна модель виробу (device_definition) з відповідним типом та має бути хоча б один активний та доступний участник (program_device.is_active = true, start_date <= today <= end_date)

      4. при вказанні моделі (code_reference) та наявності медичної програми має бути хоча б один активний та доступний участник (program_device.is_active = true, start_date <= today <= end_date)

    5. Кількість медичних виробів, які потрібно отримати пацієнтові за призначенням (quantity):

      1. при вказанні медичної програми

        1. вказується обов'язково

        2. передана кількість менше або дорівнює кількість днів курсу лікування * максимум всіх program_devices.max_daily_count, що входять в таку програму та відповідають переданому device_request.code

      2. передана кількість кратна мінімуму з всіх device_definition.packaging_count, що входять в таку програму

      3. повинно бути цілим числом більшим за нуль

    6. Посилання на взаємодію (encounter)

      1. відноситься до того ж пацієнта (subject)

      2. створена в тому ж закладі (managing_organization)

      3. не позначена помилковою (entered_in_error)

    7. Причину (обгрунтування) створення призначення (reason)

      1. можливе посилання на діагностичний звіт (diagnostic report), спостереження (observation) або діагноз (condition)

    8. Працівника, що є ініціатором призначення (requester)

      1. є активним (approved)

      2. відповідає виконавцю взаємодії (encounter.performer)

      3. якщо в атрибуті employee_types_to_create_request зазначений хоча б один тип медичного працівника та skip_employee_validation = false,  то виконується перевірка відповідності цього типу (або всіх типів, що містить даний атрибут) працівника,що вказаний в призначенні 

      4. якщо в атрибуті speciality_types_allowed зазначена хоча б одна спеціальність медичного працівника та skip_employee_validation = false та тип працівника SPECIALIST, то виконується перевірка відповідності спеціальності автора призначення, тому переліку що вказаний в програмі

      5. якщо атрибут skip_request_employee_declaration_verify = false та тип працівника DOCTOR, то здійснюється перевірка наявності активної декларації у пацієнта, яка укладена з медичним працівником, який є автором призначення

      6. якщо атрибут skip_request_legal_entity_declaration_verify = false та тип працівника DOCTOR, то здійснюється перевірка наявності активної декларації у пацієнта, яка відноситься до закладу медичного працівника, який є автором призначення

    9. Дату створення призначення (authored_on)

      1. знаходиться у проміжку періоду взаємодії (period)

      2. менша за поточну дату мінус конфігурований час, який дозволений для внесення даних

    10. Пріоритет призначення (priority)

      1. відповідає значенню зі словника device_request_priority

    11. Медичну програму, в рамках якої виписується призначення (program)

      1. є активна (active)

      2. тип програми Медична програма з видачі медичних виробів (DEVICE)

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

      1. можливе посилання на діагностичний звіт (diagnostic report), спостереження (observation) або діагноз (condition), процедуру (procedure), взаємодію (encounter), епізод (episode), запис про медичний виріб (device), запис про асоціацію медичного виробу з пацієнтом (device_association)

      2. відноситься до того ж пацієнта (subject)

      3. посилання на медичні записи не позначені помилковими (entered_in_error)

    13. Заклад, який рекомендований лікарем як виконавець призначання (performer)

      1. Є активним (active) або призупиненим (suspended)

    14. Період лікування, на який виписується призначення (occurrence_period)

      1. при вказанні медичної програми

        1. вказується обов'язково

      2. дата початку періоду повинна бути більше або дорівнювати даті створення призначення (authored_on)

      3. дата закінчення періоду повинна бути більша за дату початку

    15. Конкретні параметри виробу (parameter)

    16. Можливість повторного виписування медичного виробу

      1. при вказанні медичної програми

        1. якщо атрибут налаштувань медичної програми skip_request_in_treatment_period = false, то виконується перевірка наявності у пацієнта активного призначення на медичний виріб за цією ж програмою з аналогічним типом (code) виробу або посиланням на модель виробу (code_reference)

          1. існуюче призначення має період лікування менше рівне 21 дня і до закінчення цього періоду залишилось більше ніж 3 днів

          2. існуюче призначення має період лікування більше 21 дня і до закінчення цього періоду залишилось більше ніж 7 днів

        2. якщо атрибут налаштувань медичної програми skip_request_in_treatment_period = true або відсутній, періодичність створення призначення на тип або модель медичного виробу не обмежується

  3. Перевіряє відповідність запиту на створення призначення кожній з обраних користувачем медичних програм. Кожна медична програма має окрему логіку валідації, налаштовану адміністратором НСЗУ у налаштуваннях медичної програми.

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

Створення призначення

Схема бізнес процесу

Source:

Опис бізнес процесу

 

Крок

Опис

 

Крок

Опис

1

Здійснити пошук пацієнта

Search for a person v3

Користувач:

  1. Виконує пошук пацієнта

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Наявність відповідного скоупу

    2. Користувач не заблокований

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  3. Повертає перелік пацієнтів

2

Отримати перелік типів медичних виробів

Get dictionaries v2

Користувач:

  1. Виконує пошук типу медичного виробу з використанням необхідних пошукових параметрів

    1. Назва класифікатора (name = device_classification_type)

    2. Код (value_code)

    3. Опис (value_description)

    4. Статус (is_active)

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Наявність відповідного скоупу

    2. Користувач не заблокований

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  3. Повертає перелік типів медичних виробів

3

АБО

4

Отримати перелік моделей медичних виробів

Get Device definitions

Користувач:

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

    1. Назва (name)

    2. Тип назви (name_type)

    3. Тип (classification_type)

    4. Статус (is_active)

    5. Номер моделі (model_number)

    6. Медична програма (medical_program_id)

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Наявність відповідного скоупу

    2. Користувач не заблокований

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  3. Повертає перелік моделей медичних виробів

5

Заповнити дані на створення призначення

 

Користувач:

  1. Обирає та заповнює необхідну інформацію:

    1. Пацієнта (subject)

    2. Посилання на призначення плану лікування (activity), на основі якого створюється поточне призначення (based_on)

      1. Тільки одне посилання

    3. Намір призначення (intent)

    4. Тип (code) або посилання на запис реєстру медичних виробів (code_reference)

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

    5. Кількість медичних виробів, які потрібно отримати пацієнтові за призначенням (quantity)

    6. Період лікування, на який виписується призначення (occurrence_period)

    7. Посилання на взаємодію (encounter)

    8. Причину (обґрунтування) створення призначення (reason)

    9. Працівника, що є ініціатором призначення (requester)

    10. Дату створення призначення (authored_on)

    11. Пріоритет призначення (priority)

    12. Конкретні параметри виробу (parameter)

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

    14. Заклад, який рекомендований лікарем як виконавець призначання (performer)

    15. Медичну програму, в рамках якої виписується призначення (program)

6

Відправити запит на створення призначення

RC-[UPD] Create Device requestarchived

Користувач:

  1. Відправляє запит на створення призначення, підписаний кваліфікованим електронним підписом (далі - КЕП).

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Наявність відповідного скоупу

    2. Користувач не заблокований

    3. Обліковий запис співробітника не неверифікований

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

    1. Пацієнта (subject)

      1. є активним та не неверифікованим

    2. Посилання на призначення плану лікування (activity), на основі якого створюється поточне призначення (based_on)

      1. є запланованим або в роботі (status IN (scheduled, in progress))

      2. відноситься до того ж пацієнта (subject)

      3. посилання має бути обов'язковим, якщо вказана медична програма та атрибут налаштування care_plan_required = true (в такому випадку є можливість послатись тільки на призначення плану лікування)

      4. вид призначення плану лікування (kind) має Призначення з видачі медичних виробів (device_request)

      5. тип (code) або модель (code_reference) призначення повинен співпадати з типом (product_codeable_concept) або моделлю (product_reference) призначення плану лікування (activity)

      6. одиниці вимірювання (quantity.code) призначення повинен співпадати з одиницями вимірювання (quantity.code) призначення плану лікування (activity)

      7. залишкова кількість в призначенні плану лікування (розраховується як різниця між кількістю в призначенні плану лікування мінус сума всіх кількостей всіх призначень, які створені на основі нього) не менша кількості, що вказана у призначенні (quantity)

      8. період призначення плану лікування (activity.scheduled.period) має охоплювати період призначення (occurence_period)

        1. у випадку, коли графік призначення плану лікування (activity.scheduled) заданий часом (activity.[].scheduled_timing) перевіряється входження в період (activity.bounds_period)

        2. у випадку, коли графік призначення плану лікування (scheduled) заданий періодом (activity.[].scheduled_period) перевіряється входження в період (activity.scheduled_period)

        3. в інших випадках перевірка здійснюється з періодом плану лікування такого призначення (care_plan.period)

      9. наявність та значення (у разі наявності) медичної програми повинно співпадати (program)

    3. Перевіряє намір призначення (intent)

      1. відповідає значенню зі словника device_request_intent

    4. Тип (code) або посилання на запис реєстру медичних виробів (code_reference)

      1. Тип (code) або посилання на запис реєстру медичних виробів (code_reference)

        1. при вказанні медичної програми

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

      2. активний статус (is_active = true)

      3. при вказанні типу (code) та наявності медичної програми має бути хоча б одна модель виробу (device_definition) з відповідним типом та має бути хоча б один активний та доступний участник (program_device.is_active = true, start_date <= today <= end_date)

      4. при вказанні моделі (code_reference) та наявності медичної програми має бути хоча б один активний та доступний участник (program_device.is_active = true, start_date <= today <= end_date)

    5. Кількість медичних виробів, які потрібно отримати пацієнтові за призначенням (quantity):

      1. при вказанні медичної програми

        1. вказується обов'язково

        2. передана кількість менше або дорівнює кількість днів курсу лікування * максимум всіх program_devices.max_daily_count, що входять в таку програму та відповідають переданому device_request.code

      2. передана кількість кратна мінімуму з всіх device_definition.packaging_count, що входять в таку програму

      3. повинно бути цілим числом більшим за нуль

    6. Посилання на взаємодію (encounter)

      1. відноситься до того ж пацієнта (subject)

      2. створена в тому ж закладі (managing_organization)

      3. не позначена помилковою (entered_in_error)

    7. Причину (обгрунтування) створення призначення (reason)

      1. можливе посилання на діагностичний звіт (diagnostic report), спостереження (observation) або діагноз (condition)

    8. Працівника, що є ініціатором призначення (requester)

      1. є активним (approved)

      2. відноситься до користувача, що виконує запит та накладає КЕП

      3. відповідає виконавцю взаємодії (encounter.performer)

      4. якщо в атрибуті employee_types_to_create_request зазначений хоча б один тип медичного працівника та skip_employee_validation = false,  то виконується перевірка відповідності цього типу (або всіх типів, що містить даний атрибут) працівника,що вказаний в призначенні 

      5. якщо в атрибуті speciality_types_allowed зазначена хоча б одна спеціальність медичного працівника та skip_employee_validation = false та тип працівника SPECIALIST, то виконується перевірка відповідності спеціальності автора призначення, тому переліку що вказаний в програмі

      6. якщо атрибут skip_request_employee_declaration_verify = false та тип працівника DOCTOR, то здійснюється перевірка наявності активної декларації у пацієнта, яка укладена з медичним працівником, який є автором призначення

      7. якщо атрибут skip_request_legal_entity_declaration_verify = false та тип працівника DOCTOR, то здійснюється перевірка наявності активної декларації у пацієнта, яка відноситься до закладу медичного працівника, який є автором призначення

    9. Дату створення призначення (authored_on)

      1. знаходиться у проміжку періоду взаємодії (period)

      2. менша за поточну дату мінус конфігурований час, який дозволений для внесення даних

    10. Пріоритет призначення (priority)

      1. відповідає значенню зі словника device_request_priority

    11. Медичну програму, в рамках якої виписується призначення (program)

      1. є активна (active)

      2. тип програми Медична програма з видачі медичних виробів (DEVICE)

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

      1. можливе посилання на діагностичний звіт (diagnostic report), спостереження (observation) або діагноз (condition), процедуру (procedure), взаємодію (encounter), епізод (episode), запис про медичний виріб (device), запис про асоціацію медичного виробу з пацієнтом (device_association)

      2. відноситься до того ж пацієнта (subject)

      3. посилання на медичні записи не позначені помилковими (entered_in_error)

    13. Заклад, який рекомендований лікарем як виконавець призначання (performer)

      1. Є активним (active) або призупиненим (suspended)

    14. Період лікування, на який виписується призначення (occurrence_period)

      1. при вказанні медичної програми

        1. вказується обов'язково

      2. дата початку періоду повинна бути більше або дорівнювати даті створення призначення (authored_on)

      3. дата закінчення періоду повинна бути більша за дату початку

    15. Конкретні параметри виробу (parameter)

    16. Можливість повторного виписування медичного виробу

      1. при вказанні медичної програми

        1. якщо атрибут налаштувань медичної програми skip_request_in_treatment_period = false, то виконується перевірка наявності у пацієнта активного призначення на медичний виріб за цією ж програмою з аналогічним типом (code) виробу або посиланням на модель виробу (code_reference).

          1. існуюче призначення має період лікування менше рівне 21 дня і до закінчення цього періоду залишилось більше ніж 3 днів

          2. існуюче призначення має період лікування більше 21 дня і до закінчення цього періоду залишилось більше ніж 7 днів

        2. якщо атрибут налаштувань медичної програми skip_request_in_treatment_period = true або відсутній, періодичність створення призначення на тип або модель медичного виробу не обмежується

    17. Розраховує термін виконання призначення (dispense_valid_to)

      1. без медичної програми

        1. не розраховується

      2. при вказанні медичної програми

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

  3. Надсилає SMS-повідомлення відповідно до шаблону (CREATE_DEVICE_REQUEST_SMS_TEMPLATE) в залежності від налаштувань медичної програми (для призначень за реімбурсацією) або конфігураційного параметру (для призначень без медичної програми або відсутності налаштування в медичній програмі для призначень за реімбурсацією)

    1. Якщо медична програма не передана, то пацєнту відправляється sms-повідомлення за шаблоном CREATE_DEVICE_REQUEST_SMS_TEMPLATE_WITHOUT_CODE, що не містить коду верифікації

  4. Повертає результати успішного виконання запиту або причину його відхилення

Для перевірки стану виконання завдання із створення запиту, визиваюча сторона повинна опитувати систему ЦБД за ідентифікатором завдання.

7

Отримання друкованої форми призначення

Користувач:

  1. Виконує отримання друкованної форми призначення інструментами MIS

8

Повторне отримання SMS-повідомлення призначення

RC-[UPD] Процеси роботи з призначеннями медичних виробів | Повторне отримання смс повідомлення за призначеннямarchived

Користувач виконує повторне відправлення SMS-повідомлення призначення відповідно до опису бізнес процесу.

Отримання призначення

Отримання призначення за номером

Схема бізнес процесу

Source:

Опис бізнес процесу

Крок

Опис

Крок

Опис

1

Отримати від пацієнта номер призначення

Користувач:

  1. Отримує запитує номер призначення від пацієнта (з смс-повідомлення або друкованої форми)

2

Здійснити пошук призначення за номером

RC-[UPD] Search for a Device requestsarchived

Користувач:

  1. Отримує отримав номер призначення від пацієнта

  2. Виконує пошук призначення за номером

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Наявність відповідного скоупу

    2. Користувач не заблокований

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

    1. Номер призначення (requisition)

  3. Повертає результати успішного виконання запиту (призначення) або причину його відхилення

Отримання призначення за ідентифікатором

Схема бізнес процесу

Source:

Опис бізнес процесу

Крок

Опис

Крок

Опис

1

Отримати ідентифікатор призначення з медичного запису або запиту

Користувач:

  1. Отримує ідентифікатор призначення з доступних медичних записів (device_dispense) або запитів (service_request)

2

Отримати контекст епізоду призначення

RC-[NEW] Get Device request contextarchived

Користувач:

  1. Отримав ідентифікатор призначення

  2. Виконує запит на отримання контексту епізоду

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Наявність відповідного скоупу

    2. Користувач не заблокований

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  3. Повертає результати успішного виконання запиту (контекст епізоду) або причину його відхилення

3

Запросити доступ на отримання інформації

Користувач:

  1. Вказує епізод за яким створено взаємодію, в рамках якої створено призначення

  2. Запрошує підтвердження доступу

  3. Верифікує підтвердження доступу

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Наявність відповідного скоупу

    2. Користувач не заблокований

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  3. Повертає ідентифікатор завдання із створення та верифікації підтвердження

4

Отримати деталі призначення

RC-[UPD] Get Device request detailsarchived

Користувач:

  1. Обирає деталі призначення

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту.

    1. Наявність відповідного скоупу

    2. Користувач не заблокований

    3. Доступ до інформації відбувається з використанням існуючої системи надання доступів (ABAC)

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

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

    1. отримується перелік записів про облік видачі в роботі (in progress) та завершеному (completed) стані, що створені на основі поточного призначення (device_dispense.based_on)

    2. розраховується використана сума в отриманих записах

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

    4. відображається актуальна кількість до погашення (remaining_qty)

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

Отримання призначення через пошук пацієнта

Схема бізнес процесу

Source:

Опис бізнес процесу

Крок

Опис

Крок

Опис

1

Здійснити пошук пацієнта

Search for a person v3

Користувач:

  1. Виконує пошук пацієнта

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Наявність відповідного скоупу

    2. Користувач не заблокований

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  3. Повертає перелік пацієнтів

2

Запросити доступ на отримання інформації

Користувач:

  1. Обирає необхідного пацієнта або епізод за яким створено взаємодію, в рамках якої створено призначення

  2. Запрошує підтвердження доступу

  3. Верифікує підтвердження доступу

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Наявність відповідного скоупу

    2. Користувач не заблокований

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  3. Повертає ідентифікатор завдання із створення та верифікації підтвердження

3

Здійснити пошук призначень за пошуковими параметрами

https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17730341846

Користувач:

  1. Виконує пошук призначень за пошуковими параметрами

    1. Посилання на план лікування, на основі якого створено призначення (context_care_plan_id)

    2. Призначення плану лікування, на основі якого створено призначення (activity_id)

    3. Епізод, на основі якого створено взаємодію, в рамках якої створено призначення (context_episode_id)

    4. Тип (code) або посилання на запис реєстру медичних виробів (code_reference_id)

    5. Період створення призначення (authored_on_from та authored_on_to)

    6. Cтатус призначення (status)

    7. Посилання на взаємодію (encounter_id)

    8. Працівника, що є ініціатором призначення (requester_id)

    9. Заклад, в якому створено призначення (requester_legal_entity_id)

    10. Заклад, який рекомендований лікарем як виконавець призначання (performer_id)

    11. Медичну програму, в рамках якої виписується призначення (program_id)

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту.

    1. Наявність відповідного скоупу

    2. Користувач не заблокований

    3. Доступ до інформації з використанням методу за пошуковими параметрами відбувається з використанням існуючої системи надання доступів (ABAC)

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  3. Повертає результати успішного виконання запиту (список призначень) або причину його відхилення

4

Отримати деталі призначення

RC-[UPD] Get Device request detailsarchived

Користувач:

  1. Обирає деталі призначення

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту.

    1. Наявність відповідного скоупу

    2. Користувач не заблокований

    3. Доступ до інформації відбувається з використанням існуючої системи надання доступів (ABAC)

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  3. Повертає результати успішного виконання запиту (призначення) або причину його відхилення

Повторне отримання смс-повідомлення за призначенням

Схема бізнес процесу

Source:

Опис бізнес процесу

Крок

Опис

Крок

Опис

1

Отримати призначення

https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17730341384#%D0%9E%D1%82%D1%80%D0%B8%D0%BC%D0%B0%D0%BD%D0%BD%D1%8F-%D0%BF%D1%80%D0%B8%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%BD%D1%8F

Користувач виконує отримання призначення відповідно до опису бізнес процесу.

2

Виконати запит на повторне відправлення SMS пацієнту

https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17730341887

Користувач:

  1. Обирає призначення, для якого потрібно повторно відправити SMS-повідомлення з інформацією про створення

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Наявність відповідного скоупу

    2. Користувач не заблокований

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  3. Перевіряє валідність переданих даних відповідно до бізнес правил:

    1. Виконати повторну відправку SMS з інформацією про створення призначення можна в Активному (ACTIVE) статусі

  4. Перевіряє наявність у пацієнта відповідного типу аутентифікації (OTP)

  5. Перевіряє можливість відправлення SMS в залежності від налаштувань медичної програми (для призначень за реімбурсацією) або конфігураційного параметру (для призначень без медичної програми або відсутності налаштування в медичній програмі для призначень за реімбурсацією)

  6. Перевіряє, чи не перевищено користувачем ліміт запитів на повторне відправлення SMS-повідомлень

    1. У разі, якщо ліміт запитів на даний момент перевищено, Система повертає причину відхилення запиту з указанням часу (UTC), коли користувачу буде доступна наступна спроба

  7. Надсилає SMS-повідомлення відповідно до шаблону CREATE_DEVICE_REQUEST_SMS_TEMPLATE (якщо призначення створено за медичною програмою) або CREATE_DEVICE_REQUEST_SMS_TEMPLATE_WITHOUT_CODE (якщо призначення створено без медичної програми)

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

  8. Повертає результати успішного виконання запиту (призначення) або причину його відхилення

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

Схема бізнес процесу

Source:

Крок

Опис

Крок

Опис

1

Отримати призначення

https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17730341384#%D0%9E%D1%82%D1%80%D0%B8%D0%BC%D0%B0%D0%BD%D0%BD%D1%8F-%D0%BF%D1%80%D0%B8%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%BD%D1%8F

Користувач виконує отримання призначення відповідно до опису бізнес процесу.

2

Заповнити дані та вказати причину позначення помилковим

Користувач:

  1. Обирає призначення, яке необхідно позначити помилковим

  2. Ініціює відправку запиту на позначення запису про призначення помилковим

3

Накласти КЕП та відправити запит на позначення помилковим

https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17730341905

Користувач:

  1. Відправляє запит на позначення призначення помилковим з накладанням КЕП.

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Наявність відповідного скоупу

    2. Користувач не заблокований

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

  2. Перевіряє кваліфікований електронний підпис

  3. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  4. Перевіряє валідність переданих даних відповідно до бізнес правил:

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

  5. Надсилає SMS-повідомлення відповідно до шаблону (MARK_IN_ERROR_DEVICE_REQUEST_SMS_TEMPLATE) в залежності від налаштувань медичної програми (для призначень за реімбурсацією) або конфігураційного параметру (для призначень без медичної програми або відсутності налаштування в медичній програмі для призначень за реімбурсацією)

  6. Змінює статус призначення (відповідно до https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17730341613) на Позначений помилковим (ENTERED_IN_ERROR)

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

Для перевірки стану виконання завдання із створення запиту, визиваюча сторона повинна опитувати систему ЦБД за ідентифікатором завдання.

Скасування призначення

Схема бізнес процесу

Source:

Опис бізнес процесу

Крок

Опис

Крок

Опис

1

Отримати призначення

https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17730341384#%D0%9E%D1%82%D1%80%D0%B8%D0%BC%D0%B0%D0%BD%D0%BD%D1%8F-%D0%BF%D1%80%D0%B8%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%BD%D1%8F

Користувач виконує отримання призначення відповідно до опису бізнес процесу.

2

Заповнити дані та вказати причину скасування

Користувач:

  1. Обирає призначення, яке необхідно скасувати

  2. Заповнює дані з вказанням причини скасування

  3. Ініціює відправку запиту на скасування призначення

3

Накласти КЕП та відправити запит на скасування

https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17730341923

Користувач:

  1. Відправляє запит на скасування призначення з накладанням КЕП.

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Наявність відповідного скоупу

    2. Користувач не заблокований

    3. Скасувати призначення може будь-який співробітник з відповідними правами доступу (скоуп device_request:revoke)

  2. Перевіряє кваліфікований електронний підпис

  3. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  4. Перевіряє валідність переданих даних відповідно до бізнес правил:

    1. Скасувати призначення можна в Активному (ACTIVE) статусі

  5. Надсилає SMS-повідомлення відповідно до шаблону (REVOKE_DEVICE_REQUEST_SMS_TEMPLATE) в залежності від налаштувань медичної програми (для призначень за реімбурсацією) або конфігураційного параметру (для призначень без медичної програми або відсутності налаштування в медичній програмі для призначень за реімбурсацією)

  6. Змінює статус призначення (відповідно до https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17730341613) на Скасований (REVOKED)

  7. Повертає результати успішного виконання запиту (призначення з оновленим статусом) або причину його скасування

Для перевірки стану виконання завдання із створення запиту, визиваюча сторона повинна опитувати систему ЦБД за ідентифікатором завдання.

Завершення призначення

Схема бізнес процесу

Source:

Крок

Опис

Крок

Опис

1

Отримати призначення

https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17730341384#%D0%9E%D1%82%D1%80%D0%B8%D0%BC%D0%B0%D0%BD%D0%BD%D1%8F-%D0%BF%D1%80%D0%B8%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%BD%D1%8F

Користувач виконує отримання призначення відповідно до опису бізнес процесу.

2

Обрати призначення

Користувач:

  1. Обирає призначення, яке необхідно завершити

  2. Обирає призначення та вказує причину завершення

  3. Ініціює відправку запиту на завершення призначення

3

Відправити запит на завершення

https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17730341941

Користувач:

  1. Обирає призначення, яке необхідно завершити та вказує причину завершення

  2. Відправляє запит на завершення призначення

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Наявність відповідного скоупу

    2. Користувач не заблокований

    3. Завершити призначення може будь-який співробітник з відповідними правами доступу (скоуп device_request:complete)

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  3. Перевіряє валідність переданих даних відповідно до бізнес правил:

    1. Завершити призначення можна в Активному (ACTIVE) статусі

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

  4. Надсилає SMS-повідомлення відповідно до шаблону (COMPLETE_DEVICE_REQUEST_SMS_TEMPLATE) в залежності від налаштувань медичної програми (для призначень за реімбурсацією) або конфігураційного параметру (для призначень без медичної програми або відсутності налаштування в медичній програмі для призначень за реімбурсацією)

  5. Змінює статус призначення (відповідно до https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17730341613) на Завершений (COMPLETED)

  6. Повертає результати успішного виконання запиту (призначення з оновленим статусом) або причину його скасування

Для перевірки стану виконання завдання із створення запиту, визиваюча сторона повинна опитувати систему ЦБД за ідентифікатором завдання.

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