2.1. МВН - Створення нового

№Ф

Крок

Опис

1

Знайти записи про жінку та новонародженого

Для створення МВН медичний працівник повинен мати ідентифікатор пацієнта (новонародженого) та ідентифікатор взаємодії для живонародженої дитини.

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

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

2

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

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

Пошук здійснюється відповідно до опису процесу Пошук та отримання МВ.

3

Обрати взаємодію

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

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

4

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

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

• тип МВН (параметр "type") із довідника "COMPOSITION_TYPES". Значення за замовчуванням "Медичний висновок про народження" ("NEWBORN");

• категорія (параметр "category") із довідника "COMPOSITION_CATEGORIES". Значення за замовчуванням "пологи, живонароджена дитина" ("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“) із довідника “GENDER“,що має дорівнювати параметру “preperson.gender”;

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

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

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

5

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

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

6

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

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

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

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

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

7

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

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

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

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

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

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

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

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

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

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

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

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

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

8

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

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

9

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

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

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

10

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

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

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

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

11

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

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

12

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

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

13

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

Дані по статусу медичний працівник отримує через деталі по статусу обробки МВ за методом АРІ 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”).