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

Search for a person v3

Користувач:

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

Система e-Health:

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

   1. Валідність токену доступу

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

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

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

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

Get dictionaries v2

Користувач:

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

   1. Назва класифікатора (name = один із довідників вказаних у конфігурації prescribable_device_codes)

   2. Код (value_code)

   3. Опис (value_description)

   4. Статус (is_active)

Система e-Health:

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

   1. Валідність токену доступу

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

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

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

АБО

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

https://e-health-ua.atlassian.net/wiki/spaces/REHABILIT/pages/18431016994/UPD+Get+Device+definitions

https://e-health-ua.atlassian.net/wiki/spaces/REHABILIT/pages/18431246359/NEW+Get+Device+definitions+V2

Користувач:

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

   1. Назва (name)

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

   3. Тип (classification_type)

      1. Для версії 2 пошуку використовується пара параметрів: classification_type_system та classification_type_code які працюють за принципом логічного AND - якщо вказано обидва параметри, буде знайдено всі записи, в яких присутня така пара параметрів.

   4. Статус (is_active)

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

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

Система e-Health:

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

   1. Валідність токену доступу

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

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

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

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

Користувач:

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

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

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

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

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

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

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

      2. Незалежно від наявності програми, можливий тип регламентовано налаштуваннями конфіграції prescribable_device_codes

   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)

   16. Метод аутентифікації, на який буде відправка смс (authorize_with)

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

Search Medical programs

Користувач:

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

Система e-Health:

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

   1. Валідність токену доступу

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

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

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

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

https://e-health-ua.atlassian.net/wiki/spaces/REHABILIT/pages/18430591142/UPD+PreQualify+Device+request

Користувач:

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

Система e-Health:

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

   1. Валідність токену доступу

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

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

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

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

      2. не є преперсоною (preperson)

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

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

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

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

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

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

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

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

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

      9. період призначення плану лікування (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)

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

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

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

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

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

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

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

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

            1. вибір створення призначення на тип визначається конфігурацією prescribable_device_codes

            2. вибір створення призначення на code_reference визначається через конфігурацію prescribable_device_codes: хоча б один тип моделі виробу має входити у вказану конфігурацію

            3. класифікатор типу виробу має бути вказаний тільки один

      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. містить діагнози (diagnosis)

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

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

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

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

   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_treatment_period = false, то виконується перевірка наявності у пацієнта активного призначення на медичний виріб за цією ж програмою з аналогічним типом (code) виробу або посиланням на модель виробу (code_reference).

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

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

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

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

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

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

Search for a person v3

Користувач:

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

Система e-Health:

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

   1. Валідність токену доступу

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

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

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

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

Get dictionaries v2

Користувач:

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

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

   2. Код (value_code)

   3. Опис (value_description)

   4. Статус (is_active)

Система e-Health:

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

   1. Валідність токену доступу

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

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

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

АБО

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

https://e-health-ua.atlassian.net/wiki/spaces/REHABILIT/pages/18431016994/UPD+Get+Device+definitions

https://e-health-ua.atlassian.net/wiki/spaces/REHABILIT/pages/18431246359/NEW+Get+Device+definitions+V2

Користувач:

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

   1. Назва (name)

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

   3. Тип (classification_type)

      1. Для версії 2 пошуку використовується пара параметрів: classification_type_system та classification_type_code які працюють за принципом логічного AND - якщо вказано обидва параметри, буде знайдено всі записи, в яких присутня така пара параметрів.

   4. Статус (is_active)

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

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

Система e-Health:

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

   1. Валідність токену доступу

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

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

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

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

Користувач:

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

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

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

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

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

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

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

      2. Незалежно від наявності програми, можливий тип регламентовано налаштуваннями конфіграції prescribable_device_codes

   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)

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

https://e-health-ua.atlassian.net/wiki/spaces/REHABILIT/pages/18431246338/UPD+Create+Device+request

Користувач:

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

