№ кроку

Крок

Опис

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

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

SE 1.10

Уточнення МВТН

Потреба створити уточнення МВТН, вказуючи ідентифіковану персону замість неідентифікованої

1.10

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

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

GW 1.10

Пацієнт ідентифікований?

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

• Якщо ні (пацієнт неідентифікований), то перейти до EE 1.10.

EE 1.10

Уточнення МВТН не виконано

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

1.20

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

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

 Scope -person:read.

Resource - GET /api/persons.

Пошук запису про ідентифіковану особу в ЕСОЗ можливий за методом Search for a Person [API-010-001-003-0360] .

GW 1.20

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

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

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

1.30

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

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

1.40

Провести поєднання записів про пацієнта

Для того, щоб поєднати медичні дані ідентифікованої персони з медичними даними неідентифікованої персони, необхідно виконати дії, описані в процесі BP-ESOZ-019-0001 [MIS] Об'єднання пацієнтів користувачем МІС, після чого перейти до кроку 1.50.

1.50

Створити нову взаємодію

Оскільки на одну взаємодію (encounter.value) можна створити тільки один медичний висновок однієї категорії та типу медвисновку в статусі “Підписаний“ (status “FINAL”), створення уточнюючого МВТН потребує створення нової взаємодії пацієнта, яка відбувається за процесом BP-ESOZ-014-0001 [MIS] Створення пакету Взаємодії.

Необхідно вказати тип взаємодії відповідно до довідника https://e-health-ua.atlassian.net/wiki/spaces/ENS/pages/17945952488. По завершенню дій, перейти до кроку 1.60.

1.60

Обрати характер зв'язку Replaces

Користувач вказує ідентифікатор медичного висновку, останнього з ланцюгу МВТН, який належить неідентифікованій особі (параметр "relatesTo") та обирає значення “replaces” з довідника "COMPOSITION_RELATION_CODE" (параметр “relatesTo.code”), після чого переходить до кроку 1.70.

1.70

Пошук та отримання даних МC, який уточнюємо

Для того, щоб Користувач міг побачити дані з медичного висновку, який уточнюється, в МІС мають бути виконані дії, описані в процесі BP-ESOZ-018-0008 [MIS] Пошук та отримання даних про медичні висновки. По завершенню дій, перейти до кроку GW 1.30.

GW 1.30

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

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

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

1.80

Вказати МА непрацездатної особи

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

GW 1.40

Чи вказано МА?

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

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

1.90

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

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

1.100

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

Користувач створює новий МВТН відповідно до умов процесу BP-ESOZ-018-0001 [MIS] Формування нового МВТН.

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

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

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

• початок періоду дійсності МВТН (параметр "event.period.start") в точності до години та хвилини повинен співпадати з початком періоду дії по МВТН для преперсони. У випадку уточнення ланцюгу (масиву) МВТН преперсони Система повинна перевіряти, що початок терміну дійсності по уточнюючому МВТН збігається з початком терміну першого МВТН преперсони з ланцюга: person.мвтн.event.period.start=preperson.мвтн.event.period.start (перший з ланцюга).

• кінець періоду дійсності МВТН (параметр "event.period.end") в точності до години та хвилини повинен співпадати з кінцем періоду дії по МВТН для преперсони. У випадку уточнення ланцюгу (масиву) МВТН преперсони Система повинна перевіряти, що кінець терміну уточнюючого МВТН збігається з кінцем терміну останнього МВТН преперсони з ланцюга: person.мвтн.event.period.end=preperson.мвтн.event.period.end (останній з ланцюга);

• ідентифікатор пацієнта (параметр "subject") який дорівнює параметру "person_id" для ідентифікованої особи, яка отримує медичну допомог і заповнюється згідно з /wiki/spaces/emal/pages/16906977281;

• ідентифікатор непрацездатної особи (параметр "section.focus"), в якому зазначається ідентифікатор пацієнта, який дорівнює параметру "person_id" для ідентифікованої особи, яка отримує медичну допомогу. Заповнюється згідно з /wiki/spaces/emal/pages/16906977281;

Користувач може заповнити наступні необов'язкові параметри:

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

• відмітка (“TRUE” or “FALSE”) про те, що непрацездатність повʼязана з випадком на виробництві (параметр "extension.valueCode.IS_ACCIDENT"). У випадку уточнення ланцюгу (масиву) МВТН преперсони: якщо хоч в одному МВ з масиву, який уточнюється, зазначено IS_ACCIDENT=”TRUE”, то в уточнюючому значення наслідується “TRUE”;

• відмітка (“TRUE” or “FALSE”) про те, що діагностована алкогольна, або наркотична інтоксикація (параметр "extension.valueCode.IS_INTOXICATED"). Значення за замовчуванням “FALSE”. У випадку уточнення ланцюгу (масиву) МВТН преперсони: якщо хоч в одному МВ з масиву який уточнюється, зазначено IS_INTOXICATED=”TRUE”, то в уточнюючому значення наслідується “TRUE”;

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

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

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

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

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

