№ кроку

Крок

Опис

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

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

SE 1.10

Створення МВН

Для того, щоб мати підстави для реєстрації новонародженої дитини в органах ДРАЦСГ, виникає потреба створити МВН.

1.10

Ідентифікація персони

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

1.20

Пошук та обрання prepersona (дитина)

Користувач вводить прізвище, ім'я та дату народження пацієнта. Отримання даних неідентифікованої персони виконується за її ідентифікатором.

За необхідності, перед формуванням запиту на створення МВН, Користувач може перевірити наявність раніше створених МВН через [DRAFT] BP-ESOZ-018-0008 [MIS] Пошук та отримання даних про медичні висновки .

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

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

1.30

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

Користувач створює та обирає взаємодію окремо для кожної живонародженої дитини стосовно наданих медичних послуг протягом перебування дитини в НМП.

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

1.40

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

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

• тип МВН (параметр "type") із довідника https://e-health-ua.atlassian.net/wiki/spaces/ENS/pages/18024857818 . Значення за замовчуванням "Медичний висновок про народження" ("NEWBORN");

• категорія (параметр "category") із довідника https://e-health-ua.atlassian.net/wiki/spaces/ENS/pages/18047205400. Значення за замовчуванням "пологи, живонароджена дитина" ("LIVE_BIRTH");

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

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

• кінець періоду дійсності МВН (параметр "event.period.end") із порожнім значенням за замовчуванням та без можливості зміни цього значення користувачем;

• ідентифікатор новонародженої дитини (параметр "subject") який дорівнює параметру "preperson_id";

• ідентифікатор взаємодії по новонародженій дитині (параметр "encounter"), який дорівнює параметру "encounter_id";

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

• ідентифікатор жінки, що народила, (параметр "section.focus") який дорівнює параметру "person_id";

• дата народження дитини (параметр “extension.newborn_birth_date“), в якому зазначається дата народження новонародженої дитини. Має дорівнювати параметру “preperson.birth_date” та відповідати даті, вказаної у параметрі “event.period.start”;

• стать новонародженого (параметр “extension.newborn_sex“) із довідника [RC] GENDER ,що має дорівнювати параметру “preperson.gender”;

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

Користувач разом з пацієнтом повинен мати можливість обрати бажаний метод автентифікації, а МІС отримати параметр "authorize_with" (параметр "id") для наступних дій;

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

1.50

Обрати або створити запис про жінку, що народила

Користувач має обрати потрібний запис або створити новий, згідно процесу [DRAFT] BP-ESOZ-022-0001 [MIS] Створення запису про пацієнта, після чого перейти до кроку GW 1.10.

GW 1.10

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

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

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

1.60

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

Користувач вказує метод автентифікації згідно з процесом BP-ESOZ-020-0001 [MIS] Створення методу автентифікації пацієнта та переходить до кроку GW 1.20.

GW 1.20

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

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

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

1.70

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

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

1.80

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

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

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.90

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

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

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.30

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

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

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

1.100

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

Користувач може переглянути результати створення МВН та уникнути помилок при наступному створені нового МВН. Далі перейти до кроку EE 1.10.

EE 1.10

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

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

1.110

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

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

• ідентифікатора МВН "composition_id"; 

• ідентифікатора новонародженої дитини "preperson_id";

• ідентифікатора ЕМЗ по новонародженій дитині "encounter_id". 

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

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.120

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

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

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

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

• новонароджена дитина (параметр "composition.subject");

• жінка, що народила (параметр "composition.section.focus");

• ідентифікатор взаємодії по новонародженій дитині (параметр "encounter");

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

• початок періоду дійсності та кінець періоду дійсності медичного висновку (параметри "event.period.start" та "event.period.end");

• дата народження новонародженої дитини (параметр “newborn_birth_date“);

• стать новонародженого (параметр “newborn_sex“);

• автор МВН (параметр "author");

• ідентифікатор обраного методу автентифікації, якщо його було зазначено на кроці 1.60 (параметр "extension.valueCode.authorize_with").

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

GW 1.40

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

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

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

1.130

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

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

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

GW 1.50

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

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

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

1.140

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

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

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

GW 1.90

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

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

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

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

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

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

1.150

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

В разі відсутності помилок у відомостях інформаційної довідки та/або інтерфейсі, Користувач повинен мати можливість засвідчити запит на підписання МВН за допомогою КЕП користувача. Після засвідчення КЕП, перейти до кроку 1.160.

1.160

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

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

 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.50.1

Create SIGN_COMPOSITION job

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

2.20.2

Валідація

В ЦБД ЕСОЗ виконуються валідації описані на сторінці.

GW 2.10

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

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

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

ЕЕ 2.10.

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

Результат обробки невдалий. Вихід із процесу.

GW 2.20

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

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

• Якщо ні (метод автентифікації не зазаначено), тоді перейти до кроку EE 2.20

2.50.3

Відправка SMS

SMS-0005

EE 2.20

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

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

1.170

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

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

Scope -composition:read

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

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

2.60

getAsyncJobStatus

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

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

GW 1.60

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

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

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

ЕЕ 1.20

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

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

GW 1.70

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

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

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

1.130180

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

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

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

Scope -composition:read

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

відповідно до процесу BP-ESOZ-018-0013 [MIS] Отримання друкованої форми МВ.

GW 1.50Помилки відсутні80

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

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

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

1.140

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

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

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

GW 1.90

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

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

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

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

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

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

1.150

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

В разі відсутності помилок у відомостях інформаційної довідки та/або інтерфейсі, Користувач повинен мати можливість засвідчити запит на підписання МВН за допомогою КЕП користувача. Після засвідчення КЕП, перейти до кроку 1.160.

1.160

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

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

[API-006-001-001-0212]

signComposition

1.170

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

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

Scope -composition:read

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

[API-006-001-001-0209]

getAsyncJobStatus

GW 1.60

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

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

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

ЕЕ 1.20

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

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

GW 1.70

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

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

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

1.180

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

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

getPrintForm.

GW 1.80

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

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

• Якщо ні (статус поточного МВН переглядати не потрібно), Користувач переходить до кроку ЕЕ 1.30 та завершує процес.

1.190

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

getIntegrationData

EE 1.30

МВН створено

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

190

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

Дані по статусу Користувач отримує через деталі по статусу обробки медичного висновку за методом АРІgetIntegrationData.

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

• компонент, з яким відбувається взаємодія (параметр “component“): "ДРАЦСГ" ("MJU_DRACZ"), "Дія" (“DIIA”);

• тип виклику до компоненту (параметр “type”): "NEWBORN_POST_COMPOSITION" та “NEWBORN_GET_COMPOSITION” (“ДРАЦСГ”), "NEWBORN_GET_COMPOSITION" (“Дія”);

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

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

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

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

• набір даних, визначений інтеграційним компонентом (параметр “details”). Для типу виклику (параметр “type”) "NEWBORN_POST_COMPOSITION" до компоненти "ДРАЦСГ" ("MJU_DRACZ") в наборі даних буде передаватися ідентифікатор створеної ідентифікованої дитини (параметр “personId”).

Scope -composition:read

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

[DRAFT] getIntegrationData [API-006-001-001-0217]

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

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