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

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 11 Next »

Бізнес-процес (настанова) (видаліть блок з посиланням перед публікацією документа)

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

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

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

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

BP-ESOZ-018-0002 [MIS] Продовження / Скорочення МВТН

ID настанови

GUI-004

Автор

Mariana Veremeieva (UA SoE eHealth)

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

v010

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

DRAFT

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

29.05.2024

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

ID групи

BPG-ESOZ-018

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

BP-ESOZ-018-0002

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

[MIS] Продовження / Скорочення МВТН

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

BP-ESOZ-018-0002 [MIS] Продовження / Скорочення МВТН

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

Передумови

  • Наявність в Системі успішно зареєстрованого НМП СМД (надавача медичних послуг спеціалізованої медичної допомоги) та доступ до ЕСОЗ медичного працівника з відповідними правами користувача ЕСОЗ (далі - Користувач).

  • Наявний у системі дійсний МВТН

  • Медичний працівник, створюючи МВТН, не може (і не має) вказувати дані про продовження, або скорочення;

  • ЕСОЗ за допомогою пошуку МВТН у зазначеній категорії зазначає ідентифікатор знайденого попереднього висновоку в об'єкті relatesTo;

  • Медичний працівник може повідомити пацієнта, що знайдено існуючий МВТН. Тож, наступний МВТН може доповнити, або скоротити термін непрацездатності;

  • Обʼєкт relatesTo у випадку продовження/скорочення МВТН генерується Системою, не лікарем. Ідентифікатор у relatesTo.code вказує на характер зв'язку із попереднім МВТН:

– Appends (продовження строку МВТН);

– Transforms (скорочення строку МВТН);

– Replaces (уточнення особи існуючого висновку (тільки якщо попередній МВТН був створений на неідентифікованого пацієнта (pre-person)) або створення МВТН “на заміну“);

  • Обʼєкт relatesTo генерується на етапі створення чернетки МВТН (STATUS = PRELIMINARY);

  • Обʼєкт relatesTo для випадків продовження (appends) та скорочення (transforms) генерується Системою за наступних умов:

    • в обох МВТН зазначено одного і того ж пацієнта (subject);

    • пов'язані МВТН мають одну і ту саму категорію МВТН (наприклад, SICKNESS);

    • періоди дії по МВТН стикуються, або пересікаються.

  • Якщо медичний працівник при створенні МВТН зазначив IS_FORCE_RENEW = TRUE (на думку лікаря, це новий випадок непрацездатності, а не продовження), то relatesTo не буде сформовано Системою і МВ буде створено як новий.

Приклад:

період дійсності МВТН 1

період дійсності МВТН 2

Результат

relatesTo у МВТН2

з 01.10 по 05.10

03.10 по 15.10

продовження, бо періоди дії по МВТН пересікаються

code = appends

targetIdentifier = МВТН1

01.10 по 05.10

03.10 по 03.10

скорочення, бо початк періоду дії МВТН2 знаходиться в межах періоду дії МВНТ1.

code = transforms

targetIdentifier = МВТН1

01.10 по 05.10

05.10 по 10.10

продовження, бо періоди дії по МВТН стикуються

code = appends

targetIdentifier = МВТН1

01.10 по 05.10

06.10 по 10.10

продовження, бо періоди дії по МВТН стикуються

code = appends

targetIdentifier = МВТН1

01.10 по 05.10

07.10 по 10.10

Висновки не пов'язані одним випадком непрацездатності. Періоди дії МВТН1 та МВТН2 мають розрив більше, ніж на 1 день. Продовження не буде, relatesTo у МВТН1

блок relatesTo у МВТН1 відсутній

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

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

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

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

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

1

№ кроку

Крок

Опис

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

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

2

SE 1.10

Продовження або скорочення МВТН

Потреба змінити (продовжити або скоротити) період тривалості МВТН.

3

1.10

Ідентифікація пацієнта

Медпрацівник (Користувач) ідентифікує пацієнта поза системою для подальшого пошуку інформації по пацієнту в ЕСОЗ.

 

4

1.20

Знайти запис про пацієнта

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

Search for a person v3

Пошук запису про ідентифіковану особу в ЕСОЗ можливий за методом АРІ Search for a Person.

5

GW 1.10

Продовжити без пошуку існуючого МВТН?

  • Якщо так (потрібно знайти існуючий МВТН), то перейти до кроку GW 1.20.

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

6

1.30

Виконати пошук та отримання медвисновку

Користувач перевіряє наявність раніше створених МВТН через пошук таких МВТН.

По завершенню дії перейти до кроку GW 1.20

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

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

7

GW 1.20

