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

[DRAFT] BP-ESOZ-018-0009 [MIS] Скасування МВТН

Сторінка знаходиться в процесі розробки. Інформація на ній може бути застарілою.

https://e-health-ua.atlassian.net/wiki/spaces/EN/pages/17560797187 (видаліть блок з посиланням перед публікацією документа)

Властивості документа

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

Бізнес-процес

Назва документа

BP-ESOZ-018-0009 [MIS] Скасування МВТН

ID настанови

GUI-004

Автор

@Mariana Veremeieva (UA SoE eHealth)

Версія документа

v010

Статус документа

DRAFT

Дата створення

07.06.2024

Дата оновлення

 

ID групи

BPG-ESOZ-018

ID бізнес-процесу

BP-ESOZ-018-0009

Назва бізнес-процесу

[MIS] Скасування МВТН

Посилання на схеми

BP-ESOZ-018-0009 [MIS] Скасування МВТН

Загальні відомості

Через помилкове введення відомостей або хибну ідентифікацію пацієнта, медичний працівник (далі - Користувач), що є автором медичного висновку про непрацездатність (далі - МВТН) може скасувати свій медичний висновок.

Передумови

Скасування МВТН можливе за наступних умов:

  • якщо МВТН є останнім в ланцюгу продовження/скорочення МВТН. Тобто, на медвисновок, що скасовується не ссилаються інші підписані медвисновки;
    Приклад:
    - МВТН1 → МВТН2 → МВТН3: скасувати можна лише МВТН3;

  • статус МВТН (параметр "status") дорівнює "Підписаний" ("FINAL");

  • Користувач, який виконує запит, є автором МВТН (ідентифікатор лікаря у параметрі "author" у МВТН повинен співпадати з ідентифікатором автора у параметрі "performer" для взаємодії, яка є основою МВТН);

  • статус обробки (параметр “integrationStatus” за типом виклику до компоненту ”CREATE_ERLN_RECORD” (параметр “type”)) дорівнює “Оброблено“ (“DONE”) або “Помилка обробки“ (“ERROR”). Забороняється скасування МВТН з транзитними значеннями статусу обробки (“PENDING”, “IN_PROGRESS”);

    • для загального процесу скасування: не перевищено максимальну кількість днів з моменту створення, протягом яких можна відмінити МВТН (змінна "EMAL_FILTER_CANCEL_TIMEOUT_DISABILITY") за конфігурацією Системи;

    • для скасування із наступним створенням МВТН “на заміну” Корисувач повинен зазначити причину скасування з довідника COMPOSITION_CANCELLATION_REASONS_TEMP_DISABILITY, яка законфігурована як причина, що дозволяє скасування МВТН в минулому (параметр “EMAL_REPLACEMENT_FLOW_DISABILITY_ALLOWED_CANCELLATION_REASONS”). Таким, чином, при зазначенні такої причини ігнорується конфігураційний параметр "EMAL_FILTER_CANCEL_TIMEOUT_DISABILITY".

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

 

Зображення схеми

 

 

 

 

Посилання на схему

На перегляд: https://modeler.cloud.camunda.io/share/1456a7e0-86f6-4358-875c-b7738c5f632a

На редагування: https://modeler.cloud.camunda.io/diagrams/1b4d49a5-4e67-461b-8583-ba5a8f4b2b1a--bp-esoz-018-0009-mis-скасування-медичного-висновку?v=4435,437,1

Похідний файл схеми (BPMN)

Опис кроків по процесу

1

№ кроку

Крок

Опис

Технічний модуль

Методи API які мають або можуть бути використані

2

SE 1.10

Скасування МВТН

Пацієнт звертається до НМП СМД, маючи об'єктивні причини для скасування МВТН.

 

 

3

1.10

Виконати пошук МВТН

Медичний працівник (Користувач) за допомогою МІС має можливість пошуку раніше створених МВТН за пошуковим запитом описаним в процесі BP-ESOZ-018-0008 [MIS] Пошук та отримання даних про медичні висновки за допомогою методу АРІ searchCompositions.

Scope -composition:search.

Resource - GET /patients/{patientId}/composition.

[DRAFT] searchCompositions [API-006-001-001-0215]

4

2.10

searchCompositions

В ЦБД ЕСОЗ виконуються дії, передбачені відповідним методом АРІ.

 

[DRAFT] searchCompositions [API-006-001-001-0215]

5

1.20

Виконати  отримання МВТН за необхідності

У разі наявності існуючих МВТН, МІС може отримати від ЦБД ЕСОЗ за допомогою методу АРІ getComposition деталі МВТН для ознайомлення із даними та перегляду інформації, пов'язаної з МВТН відповідно доступу до контенту медвисновку, регламентованим правами на перегляд даних, створених від батьківської сутності, до якої користувач має відповідні права доступу.  Після цього Користувач переходить до виконання кроку GW 1.10.

