RC_6. Уточнення (preperson -> person) для МВТН

1

Ідентифікувати пацієнта

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

2

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

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

• створення запису для ідентифікованої особи;

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

3

Виконати пошук МВТН

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

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

4

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

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

5

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

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

При створенні МВТН слід використовувати типи взаємодії відповідно до https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/583402009/Medical+Events+Dictionaries+and+configurations#encounter_class_encounter_types

6

Вказати посилання на МВ та relatesTo.code = replaces

Медичний працівник вказує ідентифікатор МВ останнього з ланцюгу МВТН, який належить неідентифікованій особі (параметр "relatesTo") та зазначає значення “replaces” з довідника "COMPOSITION_RELATION_CODE" (параметр “relatesTo.code”).

7

Вказати непрацездатну особу та МА

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

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

8

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

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

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

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

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

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

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

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

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

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

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

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

• відмітка (“TRUE” or “FALSE”) про те, що непрацездатність повʼязана з випадком на виробництві (параметр "extension.valueCode.IS_ACCIDENT"). У випадку уточнення ланцюгу (масиву) МВТН преперсони: якщо хоч в одному МВ з масиву, який уточнюється, зазначено IS_ACCIDENT=”TRUE”, то в уточнюючому значення наслідується “TRUE”;

• відмітка (“TRUE” or “FALSE”) про те, що діагностована алкогольна, або наркотична інтоксикація (параметр "extension.valueCode.IS_INTOXICATED"). Значення за замовчуванням “FALSE”. У випадку уточнення ланцюгу (масиву) МВТН преперсони: якщо хоч в одному МВ з масиву який уточнюється, зазначено IS_INTOXICATED=”TRUE”, то в уточнюючому значення наслідується “TRUE”;

• відмітка (“FALSE”) про те, що МВТН відкривається для фіксації в Системі випадків непрацездатності, що настала за кордоном (параметр "extension.valueCode.IS_FOREIGN_TREATMENT"). Медичний працівник має зазначати “FALSE” , оскільки преперсона не може лікуватися за кордоном;

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

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

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

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

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

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

9

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

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

10

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

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

11

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

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

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

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

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

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

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

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

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

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

• ідентифікатор останнього в ланцюгу МВ для preperson (параметр "relatesTo.targetIdentifier").

12

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

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

13

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

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

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

14

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

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

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

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

15

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

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

16

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

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

17

Переглянути статус обробки МВТН, номер запису в ЕРЛН

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

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

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

• тип виклику до компоненту (параметр “type”): "CREATE_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“).