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

OLD_Продовження / скорочення МВТН

Owned by Dmytro Kulibaba (Unlicensed)
Aug 23, 2022
5 min read

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

  • Медичний працівник, створюючи МВТН, не може (і не має) вказувати дані про продовження, або скорочення;

  • ЕСОЗ за допомогою пошуку МВТН у зазначеній категорії показує знайдений попередній висновок в об'єкті relatesTo з відповідними атрибутами

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

  • обʼєкт relatesTo завжди генерується Системою, не лікарем! Ідентифікатор у relatesTo.code вказує на попередній МВТН, з яким Система виявила зв'язок.

– Appends (доповнення/продовження строку МВТН);

– Replaces (уточнення особи - тільки якщо попередній МВТН був створений на неідентифікованого пацієнта (pre-person));

– Transforms (скорочення строку МВТН);

  • обʼєкт relatesTo генерується на етапі створення чернетки МВТН (STATUS = PRELIMINARY);

  • обʼєкт relatesTo для випадків продовження (appends) та скорочення (transforms) генерується Системою за наступних умов:

    • в обох МВТН зазначено одного і того ж пацієнта (subject);

    • пов'язані МВТН мають одну і ту саму категорію МВТН (наприклад, SICKNESS);

    • періоди дії по МВТН стикуються, або пересікаються. Приклад: МВТН 1 з 01.10 по 05.10, МВТН2 з 03.10 по 15.10 (продовження); або МВТН 1 з 01.10 по 05.10, МВТН2 з 03.10 по 03.10 (скорочення); або МВТН 1 з 01.10 по 05.10, МВТН2 з 05.10 по 10.10 (продовження);

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

Процес створення МВТН для продовження / скорочення

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

 

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

№

Крок

Опис

№

Крок

Опис

1

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

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

 

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

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

2

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

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

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

3

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

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

4

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

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

  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;

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

  • ідентифікатор обраного методу автентифікації (параметр "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) про те, що МВТН створюється як новий випадок непрацездатності, не пов'язаний із попередніми випадками. Значення за замовчуванням FALSE.

5

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

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

6

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

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

7

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

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

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

8

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

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

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

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

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

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

9

Проінформувати пацієнта (за необхідності)

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

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

В іншому випадку медичний працівник переходить до наступного кроку.

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 та за необхідності інформує пацієнта про (не)успішність створення МВТН.

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