Scope -composition:read

Resource - GET /patients/{patientId}/composition/{compositionId}/episode/{episodeId}/encounter/{encounterId}

[DRAFT] REST API getComposition [API-006-001-001-0214]

6

2.20

getComposition

В ЦБД ЕСОЗ виконуються дії, передбачені відповідним методом АРІ.

 

[DRAFT] REST API getComposition [API-006-001-001-0214]

7

GW 1.10

Чи дотримані умови по статусу, автору,  відсутності посилань на цей документ інших МВТН та можливого терміну скасування?

  • Якщо так (всі умови валідації для МВТН, зазначені в передумовах дотримані), то перейти до кроку 1.30.

  • Якщо ні (не всі умови валідації для МВТН дотримані або жодна з умов зазначених в передумовах не дотримана), то перейти до кроку EE 1.10 та завершити процес.

 

 

8

EE 1.10

МВТН не скасовано

МВТН не скасовано, вихід із процесу.

 

 

9

1.30

Вказати причину скасування МВТН та обґрунтування

Користувач за допомогою МІС вказує причину скасування МВТН (параметр “reason.coding.code“) із довідника COMPOSITION_CANCELLATION_REASONS_TEMP_DISABILITY, а також Користувач додає обґрунтування позначення МВТН як "введений помилково" (параметр "reason.text"), після чого переходить на крок GW 1.40.

 

 

10

1.40

Інформаційне повідомлення про скасування МВТН

Користувач отримує повідомленя (MSG-0008) про потребу проінформувати пацієнта щодо наслідків скасування МВТН.

 

 

11

1.50

Проінформувати пацієнта

За можливості, Користувач інформує пацієнта про наслідки скасування МВТН, після чого переходить до кроку 1.60.

 

 

12

1.60

Засвідчити дані КЕП

Користувач засвідчує запит на скасування МВТН за допомогою КЕП користувача. Після засвідчення КЕП, перейти до кроку 1.70.

 

 

13

1.70

Виконати запит на скасування

Користувач за допомогою МІС виконує запит на скасування методом АРІ cancelComposition, після чого МІС переходить до виконання кроку 1.80.

Результатом виконання запиту буде або успішне скасування МВТН, або помилка.

 

Scope -composition:cancel.

Resource - PATCH /patients/composition/{compositionId}/cancel.

[DRAFT] cancelComposition [API-006-001-001-0213]

14

2.30

cancelComposition

В ЦБД ЕСОЗ виконуються дії, передбачені відповідним методом АРІ.

 

[DRAFT] cancelComposition [API-006-001-001-0213]

15

SE 2.10

Ініціація Create CANCEL_COMPOSITION job

 Під час виконання методу АПІ ЕСОЗ виконує внутрішню задачу CANCEL_COMPOSITION.

 

 

16

2.30.1

Create CANCEL_COMPOSITION job

Створення асинхронної задачі, яка ставиться в чергу задач. За результатом виконання задачі та за умови успішної валідації зі скасування Composition, ЕСОЗ віддає через АПІ відповідь, що МВТН успішно скасований.

 

 

17

2.30.2

Валідація

 Виконуються умови валідації, описані в методі [DRAFT] cancelComposition [API-006-001-001-0213] | Request data validation .

 

 

18

GW 2.10

Валідація успішна?

  • Якщо так (валідація успішна), система виконує крок GW 2.20.

  • Якщо ні (валідація неуспішна), то система виконує крок ЕЕ 2.10.

 

 

19

ЕЕ 2.10

Результат обробки Failed

Результат обробки job невдалий, що на кроці GW 1.20 приведе до завершення процесу.

 

 

20

GW 2.20

Чи зазначено МА?

  • Якщо так (МА зазначено), система виконує крок 2.30.3.

  • Якщо ні (МА не зазначено), то система виконує крок GW 2.30.

 

 

21

2.30.3

Відправка SMS

SMS-0003

 

 

22

GW 2.30

Чи focus містить preperson?

  •  Якщо так (focus містить preperson), система виконує крок EE 2.20.

  • Якщо ні (focus не містить preperson), то система виконує крок 2.30.4.

 

 

23

2.30.4

CANCEL_ERLN_RECORD

В результаті успішного опрацювання запиту на відміну МВТН, в таблиці task_queue створюється задача.

 

 

24

3.10

Обробка запиту

В зовнішній системі ЕРЛН виконується обробка запиту.

 

 

25

EE 2.20

Результат обробки Done

Виконання внутрішної задачі CANCEL_COMPOSITION успішно завершене.

 

 