Знайдено МВТН?

  • Якщо так (МВТН знайдений), то перейти до кроку 1.40.

  • Якщо ні (МВТН не знайдений), то перейти до кроку EE 1.10 та завершити процес.

8

EE 1.10

МВТН не знайдено

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

9

1.40

Створити / обрати епізод та взаємодію

Створення ЕМЗ по взаємодії пацієнта відбувається за правилами процесу “Реєстрація результатів візиту в ЦК”.

Медичний працівник має бути автором обраної взаємодії (ідентифікатор користувача повинен співпадати з ідентифікатором "Виконавець" ("performer") у взаємодії).

Створення взаємодії: опис

та схема BP-ESOZ-014-0001 [MIS] Створення пакету Взаємодії

Пошук та отримання взаємодії: опис

та схема BP-ESOZ-014-0002 [MIS] Пошук та отримання даних пакету Взаємодії

Пошук існуючої взаємодії може бути здійснений із дотриманням вимог по пошуку за методами АРІ:

10

1.50

Визначити непрацездатну особу

Користувач визначає непрацездатну особу, заповнюючи відповідні атрибути МВТН згідно з правилами застосування атрибутів Subject та Focus. Також при формуванні запиту на створення МВТН у випадку вказання ідентифікованого пацієнта як непрацездатної особи (параметр "section.focus") Користувач повинен мати змогу обрання методу автентифікації з наявних у непрацездатної особи. 

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

По завершенню виконання дії, перейти до GW 1.30.

11

GW 1.30

Чи потрібно вказувати метод автентифікації?

  • Якщо так (потрібно вказати метод автентифікації), то перейти до кроку 1.60 щоб створити або обрати метод автентифікації.

  • Якщо ні (не потрібно вказувати метод автентифікації), то перейти до кроку 1.70 та отримати відповідне повідомлення.

12

1.60

Створити/обрати метод автентифікації непрацездатної особи

На цьому кроці медпрацівник вказує метод автентифікації непрацездатної особи.

По завершенню виконання дії, перейти до GW 1.40.

[RC] BP-ESOZ-020-0003 [MIS] Отримання даних методів автентифікації пацієнта

13

GW 1.40

Чи вказано метод МА?

  • Якщо так (вказано МА), то перейти до кроку 1.80.

  • Якщо ні (МА не вказано), то перейти до кроку 1.70 та отримати відповідне повідомлення.

14

1.70

Інформаційне повідомлення про відсутність МА

Користувач отримує інформаційне повідомлення про відсутність МА та переходить до кроку 1.80.

MSG-0006

15

1.80

Заповнити дані по новому МВТН

Медичний працівник заповнює такі дані при формуванні запиту на створення МВТН:

  1. обов’язкові параметри:

  • тип МВТН (параметр "type") із довідника "COMPOSITION_TYPES";

  • категорія (параметр "category") із довідника "COMPOSITION_CATEGORIES";

  • термін дії медичного висновку (параметр "event.code") із значенням за замовчуванням ("COMPOSITION VALIDITY PERIOD");

  • початок періоду дійсності МВТН (параметр "event.period.start"), що має дорівнювати даті та часу початку непрацездатності, та передаватися МІС до Системи у форматі ISO 8601 із обов’язковим приведенням до Всесвітнього координованого часу UTC (приклад: "2021-04-06T15:22:53.403Z");

 Правило створення МВТН в минулому

значення параметру EMAL_FILTER_PERIOD_START_DISABILITY ігнорується, якщо:

  1. в створюваному МВТН зазначено:

  • або категорію PREGNANCY;

  • або extension.is_foreign_treatment=true

  1. при створенні уточнення (preperson -> person) для МВТН

  2. при створенні МВТН “на заміну“, якщо при скасуванні МВТН, на який робиться заміна, була вказана законфігурована причина, яка дозволяє скасовувати та створювати МВТН в минулому

 Правило створення МВТН в майбутньому

