Page Comparison

Знайти персону у e-Health
Search for a person v3

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

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

Заповнити дані плану лікування
API. Create Care plan

План лікування (care plan) може створити будь-який лікар, який авторизований у системі e-Health та має відповідні для цього права доступу.

Виконати запит на створення плану лікування може користувач із типом DOCTOR або SPECIALIST у активному медичному закладі із відповідним типом.

План лікування амбулаторного рівня може створити тільки лікар, у якого є хоча б одна роль (employee_role), що містить амбулаторні умови надання послуг.

При заповненні плану лікування лікар визначає:

• взаємодію (encounter), за якою створюється план лікування

• категорію плану лікування відповідно до словника eHealth/care_plan_categories (category)

• період дії плану лікування (period)

• існуючі плани лікування, якщо план лікування створюється на їх основі (based_on)

• існуючі плани лікування, якщо план лікування створюється як їх частина (part_of)

• назву плану лікування (title)

• діагноз на підставі якого створюється план лікування. Такий діагноз має відноситися до взаємодії (encounter), за якою створюється план лікування (addresses)

• епізоди (episodes), процедури (procedures) чи діагностичні звіти (diagnostic reports), на які пропонує звернути увагу лікар, який створює план лікування, медичному спеціалісту, який буде надавати послуги за планом лікування (supporting_info)

• пацієнта, для якого створюється план лікування

• інші додаткові параметри.

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

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

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

• При створенні плану лікування всі валідації та структура запиту мають відповідати описаним.

Система e-Health:

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

• створює план лікування з Requisition Number (правила формування Requisition Number наведені у документі Human readable requisition number)

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

Для проведення лікування за створеним планом, лікарю необхідно отримати від пацієнта підтвердження. Відбувається перехід до процесу "Отримання підтвердження на лікування пацієнта".

Отримання підтвердження на лікування пацієнта

Create approvalVerify approval

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

Лікар формує запит на підтвердження на лікування пацієнта за вказаним ідентифікатором плану лікування та відповідними правами.

При відправці запиту на отримання підтвердження лікар вказує:

• посилання на план лікування (resources), на який необхідно створити підтвердження на створення плану лікування

• лікаря, якому надається підтвердження (granted_to)

• права доступу (access_level).

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

лікарю виконується на загальних підставах.

Після виконання запиту лікар виконує верифікацію отримання доступу. У разі необхідності лікар має можливість виконати повторну відправку SMS.

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

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

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

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

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

Інформувати пацієнта про надходження повідомлення з підтвердженням створення плану лікування

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

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

https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/2125039059
або
https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/2125039033

Лікар здійснює пошук за наявною інформацією про план лікування. Для отримання переліку планів лікування лікар може скористатись пошуком за номером плану лікування або пошуком за іншими параметрами.

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

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

У випадку, якщо система не повернула перелік планів лікування, лікар має можливість виконати дії щодо створення плану лікування.

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

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

системи отримання доступів до медичної інформації.

Отримати деталі плану лікування за його ідентифікатором

АРІ: get-care-plan-by-id

Опис валідацій: Get Care plan by ID

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

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

системи отримання доступів до медичної інформації.

Додатковий блок urgent у відповіді надає можливість перевірити номер телефону, на який буде надіслано смс (authentication_method_current.number)

Здійснити пошук плану лікування
API. Get Care plan by ID

Користувач виконує пошук плану лікування виконуючи необхідні кроки з процесу "Отримання інформації плану лікування".

У разі успішного пошуку плану лікування, лікар переходить до кроку заповнення даних первинного призначення плану лікування (activity).

Заповнити дані первинного призначення плану лікування
API. Create activities

Первинне призначення може створити будь-який лікар, який авторизований у системі e-Health та має відповідні для цього права доступу.

При заповненні інформації первинного призначення плану лікування лікар вказує:

• автора первинного призначення (author)

• посилання на план лікування (care_plan)

• деталі первинного призначення (detail).

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

• При створенні первинного призначення всі валідації та структура запиту мають відповідати описаним.

Система e-Health виконує наступні дії:

1. повертає до визиваючої сторони ідентифікатор завдання із створення первинного призначення

2. Якщо створюване призначення є першим у новому плані лікування (тобто, статус Плану лікування дорівнює status=new), то:

• попередній активний (status=active) план лікування переходить в статус terminated, якщо вони мають однакові діагнози (addresses) та умови надання послуг (terms_of_service). Отримання ліків або послуг за вторинними призначеннями припиняється.

• статус нового плану лікування змінюється з new на active

Отримати деталі плану лікування
API. Get Care Plans by search params
API. Get Care plan by ID

Користувач виконує пошук плану лікування виконуючи необхідні кроки з процесу "Отримання інформації плану лікування".

Отримати первинні призначення за пошуковими параметрами
API. Get activities by search params

Лікар здійснює пошук за наявною інформацією про первинне призначення в контексті плану лікування, якому воно належить. У якості пошукових параметрів лікар може вказати:

• ідентифікатор пацієнта (обов'язково)

• ідентифікатор лікаря, який є автором первинного призначення (author)

• вид деталей первинного призначення (kind)

У випадку, якщо система не повернула перелік планів лікування, лікар має можливість виконати дії щодо створення плану лікування.

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

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

системи отримання доступів до медичної інформації.

Отримати деталі первинного призначення за його ідентифікатором
API. Get activity by ID

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

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

системи отримання доступів до медичної інформації.

Отримати деталі плану лікування
API. Get Care Plans by search params
API. Get Care plan by ID

Користувач виконує пошук плану лікування виконуючи необхідні кроки з процесу "Отримання інформації плану лікування".

Отримати деталі первинного призначення
API. Get activities by search params 
API. Get activity by ID

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

Завершення первинного призначення
API. Complete activity

Первинне призначення може бути завершено зі станів відповідно статусній моделі.

Здійснити завершення первинного призначення може тільки його автор або автор плану лікування (author).

Користувач вказує причину завершення (status_reason)

, ініціюючи запит до системи e-Health на завершення первинного призначення.

Система e-Health виконує наступні дії:

1. перевіряє дійсність пацієнта, організації, лікаря

2. перевіряє поточний стан первинного призначення

3. змінює статус на "COMPLETED". При цьому тимчасові права доступу, видані на підставі цього плану лікування, не припиняють свою дію.

Отримати деталі плану лікування
API. Get Care Plans by search params
API. Get Care plan by ID

Користувач виконує пошук плану лікування виконуючи необхідні кроки з процесу "Отримання інформації плану лікування".

Отримати деталі первинного призначення
API. Get activities by search params 
API. Get activity by ID

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

Відміна первинного призначення
API. Cancel activity

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

Здійснити відміну первинного призначення може тільки його автор або

користувач, який отримав від пацієнта права доступу write до ПЛ.

Користувач вказує причину відміни (status_reason) та накладає ЕЦП, ініціюючи запит до системи e-Health на відміну первинного призначення.

Система e-Health виконує наступні дії:

1. перевіряє дійсність пацієнта, організації, лікаря

2. перевіряє поточний стан первинного призначення

3. змінює статус на "CANCELLED". При цьому тимчасові права доступу, видані на підставі цього плану лікування, не припиняють свою дію.