Versions Compared

Old Version 20

changes.mady.by.user Olena Yermolenko

Saved on

compared with

New Version Current

changes.mady.by.user Yuliia Mazur (UA SoE eHealth)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

Table of Contents

...

Загальні ствердження

  • Система e-Health не керує та на є джерелом зберігання чи отримання інформації стосовно недієздатності персон. Таким джерелом у цільовому процесі мають виступати органи, які несуть відповідальність за визначення персони недієздатною або навпаки та надають артефакти, які підтверджують такий стан персони. Наявна інформація про законного представника персони використовується виключно у внутрішніх процесах системі та не може використовуватися як ознака недієздатності персони.

Процес створення або зміни даних ідентифікованої персони

Image Removed

...

3_create_person_request (2).graphml

...

Крок

Опис

1

Знайти персону у e-Health

Користувач виконує пошук персони у системі

API: Search for a person v3

Якщо персону у системі не знайдено, виконується перехід до кроку "Заповнити дані для створення персони", у іншому випадку виконується перехід до кроку "Заповнити дані для оновлення персони".  

2

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

...

Для персони, що створюється, користувач заповнює:

  • персональні дані персони

...

  • :

    • ПІБ

    • Дату, країну, місто народження

    • Стать

    • e-mail

    • позначку наявності ІПН

    • ІПН за наявності.

    • Секретне слово

  • блок інформації про документи

  • блок інформації з адресами 

  • блок інформації про контактні телефони

  • номер УНЗР, за наявності

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

  • бажаний спосіб комунікації (e-mail або телефон)

  • блок даних із інформацією про законного представника персони

    • для персон, які не досягли віку 14 років, заповнення цього блоку обов'язкове

    • для персон старших за 14 років, заповнення блоку опціональне (на розсуд лікаря)

...

    • вік законного представника повинен бути більшим за 14 років

  • блок даних із

...

...

Передача даних пацієнта на запит створенні персони без декларації

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

Пошук людини в системі E-Health.

Якщо не знайшли вже існуючу персону - то будемо стоврювати нову.

Валідация запиту по json-схемі та ключування инн з датою народження та полом *1. Відправлення смс ( якщо OTP)

...

При автентифікації (OTP), необхідно наділати смс з секретним кодом на вказаний пацієнтом номер телефону та перевірити, що пацієнт смс отримав.

Зміна статуса запиту на створення персони без декларації на `Approved`

...

*1 - ключування ИНН з ДР та полом

  • перші п'ять цифр ИНН утворюють число, яке дорівнює кількості днів від 01.01.1900 до дати народження власника ІПН
  • пол перевіряється парність дев'ятої цифри: парна цифра - женский, непарна - чоловічий
  • Запит на створення персони без декларації може бути створений адміністратором чи лікарем.
  • Пацієнт не може зареєструватись як `персона без декларації`, якщо вона вже в системі.
  • Якщо вже є запит на створення декларації, то не можна створити запит на створення персони без декларації
  • Щоб внести зміни інформації пацієнта, необхідно зробити запит на створення пацієнта передавши id персони, яку хочешь оновити

...

    • якщо методом аутентифікації є третя персона, така персона повинна існувати у системі

3

Отримати методи аутентифікації персони

Якщо персону за її даними знайдено, необхідно отримати із системи наявні в неї методи аутентифікації.

API: Get Person Authentication methods

4

Обрати метод аутентифікації для підтвердження дій

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

5

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

Користувач заповнює той же набір даних, що і при створенні персони у повному обсязі, за виключенням блоку даних із методами аутентифікації (для існуючої персони керування методами аутентифікації виконується за допомогою окремих методів  - Authentication Methods Technical Requirements).

Додатково опціонально може бути вказаний метод аутентифікації персони, що оновлюється, який необхідно використати для підтвердження дій над персоною. За відсутності такого параметру для підтвердження оновлення персони буде використано її поточний метод аутентифікації.

Оновлення ІПН можливе тільки якщо цей параметр не був заповненим або персоні можливо змінити ІПН після валідації із залученням ДРФО

Оновлення дати народження можливе тільки якщо вона відповідає ІПН

6

Виконати запит на створення/оновлення перосони

Користувач виконує запит на створення чи оновлення персони у e-Health.

Запит може бути виконаним співробітниками із типами Doctor, Specialist, Receptionist, Assistant у активних медичних закладах із типами MSP, OUTPATIENT, EMERGENCY, PRIMARY_CARE.