Система e-Health:

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

   1. Валідність токену доступу

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

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

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

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

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

      2. не є преперсоною (preperson) за наявності медичної програми

   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. незалежно від наявності медичної програми

            1. вибір створення призначення на тип визначається конфігурацією prescribable_device_codes

            2. вибір створення призначення на code_reference визначається через конфігурацію prescribable_device_codes: хоча б один тип моделі виробу має входити у вказану конфігурацію

            3. класифікатор типу виробу має бути вказаний тільки один

      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. містить діагнози (diagnosis)

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

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

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

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

   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, то здійснюється перевірка наявності активної декларації у пацієнта, яка відноситься до закладу медичного працівника, який є автором призначення

      8. додатково, якщо виріб, обраний для призначення, віднесено до виробів ДЗР конфігурацією dictionaries_configurations, здійснюється перевірка основної спеціальності лікаря налаштуванням параметру ASSISTIVE_DEVICES_SPECIALITIES_ALLOWED

   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)

       1. Якщо конфігурацією devices_configurations задано перелік параметрів для коду призначеного виробу або коду/кодів класифікаторів вказаних для моделі виробу, в запиті мають бути включеними всі параметри, визначені в конфігурації

          1. При цьому в запиті можуть бути присутніми також і інші параметри

          2. Якщо призначення на модель виробу і для декількох кодів класифікаторів моделі виробу конфігурацією визначений набір параметрів, їх значення мають бути заданими або у призначенні, або для моделі виробу. При цьому:

             1. Якщо для моделі виробу вказане одне можливе значення параметру - такий параметр може бути або відсутнім у призначенні, або мати значення що дорівнює значенню цього параметру, заданому для моделі виробу

             2. Якщо для моделі виробу вказане більше одного можливого значення параметру - такий параметр має бути присутнім у призначенні і мати значення що дорівнює одному зі значень цього параметру, заданих для моделі виробу

       2. Типи параметрів мають відповідати конфігурації device_parameters_configurations якщо конфігурація для параметру існує

       3. Значення параметрів мають входити в перелік значень визначених в блоці DEVICE_PARAMETER_ALLOWED_VALUES конфігурації для виробу, якщо такі обмеження задані

       4. В межах призначення будь-який параметр може бути присутнім один раз за виключенням параметру із кодом default

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

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

          1. якщо атрибут налаштувань медичної програми skip_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) або конфігураційного параметру (device_dispense_period)

3. Надсилає SMS-повідомлення

   1. для призначень за програмою в залежності від налаштувань медичної програми (для призначень за реімбурсацією) відповідно до шаблону CREATE_DEVICE_REQUEST_SMS_TEMPLATE або CREATE_ASSISTIVE_DEVICE_REQUEST_SMS_TEMPLATE_WITH_CODE, якщо виріб, обраний для призначення, віднесено до виробів ДЗР конфігурацією dictionaries_configurations

      1. якщо для призначення за програмою відсутні такі налаштування, СМС надсилається чи не надсилається залежно від загального налаштування для системи

   2. для призначень без програми

      1. якщо виріб, обраний для призначення, віднесено до виробів ДЗР конфігурацією dictionaries_configurations і ввімкнено відправку СМС для призначень на вироби ДЗР, то повідомлення надсилається за шаблоном CREATE_ASSISTIVE_DEVICE_REQUEST_SMS_TEMPLATE_WITHOUT_CODE, що не містить коду верифікації

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

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

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

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

Користувач:

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

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

https://e-health-ua.atlassian.net/wiki/spaces/REHABILIT/pages/18431017911/UPD#%D0%9F%D0%BE%D0%B2%D1%82%D0%BE%D1%80%D0%BD%D0%B5-%D0%BE%D1%82%D1%80%D0%B8%D0%BC%D0%B0%D0%BD%D0%BD%D1%8F-%D1%81%D0%BC%D1%81-%D0%BF%D0%BE%D0%B2%D1%96%D0%B4%D0%BE%D0%BC%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F-%D0%B7%D0%B0-%D0%BF%D1%80%D0%B8%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%BD%D1%8F%D0%BC

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

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

Користувач:

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

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

Search for a Device requests

Користувач:

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

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

