ЕСОЗ - публічна документація

Створення МВТН як нового

Owned by Vyacheslav Syrskyy (Unlicensed)
Last updated: Mar 02, 2023 by Nickolay Kolotov (SoE eHealth)
4 min read

Загальні ствердження

  • Створення МВТН можливе лікарем ПМД, або лікарем СМД;

  • Створення МВТН можливе для ідентифікованої особи (ПМД + СМД) та для неідентифікованої (тільки СМД);

  • Правила застосування person/preperson у атрибутах subject/focus при створенні МВТН наведено у Специфікації;

  • якщо медичний працівник при створенні МВТН зазначив IS_FORCE_RENEW = TRUE (на думку лікаря, це новий випадок непрацездатності, а не продовження), то relatesTo не буде сформовано Системою і МВ буде створено як новий;

  • Незалежно від категорії, два МВТН на одну взаємодію допускається тільки для випадку уточнення особи (preperson->person). В усіх інших випадках буде помилка "Composition updates are only allowed for preperson->person".

Процес створення нового МВТН

 

Вимоги до процесу

Створення МВТН повинно враховувати модель даних: Composition - специфікація.

№

Крок

Опис

№

Крок

Опис

1

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

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

 

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

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

2

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

Створення ЕМЗ по взаємодії пацієнта відбувається за правилами процесу “Реєстрація результатів візиту в ЦК”.

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

 

При створенні МВТН слід використовувати типи взаємодії відповідно до Medical Events Dictionaries and configurations | encounter_class_encounter_types

3

Здійснити пошук МВТН

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

4

Переглянути деталі МВТН

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

  • наявність укладеної декларації із пацієнтом (@rule_1);

  • медичний працівник є автором МВТН (@rule_6);

  • медичний працівник зареєстрований у тому ж ЗОЗ, що і автор МВТН (@rule_2);

  • медичний працівник має Approval на відповідний Епізод МД пацієнта (@rule_5).

5

Створити запит на approval

Якщо медичний працівник не має доступу до деталей МВТН, то він повинен мати змогу створити запит на отримання доступу з боку пацієнта відповідно до опису процесу “Отримання дозволу пацієнта на операції з даними у системі E-Health”

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

6

Визначити непрацездатну особу + МА (метод автентифікації)

Медичний працівник визначає непрацездатну особу, заповнюючи відповідні атрибути МВТН згідно з правилами застосування атрибутів Subject та Focus. Також при формуванні запиту на створення МВТН у випадку вказання ідентифікованого пацієнта як непрацездатної особи (параметр "section.focus") медичний працівник повинен мати змогу обрання методу автентифікації з наявних у непрацездатної особи.

7

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

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

1. обов’язкові параметри:

  • тип МВТН (параметр "type") із довідника "COMPOSITION_TYPES";

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

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

  • початок періоду дійсності МВТН (параметр "event.period.start"), що має дорівнювати даті та часу початку непрацездатності;

1. дата початку регулюється параметром EMAL_FILTER_PERIOD_START_DISABILITY. В змінній міститься значення Х днів, яке означає, що дату початку можна вказати як (СЬОГОДНІ - Х).

Приклад:

EMAL_FILTER_PERIOD_START_DISABILITY = 2.

СЬОГОДНІ = 2021-07-01

можливі значення для event.period.start:

- 2021-06-29

- 2021-06-30

- 2021-07-01

 

2. значення параметру EMAL_FILTER_PERIOD_START_DISABILITY ігнорується, якщо в створюваному МВТН зазначено:

- категорію PREGNANCY;

або

- extension.is_foreign_treatment=true

або

- ідентифікація неідентифікованого"

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

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

  • ідентифікатор пацієнта (параметр "subject") який дорівнює параметру "preperson_id" для неідентифікованої особи або "person_id" для ідентифікованої особи, яка отримує медичну допомогу згідно з правилами застосування атрибутів Subject та Focus;

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

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

  • ідентифікатор непрацездатної особи (параметр "section.focus") згідно з правилами застосування атрибутів Subject та Focus;

2. необов'язкові параметри:

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

  • відмітка (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;

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

    • параметр "extension.valueCode.TREATMENT_VIOLATION" із значенням за замовчуванням FALSE;

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

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

8

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

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

9

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

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

10

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

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

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

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

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

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

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

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

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

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

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

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

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

11

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

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

12

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

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

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

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

13

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

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

ЕСОЗ - публічна документація