Запит може бути створеним, якщо виконуються наступні правила:

  • склад запиту відповідає вимогам щодо створення чи оновлення ідентифікованої персони

  • у системі не існує активного запиту на створення декларації для тієї ж персони

  • у системі не існує персони із даними ідентичними до даних створюваної персони або дані оновлені дані персони відповідають даним персони, для якої виконуються зміни (для валідації використовується скорінгова модель Search for a person v3)

У один момент часу для однієї персони у системі може існувати лише один запит на створення/оновлення персони. Якщо на момент створення запиту у системі існували інші активні запити на створення чи оновлення тієї ж персони, вони анулюються, статус встановлюється у "CANCELLED"

У разі успішного виконання запиту:

  • запит зберігається у системі зі статусом NEW

  • якщо поточний метод аутентифікації персони offline або третя персона з offline, система повертає у відповідь посилання для завантаження скан-копій документів персони/третьої персони 

  • якщо поточний метод аутентифікації персони otp або третя персона з otp, на вказаний номер надсилається код

  • якщо у запиті наявний блок даних для законного представника персони, система повертає у відповідь посилання на завантаження скан-копій документів, підтверджуючих законне представництво, такими документами вважаються:

    • Свідоцтво - свідоцтво про народження

    • Посвідчення опікуна - посвідчення опікуна або піклувальника

    • документ - документ, що підтверджує повноваження представника органу опіки та піклування або керівника дитячого закладу, закладу охорони здоров’я або закладу соціального захисту дітей, у якому дитина перебуває на повному державному забезпеченні, та документ, що підтверджує факт зарахування дитини до цього закладу

    • Рішення суду

...

  • Пацієнт має надати згоду на створення персони шляхом авторизації в системі eHealth.
  • Під час обробки запиту на створення персони без декларації система eHealth формує шаблон електронного документу (content) на основі якого має бути сформована друкована форма та який має бути підписаний лікарем.
  • Для попередження дублікації patient requests здійснюється пошук подібних patient request за параметрами person.tax_id, person.document_number та статусам 'NEW', 'APPROVED'.  Усі очікуючі patient requests, які були знайдені під час пошуку подібних, будуть автоматично деактивовані (присвоєно статус “СANCELED”)
  • Створити персону без декларації може тільки Legal Entity, що має активний та верифікований NHS тип MSP, OUTPATIENT, EMERGENCY чи PRIMARY_CARE
  • Створити персону без декларації може тільки Employee, який активний та типу Doctor, Specialist, Receptionist чи Assistant

Sign patient request

Image Removed

sign patient request.graphml

...

Крок

...

Опис

...

  • Підписання запиту на створення персони без декларації можливо лише користувачем який має зареєстрованого співробітника, має ЕЦП та праціє в тому медзакладі, тип якого дозволяє реєструвати паціентів без декларації( Doctor, Specialist, Receptionist чи Assistant).
  • При обробці запиту на підписання персони без декларації (метод sign patient request) підписаний контент звіряється з шаблоном електронного документу (content)

...

  • повертає інформацію щодо:

    • використаного поточного методу аутентифікації для підтвердження дій над персоною

API: Create/Update person request

7

Надіслати додаткове повідомлення для підтвердження дій над персоною

Якщо при OTP-методі аутентифікації персони або третьої персони за якихось причин повідомлення не надійшло, користувач має можливість виконати повторне надсилання повідомлення використовуючи поточний метод аутентифікації.

API: Resend Authorization OTP on Person Request

8

Підтвердити дії над персоною

Користувач повинен завантажити документи, для яких на кроці "Виконати запит на створення/оновлення перосони" були згенеровані посилання, або ввести код підтвердження, який надійшов на телефон персони/третьої персони та підтвердити виконання дій над персоною.

