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

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 8 Current »

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

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

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

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

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

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

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

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

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

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

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

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

    • періоди дії по МВТН стикуються, або пересікаються. Приклад:

період дійсності МВТН 1

період дійсності МВТН 2

Результат

relatesTo у МВТН2

з 01.10 по 05.10

03.10 по 15.10

продовження, бо періоди дії по МВТН пересікаються

code = appends

targetIdentifier = МВТН1

01.10 по 05.10

03.10 по 03.10

скорочення, бо початк періоду дії МВТН2 знаходиться в межах періоду дії МВНТ1.

code = transforms

targetIdentifier = МВТН1

01.10 по 05.10

05.10 по 10.10

продовження, бо періоди дії по МВТН стикуються

code = appends

targetIdentifier = МВТН1

01.10 по 05.10

06.10 по 10.10

продовження, бо періоди дії по МВТН стикуються

code = appends

targetIdentifier = МВТН1

01.10 по 05.10

07.10 по 10.10

Висновки не пов'язані одним випадком непрацездатності. Періоди дії МВТН1 та МВТН2 мають розрив більше, ніж на 1 день. Продовження не буде, relatesTo у МВТН1

блок relatesTo у МВТН1 відсутній

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

Схема процесу створення МВТН для продовження / скорочення

https://cawemo.com/share/a8da3655-a949-4b46-9977-ea978903fa15

Опис кроків по процесу

Крок

Опис

1

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

Медичний працівник знаходить запис про пацієнта.

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

2

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

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

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

3

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

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

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

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

4

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

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

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

5

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

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

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

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

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

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

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

 Правила створення МВТН в минулому

значення параметру EMAL_FILTER_PERIOD_START_DISABILITY ігнорується, якщо:

1. в створюваному МВТН зазначено

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

- або extension.is_foreign_treatment=true

2. при створенні уточнення (preperson -> person) для МВТН

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

 Правило створення МВТН в майбутньому

Зазначення початку періоду дійсності МВТН в майбутньому дозволено тільки для продовження попереднього випадку непрацездатності категорії PREGNANCY (характер зв'язку з попереднім МВТН “appends“ ). Термін дійсності такого МВТН регулюється конфігураційним параметром EMAL_VALIDATION_PREGNANCY_APPENDED_COMPOSITION_ALLOWED_PERIOD

  • кінець періоду дійсності МВТН (параметр "event.period.end") що має визначатись користувачем в залежності від стану пацієнта та категорії МВТН та передаватися МІС до Системи у форматі ISO 8601 із обов’язковим приведенням до Всесвітнього координованого часу UTC (приклад: "2021-04-11T15:22:53.403Z");

 Правила зазначення дати кінця дійсності

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

Для категорії PREGNANCY період дійсності первинного МВТН має відповідати одному з дозволених значень, вказаних в конфігураційному параметрі EMAL_VALIDATION_PREGNANCY_NEW_COMPOSITION_ALLOWED_PERIODS.

  • ідентифікатор пацієнта (параметр "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;

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

    • параметр "extension.valueCode.TREATMENT_VIOLATION" із довідника “COMPOSITION_TREATMENT_VIOLATION”;

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

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

6

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

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

7

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

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

8

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

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

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

9

Отримати деталі з МВТН з relatesTo

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

10

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

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

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

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

11

Перевірити дані по створюваному МВТН

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

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

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

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

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

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

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

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

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

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

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

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

12

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

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

13

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

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

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

14

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

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

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

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

15

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

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

16

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

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

17

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

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

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

  • компонент, з яким відбувається взаємодія (параметр “component“): "ЕРЛН";

  • тип виклику до компоненту (параметр “type”): "CREATE_ERLN_RECORD", "CANCEL_ERLN_RECORD";

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

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

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

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

  • набір даних, визначений інтеграційним компонентом (параметр “details”):

    • для типу виклику "CREATE_ERLN_RECORD" до компоненти "ЕРЛН" ("ERLN") в наборі даних будуть передаватися: Єдиний реєстраційний номер ЕЛН (параметр “SL_NUM“), Дата та час реєстрації ЕЛН (параметр “SL_REG_DATETIME“), Дата відкриття ЕЛН (параметр “SL_START“), Дата подовження ЕЛН (параметр “SL_PROLONGATION“), Дата закриття ЕЛН (параметр “SL_STOP“) та Номер випадку непрацездатності (параметр “IC_NUM“).

    • для типу виклику "CANCEL_ERLN_RECORD" до компоненти "ЕРЛН" ("ERLN") в наборі даних будуть передаватися: Єдиний реєстраційний номер ЕЛН (параметр “SL_NUM“), Дата та час реєстрації ЕЛН (параметр “SL_REG_DATETIME“) та Номер випадку непрацездатності (параметр “IC_NUM“).

  • No labels