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

[DRAFT] BP-ESOZ-018-0007 [NHS] Повторна відправка МВТН в ЕРЛН з ініціації НСЗУ

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

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

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

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

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

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

BP-ESOZ-018-0007 [NHS] Повторна відправка МВТН в ЕРЛН з ініціації НСЗУ

ID настанови

GUI-004

Автор

@Mariana Veremeieva (UA SoE eHealth)

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

v010

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

DRAFT

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

31.07.2024

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

 

ID групи

BPG-ESOZ-018

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

BP-ESOZ-018-0007

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

[NHS] Повторна відправка МВТН в ЕРЛН з ініціації НСЗУ

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

BP-ESOZ-018-0007 [NHS] Повторна відправка МВТН в ЕРЛН з ініціації НСЗУ

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

 

Кнопка повторного надсилання в ЕРЛН на адміністративній панелі НСЗУ дає можливість з ініціативи користувача повторно надіслати МВ до ЕРЛН та є доступною лише для користувачів з розширеним скоупом composition_admin:write.

Передумови

  • статус МВТН (параметр "status") дорівнює "FINAL";

  • Коректний інтеграційний статус МВТН (реєстрація в ЕРЛН пройшла неуспішно)

  • Не має існувати іншої задачі на відправку запиту CREATE_ERLN_RECORD щодо цього МВ

  • в якості тимчасово непрацездатної особи зазначено ідентифікованого пацієнта (ПФУ не приймає МВ із преперсоном)

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

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

 

 

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

На перегляд: https://modeler.camunda.io/share/88b7ed92-ef7e-4410-9b68-0269efe7d2cc

На редагування: https://modeler.camunda.io/diagrams/40e9d8e8-a131-4d25-a511-db685a1dfd35--bp-esoz-018-0007-nhs-повторна-відправка-мвтн-в-ерлн-з-ініціації-нсзу?v=778,893,1

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

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

1

№ кроку

Крок

Опис

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

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

2

SE 1.10

Перевідправка МВТН пацієнта співробітником НСЗУ

У разі виникнення судового рішення скасувати МВТН пацієнта, Користувачеві НСЗУ через адміністративну панель в ЕСОЗ при виборі розділу “Медичні висновки” має бути доступною сторінка з полями для пошуку МВТН за різними атрибутами

 

 

3

1.10

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

Пошук здійснюється після натискання на кнопку “Шукати”. Користувач НСЗУ має для пошуку обов'язково заповнити хоча б один атрибут МВТН — номер, пацієнта чи особу, якій видано МВТН

 

 

4

2.10

GET/admin/composition/search (NHS Admin)

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

Результати пошуку виводяться на сторінці у форматі таблиці, де кожному рядку відповідає запис про один МВ. При виведенні великої вибірки результатів, варто виводити результати у форматі “10, 20, 50 результатів запиту”. Порядок виведення — довільний.

Scope -composition_admin:read

Resource - GET/admin/composition/search

https://app.swaggerhub.com/apis/ehealthua/compositions_Admin_panel/2.33.0#/default/searchCompositions

https://e-health-ua.atlassian.net/wiki/spaces/emal/pages/17350885447

5

1.20

Відкрити деталі МВТН

Для того, щоб переглянути МВТН детальніше або зробити з ним якусь дію, потрібно натиснути кнопку Деталі, після чого перейти до виконання кроку 1.30

 

 

6

2.20

getComposition (NHS Admin) ?

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

Scope -composition_admin:read

Вендор не надав АРІ-документацію, можливо цей крок упускається, т.я

7

1.30

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

Користувач НСЗУ може переглянути статус обробки МВТН, після чого перейти до кроку GW 1.10

 

 

8

2.30

getIntegrationData (NHS Admin) ?

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

 

Вендор не надав АРІ-документацію, ймовірно працює спільний метод getIntegrationData

9

GW 1.10

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

  • Якщо так (параметр "status" МВТН дорівнює "FINAL", інтеграційний статус integrationStatus="ERROR", пацієнт ідентифікований як person), то перейти до кроку 1.40.

  • Якщо ні (параметр "status" МВТН не дорівнює "FINAL", параметру integrationStatus належить відмінне від “ERROR” значення, пацієнт ідентифікований як preperson), то перейти до кроку EE 1.10.

 

 

10

EE 1.10

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

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

 

 

11

1.40

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

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

 

 

12

GW 1.20

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

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

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

 

 

13

EE 1.20

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

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

 

 

14

1.50

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

Висновки, для яких інтеграція ЕРЛН початково не була успішна (DISABILITY_PROCESSING_STATUS дорівнює значенню “ERROR” перевідправляються в ЕРЛН за методом API PATCH/admin/composition/{compositionId}/erln/create/retryd__erln. Після цього Користувач НЗСУ переходить до кроку 1.60

 

 

15

2.40

PATCH/admin/composition/{compositionId}/erln/create/retry

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

Scope -composition_admin:write

Resource - PATCH/admin/composition/{compositionId}/erln/create/retry

https://e-health-ua.atlassian.net/wiki/spaces/emal/pages/17351671838

https://app.swaggerhub.com/apis/ehealthua/compositions_Admin_panel/2.33.0#/default/retryCreateErlnRecord

16

GW 2.10

Чи існують актуальні задачі на відправку запиту CREATE_ERLN_RECORD для цього МВТН?

  • Якщо так (існує задача на відправку запиту CREATE_ERLN_RECORD), система виконує крок EE 2.10.

  • Якщо ні (активних задач на відправку запиту CREATE_ERLN_RECORD не існує), то система виконує крок 2.50

 

 

17

2.50

Create job

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

 

 

18

2.60

CREATE_ERLN_RECORD

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

 

 

19

EE 2.20

Статус Done

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

 

 

20

1.60

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

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

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

 

 

21

2.70

GetAsyncJobStatus

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

 Scope -composition:read

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

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

22

 

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

Виконати дії, описані в методі getIntegrationData (NHS Admin), після чого перейти до кроку GW 1.30.

 

 

23

2.80

getIntegrationData

Після отримання оновлених даних щодо інтеграційного статусу, метод повертає для МВТН результат з реєстру ЕРЛН

 Scope -composition:read

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

[DRAFT] getIntegrationData [API-006-001-001-0217]

24

GW 1.30

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

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

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

 

 

25

EE 1.30

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

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

 

 

26

EE 1.40

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

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

 

 

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

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

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

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

Перелік змін

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

Опис змін

Номер релізу

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

Опис змін

Номер релізу

1

 

 

 

2

 

 

 

 

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