ЕСОЗ - публічна документація
[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
Похідний файл схеми (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://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 | Чи дотримуються умови за статусами (документу та інтеграційним), типом облікового запису пацієнта? |
|
|
|
10 | EE 1.10 | МВТН повторно не відправлений | МВТН повторно не відправлений. Вихід із процесу |
|
|
11 | 1.40 | Переглянути опис помилки | Користувач НСЗУ ознайомлюється з описом помилки у statusMessage, після чого приймає рішення про необхідність перевідправки МВТН в ЕРЛН. Це потрібно робити, наприклад, після того, як дані про пацієнта були уточнені в ЕРЛН, або якщо на момент інтеграційної обробки даних по пацієнту в ЕРЛН ще не було зареєстровано. Довідник опису помилки знаходиться на сторінці Dict ERLN_RESULT_CODES. Після виконаної дії перейти до кроку GW 1.20 |
|
|
12 | GW 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 |
16 | GW 2.10 | Чи існують актуальні задачі на відправку запиту CREATE_ERLN_RECORD для цього МВТН? |
|
|
|
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} | |
22 |
| Оновити інтеграційний статус | Виконати дії, описані в методі getIntegrationData (NHS Admin), після чого перейти до кроку GW 1.30. |
|
|
23 | 2.80 | getIntegrationData | Після отримання оновлених даних щодо інтеграційного статусу, метод повертає для МВТН результат з реєстру ЕРЛН | Scope -composition:read Resource - GET /patients/{patientId}/composition/{compositionId}/episode/{episodeId}/encounter/{encounterId} | |
24 | GW 1.30 | "integrationStatus" дорівнює "ERROR"? |
|
|
|
25 | EE 1.30 | МВТН повторно не відправлен | МВТН повторно не відправлений. Вихід із процесу. |
|
|
26 | EE 1.40 | МВТН перевідправлений | МВТН перевідправлений. Завершення процесу. |
|
|
Бізнес правила
З метою недопущення по створенню надлишкової кількості запитів на перевідправку МВТН, з боку ЦБД ЕСОЗ реалізоване обмеження: можливо повторно відправити лише ті МВТН, які мають integrationStatus = ERROR та у них є наявним опис помилки у statusMessage. В протилежному випадку МІС отримає при спробі перевідправки МВТН помилку 400 BAD REQUEST.
Результат процесу
МВТН повторно відправлений в ЕРЛН ПФУ.
Перелік змін
Версія документа | Опис змін | Номер релізу | |
---|---|---|---|
1 |
|
|
|
2 |
|
|
|
ЕСОЗ - публічна документація