№ кроку

Крок

Опис

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

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

SE 1.10

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

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

1.10

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

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

1.20

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

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

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

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

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

1.30

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

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

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

1.40

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

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

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

• категорія (параметр "category") із довідника "COMPOSITION_CATEGORIES" 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.Medical Events API

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]

createComposition

2.10

createComposition

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

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

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]GetAsyncJobStatus

2.30

getAsyncJobStatus

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

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

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]

getComposition

2.40

getComposition

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

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

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]signComposition

2.50

SignComposition

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

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

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]

getAsyncJobStatus

2.60

getAsyncJobStatus

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

[DRAFT] REST API getAsyncJobStatus [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

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

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

GW 1.80

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

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

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

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

МВН створено

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