• відмітка (TRUE or FALSE) про те, що МВТН створюється як новий випадок непрацездатності, не пов'язаний із попередніми випадками (параметр IS_FORCE_RENEW). У випадку коли Користувач зазначає IS_FORCE_RENEW=TRUE, то уточнюючий МВТН не буде створено як продовження або скорочення попереднього МВТН (за його наявності), але зв'язок replaces (уточнення) з МВТН (ланцюгом МВТН), який уточнюється, буде сформований.

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

По завершенню, перейти до виконання кроку 1.110.

1.110

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

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

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

 Scope -composition:create.

Resource - POST /patients/composition.

[DRAFT] REST API createComposition [API-006-001-001-0211]

2.10

createComposition

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

[DRAFT] REST API createComposition [API-006-001-001-0211]

2.20

Create job

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

1.120

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

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

 Scope -composition:read

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

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

2.30

getAsyncJobStatus

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

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

GW 1.50

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

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

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

ЕЕ 1.20

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

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

1.130

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

Користувач отримує деталі по уточнюючому МВТН за методом АРІ getComposition, зазначаючи ідентифікатор ідентифікованої особи (person_id), для якої було створено взаємодію. Після виконання дій перейти до кроку 1.140.

Scope -composition:read

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

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

2.40

getComposition

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

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

1.140

Перевірити дані за МВТН

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

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

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

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

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

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

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

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

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

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

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

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

GW 1.50

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

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

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

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

1.150

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

На вимогу пацієнта Користувач має роздрукувати інформаційну довідку МВТН відповідно до процесу BP-ESOZ-018-0013 [MIS] Отримання друкованої форми МВ, після чого перейти до кроку GW 1.60.

GW 1.60

Помилки відсутні?

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

• Якщо ні (помилки знайдені), перейти до кроку 1.160.

1.160

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

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

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

GW 1.70

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

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

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

• Якщо потрібно (змінити дані в МВТН, який уточнюємо) перейти до кроку 1.70.

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

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

1.170

Засвідчити КЕП та виконати запит на підписання

В разі відсутності помилок у відомостях інформаційної довідки та/або інтерфейсі, Користувач повинен мати можливість:

• засвідчити запит на підписання МВТН за допомогою КЕП користувача;

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

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

Scope -composition:signd

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

[DRAFT] REST API signComposition [API-006-001-001-0212]

2.50

SignComposition

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

[DRAFT] REST API signComposition [API-006-001-001-0212]

GW 2.10

Чи є помилка?

• Якщо так (помилка є), система виконує крок EE 2.10.

• Якщо ні (помилки немає), то система виконує крок 2.60.

EE 2.10

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

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

2.60

Create job

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

2.70

CREATE_ERLN_RECORD

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

2.80

Відправка SMS

SMS-0004

EE 2.20

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

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

1.180

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

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

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

 Scope -composition:read

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

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

2.90

getAsyncJobStatus

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

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

GW 1.80

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

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

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

1.190

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

На вимогу пацієнта Користувач має роздрукувати інформаційну довідку МВТН відповідно до процесу BP-ESOZ-018-0013 [MIS] Отримання друкованої форми МВ, після чого перейти до кроку GW 1.80.

GW 1.100

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

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

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

1.200

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

Дані по статусу Користувач отримує через деталі по статусу обробки МВТН за методом АРІ getIntegrationData, описаного в процесі BP-ESOZ-018-0005 [MIS] Отримання даних про інтеграційний статус медичних висновків.

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

GW 1.110

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

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

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

1.210

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

Перевідправка в ЕРЛН реалізовується за окремим процесом BP-ESOZ-018-0006 [MIS] Повторна відправка МВТН в ЕРЛН.

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

EE 1.30

Уточнення МВТН виконано.

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

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

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

NEWBORN

LIVE_BIRTH

+

-

-

-

-

-

+

+

TEMP_DISABILITY

SICKNESS

+

+

+

+

+

+

-

-

TEMP_DISABILITY

PARENTAL_CARE

+

-

-

-

-

+

-

-

TEMP_DISABILITY

FAMILY_CARE

+

-

-

-

-

+

-

-

TEMP_DISABILITY

CHILD_CARE

+

-

+

-

+

+

-

-

TEMP_DISABILITY

COVID19

+

-

+

-

-

+

-

-

TEMP_DISABILITY

TEMP_TRANSFER

+

+

-

-

-

+

-

-

TEMP_DISABILITY

PROSTHETIC

+

-

+

-

+

+

-

-

TEMP_DISABILITY

PREGNANCY

+

-

-

-

+

-

-

-

TEMP_DISABILITY

QUARANTINE

+

-

+

-

-

+

-

-

TEMP_DISABILITY

RESTORATION

+

-

+

-

-

+

-

-