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

[DRAFT] BP-ESOZ-018-0006 [MIS] Повторна відправка МВТН в ЕРЛН

Сторінка знаходиться в процесі розробки. Інформація на ній може бути застарілою.

https://e-health-ua.atlassian.net/wiki/spaces/EN/pages/17560797187 (видаліть блок з посиланням перед публікацією документа)

Властивості документа

Тип документа

Бізнес-процес

Назва документа

BP-ESOZ-018-0006 [MIS] Повторна відправка МВТН в ЕРЛН

ID настанови

GUI-004

Автор

@Mariana Veremeieva (UA SoE eHealth)

Версія документа

v010

Статус документа

DRAFT

Дата створення

19.06.2024

Дата оновлення

 

ID групи

BPG-ESOZ-018

ID бізнес-процесу

BP-ESOZ-018-0006

Назва бізнес-процесу

[MIS] Повторна відправка МВТН в ЕРЛН

Посилання на схеми

BP-ESOZ-018-0006 [MIS] Повторна відправка МВТН в ЕРЛН

Загальні відомості

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

Передумови

  • наявність в Системі успішно зареєстрованого НМП СМД (надавача медичних послуг спеціалізованої медичної допомоги) та доступ до ЕСОЗ медичного працівника з відповідними правами користувача ЕСОЗ (далі - Користувач);

  • наявний дійсний МВТН у статусі "FINAL" (параметр "status");

  • в якості тимчасово непрацездатної особи зазначено ідентифікованого пацієнта section.focus.type.coding.code = person;

  • реєстрація МВТН в ЕРЛН пройшла неуспішно (параметр "integrationStatus" дорівнює "ERROR" у компоненті "ERLN" із відповідним типом (параметр "type"), який дорівнює значенням "CREATE_ERLN_RECORD");

  • наявний опис помилки від ЕРЛН (параметр “statusMessage” непустий).

Схема бізнес-процесу

 

Зображення схеми

 

 

 

 

Посилання на схему

На перегляд: https://modeler.cloud.camunda.io/share/9ffd53f3-8b20-4fc0-9867-57cf20faefe4

На редагування: https://modeler.cloud.camunda.io/diagrams/0a381b61-6145-47aa-ba09-ef8d12972090--bp-esoz-018-0006-mis-повторна-відправка-мвтн-в-ерлн?v=1358,488,1

Похідний файл схеми (BPMN)

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

1

№ кроку

Крок

Опис

Технічний модуль

Методи API які мають або можуть бути використані

2

SE 1.10

Перевідправка МВТН

Потреба повторно відправити дані по МВТН у разі помилки обробки з боку ЕРЛН.

 

 

3

1.10

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

Медичний працівник (Користувач) за допомогою МІС має можливість пошуку раніше створених МВТН відповідно до процесу BP-ESOZ-018-0008 [MIS] Пошук та отримання даних про медичні висновки

 

 

4

1.20

Виконати  отримання МВТН

МІС може отримати від ЦБД ЕСОЗ деталі МВТН для ознайомлення із даними та перегляду інформації, пов'язаної з МВТН відповідно доступу до контенту медвисновку, регламентованим правами на перегляд даних, створених від батьківської сутності, до якої користувач має відповідні права доступу.  

 

 

5

1.30

Перевірити статус опрацювання в ЕРЛН

Користувач може переглянути статус обробки МВТН, що описаний в процесі BP-ESOZ-018-0005 [MIS] Отримання даних про інтеграційний статус медичних висновків. Після виконання дії перейти до кроку GW 1.10.

 

 

6

GW 1.10

Чи дотримуються умови за статусами (документу та інтеграційним), типом облікового запису пацієнта?

  • Якщо так (статус документу status="FINAL" та інтеграційний статус integrationStatus="ERROR"), то перейти до кроку 1.40, щоб переглянути опис помилки.

  • Якщо ні (статус документу status !="FINAL" та інтеграційний статус integrationStatus != "ERROR"), то перейти до кроку EE 1.10.

 

 

7

EE 1.10

МВТН повторно не відправлений

МВТН повторно не відправлений. Вихід із процесу.

 

 

8

1.40

Переглянути опис помилки

