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

API: Search for a person v3

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

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

• персональні дані персони:
  • ПІБ
  • Дату, країну, місто народження
  • Стать
  • e-mail
  • позначку наявності ІПН
  • ІПН за наявності. Повинен відповідати даті народження та статі.
  • Секретне слово
• блок інформації про документи
• блок інформації з адресами 
• блок інформації про контактні телефони
• номер УНЗР, за наявності
• блок даних із переліком контактів для зв'язку у екстрених випадках
• бажаний спосіб комунікації (e-mail або телефон)
• блок даних із інформацією про законного представника персони
  • для персон, які не досягли віку 14 років, заповнення цього блоку обов'язкове
  • для персон старших за 14 років, заповнення блоку опціональне (на розсуд лікаря)
  • вік законного представника повинен бути більшим за 18 років
• блок даних із методом аутентифікації за замовчуванням, обов'язковий для всіх персон згідно вимогам до методів аутентифікації (Керування методами аутентифікації ідентифікованих персон#Загальні-вимоги)
  • якщо методом аутентифікації є третя персона, така персона повинна існувати у системі

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

API: Get Person Authentication methods

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

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

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

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

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

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

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

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

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

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

• запит зберігається у системі зі статусом NEW
• якщо поточний метод аутентифікації персони offline або третя персона із offline, система повертає у відповідь посилання для завантаження скан-копій документів персони/третьої персони 
• якщо поточний метод аутентифікації персони otp або третя персона із otp, на вказаний номер надсилається код
• якщо у запиті наявний блок даних для законного представника персони, система повертає у відповідь посилання на завантаження скан-копій документів, підтверджуючих законне представництво, такими документами вважаються:
  • Свідоцтво - свідоцтво про народження
  • Посвідчення опікуна - посвідчення опікуна або піклувальника
  • документ - документ, що підтверджує повноваження представника органу опіки та піклування або керівника дитячого закладу, закладу охорони здоров’я або закладу соціального захисту дітей, у якому дитина перебуває на повному державному забезпеченні, та документ, що підтверджує факт зарахування дитини до цього закладу
  • Рішення суду
• повертає інформацію щодо:
  
  • використаного поточного методу аутентифікації для підтвердження дій над персоною

API: IL.Create/Update person request (w/o declaration)

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

API: IL.Resend Authorization method on Person Request

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

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

• при створенні персони старшої за 14 років із методом аутентифікації OTP, персона, яка надає код такою дією:
  • підтверджує що вказаний номер телефону коректний
  • підтверджує що вказаний номер належить персоні, яка створюється 
  • підтверджує що є тою персоною, яка створюється
  • надає згоду на створення запису про неї у системі e-Health користувачеві, що виконує даний крок
•  при створенні персони старшої за 14 років із методом аутентифікації Offline, персона, яка надає документи для завантаження:
  • підтверджує що є тою персоною, яка створюється
  • надає згоду на створення запису про неї у системі e-Health користувачеві, що виконує даний крок
• при створенні персони молодшої за 14 років із методом аутентифікації "третя персона" із персоною, для якої за замовчуванням встановлено метод аутентифікації OTP, персона, яка надає код, такою дією:
  • підтверджує, що її, як третю персону, ідентифіковано коректно
  • надає згоду на отримання персональних даних поточним користувачем, який виконує запит, для відображення у друкованій формі
  • надає згоду на створення запису про персону у системі e-Health від імені персони, що створюється, користувачеві, що виконує даний крок
  • надає згоду на використання її як метода аутентифікації "третя персона" для персони, що створюється
• при створенні персони молодшої за 14 років із методом аутентифікації "третя персона", із персоною, для якої за замовчуванням встановлено метод аутентифікації Offline, персона, яка надає документи, такою дією:
  • підтверджує, що її, як третю персону, ідентифіковано коректно
  • надає згоду на отримання своїх персональних даних поточним користувачем, який виконує запит, для відображення у друкованій формі
  • надає згоду на створення запису про персону у системі e-Health від імені персони, що створюється, користувачеві, що виконує даний крок
  • надає згоду на використання її як метода аутентифікації "третя персона" для персони, що створюється
• при оновленні персони персона, яка надає код або документи такою дією:
  • підтверджує, що персону, дані якої оновлюються, ідентифіковано коректно
  • надає згоду на оновлення даних у системі e-Health користувачеві, що виконує даний крок
  • у разі, якщо підтвердження виконується третьою персоною, підтверджує, що є персоною, яка має право на виконання дій із оновлення даних персони, для якої виконується даний крок

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

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

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

API: IL.Approve person request

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

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

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

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

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

API: IL. Reject person request

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

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

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

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

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

API: IL.Sign patient request