№ кроку

Крок

Опис

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

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

SE 1.10

Початок процесу

Користувач хоче оновити персональні дані

1.10

Користувач виконує авторизацію в Системі

Користувач:

• виконав авторизацію в ЕСОЗ згідно процесів через:

  • https://e-health-ua.atlassian.net/wiki/x/0IBBKwQ

  • https://e-health-ua.atlassian.net/wiki/x/24BBKwQ

Система ЕСОЗ:

• Згенерувала токен доступу (access token) та токен оновлення доступу (refresh token) для користувача

1.20

Отримати персональні дані

Користувач виконує запит на отримання персональних даних, згідно процесу https://e-health-ua.atlassian.net/wiki/x/LoE9KwQ

1.30

Внести зміни в персональні дані

Користувач вносить зміни в персональні дані:

1. ім'я (параметр "first_name") - обов'язково;

2. прізвище (параметр "last_name") - обов'язково;

3. по батькові (параметр "second_name");

4. дата народження (параметр "birth_date"), яка заповнюється в форматі "ДД.ММ.РРРР" - обов'язково;

5. країна народження (параметр "birth_country"), згідно з довідником "COUNTRY"  - обов'язково;

6. місце народження (параметр "birth_settlement"), згідно з довідником "SETTLEMENT_TYPE" - обов'язково;

7. стать (параметр "gender") згідно з довідником "GENDER" - обов'язково;

8. електронна пошта (параметр "email"), домен якої не міститься в переліку заборонених (заблокованих) визначених відповідними розпорядженнями Національного центру оперативно-технічного управління мережами телекомунікацій (НЦУ);

9. відмітка про відмову від РНОКПП (параметр "no_tax_id") - для КПІС - обов'язково;

10. РНОКПП (параметр "tax_id") - (для КПІС якщо відсутні дані); 

11. кодове слово (параметр "secret") відповідно формату "^[A-Za-zА-Яа-яҐґЇїІіЄє0-9]{6,20}$"   - обов'язково;

12. документ пацієнта (масив "documents"), що посвідчуютє особу згідно закону - обов’язково, зокрема:

    1. тип документа (параметр "type") згідно з довідником "DOCUMENT_TYPE" - обов’язково;

    2. серію (за наявності) та номер документа (параметр "number") - обов’язково:

• PASSPORT - "^((?![ЫЪЭЁ])([А-ЯҐЇІЄ])){2}[0-9]{6}$",

• NATIONAL_ID - "^[0-9]{9}$",

• BIRTH_CERTIFICATE - "^((?![ЫЪЭЁыъэё@%&$^#`~:,.*|}{?!])[A-ZА-ЯҐЇІЄ0-9№\\/()-]){2,25}$",

• COMPLEMENTARY_PROTECTION_CERTIFICATE - "^((?![ЫЪЭЁ])([А-ЯҐЇІЄ])){2}[0-9]{6}$",

• REFUGEE_CERTIFICATE - "^((?![ЫЪЭЁ])([А-ЯҐЇІЄ])){2}[0-9]{6}$"

• TEMPORARY_CERTIFICATE - "^(((?![ЫЪЭЁ])([А-ЯҐЇІЄ])){2}[0-9]{4,6}|[0-9]{9}|((?![ЫЪЭЁ])([А-ЯҐЇІЄ])){2}[0-9]{5}\\/[0-9]{5})$",

• TEMPORARY_PASSPORT - "^((?![ЫЪЭЁыъэё@%&$^#`~:,.*|}{?!])[A-ZА-ЯҐЇІЄ0-9№\\/()-]){2,25}$";

3. орган яким виданий (параметр "issued_by");

4. дата видачі (параметр "issued_at") - обов’язково;

5. дійсний до (параметр "expiration_date");

6. унікальний номер запису в ЄДДР  (УНЗР) (параметр "unzr"), має відповідати формату: "^[0-9]{8}-[0-9]{5}$" -(для КПІС, для АПІС - повинна заповнити УНЗР відомостями одержаними з ЄДДР без можливості їх редагування користувачем);

