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

Search for a person v3

Користувач:

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

Система e-Health:

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

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

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

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

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

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

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. Повертає перелік типів медичних виробів

АБО

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

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. Повертає перелік моделей медичних виробів

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

Користувач:

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

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

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

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

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

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

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

   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)

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

Search Medical programs

Користувач:

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

Система e-Health:

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

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

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

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

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

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

https://e-health-ua.atlassian.net/wiki/x/0wBwFwQ

Користувач:

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

         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. містить діагнози (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. дата початку періоду повинна бути більше або дорівнювати даті створення призначення (authored_on)

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

   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 = device_classification_type)

   2. Код (value_code)

   3. Опис (value_description)

   4. Статус (is_active)

Система e-Health:

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

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

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

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

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

АБО

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

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. Повертає перелік моделей медичних виробів

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

Користувач:

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

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

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

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

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

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

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

   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/x/8ABwFwQ

Користувач:

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

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

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

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

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

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

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

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

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

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

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

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

Користувач:

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

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

https://e-health-ua.atlassian.net/wiki/x/DgBwFwQ

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

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

Користувач:

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

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

https://e-health-ua.atlassian.net/wiki/x/MAFwFwQ

Користувач:

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

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

Система e-Health:

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

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

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

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

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

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

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

Користувач:

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

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

RС_[NEW] Get Device request contextarchived

Користувач:

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/x/YwFwFwQ

Користувач:

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) та завершеному (completed) стані, що створені на основі поточного призначення (device_dispense.based_on)

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

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

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

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

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

Search for a person v3

Користувач:

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

Система e-Health:

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

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

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

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

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

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

Користувач:

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

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

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

Система e-Health:

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

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

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

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

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

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

https://e-health-ua.atlassian.net/wiki/x/TAFwFwQ

Користувач:

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

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

https://e-health-ua.atlassian.net/wiki/x/YwFwFwQ

Користувач:

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/x/DgBwFwQ

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

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

https://e-health-ua.atlassian.net/wiki/x/egFwFwQ

Користувач:

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

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

https://e-health-ua.atlassian.net/wiki/x/DgBwFwQ

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

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

Користувач:

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

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

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

https://e-health-ua.atlassian.net/wiki/x/QABlRgQ

Користувач:

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

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

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

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

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

https://e-health-ua.atlassian.net/wiki/x/DgBwFwQ

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

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

Користувач:

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

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

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

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

https://e-health-ua.atlassian.net/wiki/x/kwFwFwQ

Користувач:

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/x/rABwFwQ ) на Скасований (REVOKED)

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

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

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

https://e-health-ua.atlassian.net/wiki/x/DgBwFwQ

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

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

Користувач:

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

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

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

https://e-health-ua.atlassian.net/wiki/x/AYCKRgQ

Користувач:

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/x/rABwFwQ ) на Завершений (COMPLETED)

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

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