Після ознайомлення з описом помилки Користувач може прийняти рішення про необхідність перевідправки МВТН в ЕРЛН. Це потрібно робити, наприклад, після того, як дані про пацієнта були уточнені в ЕРЛН, або на момент інтеграційної обробки даних по пацієнту в ЕРЛН ще не було зареєстровано. Довідник опису помилки знаходиться на сторінці [DRAFT] Dict ERLN_RESULT_CODES . Після виконаної дії перейти до кроку GW 1.20.

 

 

9

GW 1.20

Потрібна перевідправка?

  • Якщо так (перевідправка МВТН потрібна), то перейти до кроку 1.50.

  • Якщо ні (перевідправка МВТН непотрібна), то перейти до кроку EE 1.20.

 

 

10

EE 1.20

МВТН повторно не відправлений

МВТН повторно не відправлений. Вихід із процесу.

 

 

11

1.50

Здійснити перевідправку

Висновки, для яких інтеграція ЕРЛН початково не була успішна (DISABILITY_PROCESSING_STATUS та дорівнює значенню “ERROR” перевідправляються в ЕРЛН за методом API patch_patients_composition__compositionId__erln

 

 

12

2.10

Patch_patients_composition__compositionId__erln

В ЦБД ЕСОЗ виконуються дії, передбачені відповідним методом АРІ.

Scope -composition:create

Resource - POST /patients/composition

[DRAFT] patch_patients_composition__compositionId__erln [API-006-001-001-0210]

13

GW 2.10

Чи є помилки?

  • Якщо так (є помилка з кодом 400, тобто валідація, описана в передумовах неуспішна ), система виконує крок EE 2.10.

  • Якщо ні (помилок немає, тобто валідація, описана в передумовах успішна), то система виконує крок 2.20

 

 

14

ЕЕ 2.10

МВТН повторно не відправлений

МВТН повторно не відправлений. Вихід із процесу.

 

 

15

2.20

Create job

Під час виконання методу API ЕСОЗ виконує задачу CREATE_ERLN_RECORD.

 

 

16

2.30

CREATE_ERLN_RECORD

Створюється запит до зовнішньої системи ЕРЛН, після чого здійснюється виконання кроку EE 2.20.

 

 

17

EE 2.20

Статус Done

Виконання внутрішної задачі CREATE_ERLN_RECORD успішно завершене.

 

 

18

1.60

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

МІС отримує результати виконання запиту через виконання методу getAsyncJobStatus. Далі МІС переходить до виконання кроку 1.70.

Приклад повідомлень про помилки ЦБД по роботі із медичними висновками надано на сторінці Повідомлення системи .

 

 

19

2.40

GetAsyncJobStatus

В ЦБД ЕСОЗ виконуються дії, передбачені відповідним методом АРІ.

 Scope -composition:read

Resource - GET /patients/{patientId}/composition/{compositionId}/episode/{episodeId}/encounter/{encounterId}

[DRAFT] REST API getAsyncJobStatus [API-006-001-001-0209]

20

1.70

Оновити інтеграційний статус

Виконати дії, описані в процесі

BP-ESOZ-018-0005 [MIS] Отримання даних про інтеграційний статус медичних висновків, після чого перейти до кроку GW 1.30.

 

 

21

GW 1.30

"integrationStatus" дорівнює "ERROR"?

  • Якщо так ("integrationStatus" дорівнює "ERROR" ), система виконує крок EE 1.30.

  • Якщо ні ("integrationStatus" не дорівнює "ERROR"), то система виконує крок EE 1.40.

 

 

22

EE 1.30

МВТН повторно не відправлен

МВТН повторно не відправлений. Вихід із процесу.

 

 

23

EE 1.40

МВТН перевідправлений

МВТН перевідправлений. Завершення процесу.

 

 

Бізнес правила

З метою недопущення по створенню надлишкової кількості запитів на перевідправку МВТН, з боку ЦБД ЕСОЗ реалізоване обмеження: можливо повторно відправити лише ті МВТН, які мають integrationStatus = ERROR та у них є наявним опис помилки у statusMessage. В протилежному випадку МІС отримає при спробі перевідправки МВТН помилку 400 BAD REQUEST.

Результат процесу

МВТН повторно відправлений в ЕРЛН ПФУ.

Перелік змін

Версія документа

Опис змін

Номер релізу

Версія документа

Опис змін

Номер релізу

1

 

 

 

2

 

 

 

 

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