7. адреси пацієнта  (масив параметрів "addresses"), користувач повинен обов'язково вказати адресу фактичного місця проживання та адресу реєстрації. Якщо ці адреси співпадають, необхідно поставити відмітку, що адреси збігаються  - обов’язково;

   1. тип адреси - (параметр "type"), згідно з довідником "ADDRESS_TYPE" - обов’язково;

   2. країна - (параметр "country"), згідно з довідником "COUNTRY" - обов’язково;

   3. область - (параметр "area") - обов’язково;

   4. район області - (параметр "region");

   5. населений пункт - (параметр "settlement") - обов’язково;

   6. тип населеного пункту - (параметр "settlement_type"), згідно з довідником "SETTLEMENT_TYPE"  - обов’язково;

   7. ідентифікатор населеного пункту (параметр "settlement_id") - обов’язково;

   8. тип вулиці - (параметр "street_type"), згідно з довідником "STREET_TYPE";

   9. назва вулиці - (параметр "street");

   10. будинок - (параметр "building");

   11. квартира - (параметр "apartment");

   12. поштовий індекс - (параметр "zip");

8.  контактний телефон користувача (об'єкт "phones"):

   1. тип телефону (параметр "phones_type"), згідно з довідником PHONE_TYPE - обов’язково;

   2. номер телефону в форматі "^\\+38[0-9]{10}$" (параметр "number") - обов’язково;

9. бажаний спосіб зв'язку (параметр "preferred_way_communication");

   1. електронна пошта (параметр "email");

   2. телефон (параметр "phone");

10. дані особи для екстреного зв'язку (об'єкт "emergency_contact") - обов’язково:

    1. ім'я (параметр "first_name") - обов'язково;

    2. прізвище (параметр "last_name") - обов'язково;

    3. по батькові (параметр "second_name");

    4. телефон контакту для екстреного зв'язку (масив "emergency_contact.phones"):

       1. тип телефону (параметр "phones_type") - обов’язково;

       2. номер в форматі "^\\+38[0-9]{10}$" (параметр "number") - обов’язково;

1.40

Ініціалізувати оновлення персональних даних

Користувач підтверджує зміни в персональних даних

1.50

Запит на оновлення персональних даних

ПІС передає повний змінений набір даних персони до системи ЕСОЗ

Scope - person_request:write_pis

Resource - POST /api/pis/person_requests

API-010-001-012-0452

https://pisapi1.docs.apiary.io/#reference/public.-patient-information-system/person-requests/initialize-update-person-details

2.10

PIS. Initialize Update Person details

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

GW 1.10

Процес перервався?

• Якщо “ні“ (процес оновлення персональних даних не перервався), перейти до кроку GW 1.40

• Якщо “так“ (процес оновлення персональних даних перервався), перейти до кроку GW 1.20

GW 1.20

Продовжити оновлення персональних даних?

• Якщо “ні“ (не продовжити оновлення персональних даних), перейти до кроку EE 1.10

• Якщо “так“ (продовжити оновлення персональних даних), перейти до кроку 1.60

EE 1.10

Персональні дані не оновились

Користувач не продовжив оновлення персональних даних

1.60

Відновити процес оновлення даних

Користувач вирішив продовжити оновлення персональних даних

GW 1.30

Відновити через перелік запитів?

• Якщо “ні“ (відновити процес оновлення персональних даних через дані перерваного запиту), перейти до кроку 1.100

• Якщо “так“ (відновити процес оновлення персональних даних через перелік запитів), перейти до кроку 1.70

1.70

Отримати перелік запитів

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

1.80

Запит на отримання переліку запитів на оновлення даних персони

Сформован запит на отримання списоку переліку запитів на зміну персональних даних користувача

Scope - person_request:read_pis

Resource - GET /api/pis/person_requests

API-010-001-012-0454

https://pisapi1.docs.apiary.io/#reference/public.-patient-information-system/person-requests/get-person-requests-list

2.20

PIS. Get Person request list

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

https://pisapi1.docs.apiary.io/#reference/public.-patient-information-system/person-requests/get-person-requests-list

1.90

Обрати перерваний запит

