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

OLD_Уточнення МВТН (preperson -> person)

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

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

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

  • Після ідентифікації пацієнта записи про ідентифікованого та неідентифікованого пацієнта повинні бути поєднані (merge);

  • Уточнюючий МВТН повинен створюватися тільки для ідентифікованої особи (person) із посиланням на взаємодію неідентифікованої особи. Це єдиний випадок, коли допускається створення двох МВТН незалежно від категорії

  • обʼєкт relatesTo для уточнюючого МВТН генерується Системою та вказує на попередній МВТН і відношення до нього через значення relatesTo.code:

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

  • При створенні уточнюючого МВТН не дозволяється зазначення параметру про новий випадок непрацездатності IS_FORCE_RENEW = TRUE, оскільки цей параметр зазначається тільки для нових випадків непрацездатності, що не пов'язані жодним чином із попередніми;

  • ВАЖЛИВО!!! Отримання уточнюючого МВТН (за методом АРІ getComposition) виконується виключно із зазначенням ідентифікатора пацієнта, по якому створено взаємодію, тобто preperson_id

Процес створення МВТН для уточнення (preperson -> person)

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

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

№

Крок

Опис

№

Крок

Опис

1

Створити запис про пацієнта (preperson)

Для створення МВТН медичний працівник повинен створити в ЕСОЗ запис про неідентифікованого пацієнта за правилами відповідного процесу:

2

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

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

 

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

3

Створити новий МВТН

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

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

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

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

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

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

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

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

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

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

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

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

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

  • ідентифікатор обраного методу автентифікації. Не зазначається, оскільки у неідентифікованого пацієнта відсутні методи автентифікації;

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

4

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

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

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

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

5

Надати медичні послуги пацієнту

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

6

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

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

7

Провести поєднання записів про пацієнта

Необхідною умовою по створенню уточнюючого МВТН є поєднання записів про пацієнта за правилами Зв'язування неідентифікованої персони із ідентифікованою персоною

8

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

По суті уточнюючий МВТН має той же набір даних, що і МВТН для неідентифікованої особи, за виключенням:

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

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

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

необов'язково:

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

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

9

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

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

10

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

ВАЖЛИВО !!! Медичний працівник отримує деталі по уточнюючему МВТН за методом АРІ getComposition, зазначаючи ідентифікатор неідентифікованої особи (preperson_id), для якої було створено взаємодію, зазначену на кроці 7.

11

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

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

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

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

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

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

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

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

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

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

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

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

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

12

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

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

13

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

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

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

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

14

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

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

 

 

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