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

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 9 Current »

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

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

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

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

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

Схема процесу створення нового МВТН

https://cawemo.com/share/d71b8ea8-7255-4b18-b7a9-164b48ce5bdd

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

№

Крок

Опис

1

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

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

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

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

2

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

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

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

3

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

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

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

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

При створенні МВТН на певну взаємодію слід враховувати, що на одну взаємодію (encounter.value) можна створити тільки один медичний висновок однієї категорії та типу МВ в статусі “Підписаний“ (status “FINAL”).

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. необов'язкові параметри (застосування розширень для певних категорій МВ здійснюється відповідно до Можливість застосування extensions в залежності від категорії МВ):

  • ідентифікатор обраного методу автентифікації (параметр "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

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

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

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

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

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

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

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

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

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

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

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

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

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

9

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

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

10

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

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

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

11

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

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

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

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

12

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

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

13

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

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

14

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

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

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

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

  • тип виклику до компоненту (параметр “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

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