Мета із якою повинні бути завантажені документи, або бути використаним код, надісланий на телефон, повинна бути артикульованою персоні/третій персоні у повному обсязі до виконання підтвердження над персоною, і залежить від умов виконання запиту:

  • при створенні персони старшої за 14 років із методом аутентифікації OTP, персона, яка надає код такою дією:

    • підтверджує що вказаний номер телефону коректний

    • підтверджує що вказаний номер належить персоні, яка створюється 

    • надає згоду на створення запису про неї у системі e-Health користувачеві, що виконує даний крок

  • при створенні персони старшої за 14 років із методом аутентифікації Offline, персона, яка надає документи для завантаження:

    • надає згоду на створення запису про неї у системі e-Health користувачеві, що виконує даний крок

  • при створенні персони молодшої за 14 років із методом аутентифікації "третя персона", персона, яка надає код або документи, такою дією:

    • підтверджує, що її, як третю персону, ідентифіковано коректно

    • надає згоду на створення запису про персону у системі e-Health від імені персони, що створюється, користувачеві, що виконує даний крок

    • надає згоду на використання її як методу аутентифікації від імені персони, для якої виконується запит

  • при оновленні персони персона, яка надає код або документи такою дією:

    • підтверджує, що персону, дані якої оновлюються, ідентифіковано коректно

    • надає згоду на оновлення даних у системі e-Health від імені персони, що оновлюється користувачеві, що виконує даний крок

Виконати підтвердження запиту на створення/зміну персони може тільки користувач із типами Doctor, Specialist, Receptionist, Assistant у активних медичних закладах із типами MSP, OUTPATIENT, EMERGENCY, PRIMARY_CARE із того ж медичного закладу, що і користувач, який створив такий запит.

У разі успішного підтвердження:

  • статус запиту на створення/зміну персони змінюється на "APPROVED" 

  • система повертає електронний документ із даними для перевірки та підписання

API: Approve person request

9

Друк документу для перевірки

Користувач повинен роздрукувати документ, отриманий на кроці "Підтвердити дії над персоною" та передати персоні, для якої виконуються дії зі створення/оновлення даних або її представнику.

10

Перевірка та підписання документу пацієнтом

Персона або її представник повинні перевірити коректність даних, наведених у документі, та підписати документ. Після цього виконується перехід до кроку "Підписати запит на створення персони".

Якщо документ містить помилки, виконується перехід до кроку "Відмінити запит на створення/оновлення персони".

11

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

Користувач відміняє запит на створення чи оновлення персони.

Виконати відміну запиту на створення/зміну персони може тільки користувач із типами Doctor, Specialist, Receptionist, Assistant у активних медичних закладах із типами MSP, OUTPATIENT, EMERGENCY, PRIMARY_CARE із того ж медичного закладу, що і користувач, який створив такий запит.

В результаті виконання кроку статус запиту змінюється на “REJECTED”.

API: Reject person request

12

Підписати запит на створення персони

Користувач накладає на запит на створення/оновлення персони свій електронний підпис, та передає його до системи.

Підписаний запит має містити ствердження, зроблене користувачем, що персона, що створювалася чи оновлювалася, або її представник, підписала друковану версію запиту.

Виконати підписання запиту на створення/зміну персони може тільки користувач із типами Doctor, Specialist, Receptionist, Assistant у активних медичних закладах із типами MSP, OUTPATIENT, EMERGENCY, PRIMARY_CARE із того ж медичного закладу, що і користувач, який створив такий запит.

В результаті виконання кроку:

  • статус запиту змінюється на "SIGNED"

  • у системі створено чи оновлено запис про персону

API: Sign person request

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

У разі необхідності, наприклад якщо користувач відклав підписання запиту на створення/оновлення персони, користувач може отримати перелік та/або дані непідписаних запитів.

  1. Перелік запитів на створення/оновлення персони можуть отримати користувачі із типами Doctor, Specialist, Receptionist, Assistant у медичних закладах із типами MSP, OUTPATIENT, EMERGENCY, PRIMARY_CARE. Такий перелік містить тільки запити, які було створено у тому ж медичному закладі, від імені якого виконується отримання даних.

  2. Дані запиту на створення/оновлення персони можуть отримати користувачі із типами Doctor, Specialist, Receptionist, Assistant у медичних закладах із типами MSP, OUTPATIENT, EMERGENCY, PRIMARY_CARE

    1. Результати запиту залежать від поточного статусу запиту на створення/оновлення персони: в залежності від того, чи був підтверджений запит, у результаті присутні або відсутні електронний документ та дані персони, для якої створено запит

API: Get Person Requests List, Get Person Request by ID

Термін існування запитів на створення/оновлення персони

У разі відсутності підтвердження/підписання запиту на створення/оновлення персони протягом N днів (де N - конфігураційна змінна), такий запит анулюється процесом [AUTO] Terminate Person requests. Статус запиту встановлюється у "EXPIRED".