№ кроку

Крок

Опис

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

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

SE 1.10

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

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

1.10

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

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

1.20

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

Для продовження або скорочення МВТН Користувачем має бути переданий через МІС до ЕСОЗ ідентифікатор пацієнта та ідентифікатор взаємодії, за якою встановлено факт настання медичної непрацездатності.

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

GW 1.10

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

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

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

1.30

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

Користувач перевіряє наявність раніше створених МВТН через пошук таких МВТН, що описано в процесі https://e-health-ua.atlassian.net/wiki/x/O4BJFQQ.

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

Scope -composition:search.

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

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

GW 1.20

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

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

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

EE 1.10

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

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

1.40

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

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

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

1.40

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

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

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

Scope -encounter:read.

Resource -GET /api/patients/{{patient_id}}/encounters/{{encounter_id}}
GET /api/patients/{{patient_id}}/encounters/

Scope -patient_summary:read.

Resource -GET /api/patients/{{patient_id}}/summary/episodes.

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

• get-encounters-by-search-params;

• get-short-encounters-by-search-params

1.50

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

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

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

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

GW 1.30

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

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

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

1.60

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

На цьому кроці Користувач вказує метод автентифікації непрацездатної особи, описаний в процесі [RC] BP-ESOZ-020-0003 [MIS] Отримання даних методів автентифікації пацієнта.

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

GW 1.40

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

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

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

1.70

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

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

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");

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

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

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

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

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

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

Можливість застосування 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.

GW 1.50

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

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

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

1.90

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

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

ЕЕ 1.20

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

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

1.100

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

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

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

.110.

 Scope -composition:create.

Resource - POST /patients/composition.

[API-006-001-001-0211]

createComposition

1.110

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

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

 Scope -composition:read

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

[API-006-001-001-0209]

GetAsyncJobStatus

GW 1.60

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

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

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

1.120

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

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

ЕЕ 1.30

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

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

1.130

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

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

 Scope -composition:read

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

[API-006-001-001-0214]

getComposition

GW 1.70

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

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

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

GW 1.80

Є доступ до МВТН?

• Якщо так (є доступ до МВТН), то перейти до кроку GW 1.90.

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

1.140

Виконати пошук МВТН з relatesTo для отримання ID контексту

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

Scope -composition:search.

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

[API-006-001-001-0215]

searchCompositions

1.150

Створити запит на approval для контексту

В разі наявності даних у об'єкті relatesTo та якщо Користувач не має доступу до деталей МВТН, то він повинен мати змогу створити запит на отримання доступу (до ЕМЗ з метою перегляду пов'язаного МВТН) з боку пацієнта відповідно до опису процесу “Отримання дозволу пацієнта на операції з даними у системі E-Health”

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

GW 1.90

Чи отримано доступ?

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

• Якщо ні (доступ до МВТН не отримано), тоді перейти до кроку 1.190

1.160

Отримати деталі МВТН з relatesTo

Користувач отримує деталі по пов'язаному МВТН за методом АРІgetComposition для ознайомлення з даними висновку.за методом АРІgetComposition для ознайомлення з даними висновку.

Scope -composition:read

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

[API-006-001-001-0214]

getComposition

1.170

Проінформувати пацієнта (за необхідності)

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

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

В іншому випадку Користувач переходить до наступного кроку.

1.180

Перегляд медзаписів

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

GW 1.130

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

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

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

1.190

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

Потребує переходу на інший процес - https://e-health-ua.atlassian.net/wiki/x/I4BKFQQ

EE 1.40

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

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

1.200

Перевірити дані по створюваному МВТН

Користувач здійснює перевірку відомостей про створюваний МВТН, що зазначені в інформаційній довідці, та/або інтерфейсі. Зокрема повинні бути перевірені:

• тип МВТН (параметр "type");

• категорію МВТН (параметр "category");

• пацієнта (параметр "composition.subject");

• непрацездатну особу (параметр "composition.section.focus");

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

