№ кроку

Крок

Опис

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

Методи 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