26

1.80

Отримати результат виконання job

Результатом виконання запиту буде або успішне скасування МВТН, або помилка. Далі МІС переходить до виконання кроку GW 1.20.

Приклад повідомлень про помилки ЦБД по роботі із медичними висновками надано на сторінці Повідомлення системи.

Scope -composition:read

Resource - GET /patients/{patientId}/composition/{compositionId}/episode/{episodeId}/encounter/{encounterId}

[DRAFT] REST API getAsyncJobStatus [API-006-001-001-0209]

27

2.40

getAsyncJobStatus

В ЦБД ЕСОЗ виконуються дії, передбачені відповідним методом АРІ.

 

[DRAFT] REST API getAsyncJobStatus [API-006-001-001-0209]

28

GW 1.20

Який статус джоби?

  • Якщо Done (виконано), то перейти до кроку GW 1.30.

  • Якщо In progress (триває виконання), то перейти до кроку 1.80.

  • Якщо Failed (невдача), Користувач переходить до кроку EE 1.20 та завершує процес.

 

 

29

EE 1.20

МВТН не скасовано

МВТН не скасовано, вихід із процесу.

 

 

30

GW 1.30

Переглянути поточний статус обробки МВТН?

  • Якщо так (потрібно переглянути поточний статус обробки МВТН), то перейти до кроку 1.90.

  • Якщо ні (не потрібно переглядати поточний статус обробки МВТН), то перейти до кроку EE 1.30.

 

 

31

1.90

Переглянути статус обробки МВТН

Користувач може переглянути статус обробки МВТН, що описаний в процесі BP-ESOZ-018-0005 [MIS] Отримання даних про інтеграційний статус медичних висновківПісля виконаної дії перейти до кроку EE 1.30.

 

 

32

EE 1.30.

МВТН скасовано

МВТН скасовано. Завершення процесу.

 

 

Бізнес правила

  • Доступ до контенту медвисновку регламентується правами на перегляд даних, створених від батьківської сутності, до якої користувач має відповідні права доступу.

  • Правила застосування subject/focus для person/preperson при створенні МВ, наведені нижче:

type

category

SUBJECT

FOCUS

type

category

SUBJECT

FOCUS

NEWBORN

LIVE_BIRTH

ЕСОЗ: preperson

Трактування: новонароджена дитина

ЕСОЗ: person

Трактування: жінка що народила новонароджену дитину

TEMP_DISABILITY

SICKNESS

ЕСОЗ: preperson/person

Трактування: Пацієнт- непрацездатна особа

TEMP_DISABILITY

PARENTAL_CARE

ЕСОЗ: person

Трактування: Пацієнт, який доглядав за дитиною і через свій стан не може продовжевати

ЕСОЗ: person

Трактування: Особа, яка доглядатиме за дитиною пацієнта і через це - непрацездатна

TEMP_DISABILITY

FAMILY_CARE

ЕСОЗ: person

Трактування: Пацієнт, повнолітній

ЕСОЗ: person

Трактування: Особа, яка доглядатиме за пацієнтом і через це - непрацездатна

TEMP_DISABILITY

CHILD_CARE

ЕСОЗ: preperson/person

Трактування: Пацієнт, дитина (зокрема новонароджена)

ЕСОЗ: person

Трактування: Особа, яка доглядатиме за пацієнтом і через це - непрацездатна

TEMP_DISABILITY

COVID19

ЕСОЗ: person

Трактування: Особа що проходить обсервація або самоізоляцію з метою запобігання поширенню гострої респіраторної хвороби COVID-19, спричиненої коронавірусом SARS-CoV-2

*хворі на ковід отримують категорію Загальне захворювання

TEMP_DISABILITY

TEMP_TRANSFER

ЕСОЗ: person

Трактування: пацієнт, непрацездатний за своїм основним місцем роботи, що переводиться на легшу роботу для уникнення порушення процесу лікування

TEMP_DISABILITY

PROSTHETIC

ЕСОЗ: person

Трактування: Пацієнт, що отримує медичні послуги з ортопедичного протезування в стаціонарних умовах

TEMP_DISABILITY

PREGNANCY

ЕСОЗ: person

Трактування: Пацієнтка, що вагітна або народила та є непрацездатною.

TEMP_DISABILITY

QUARANTINE

ЕСОЗ: person

Трактування: Особа, що перебуває на карантині

TEMP_DISABILITY

RESTORATION

ЕСОЗ: person

Трактування: Пацієнт- непрацездатна особа

Результат процесу

Медичний працівник скасував МВТН.

Перелік змін

Версія документа

Опис змін

Номер релізу

Версія документа

Опис змін

Номер релізу

1

 

 

 

2

 

 

 

 

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