Зазначення початку періоду дійсності МВТН в майбутньому дозволено тільки для продовження попереднього випадку непрацездатності категорії PREGNANCY (характер зв'язку з попереднім МВТН “appends“ ). Термін дійсності такого МВТН регулюється конфігураційним параметром EMAL_VALIDATION_PREGNANCY_APPENDED_COMPOSITION_ALLOWED_PERIOD

  • кінець періоду дійсності МВТН (параметр "event.period.end") що має визначатись користувачем в залежності від стану пацієнта та категорії МВТН та передаватися МІС до Системи у форматі ISO 8601 із обов’язковим приведенням до Всесвітнього координованого часу UTC (приклад: "2021-04-11T15:22:53.403Z");

 Правило зазначення дати кінця дійсності

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

Для категорії PREGNANCY період дійсності первинного МВТН має відповідати одному з дозволених значень, вказаних в конфігураційному параметрі EMAL_VALIDATION_PREGNANCY_NEW_COMPOSITION_ALLOWED_PERIODS.

  • ідентифікатор пацієнта (параметр "subject") який дорівнює параметру "preperson_id" для неідентифікованої особи або "person_id" для ідентифікованої особи, яка отримує медичну допомогу згідно зправилами застосування атрибутів Subject та Focus;

  • ідентифікатор взаємодії по визначенню непрацездатності пацієнта (параметр "encounter");

  • автор МВТН (параметр "author"), що є ідентифікатором медичного працівника (параметр "employee_id");

  • ідентифікатор непрацездатної особи (параметр "section.focus") згідно зправилами застосування атрибутів Subject та Focus;

  1. необов'язкові параметри (застосування розширень для певних категорій медвисновків здійснюється відповідно до

Можливість застосування extensions в залежності від категорії МВ):

  • ідентифікатор обраного методу автентифікації (параметр "extension.valueCode.authorize_with"), що дорівнює параметру "id" з відповіді API Системи "Get Person Authentication Methods", та визначається з метою подальшого інформування про успішне створення або скасування МВТН;

  • відмітка (TRUE or FALSE) про те, що непрацездатність повʼязана з випадком на виробництві (параметр "extension.valueCode.IS_ACCIDENT"). Значення за замовчуванням FALSE;

  • відмітка (TRUE or FALSE) про те, що діагностована алкогольна, або наркотична інтоксикація (параметр "extension.valueCode.IS_INTOXICATED"). Значення за замовчуванням FALSE;

  • відмітка (TRUE or FALSE) про те, що МВТН відкривається для фіксації в Системі випадків непрацездатності, що настала за кордоном (параметр "extension.valueCode.IS_FOREIGN_TREATMENT"). Значення за замовчуванням FALSE;

  • дані про те, що встановлено порушення режиму лікування:

    • параметр "extension.valueCode.TREATMENT_VIOLATION" із довідника “COMPOSITION_TREATMENT_VIOLATION”;

    • параметр "extension.valueCode.TREATMENT_VIOLATION_DATE" який заповнюється в разі, якщо зазначено TREATMENT_VIOLATION;

  • відмітка (TRUE or FALSE) про те, що МВТН створюється як новий випадок непрацездатності, не пов'язаний із попередніми випадками (параметр IS_FORCE_RENEW). Значення за замовчуванням FALSE.

Далі перейти до кроку GW 1.50.

16

GW 1.50

Це новий випадок непрацездатності, не пов'язаний із попередніми випадками (чи встановлено ознаку isForceRenew == TRUE)?

  • Якщо так (це є новий випадок непрацездатності), то перейти до кроку 1.90.

  • Якщо ні (випадок непрацездатності неновий, а є пов'язаним із попередніми випадками), то перейти до кроку 1.100 та отримати відповідне повідомлення.

17

1.90

Створення та підписання нового МВТН

Користувач може створити та підписати новий МВТН за процесом https://e-health-ua.atlassian.net/wiki/x/I4BKFQQ. Далі перейти до кроку ЕЕ 1.20.

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

18

ЕЕ 1.20

Продовження або скорочення МВТН не виконано

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

19

1.100

Виконати запит на створення МВТН

Для створення МВТН медичний працівник повинен виконати запит на створення МВТН згідно методу API Системи createComposition.

Далі перейти до кроку 1.110.

 

createComposition

[API-006-001-001-0211]

20

1.110

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

На цьому кроці користувач отримує результати опрацювання запиту щодо створення МВТН в ЦБД ЕСОЗ. Далі переходе до кроку GW 1.60.

 

[API-006-001-001-0209]

GetAsyncJobStatus

21

GW 1.60

МВТН створено?

  • Якщо так (МВТН створено), то перейти до кроку 1.30.

  • Яещо ні (МВТН не створено) , тоді перейти до кроку 1.20.

22

1.120

Переглянути результати створення МВТН

У Користувача є можливість отримати результати створення МВТН. Далі перейти до кроку ЕЕ 1.30.

23

ЕЕ 1.30

МВТН не створено

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

24

1.130

Отримати створений МВТН

Медичний працівник отримує деталі створеного МВТН за методом АРІgetComposition. Далі перейти до кроку GW 1.70

 

[API-006-001-001-0214]

getComposition

25

GW 1.70

Чи треба переглянути МВТН, вказаний в relatesTo

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

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

  • доступ до контенту медвисновку надається за правилами АВАС, а також з врахуванням наявності необхідної ролі у користувача

  • /wiki/spaces/emal/pages/16906977281

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

Медичний працівник скоротив або продовжив МВТН.

Перелік змін

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

Опис змін

Номер релізу

1

2

  • No labels

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