Система e-Health:

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

   1. Валідність токену доступу

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

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

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

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

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

Користувач:

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

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

Get Device request context

Користувач:

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

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

Система e-Health:

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

   1. Валідність токену доступу

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

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

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

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

Користувач:

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

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

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

Система e-Health:

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

   1. Валідність токену доступу

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

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

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

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

https://e-health-ua.atlassian.net/wiki/spaces/REHABILIT/pages/18470568166

Користувач:

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

Система e-Health:

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

   1. Валідність токену доступу

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

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

      1. Співробітник з декларацією (declaration)

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

      3. Співробітники закладу, в якому створено епізод, на підставі якого була взаємодія зі створення запису (в тому числі автор) (context_episode_id)

      4. Співробітник з доступом (approval) на читання медичних даних пацієнта (patient)

      5. Співробітник з доступом (approval) на читання епізоду пацієнта (context_episode_id)

      6. Співробітник з доступом (approval) на читання плану лікування пацієнта (context_care_plan_id)

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

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

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

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

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

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

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

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

Search for a person v3

Користувач:

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

Система e-Health:

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

   1. Валідність токену доступу

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

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

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

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

Користувач:

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

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

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

Система e-Health:

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

   1. Валідність токену доступу

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

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

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

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

Get Device requests by search params

Користувач:

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)

   12. Курс лікування (occurrence_period_start_from, occurrence_period_start_to та occurrence_period_end_from, occurrence_period_end_to)

Система e-Health:

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

   1. Валідність токену доступу

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

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

      1. Співробітник з декларацією (declaration)

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

      3. Співробітники закладу, в якому створено епізод, на підставі якого була взаємодія зі створення запису (в тому числі автор) (context_episode_id)

      4. Співробітник з доступом (approval) на читання медичних даних пацієнта (patient)

      5. Співробітник з доступом (approval) на читання епізоду пацієнта (context_episode_id)

      6. Співробітник з доступом (approval) на читання плану лікування пацієнта (context_care_plan_id)

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

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

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

Get Device request details

Користувач:

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

Система e-Health:

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

   1. Валідність токену доступу

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

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

      1. Співробітник з декларацією (declaration)

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

      3. Співробітники закладу, в якому створено епізод, на підставі якого була взаємодія зі створення запису (в тому числі автор) (context_episode_id)

      4. Співробітник з доступом (approval) на читання медичних даних пацієнта (patient)

      5. Співробітник з доступом (approval) на читання епізоду пацієнта (context_episode_id)

      6. Співробітник з доступом (approval) на читання плану лікування пацієнта (context_care_plan_id)

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

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

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

https://e-health-ua.atlassian.net/wiki/spaces/REHABILIT/pages/18431017911/UPD#%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

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

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

Resend SMS on Device request

Користувач:

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

Система e-Health:

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

   1. Валідність токену доступу

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

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

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

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

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

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

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

6. Надсилає SMS-повідомлення

   1. для призначень за програмою в залежності від налаштувань медичної програми (для призначень за реімбурсацією) відповідно до шаблону CREATE_DEVICE_REQUEST_SMS_TEMPLATE або CREATE_ASSISTIVE_DEVICE_REQUEST_SMS_TEMPLATE_WITH_CODE, якщо виріб, обраний для призначення, віднесено до виробів ДЗР конфігурацією dictionaries_configurations

      1. якщо для призначення за програмою відсутні такі налаштування, СМС надсилається чи не надсилається залежно від загального налаштування для системи

   2. для призначень без програми

      1. якщо виріб, обраний для призначення, віднесено до виробів ДЗР конфігурацією dictionaries_configurations і ввімкнено відправку СМС для призначень на вироби ДЗР, то повідомлення надсилається за шаблоном CREATE_ASSISTIVE_DEVICE_REQUEST_SMS_TEMPLATE_WITHOUT_CODE, що не містить коду верифікації

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

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

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

https://e-health-ua.atlassian.net/wiki/spaces/REHABILIT/pages/18431017911/UPD#%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

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

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

Користувач:

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

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

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