• період дійсності МВТН (параметри "event.period.start" та "event.period.end");

• поточний статус МВТН (параметр "status");

• НМП, в якому створено МВТН (параметр "custodian");

• додаткову інформацію з розширених даних про МВТН (блок "extension") за наявності;

• тип посилання на пов’язаний МВТН (параметр "relatesTo.code") за наявності;

• ідентифікатор пов’язаного МВТН (параметр "relatesTo.targetIdentifier") за наявності;

GW 1.100

Потрібно переглянути друковану форму?

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

• Якщо ні (не потрібно переглядати друковану форму), тоді перейти до кроку GW 1.110

1.210

Переглянути друковану форму

На вимогу пацієнта Користувач має роздрукувати інформаційну довідку МВТНза допомогою метода АРІgetPrintForm.

Scope -composition:read

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

getPrintForm

GW 1.110

Помилки в МВТН відсутні?

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

• Якщо ні ( є помилки в МВТН), тоді перейти до кроку GW 1.220

1.220

Виправити помилки

За наявності помилок в інформаційній довідці МВТН та/або інтерфейсі, Користувач переходить на крок GW 1.120 для подальшого визначення шляху виправлення таких помилок.

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

GW 1.120

Вибір шляху виправлення відповідно до помилки

Якщо потрібно виправити помилку, можна обрати один або декілька з наступних варіантів подій (Inclusive Gateway):

• Якщо потрібно (змінити заповнені дані в МВТН) перейти до кроку 1.80.

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

• Якщо потрібно (змінити епізод або взаємодію) перейти до кроку 1.40.

• Якщо потрібно (змінити запис про пацієнта) перейти до кроку 1.20.

1.230

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

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

1.240

Виконати запит на підписання

Користувач виконує запит на підписання методом АРІ Системи signComposition із зазначенням в якості параметру ідентифікатора МВТН "composition_id". Далі перейти до кроку 1.190.

 Scope -composition:signd

Resource - PATCH /patients/composition/{compositionId}/sign

[API-006-001-001-0212]

signComposition

1.250

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

Користувач отримує результати виконання запиту через виконання методу getAsyncJobStatusта за необхідності інформує пацієнта про (не)успішність створення МВТН, після чого переходить до кроку GW 1.140.

Scope -composition:read

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

[API-006-001-001-0209]

getAsyncJobStatus

GW 1.140

Чи підписано МВТН?

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

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

ЕЕ 1.50

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

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

GW 1.150

Потрібно переглянути друковану форму?

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

• Якщо ні (не потрібно переглядати друковану форму), тоді перейти до кроку GW 1.160.

1.260

Роздрукувати МВТН за вимогою

На вимогу пацієнта, Користувач має роздрукувати інформаційну довідку МВТН за допомогою метода АРІ getPrintForm, після чого переходить до кроку GW 1.160.

Scope -composition:read

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

getPrintForm

GW 1.160

Переглянути статус обробки МВТН з зовнішними системами?

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

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

1.270

Переглянути статус обробки МВТН з зовнішними системами

Користувач може переглянути статус обробки МВТН, що описаний в процесі https://e-health-ua.atlassian.net/wiki/x/HQBFFQQ. Після виконаної дії перейти до кроку GW 1.170.

GW 1.170

Чи потрібно перевідправити в ЕРЛН?

• Якщо так (отримана помилка і потрібно перевідправити в ЕРЛН), то перейти до кроку 1.280.

• Якщо ні (помилки не було і перевідправити в ЕРЛН не потрібно), тоді перейти до кроку ЕЕ 1.60.

1.280

Перевідправка МВТН в ЕРЛН

Перевідправка в ЕРЛН реалізовується за окремим процесом https://e-health-ua.atlassian.net/wiki/x/MIBKFQQ

Після цього кроку необхідно повернутися до кроку GW 1.160.

ЕЕ 1.60

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

МВТН створений та підписаний. Завершення процесу.