ЕСОЗ - публічна документація
[DRAFT] BP-ESOZ-018-0003 [MIS] Уточнення ідентифікованого пацієнта для МВТН з неідентифікованим
Сторінка знаходиться в процесі розробки. Інформація на ній може бути застарілою.
https://e-health-ua.atlassian.net/wiki/spaces/EN/pages/17560797187 (видаліть блок з посиланням перед публікацією документа)
Властивості документа
Тип документа | Бізнес-процес |
---|---|
Назва документа | BP-ESOZ-018-0003 [MIS] Уточнення ідентифікованого пацієнта для МВТН з неідентифікованим |
ID настанови | GUI-004 |
Автор | @Mariana Veremeieva (UA SoE eHealth) |
Версія документа | v010 |
Статус документа | DRAFT |
Дата створення | 14.06.2024 |
Дата оновлення |
|
ID групи | BPG-ESOZ-018 |
ID бізнес-процесу | BP-ESOZ-018-0003 |
Назва бізнес-процесу | [MIS] Уточнення ідентифікованого пацієнта для МВТН з неідентифікованим |
Посилання на схеми | BP-ESOZ-018-0003 [MIS] Уточнення ідентифікованого пацієнта для МВТН з неідентифікованим |
Загальні відомості
Медичний працівник, створюючи МВТН для неідентифікованої особи, фіксує факт настання медичної непрацездатності.
Після ідентифікації пацієнта записи про ідентифікованого та неідентифікованого пацієнта повинні бути поєднані (процес Зв'язування неідентифікованої персони із ідентифікованою персоною);
Медичний працівник має можливість створити уточнюючий МВТН на весь період непрацездатності пацієнта (весь масив медичних висновків про тимчасову непрацездатність), незалежно від того, чи ця особа проходила лікування в одному чи в декількох закладах охорони здоров’я.
Передумови
Наявність в Системі успішно зареєстрованого НМП СМД (надавача медичних послуг спеціалізованої медичної допомоги) та доступ до ЕСОЗ медичного працівника з відповідними правами користувача ЕСОЗ (далі - Користувач).
Наявний у системі дійсний МВТН.
Уточнюючий МВ можливо створити лише для МВ з типом “TEMP_DISABILITY“, тобто для МВТН;
Уточнюючий МВТН для ідентифікованої особи (person) створюється на всі МВТН з одного ланцюга по випадку непрацездатності із статусом (параметр "status") FINAL зв’язаної неідентифікованої особи (preperson);
Уточнюючий МВТН, який створюється на весь період непрацездатності повинен створюватись тільки для ідентифікованої особи (person) із посиланням на останній МВ з ланцюгу медичних висновків (параметр "relatesTo") неідентифікованої особи (preperson) та зазначення Користувачем в атрибуті "relatesTo.code" характеру зв'язку “replaces”.
Схема бізнес-процесу
Зображення схеми
Посилання на схему
На перегляд: https://modeler.camunda.io/share/8cd76a52-1b02-4253-b3f7-6fce40b0c0fe
Похідний файл схеми (BPMN)
Опис кроків по процесу
1 | № кроку | Крок | Опис | Технічний модуль | Методи API які мають або можуть бути використані |
2 | SE 1.10 | Уточнення МВТН | Потреба створити уточнення МВТН, вказуючи ідентифіковану персону замість неідентифікованої |
|
|
3 | 1.10 | Ідентифікувати пацієнта | Медпрацівник (Користувач) ідентифікує пацієнта поза системою для подальшого пошуку інформації по пацієнту в ЕСОЗ. |
|
|
4 | GW 1.10 | Пацієнт ідентифікований? |
|
|
|
5 | EE 1.10 | Уточнення МВТН не виконано | Уточнення МВТН не виконано, вихід із процесу. |
|
|
6 | 1.20 | Знайти/створити запис про пацієнта | Для продовження або скорочення МВТН Користувачем має бути переданий через МІС до ЕСОЗ ідентифікатор пацієнта та ідентифікатор взаємодії, за якою встановлено факт настання медичної непрацездатності. На цьому кроці знаходимо або створюємо запис пацієнта для отримання ідентифікатора. | Scope -person:read. Resource - GET /api/persons.
| Пошук запису про ідентифіковану особу в ЕСОЗ можливий за методом [DRAFT] Search for a person v.3 [API-010-001-003-0360] . |
7 | GW 1.20 | Продовжити без пошуку існуючого МВТН? |
|
|
|
8 | 1.30 | Виконати пошук МВТН | Медичний працівник (Користувач) за допомогою МІС має можливість пошуку раніше створених МВТН за пошуковим запитом описаним в процесі BP-ESOZ-018-0008 [MIS] Пошук та отримання даних про медичні висновки. |
|
|
9 | 1.40 | Провести поєднання записів про пацієнта | Для того, щоб поєднати медичні дані ідентифікованої персони з медичними даними неідентифікованої персони, необхідно виконати дії, описані в процесі BP-ESOZ-019-0001 [MIS] Об'єднання пацієнтів користувачем МІС, після чого перейти до кроку 1.50. |
|
|
10 | 1.50 | Створити нову взаємодію | Оскільки на одну взаємодію (encounter.value) можна створити тільки один медичний висновок однієї категорії та типу медвисновку в статусі “Підписаний“ (status “FINAL”), створення уточнюючого МВТН потребує створення нової взаємодії пацієнта, яка відбувається за процесом BP-ESOZ-014-0001 [MIS] Створення пакету Взаємодії. Необхідно вказати тип взаємодії відповідно до довідника [DRAFT] eHealth/encounter_types. По завершенню дій, перейти до кроку 1.60. |
|
|
11 | 1.60 | Обрати характер зв'язку Replaces | Користувач вказує ідентифікатор медичного висновку, останнього з ланцюгу МВТН, який належить неідентифікованій особі (параметр "relatesTo") та обирає значення “replaces” з довідника "COMPOSITION_RELATION_CODE" (параметр “relatesTo.code”), після чого переходить до кроку 1.70. |
|
|
12 | 1.70 | Пошук та отримання даних МC, який уточнюємо | Для того, щоб Користувач міг побачити дані з медичного висновку, який уточнюється, в МІС мають бути виконані дії, описані в процесі BP-ESOZ-018-0008 [MIS] Пошук та отримання даних про медичні висновки. По завершенню дій, перейти до кроку GW 1.30. |
|
|
13 | GW 1.30 | Чи потрібно вказувати метод автентифікації непрацездатної особи? |
|
|
|
14 | 1.80 | Вказати МА непрацездатної особи | На цьому кроці Користувач вказує метод автентифікації непрацездатної особи згідно з процесом BP-ESOZ-020-0003 [MIS] Отримання даних методів автентифікації пацієнта, після чого слідує виконання кроку GW 1.40. |
|
|
15 | GW 1.40 | Чи вказано МА? |
|
|
|
16 | 1.90 | Інформаційне повідомлення про відсутність МА | Користувач отримує інформаційне повідомлення (MSG-0006) про відсутність МА та переходить до кроку 1.100. |
|
|
17 | 1.100 | Заповнити дані по новому МВТН (автоматично або ні) | Користувач створює новий МВТН відповідно до умов процесу BP-ESOZ-018-0001 [MIS] Формування нового МВТН. Користувач заповнює такі обов’язкові параметри при формуванні запиту на створення МВТН:
Користувач може заповнити наступні необов'язкові параметри:
Решта параметрів повинні співпадати з МВТН для неідентифікованої особи, оскільки уточнюючий МВТН уточнює особу, а не інші дані по медичному висновку. По завершенню, перейти до виконання кроку 1.110. |
|
|
18 | 1.110 | Виконати запит на створення МВТН | Для створення МВТН МІС виконує запит на створення МВТН згідно методу API Системи createComposition. Далі перейти до кроку 1.120. | Scope -composition:create. Resource - POST /patients/composition. | |
19 | 2.10 | createComposition | В ЦБД ЕСОЗ виконуються дії, передбачені відповідним методом АРІ. |
| |
20 | 2.20 | Create job | Під час виконання методу АПІ створюється окрема асинхронна задача, яка ставиться в чергу задач. За результатом виконання задачі зі створення Composition, ЕСОЗ віддає через АПІ відповідь, що МВТН успішно створений. |
|
|
21 | 1.120 | Отримати результат виконання job | На цьому кроці МІС отримує результати опрацювання запиту щодо створення МВТН в ЦБД ЕСОЗ. Далі виконання кроку GW 1.50. | Scope -composition:read Resource - GET /patients/{patientId}/composition/{compositionId}/episode/{episodeId}/encounter/{encounterId} | |
22 | 2.30 | getAsyncJobStatus | В ЦБД ЕСОЗ виконуються дії, передбачені відповідним методом АРІ. |
| |
23 | GW 1.50 | МВТН створено? |
|
|
|
24 | ЕЕ 1.20 | МВТН не створено | МВТН не створено. Вихід з процесу. |
|
|
25 | 1.130 | Отримати створений МВТН | Користувач отримує деталі по уточнюючому МВТН за методом АРІ getComposition, зазначаючи ідентифікатор ідентифікованої особи (person_id), для якої було створено взаємодію. Після виконання дій перейти до кроку 1.140. | Scope -composition:read Resource - GET /patients/{patientId}/composition/{compositionId}/episode/{episodeId}/encounter/{encounterId} | |
26 | 2.40 | getComposition | В ЦБД ЕСОЗ виконуються дії, передбачені відповідним методом АРІ. |
| |
27 | 1.140 | Перевірити дані за МВТН | Користувач здійснює перевірку відомостей щодо створюваного МВТН, що зазначені в інформаційній довідці, та/або інтерфейсі. Зокрема повинні бути перевірені:
|
|
|
28 | GW 1.50 | Потрібно переглянути друковану форму? | У Користувача є можливість переглянути друковану форму МВТН, щоб надалі виправити помилки.
|
|
|
29 | 1.150 | Переглянути друковану форму | На вимогу пацієнта Користувач має роздрукувати інформаційну довідку МВТН відповідно до процесу BP-ESOZ-018-0013 [MIS] Отримання друкованої форми МВ, після чого перейти до кроку GW 1.60. |
|
|
30 | GW 1.60 | Помилки відсутні? |
|
|
|
31 | 1.160 | Виправити помилки | За наявності помилок в інформаційній довідці МВТН та/або інтерфейсі, Користувач переходить на крок GW 1.70 для подальшого визначення шляху виправлення таких помилок. Виправлення помилок здійснюється виключно через створення нового медвисновку. МІС може автоматично заповнити відповідні поля (атрибути) в новому запиті на створення медвисновку, щоб Користувач мав змогу виправити помилки, допущені у попередньому запиті. |
|
|
32 | GW 1.70 | Вибір шляху виправлення відповідно до помилки | Якщо потрібно виправити помилку, можна обрати один або декілька з наступних варіантів подій (Inclusive Gateway):
|
|
|
33 | 1.170 | Засвідчити КЕП та виконати запит на підписання | В разі відсутності помилок у відомостях інформаційної довідки та/або інтерфейсі, Користувач повинен мати можливість:
Далі перейти до кроку 1.180. | Scope -composition:signd Resource - PATCH /patients/composition/{compositionId}/sign | |
34 | 2.50 | SignComposition | В ЦБД ЕСОЗ виконуються дії, передбачені відповідним методом АРІ. |
| |
35 | GW 2.10 | Чи є помилка? |
|
|
|
36 | EE 2.10 | Результат обробки Failed | Результат обробки невдалий, відповідно підписання на кроці 2.50 не відбулося, що на кроці GW 1.80 приведе до завершення процесу. |
|
|
37 | 2.60 | Create job | Під час виконання методу АПІ створюється окрема асинхронна задача, яка ставиться в чергу задач. За результатом виконання задачі зі створення Composition, ЕСОЗ віддає через АПІ відповідь, що МВТН успішно створений. |
|
|
38 | 2.70 | CREATE_ERLN_RECORD | В результаті успішного опрацювання запиту на уточнення МВТН, в таблиці task_queue створюється задача. |
|
|
39 | 2.80 | Відправка SMS | SMS-0004 |
|
|
40 | EE 2.20 | Результат обробки Done | Виконання внутрішної задачі CREATE_ERLN_RECORD успішно завершене. |
|
|
41 | 1.180 | Отримати результат виконання job | Результатом виконання запиту буде або успішне скасування МВТН, або помилка. Далі МІС переходить до виконання кроку GW 1.80. Приклад повідомлень про помилки ЦБД по роботі із медичними висновками надано на сторінці Повідомлення системи . | Scope -composition:read Resource - GET /patients/{patientId}/composition/{compositionId}/episode/{episodeId}/encounter/{encounterId} | |
42 | 2.90 | getAsyncJobStatus | В ЦБД ЕСОЗ виконуються дії, передбачені відповідним методом АРІ. |
| |
43 | GW 1.80 | Чи підписано МВТН? |
|
|
|
44 | 1.190 | Переглянути друковану форму | На вимогу пацієнта Користувач має роздрукувати інформаційну довідку МВТН відповідно до процесу BP-ESOZ-018-0013 [MIS] Отримання друкованої форми МВ, після чого перейти до кроку GW 1.80. |
|
|
45 | GW 1.100 | Потрібно переглянути статус обробки МВТН, номер запису в ЕРЛН? |
|
|
|
46 | 1.200 | Переглянути статус обробки МВТН | Дані по статусу Користувач отримує через деталі по статусу обробки МВТН за методом АРІ getIntegrationData, описаного в процесі BP-ESOZ-018-0005 [MIS] Отримання даних про інтеграційний статус медичних висновків. По завершенні перейти до кроку GW 1.110 |
|
|
47 | GW 1.110 | Чи потрібно перевідправити в ЕРЛН? |
|
|
|
48 | 1.210 | Перевідправка в ЕРЛН | Перевідправка в ЕРЛН реалізовується за окремим процесом BP-ESOZ-018-0006 [MIS] Повторна відправка МВТН в ЕРЛН. Після цього кроку необхідно повернутися до кроку GW 1.100 |
|
|
49 | EE 1.30 | Уточнення МВТН виконано. | Уточнення МВТН виконано. Завершення процесу. |
|
|
Бізнес правила
Автор уточнюваного МВТН (для preperson) не перевіряється в валідаціях створення та підписання нового МВТН, яким уточнюється особа.
Правила застосування subject/focus для person/preperson при створенні МВТН, наведені нижче:
type | category | SUBJECT | FOCUS |
---|---|---|---|
|
| ЕСОЗ: preperson Трактування: новонароджена дитина | ЕСОЗ: person Трактування: жінка що народила новонароджену дитину |
|
| ЕСОЗ: preperson/person Трактування: Пацієнт- непрацездатна особа | |
|
| ЕСОЗ: person Трактування: Пацієнт, який доглядав за дитиною і через свій стан не може продовжевати | ЕСОЗ: person Трактування: Особа, яка доглядатиме за дитиною пацієнта і через це - непрацездатна |
|
| ЕСОЗ: person Трактування: Пацієнт, повнолітній | ЕСОЗ: person Трактування: Особа, яка доглядатиме за пацієнтом і через це - непрацездатна |
|
| ЕСОЗ: preperson/person Трактування: Пацієнт, дитина (зокрема новонароджена) | ЕСОЗ: person Трактування: Особа, яка доглядатиме за пацієнтом і через це - непрацездатна |
|
| ЕСОЗ: person Трактування: Особа що проходить обсервація або самоізоляцію з метою запобігання поширенню гострої респіраторної хвороби COVID-19, спричиненої коронавірусом SARS-CoV-2 *хворі на ковід отримують категорію Загальне захворювання | |
|
| ЕСОЗ: person Трактування: пацієнт, непрацездатний за своїм основним місцем роботи, що переводиться на легшу роботу для уникнення порушення процесу лікування | |
|
| ЕСОЗ: person Трактування: Пацієнт, що отримує медичні послуги з ортопедичного протезування в стаціонарних умовах | |
|
| ЕСОЗ: person Трактування: Пацієнтка, що вагітна або народила та є непрацездатною. | |
|
| ЕСОЗ: person Трактування: Особа, що перебуває на карантині | |
|
| ЕСОЗ: person Трактування: Пацієнт- непрацездатна особа |
Результат процесу
в ЦБД ЕСОЗ створений та підписаний уточнений МВТН;
відправлена інформація в ЕРЛН;
Користувач (медичний працівник) отримує результати статусу обробки МВТН.
Перелік змін
Версія документа | Опис змін | Номер релізу | |
---|---|---|---|
1 |
|
|
|
2 |
|
|
|
ЕСОЗ - публічна документація