№ кроку

Крок

Опис

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

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

SE 1.10

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

Пацієнт звертається до НМП СМД для створення МВТН.

1.10

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

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

1.20

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

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

Створення запису про пацієнта відбувається за правилами відповідного процесу:

• для ідентифікованої особи;

• для неідентифікованї особи.

Scope -person:read.

Resource -GET /api/persons.

Scope -preperson:read.

Resource -GET /api/prepersons. 

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

Отримання запису про неідентифіковану особу (новонародженого) в ЕСОЗ можливий за методом метод API Get Preperson preperson by ID .[API-010-001-004-0374]

GW 1.10

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

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

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

1.30

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

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

Пошук здійснюється відповідно до опису процесу Пошук та отримання МВ. [DRAFT] BP-ESOZ-018-0008 [MIS] Пошук та отримання даних про медичні висновки. По завершенню виконання дії, Користувач переходить до кроку GW 1.20.

GW 1.20

Потрібен новий МВТН?

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

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

1.40

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

Створення ЕМЗ по взаємодії пацієнта відбувається за правилами процесу “Реєстрація реєстрації результатів візиту в ЦК”центральний компонент [DRAFT] Submit Encounter Package [API-007-004-004-0252].

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

При створенні МВТН слід використовувати типи взаємодії відповідно до https://e-health-ua.atlassian.net/wiki/spaces/EHENS/pages/583402009/Medical+Events+Dictionaries+and+configurations#encounter_class_encounter_types17945952488.

При створенні МВТН на певну взаємодію, слід враховувати, що на одну взаємодію (encounter.value) можна створити тільки один медичний висновок однієї категорії та типу медвисновку в статусі “Підписаний“ (status “FINAL”).

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

EE 1.10

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

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

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

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

• Якщо так (вказано МА), то перейти до кроку 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", та визначається з methods [API-010-001-001-0346] , та визначається з метою подальшого інформування про успішне створення або скасування МВТН;

• відмітка (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” https://e-health-ua.atlassian.net/wiki/spaces/ENS/pages/18024529978 ;

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

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

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

GW 1.50

Чи виконуються умови: МВТН стоврено створено на preperson ТА category == SICKNESS?

• Якщо так (виконуються умови, що МВТН стоврено на prepersona ТА category == SICKNESS), то перейти на крок 1.90.

• Якщо ні (не виконуються умови, що МВТН стоврено на prepersona ТА category == SICKNESS), то перейти до кроку 1.100.

1.90

Інформаційнне повідомлення про не відправлення МВТН в ЕРЛН

Користувач отримує інформаційнне повідомлення (MSG-0007) про неможливість створення ЕЛН та переходить до кроку 1.100

1.100

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

Для створення МВТН Користувач виконує запит на створення МВТН згідно методу API Системи [DRAFT] REST API createComposition [API-006-001-001-0211]createComposition. Далі перейти до кроку 1.110.

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 CREATE_COMPOSITION job

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

1.110

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

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

Scope -composition:read

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

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

/wiki/spaces/emal/pages/17100406810

2.30

getAsyncJobStatus

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

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

GW 1.60

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

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

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

1.120

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

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

ЕЕ 1.20

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

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

1.130

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

Користувач отримує деталі створеного МВТН за методом АРІgetComposition. Далі перейти до кроку 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.70

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

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

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

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

1.150

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

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

GW 1.80

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

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

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

1.160

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

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

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

GW 1.90

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

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

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

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

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

1.170

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

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

1.180

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

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

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]

2.60

Create SIGN_COMPOSITION job

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

1.190

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

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

Scope -composition:read

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

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

2.70

getAsyncJobStatus

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

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

GW 1.100

Чи пройшов валідацію підписаний МВТН?

• Якщо так (МВТН пройшов валідацію), то перехід до кроку GW 1.110.

• Якщо ні (МВТН не пройшов валідацію та не підписаний), тоді вихід на крок ЕЕ 1.30.

ЕЕ 1.30

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

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

GW 1.110

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

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

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

1.200

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

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

GW 1.120

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

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

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

1.210

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

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

Користувач за потреби має можливість переглянути такі дані: 

• компонент, з яким відбувається взаємодія (параметр “component“): "ЕРЛН" ("ERLN");

• тип виклику до компоненту (параметр “type”): "CREATE_ERLN_RECORD", "CANCEL_ERLN_RECORD";

• результат виклику інтеграційного компоненту (параметр “statusCode”): код обробки, повернутий від компоненту, з яким відбувається взаємодія;

• повідомлення про помилку (параметр “statusMessage”);

• статус інтеграційного процесу (параметр ”integrationStatus”): в очікуванні (PENDING), в обробці (IN_PROGRESS), оброблено (DONE) або помилка обробки (ERROR);

• дата останнього оновлення стану інтеграційного процесу (UTC) (може бути null для старих задач) (параметр “updatedAt”);

• набір даних, визначений інтеграційним компонентом (параметр “details”):

  • для типу виклику "CREATE_ERLN_RECORD" до компоненти "ЕРЛН" ("ERLN") в наборі даних будуть передаватися: Єдиний реєстраційний номер ЕЛН (параметр “SL_NUM“), Дата та час реєстрації ЕЛН (параметр “SL_REG_DATETIME“), Дата відкриття ЕЛН (параметр “SL_START“), Дата подовження ЕЛН (параметр “SL_PROLONGATION“), Дата закриття ЕЛН (параметр “SL_STOP“) та Номер випадкунепрацездатності (параметр “IC_NUM“).

  • для типу виклику "CANCEL_ERLN_RECORD" до компоненти "ЕРЛН" ("ERLN") в наборі даних будуть передаватися: Єдиний реєстраційний номер ЕЛН (параметр “SL_NUM“), Дата та час реєстрації ЕЛН (параметр “SL_REG_DATETIME“) та Номер випадку непрацездатності (параметр “IC_NUM“).
    

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

Scope -composition:read

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

GW 1.30

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

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

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

1.220

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

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

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

ЕЕ 1.40

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

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