Здійснити пошук пацієнта (персони або преперсони)
Search for a person v3

Передумови:

1. Повинен існувати запис про пацієнта для якого створюється МВ

2. Повинна бути створена\знайдена взаємодія з пацієнтом (encounter) в рамках якої створюється МВ

Користувач:

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. Перевіряє наявність прав на виконання запиту

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

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

Генерація номеру медичного висновку

RC_(MC-1165)_[NEW] Create Composition Title

Користувач:

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

Система e-Health:

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

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

3. Перевіряє, що користувач, для якого генерується номер МВ існує в БД і є активним.

4. Генерує унікальний номер МВ

5. Повертає користуваче номер МВ, дату і час, до якого цей номер медичного висновку буде валідним

Отримання правил заповнення секцій

RC_(MC-1167)_[NEW] Get Composition Configurations by search params

Користувач:

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

   1. Тип МВ

   2. Категорію МВ

Система e-Health:

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

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

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

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

   1. Тип МВ

   2. Категорія МВ

3. Повертає перелік правил заповнення секцій МВ, або причину відхилення запиту

Збереження мед. висновку

RC_(MC-1168)_[NEW] Submit Composition

Користувач:

1. Має можливість заповнити параметри медичного висновку:

   1. Номер МВ (title)

   2. Тип МВ (type)

   3. Категорія МВ (category)

   4. Взаємодія (encounter)

   5. Автор МВ (author)

   6. Підписант МВ (attester)

   7. ЗОЗ де створюється МВ (custodian)

   8. МВ який заміняється (relates_to)

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

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

   1. Статус допуску (event.code)

   2. Період дії статусу допуску (event.period)

      1. Початок періоду з якого діє статус допуску (event.period.start)

      2. Закінчення періоду дії статусу допуску (event.period.end)

   3. Може зазначити додаткові умови допуску (extentions)

      1. Обирає код додаткової умови допуску з довідника

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

      3. Вводить числове значення для обраної додаткової умови допуску (якщо це необхідно)

3. Має можливість заповнити розділ секції медичного висновку

   1. Код секції (section.code)

   2. Назва секції (section.title)

   3. Автори секції (section.author) (можливий масив значень)

   4. Коментар (section.text)
      ТА

   5. Наповнення секції:

      1. Посилання на ЕМЗ (section.entry) (можливий масив значень)

      2. Тип сортування ЕМЗ (section.orderedBy)
         АБО

      3. Причина незаповнення секції (section.emptyReason)
         АБО

      4. Підсекція секції (section.section)

4. Підписує запис про медичний висновок кваліфікованим електронним підписом.

Система e-Health:

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

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

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

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

   1. Номер МВ (title)

   2. Тип МВ (type)

   3. Категорія МВ (category)

   4. Працівник, що створює МВ (author)

   5. Підписант (attester)

   6. Взаємодія (encounter_id)

   7. Статус МВ (status)

   8. ЗОЗ в якому створюється МВ (custodian)

   9. Статус допуску пацієнта (event.code)

   10. Період дії допуску пацієнта (event.period)

3. Перевіряє, що передане значення номеру МВ (title) є унікальним серед:

   1. Медичних висновків МВВ та МВКУ

4. Перевіряє, що передане значення номеру МВ (title)

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

   2. Термін дії згенерованого номеру МВ не закінчився

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

   1. Обов'язкові секції присутні в розділі секції МВ

   2. В розділі секції МВ присутні лише секції вказані в шаблоні як обов'язкові або опційні

6. Перевіряє валідність заповнених полів розділу секцій мед.висновку згідно таблиці валідацій: RC_(MC-1167)_ [NEW] Medical Conclusions - Перелік валідацій

   1. Валідації параметрів МВ (Composition)

   2. Валідації структури розділу секцій МВ (Composition.section)

   3. Валідації контенту в розділі секцій МВ Composition.section (виконується для кожної секції)

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

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

Пошук медичного висновку

Користувач:

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

Надсилання запиту на отримання друкованої форми медичного висновку

RC_(MC-1189)_[NEW] Generate Composition print form

Користувач:

1. Обирає медичний висновок, для якого потрібно створити друковану форму

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

   1. Ідентифікатор медичного висновку

   2. Ідентифікатор пацієнта

Система e-Health:

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

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

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

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

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

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

   1. Ідентифікатор МВ стосується персони, що передана в параметрі Ідентифікатор персони

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

Пошук медичного висновку

Користувач:

1. Виконує пошук медичного висновку, що був створений раніше

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

RC_(MC-1191)_[NEW] Resend SMS on Composition Create

Користувач:

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

Система e-Health:

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

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

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

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

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

   1. Виконати повторну відправку SMS з інформацією про створення медвисновку можна лише для МВ в статусі FINAL

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

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

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

6. Надсилає SMS-повідомлення відповідно до шаблону що залежить від типу МВ

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

Здійснити пошук пацієнта
Search for a person v3

Користувач:

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

Система e-Health:

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

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

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

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

3. Повертає перелік пацієнтів, що відповідають запиту

Пошук медичного висновку за параметрами

RC_(MC-1181)_[NEW] Get Composition by search params