https://e-health-ua.atlassian.net/wiki/spaces/REHABILIT/pages/18431246380/UPD+Mark+in+error+Device+request

Користувач:

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

Система e-Health:

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

   1. Валідність токену доступу

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

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

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

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

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

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

5. Надсилає SMS-повідомлення відповідно до шаблону MARK_IN_ERROR_DEVICE_REQUEST_SMS_TEMPLATE або MARK_IN_ERROR_ASSISTIVE DEVICE_REQUEST_SMS_TEMPLATE, якщо виріб, обраний для призначення, віднесено до виробів ДЗР конфігурацією dictionaries_configurations

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

      1. якщо для призначення за програмою відсутні такі налаштування, СМС надсилається чи не надсилається залежно від загального налаштування для системи

   2. для призначень без програми, відправка СМС здійснюється за наступними правилами:

      1. якщо виріб, обраний для призначення, віднесено до виробів ДЗР конфігурацією dictionaries_configurations залежно від налаштувань відправки СМС для призначень на вироби ДЗР

      2. для всіх інших випадків пацєнту СМС надсилається чи не надсилається залежно від загального налаштування для системи

6. Змінює статус призначення (відповідно до статусної моделі) на Позначений помилковим (ENTERED_IN_ERROR)

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

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

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

https://e-health-ua.atlassian.net/wiki/spaces/REHABILIT/pages/18431017911/UPD#%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

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

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

Користувач:

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

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

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

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

https://e-health-ua.atlassian.net/wiki/spaces/REHABILIT/pages/18431180821/UPD+Revoke+Device+request

Користувач:

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

Система e-Health:

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

   1. Валідність токену доступу

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

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

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

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

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

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

5. Надсилає SMS-повідомлення відповідно до шаблону REVOKE_DEVICE_REQUEST_SMS_TEMPLATE або REVOKE_ASSISTIVE_DEVICE_REQUEST_SMS_TEMPLATE, якщо виріб, обраний для призначення, віднесено до виробів ДЗР конфігурацією dictionaries_configurations

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

      1. якщо для призначення за програмою відсутні такі налаштування, СМС надсилається чи не надсилається залежно від загального налаштування для системи

   2. для призначень без програми, відправка СМС здійснюється за наступними правилами:

      1. якщо виріб, обраний для призначення, віднесено до виробів ДЗР конфігурацією dictionaries_configurations залежно від налаштувань відправки СМС для призначень на вироби ДЗР

      2. для всіх інших випадків пацєнту СМС надсилається чи не надсилається залежно від загального налаштування для системи

6. Змінює статус призначення (відповідно до статусної моделі) на Скасований (REVOKED)

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

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

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

https://e-health-ua.atlassian.net/wiki/spaces/REHABILIT/pages/18431017911/UPD#%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

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

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

Користувач:

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

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

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

https://e-health-ua.atlassian.net/wiki/spaces/REHABILIT/pages/18430066773/UPD+Complete+Device+request

Користувач:

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

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

Система e-Health:

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

   1. Валідність токену доступу

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

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

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

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

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

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

4. Надсилає SMS-повідомлення відповідно до шаблону COMPLETE_DEVICE_REQUEST_SMS_TEMPLATE або COMPLETE_ASSISTIVE_DEVICE_REQUEST_SMS_TEMPLATE, якщо виріб, обраний для призначення, віднесено до виробів ДЗР конфігурацією dictionaries_configurations

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

      1. якщо для призначення за програмою відсутні такі налаштування, СМС надсилається чи не надсилається залежно від загального налаштування для системи

   2. для призначень без програми, відправка СМС здійснюється за наступними правилами:

      1. якщо виріб, обраний для призначення, віднесено до виробів ДЗР конфігурацією dictionaries_configurations залежно від налаштувань відправки СМС для призначень на вироби ДЗР

      2. для всіх інших випадків пацєнту СМС надсилається чи не надсилається залежно від загального налаштування для системи

5. Змінює статус призначення (відповідно до статусної моделі) на Завершений (COMPLETED)

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

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