Користувач оберає перерваний запит на оновлення для продовження роботи з ним

1.100

Отримати деталі запиту на оновлення даних

Користувач виконує запит на отримання деталей запиту на оновлення даних

1.110

Запит на отримання деталей запиту

Сформован запит на отримання деталей запиту на оновлення даних

Scope - person_request:details_pis

Resource - GET /api/pis/person_requests/{{id}}

API-010-001-012-045
https://pisapi1.docs.apiary.io/#reference/public.-patient-information-system/person-requests/get-person-request-details

2.30

PIS. Get Person request details

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

https://pisapi1.docs.apiary.io/#reference/public.-patient-information-system/person-requests/get-person-request-details

1.130

Перегляд внесених перс. даних.

Користувачу переглядає внесені дані в інтерфейсі ПІС

GW 1.50

Завершити оновлення персональних даних?

• Якщо “ні“ (не завершувати процес оновлення персональних даних), перейти до кроку GW 1.40]

• Якщо “так“ (завершити процес оновлення персональних даних), перейти до кроку 1.140

1.140

Скасувати оновлення персональних даних

У разі якщо після перевірки Користувачем внесених даних, з’ясувалось, що дані невірні, або пацієнт відмовився підписувати їх, то ПІС повинен надати можливість Користувачу скасовувати запит

1.150

Запит на скасування оновлення даних

Сформован запит на скасування оновлення даних

Scope - person_request:reject_pis

Resource - PATCH /api/pis/person_requests/{{id}}/actions/reject

API-010-001-012-0456
https://pisapi1.docs.apiary.io/#reference/public.-patient-information-system/person-requests/reject-person-request

2.40

PIS. Reject Person request

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

https://pisapi1.docs.apiary.io/#reference/public.-patient-information-system/person-requests/reject-person-request

GW 1.40

Присутні документи з вимогою до завантаження?

• Якщо “ні“ (не присутні документи з вимогою до завантаження), перейти до кроку GW 1.70

• Якщо “так“ (присутні док. з вимогою до завантаження), перейти до кроку 1.160

1.160

Завантажити електронні копії оригіналів документів

Завантаження електроних копіїй оригіналів документів відбувається відповідно процесу “Завантаження електронних копій оригіналів документів“

1.170

Підписати онов.дані ЕП

Користувачу підписує оновлені дані, за допомогою ЕП

1.180

Завершити оновлення перс. даних

Користувачу завершує оновлення даних

1.190

Запит на завершення оновлення даних

Після підписання Користувачем оновлених даних за допомогою ЕП, ПІС повинна виконати запит передавши повний набір оновлених даних із накладеним ЕП

Scope - person_request:reject_pis

Resource - PATCH /api/pis/person_requests/{{id}}/actions/reject

API-010-001-012-0453
https://pisapi1.docs.apiary.io/#reference/public.-patient-information-system/person-requests/complete-update-person-details

2.50

PIS. Complete Update Person details

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

https://pisapi1.docs.apiary.io/#reference/public.-patient-information-system/person-requests/complete-update-person-details

1.200

Повідомлення про успішне оновлення персональних даних

Користувач проінформований щодо успішного оновлення персональних даних

GW 1.60

Користувач бажає на отримати список запитів на оновлення даних?

• Якщо “ні“ (не присутні документи з вимогою до завантаження), перейти до кроку EE 1.20

• Якщо “так“ (присутні документи з вимогою до завантаження), перейти до кроку 1.210

1.210

Отримати список запитів на оновлення даних

Користувачу має можливість на отримання списку запитів на оновлення персональних даних та відображення деталей запиту в інтерфейсі ПІС

Scope - person_request:read_pis

Resource - GET /api/pis/person_requests

API-010-001-012-0454

https://pisapi1.docs.apiary.io/#reference/public.-patient-information-system/person-requests/get-person-requests-list

2.60

PIS. Get Person request list

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

https://pisapi1.docs.apiary.io/#reference/public.-patient-information-system/person-requests/get-person-requests-list

EE 1.20

Користувач оновив персональні данні

Користувач успішно оновив персональні данні