Користувач:

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

   1. Особа якої стосується МВ (subject)

   2. Взаємодія (encounter_id)(Необов'язковий параметр)

   3. Епізод (context_episode_id) (Необов'язковий параметр)

   4. Тип медичного висновку (type) (Необов'язковий параметр)

   5. Категорія медичного висновку (category) (Необов'язковий параметр)

   6. Статус медичного висновку (status) (Необов'язковий параметр)

   7. Автор МВ (author) (Необов'язковий параметр)

   8. Підписант МВ (attester) (Необов'язковий параметр)

   9. Заклад де було сформовано МВ (custodian) (Необов'язковий параметр)

   10. Дата підписання МВ (date) (Необов'язковий параметр, задається діапазоном дат)

   11. Номер медичного висновку (title) (Необов'язковий параметр)

Система e-Health:

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

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

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

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

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

   1. id

   2. status

   3. type

   4. category

   5. date

   6. title

   7. encounter

   8. custodian

   9. author

   10. attester

   11. context_episode_id

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

RC_(MC-1185)_[NEW] Get Composition by identifier

Користувач:

1. Вводить збережений раніше ідентифікатор медичного висновку

Система e-Health:

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

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

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

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

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

3. Повертає результати успішного виконання запиту або причину його відхилення. Повертається увесь об’єкт Composition включно з секціями та ЕМЗ включеними в секції. Отриманння цих ЕМЗ лікарем можливе за наявності у лікаря доступу згідно правил АВАС (згідно існуючих доступів до forbidden-груп)

Отримання деталей ЕМЗ (залежно від типу) за ідентифікатором в контексті медичного висновку 

RC_(MC-1180)_[NEW] Get Episode details in Composition context

RC_(MC-1180)_[NEW] Get Diagnostic Report details in Composition context

RC_(MC-1180)_[NEW] Get Encounter details in Composition context

RC_(MC-1180)_[NEW] Get Care Plan details in Composition context

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

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

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

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

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

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

Користувач:

1. Вводить отриманий раніше ідентифікатор ЕМЗ

Система e-Health:

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

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

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

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

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

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

Пошук МВ за параметрами та отримання МВ за ідентифікатором

Користувач:

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

Надсилання запиту на позначення медичного висновку помилковим

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

Користувач:

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

2. Обирає причину встановлення помилкового статусу

3. Додає тестовий коментар про причину скасування мед.висновку

4. Надсилає запит на позначення МВ помилковим з накладанням КЕП.

Система e-Health:

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

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

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

   3. Користувач який позначає запис помилковим належить до того ж закладу (або закладу з якого було реорганізовано цей заклад), де було створено МВ, який позначається помилковими

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

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

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

   3. Текстовий коментар про причину скасування мед.висновку не порожній

   4. Період між датою створення МВ і датою позначення його помилковим лежить у вказаному діапазоні. В перевірці застосовується конфігураційний файл “Максимально і мінімально дозволена к-ть днів між датою створення МВ і датою позначення МВ помилковим в залежності від Типу МВ і Категорії МВ

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

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

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

Визначення актуального стану допуску МВВ

Користувач:

1. Заповнює параметри запиту:

   • ПІБ

   • УНЗР

   • РНОКПП

   • Тип документа

   • Реквізити документа (номер і серія)

   • Номер МВ (compositiom.title)

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

Система e-Health:

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

   1. ПІБ пацієнта

   2. РНОКПП або інформація про документ

      1. Тип документу

      2. Реквізити документу

   3. Номер медичного висновку

2. Перевіряє що медичний висновок з вказаним номером існує і його тип це “Медичний висновок водія”

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

4. Повертає інформацію про актуальний стану допуску для всіх категорій:

   1. Категорія МВ

   2. Статус допуску

   3. Термін початку дії

   4. Термін закінчення дії (для статусу допуску “Допущено”)

   5. Додаткові умови допуску (для статусу допуску “Допущено”)

Визначення актуального стану допуску МВКУ

Користувач:

1. Заповнює параметри запиту:

   • ПІБ

   • УНЗР

   • РНОКПП

   • Тип документа

   • Реквізити документа (номер і серія)

   • Номер МВ (compositiom.title)

2. Надсилає запит на визначення актуального стану допуску для медичного висновку кандидатів в усиновлювачі

Система e-Health:

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

   1. ПІБ пацієнта

   2. РНОКПП або інформація про документ

      1. Тип документу

      2. Реквізити документу

   3. Номер медичного висновку

2. Перевіряє що медичний висновок з вказаним номером існує і його тип це “Медичний висновок кандидата в усиновлювачі”

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

4. Повертає інформацію про актуальний стану допуску:

   1. Статус допуску

   2. Термін початку дії

   3. Термін закінчення дії

Отримання даних медвисновку за номером (зовнішня система)

Користувач:

1. Заповнює параметри запиту:

   • ПІБ

   • УНЗР

   • РНОКПП

   • Тип документа

   • Реквізити документа (номер і серія)

   • Номер МВ (compositiom.title)

   • Тип МВ (type)

2. Надсилає запит на визначення актуального стану допуску для медичного висновку кандидатів в усиновлювачі та медичного висновку водія

Система e-Health:

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

   1. ПІБ пацієнта

   2. РНОКПП або інформація про документ

      1. Тип документу

      2. Реквізити документу

   3. Номер медичного висновку

   4. Тип МВ

2. Перевіряє що медичний висновок з вказаним номером існує

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

4. Повертає інформацію про медичний висновок:

   1. Номер МВ (title)

   2. Тип МВ (type)

   3. Категорія МВ (category)

   4. Статус МВ (status)

   5. Дата створення МВ (date)

   6. ЗОЗ що видав МВ (сustodian)

   7. Статус допуску (event.code)

   8. Період дії (event_period)

   9. Додаткові умови (extentions)