ЕСОЗ - публічна документація

Процеси роботи з обліку і використання медичних виробів

Мета

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

Терміни

Медичний виріб - (девайс , пристрій) будь-який інструмент, апарат, прилад, пристрій, програмне забезпечення, матеріал або інший виріб, що застосовуються як окремо, так і в поєднанні між собою Відповідає сутності FHIR - “Device”

Асоціація МВ - сутність, що фіксує зв’язку між медичним виробомі та пацієнтом (імплантовано\експлантовано\прикріплено\відкріплено). Відповідає сутності FHIR - “Device Association”

Виявлена проблема МВ - сутність, що вказує на фактичну або потенційну проблему між пацієнтом і пристроєм Відповідає сутності FHIR - “Detected Issue”

Концептуальна схема бізнес-процесів

 

Device_Concept.png

 

Пошук медичних виробів, асоціацій МВ, виявлених проблем МВ за параметрами

Device_SearchByParams.png

Пошук медичного виробу за параметрами

Ключові моменти

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

    1. Співробітник з декларацією (declaration)

    2. Співробітники закладу, в якому створено запис (в тому числі автор) (recorder_legal_entity_id)

    3. Співробітники закладу, в якому створено епізод, на підставі якого була взаємодія зі створення запису (в тому числі автор) (context_episode_id)

    4. Співробітник з доступом (approval) на читання медичних даних пацієнта (patient)

    5. Співробітник з доступом (approval) на читання епізоду пацієнта (context_episode_id)

    6. Співробітник з доступом (approval) на сутності пов'язані з медичними виробами (МВ, Асоціації МВ, Виявлені проблеми МВ)

  • В Device Summary відображаються лише медичні вироби (без асоціацій МВ і виявлених проблем МВ). Можливість відображення чи не відображення медичного виробу в Device Summary конфігурується в залежності від типу медичного виробу.

Опис бізнес-процесу

Крок

Опис

Крок

Опис

1

Здійснити пошук пацієнта
Search for a person v3

Користувач:

  1. Виконує пошук пацієнта

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Перевіряє валідність токену доступу

    2. Наявність відповідного скоупу

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  3. Повертає перелік пацієнтів, що відповідають запиту

2

Запит доступу на отримання інформації

Користувач:

  1. Обирає необхідного пацієнта, необхідні атрибути, за якими може отримати доступ (групу ресурсів пов'язану з медичними виробами, епізод і т.д.)

  2. Запрошує підтвердження доступу

  3. Верифікує підтвердження доступу

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Перевіряє валідність токену доступу

    2. Наявність відповідного скоупу

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  3. Повертає ідентифікатор завдання з створення та верифікації підтвердження

3

Пошук медичного виробу в контексті пацієнта за параметрами

https://e-health-ua.atlassian.net/wiki/spaces/OMB2/pages/17755013126

Користувач:

  1. Вводить набір параметрів за якими хоче знайти пристрої:

    1. Пацієнт (patient_id)

    2. Взаємодія (encounter_id)

    3. Епізод (context_episode_id) (Необов'язковий параметр)

    4. Тип медичного виробу (type) (можлива множина значень)

    5. Посилання на Device Definition (definition)(можлива множина значень)

    6. Номер моделі (model_number)

    7. Виробник (manufacturer)

    8. Назва медичного виробу (name)

    9. Працівник, що створив запис про медичний пристрій (recorder)

    10. Заклад в якому створено запит про МВ (recorder_legal_entity_id)

    11. Статус медичного виробу (status) (можлива множина значень)

    12. Дата додавання запису про МВ (Inserted_at) (задається діапазоном дат)

    13. Серійний номер пристрою (serial_number)

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту.

    1. Перевіряє валідність токену доступу

    2. Наявність відповідного скоупу

    3. Доступ до інформації відбувається з використанням існуючої системи надання доступів (ABAC)

  2. Перевіряє чи активний запис про пацієнта по якому запитується інформація

  3. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення.

  4. Повертає результати успішного виконання запиту або причину його відхилення. Сортування списку пристроїв відбувається за замовчуванням по параметру Inserted_at за спаданням

4

Отримання медичного виробу в контексті пацієнта за ідентифікатором

https://e-health-ua.atlassian.net/wiki/spaces/OMB2/pages/17755635730

Користувач:

  1. Вводить збережений раніше ідентифікатор пристрою

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту.

    1. Перевіряє валідність токену доступу

    2. Наявність відповідного скоупу

    3. Доступ до інформації відбувається з використанням існуючої системи надання доступів (ABAC)

  2. Перевіряє чи активний запис про пацієнта по якому запитується інформація

  3. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення.

  4. Повертає результати успішного виконання запиту або причину його відхилення.

Пошук асоціацій медичного виробу за параметрами

Ключові моменти

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

    1. Співробітник з декларацією (declaration)

    2. Співробітники закладу, в якому створено запис (в тому числі автор) (recorder_legal_entity_id)

    3. Співробітники закладу, в якому створено епізод, на підставі якого була взаємодія зі створення запису (в тому числі автор) (context_episode_id)

    4. Співробітник з доступом (approval) на читання медичних даних пацієнта (patient)

    5. Співробітник з доступом (approval) на читання епізоду пацієнта (context_episode_id)

    6. Співробітник з доступом (approval) на сутності пов'язані з медичними виробами (МВ, Асоціації МВ, Виявлені проблеми МВ)

Опис бізнес-процесу

Крок

Опис

Крок

Опис

1

Здійснити пошук пацієнта

Search for a person v3

Користувач:

  1. Виконує пошук пацієнта

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Перевіряє валідність токену доступу

    2. Наявність відповідного скоупу

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  3. Повертає перелік пацієнтів, що відповідають запиту

2

Запит доступу на отримання інформації

Користувач:

  1. Обирає необхідного пацієнта, необхідні атрибути, за якими може отримати доступ (групу ресурсів пов'язану з медичними виробами, епізод і т.д.)

  2. Запрошує підтвердження доступу

  3. Верифікує підтвердження доступу

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Перевіряє валідність токену доступу

    2. Наявність відповідного скоупу

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  3. Повертає ідентифікатор завдання з створення та верифікації підтвердження

3

Пошук асоціацій медичного виробу в контексті пацієнта за параметрами

https://e-health-ua.atlassian.net/wiki/spaces/OMB2/pages/17755471882

Користувач:

  1. Вводить набір параметрів за якими хоче знайти асоціації:

    1. Пацієнт (patient_id)

    2. Взаємодія (encounter_id)

    3. Епізод (context_episode_id) (Необов'язковий параметр)

    4. Статус асоціації (association_status) (можлива множина значень)

    5. Працівник, що створив запис про асоціацію (recorder)

    6. Заклад в якому створено запит про МВ (recorder_legal_entity_id)

    7. Дата імплантації\прикріплення або експлантації\відкріплення МВ до пацієнта (association_date) (задається діапазоном дат)

    8. Дата встановлення напрямку відношення девайсу до пацієнта (recorded) (задається діапазоном дат)

    9. Дата створення запису про асоціацію (inserted_at) (задається діапазоном дат)

    10. Місце імплантації (body_site)(можлива множина значень)

    11. Ідентифікатор пристрою (device_id)

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту.

    1. Перевіряє валідність токену доступу

    2. Наявність відповідного скоупу

    3. Доступ до інформації відбувається з використанням існуючої системи надання доступів (ABAC)

  2. Перевіряє чи активний запис про пацієнта по якому запитується інформація

  3. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення.

  4. Повертає результати успішного виконання запиту або причину його відхилення. Сортування списку асоціацій відбувається за замовчуванням по Inserted_at за спаданням

4

Отримання асоціації медичного виробу в контексті пацієнта за ідентифікатором

https://e-health-ua.atlassian.net/wiki/spaces/OMB2/pages/17755602957

Користувач:

  1. Вводить збережений раніше ідентифікатор асоціації МВ

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту.

    1. Перевіряє валідність токену доступу

    2. Наявність відповідного скоупу

    3. Доступ до інформації відбувається з використанням існуючої системи надання доступів (ABAC)

  2. Перевіряє чи активний запис про пацієнта по якому запитується інформація

  3. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення.

  4. Повертає результати успішного виконання запиту або причину його відхилення.

Пошук виявлених проблем медичного виробу за параметрами

Ключові моменти

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

    1. Співробітник з декларацією (declaration)

    2. Співробітники закладу, в якому створено запис (в тому числі автор) (recorder_legal_entity_id)

    3. Співробітники закладу, в якому створено епізод, на підставі якого була взаємодія зі створення запису (в тому числі автор) (context_episode_id)

    4. Співробітник з доступом (approval) на читання медичних даних пацієнта (patient)

    5. Співробітник з доступом (approval) на читання епізоду пацієнта (context_episode_id)

    6. Співробітник з доступом (approval) на сутності пов'язані з медичними виробами (МВ, Асоціації МВ, Виявлені проблеми МВ)

Опис бізнес-процесу

Крок

Опис

Крок

Опис

1

Здійснити пошук пацієнта

Search for a person v3

Користувач:

  1. Виконує пошук пацієнта

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Перевіряє валідність токену доступу

    2. Наявність відповідного скоупу

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  3. Повертає перелік пацієнтів, що відповідають запиту

2

Запит доступу на отримання інформації

Користувач:

  1. Обирає необхідного пацієнта, необхідні атрибути, за якими може отримати доступ (групу ресурсів пов'язану з медичними виробами, епізод і т.д.)

  2. Запрошує підтвердження доступу

  3. Верифікує підтвердження доступу

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Перевіряє валідність токену доступу

    2. Наявність відповідного скоупу

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  3. Повертає ідентифікатор завдання з створення та верифікації підтвердження

3

Пошук Виявлених проблем МВ медичного виробу в контексті пацієнта за параметрами

https://e-health-ua.atlassian.net/wiki/spaces/OMB2/pages/17755078671

Користувач:

  1. Вводить набір параметрів за якими хоче знайти виявлені проблеми МВ:

    1. Пацієнт (patient_id)

    2. Взаємодія (encounter_id)

    3. Епізод (context_episode_id) (Необов'язковий параметр)

    4. Статус (status) (можлива множина значень)

    5. Працівник, що створив запис про асоціацію (recorder)

    6. Заклад в якому створено запит про МВ (recorder_legal_entity_id)

    7. Дата створення запису про виявлені проблеми МВ (inserted_at) (задається діапазоном дат)

    8. Ідентифікатор пристрою (device_id)

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту.

    1. Перевіряє валідність токену доступу

    2. Наявність відповідного скоупу

    3. Доступ до інформації відбувається з використанням існуючої системи надання доступів (ABAC)

  2. Перевіряє чи активний запис про пацієнта по якому запитується інформація

  3. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення.

  4. Повертає результати успішного виконання запиту або причину його відхилення. Сортування списку виявлених проблем МВ відбувається за замовчуванням по параметру Inserted_at за спаданням

4

Пошук виявленої проблеми медичного виробу в контексті пацієнта за ідентифікатором

https://e-health-ua.atlassian.net/wiki/spaces/OMB2/pages/17754685450

Користувач:

  1. Вводить збережений раніше ідентифікатор виявленої проблеми МВ

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту.

    1. Перевіряє валідність токену доступу

    2. Наявність відповідного скоупу

    3. Доступ до інформації відбувається з використанням існуючої системи надання доступів (ABAC)

  2. Перевіряє чи активний запис про пацієнта по якому запитується інформація

  3. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення.

  4. Повертає результати успішного виконання запиту або причину його відхилення.

Отримання медичних виробів, асоціацій МВ, виявлених проблем МВ за ідентифікатором

 

Отримання інформації медичного виробу за ідентифікатором

Ключові моменти

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

    1. Співробітник з декларацією (declaration)

    2. Співробітники закладу, в якому створено запис (в тому числі автор) (recorder_legal_entity_id)

    3. Співробітники закладу, в якому створено епізод, на підставі якого була взаємодія зі створення запису (в тому числі автор) (context_episode_id)

    4. Співробітник з доступом (approval) на читання медичних даних пацієнта (patient)

    5. Співробітник з доступом (approval) на читання епізоду пацієнта (context_episode_id)

    6. Співробітник з доступом (approval) на сутності пов'язані з медичними виробами (МВ, Асоціації МВ, Виявлені проблеми МВ)

Опис бізнес-процесу

Крок

Опис

Крок

Опис

1

Отримання ідентифікатора МВ з медичного запису

Користувач:

  1. Отримує ідентифікатор медичного виробу з доступних йому медичних записів

2

Отримання контексту епізоду медичного виробу

https://e-health-ua.atlassian.net/wiki/spaces/OMB2/pages/17754980360

Користувач:

  1. Користувач:

    Отримав ідентифікатор медичного виробу

  2. Виконує запит на отримання контексту епізоду

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Перевіряє валідність токену доступу

    2. Наявність відповідного скоупу

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  3. Перевіряє чи активний запис про пацієнта по якому запитується інформація

  4. Повертає результати успішного виконання запиту (контекст епізоду) або причину його відхилення

3

Отримання медичного виробу в контексті пацієнта за ідентифікатором

https://e-health-ua.atlassian.net/wiki/spaces/OMB2/pages/17755635730

Користувач:

  1. Обирає деталі медичного виробу

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту.

    1. Перевіряє валідність токену доступу

    2. Наявність відповідного скоупу

    3. Доступ до інформації відбувається з використанням існуючої системи надання доступів (ABAC)

  2. Перевіряє чи активний запис про пацієнта по якому запитується інформація

  3. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення.

  4. Повертає результати успішного виконання запиту або причину його відхилення.

Отримання інформації про асоціацію медичного виробу за ідентифікатором

Ключові моменти

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

    1. Співробітник з декларацією (declaration)

    2. Співробітники закладу, в якому створено запис (в тому числі автор) (recorder_legal_entity_id)

    3. Співробітники закладу, в якому створено епізод, на підставі якого була взаємодія зі створення запису (в тому числі автор) (context_episode_id)

    4. Співробітник з доступом (approval) на читання медичних даних пацієнта (patient)

    5. Співробітник з доступом (approval) на читання епізоду пацієнта (context_episode_id)

    6. Співробітник з доступом (approval) на сутності пов'язані з медичними виробами (МВ, Асоціації МВ, Виявлені проблеми МВ)

Опис бізнес-процесу

Крок

Опис

Крок

Опис

1

Отримання ідентифікатора асоціації МВ з медичного запису

Користувач:

  1. Отримує ідентифікатор асоціації МВ з доступних йому медичних записів

2

Отримання контексту епізоду асоціації медичного виробу

https://e-health-ua.atlassian.net/wiki/spaces/OMB2/pages/17754849287

Користувач:

  1. Користувач:

    Отримав ідентифікатор асоціації медичного виробу

  2. Виконує запит на отримання контексту епізоду

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Перевіряє валідність токену доступу

    2. Наявність відповідного скоупу

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  3. Перевіряє чи активний запис про пацієнта по якому запитується інформація

  4. Повертає результати успішного виконання запиту (контекст епізоду) або причину його відхилення

3

Отримання асоціації медичного виробу в контексті пацієнта за ідентифікатором

https://e-health-ua.atlassian.net/wiki/spaces/OMB2/pages/17755602957

Користувач:

  1. Обирає деталі асоціації МВ

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту.

    1. Перевіряє валідність токену доступу

    2. Наявність відповідного скоупу

    3. Доступ до інформації відбувається з використанням існуючої системи надання доступів (ABAC)

  2. Перевіряє чи активний запис про пацієнта по якому запитується інформація

  3. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення.

  4. Повертає результати успішного виконання запиту або причину його відхилення.

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

Ключові моменти

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

    1. Співробітник з декларацією (declaration)

    2. Співробітники закладу, в якому створено запис (в тому числі автор) (recorder_legal_entity_id)

    3. Співробітники закладу, в якому створено епізод, на підставі якого була взаємодія зі створення запису (в тому числі автор) (context_episode_id)

    4. Співробітник з доступом (approval) на читання медичних даних пацієнта (patient)

    5. Співробітник з доступом (approval) на читання епізоду пацієнта (context_episode_id)

    6. Співробітник з доступом (approval) на сутності пов'язані з медичними виробами (МВ, Асоціації МВ, Виявлені проблеми МВ)

Опис бізнес-процесу

Крок

Опис

Крок

Опис

1

Отримання ідентифікатора виявленої проблем МВ з медичного запису

Користувач:

  1. Отримує ідентифікатор виявленої проблем МВ з доступних йому медичних записів

2

Отримання контексту епізоду виявленої проблем медичного виробу

https://e-health-ua.atlassian.net/wiki/spaces/OMB2/pages/17754718215

Користувач:

  1. Користувач:

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

  2. Виконує запит на отримання контексту епізоду

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Перевіряє валідність токену доступу

    2. Наявність відповідного скоупу

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  3. Перевіряє чи активний запис про пацієнта по якому запитується інформація

  4. Повертає результати успішного виконання запиту (контекст епізоду) або причину його відхилення

3

Пошук виявленої проблеми медичного виробу в контексті пацієнта за ідентифікатором

https://e-health-ua.atlassian.net/wiki/spaces/OMB2/pages/17754685450

Користувач:

  1. Обирає деталі виявленої проблеми МВ

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту.

    1. Перевіряє валідність токену доступу

    2. Наявність відповідного скоупу

    3. Доступ до інформації відбувається з використанням існуючої системи надання доступів (ABAC)

  2. Перевіряє чи активний запис про пацієнта по якому запитується інформація

  3. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення.

  4. Повертає результати успішного виконання запиту або причину його відхилення.

Облік імплантованих\прикріплених медичних виробів

Імплантація\прикріплення\виявлення пристрою

Ключові моменти

  • При подачі інформації про медичний виріб в тому ж EDP повинна бути облікована асоціація медичного виробу в статусах “прикріплено” або “імплантовано”

  • При подачі інформації про асоціацію медичного виробу, вона або посилається на медичний виріб, який був облікований раніше (в рамках іншого EDP) або на медичний виріб, що обліковується разом з цією асоціацією в поточному EDP

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

  • Разом з інформацією про МВ і асоціацію МВ лікар може також облікувати

    • процедуру, якою було імплантовано\прикріплено МВ

    • видачу МВ пацієнту

Опис бізнес-процесу

Крок

Опис

Крок

Опис

1

Пошук медичних виробів, асоціацій МВ, виявлених проблем МВ за параметрами

https://e-health-ua.atlassian.net/wiki/spaces/OMB2/pages/17752981608#%D0%9F%D0%BE%D1%88%D1%83%D0%BA-%D0%BC%D0%B5%D0%B4%D0%B8%D1%87%D0%BD%D0%B8%D1%85-%D0%B2%D0%B8%D1%80%D0%BE%D0%B1%D1%96%D0%B2%2C-%D0%B0%D1%81%D0%BE%D1%86%D1%96%D0%B0%D1%86%D1%96%D0%B9-%D0%9C%D0%92%2C-%D0%B2%D0%B8%D1%8F%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D1%85-%D0%BF%D1%80%D0%BE%D0%B1%D0%BB%D0%B5%D0%BC-%D0%9C%D0%92-%D0%B7%D0%B0-%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D0%B0%D0%BC%D0%B8

Користувач:

  1. В разі потреби виконує пошук облікованого раніше медичного виробу (див. “Пошук пристроїв в контексті пацієнта”)

2

Пошук типу обладнання в довіднику Національного класифікатора медичних виробів

https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17482547209

Користувач:

  1. Виконує пошук типу медичного виробу з використанням необхідних пошукових параметрів

    1. Назва класифікатора (name = device_definition_classification_type)

    2. Код (value_code)

    3. Опис (value_description)

    4. Статус (is_active)

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  3. Повертає перелік типів медичних виробів відповідно до критеріїв пошуку

3

Пошук моделі обладнання в довіднику Device Definition

https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17575542973

Користувач:

  1. Виконує пошук моделі медичного виробу з указанням необхідних пошукових параметрів

    1. Назва (name)

    2. Тип назви (name_type)

    3. Тип (classification_type)

    4. Статус (is_active)

    5. Номер моделі (model_number)

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

  2. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення

  3. Повертає перелік моделей медичного виробу відповідно до критеріїв пошуку

4

Облік імплантованих, прикріплених, виявлених у пацієнта медичних виробів в рамках Encounter Data Package

https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17061216257

Користувач:

  1. Виконує подачу інформації про медичний виріб, вказуючи:

    1. Посилання на тип медичного виробу з Національного класифікатора МВ (див. крок 2) - обов'язковий параметр (type)

    2. Посилання на модель медичного виробу з довідника Device Definition (див. крок 3) (definition)

    3. Назва виробу - (names (name + type) - обов'язковий параметр

    4. Модель медичного виробу (model_number)

    5. Посилання на зовнішній реєстр (identifier)

    6. Виробник (manufacturer)

    7. Дата виробництва (manufacture_date)

    8. Опис виробу (note)

    9. Серійний номер (serial_number)

    10. Додаткові властивості виробу (property (type + value_codeable_concept\value_quantity\value_range\value_boolean\ value_string\value_integer)

    11. Посилання на батьківський виріб (parent_id)

    12. Статус виробу (status) - обов'язковий параметр

    13. Працівник що створив запис (recorder) - обов'язковий параметр

    14. Термін придатності медичного виробу (expiration_date)

  2. Виконує подачу інформації про асоціацію медичного виробу, вказуючи:

    1. Посилання на запис про медичний виріб (device_id) - обов'язковий параметр.

    2. Статус асоціації медичного виробу з пацієнтом (association_status) - обов'язковий параметр.

    3. Частина тіла куди було імплантовано\прикріплено пристрій (body_site) - обов'язковий параметр.

    4. Дата дата встановлення напрямку відношення девайсу до пацієнта (recorded) - обов'язковий параметр

    5. Дата імплантації\прикріплення МВ до пацієнта (association_date)

    6. Працівник що створив запис (recorder) - обов'язковий параметр

  3. За потреби виконує подачу інформації про процедуру, якою проводилася імплантація \ прикріплення виробу вказуючи

    1. Посилання на МВ який було імплантовано\прикріплено (focal_device.manipulated)

    2. Дія яка була виконана з імплантованим\прикріпленим МВ (focal_device.action)

  4. За потреби виконує подачу інформаці про відпуск медичного виробу пацієнту

    1. Інформація про те що було видано (Посилання на запис про МВ облікований лікарем)

    2. Статус видачі (Complete\Declined)

  5. Відправляє запит на передачу даних про надану мед допомогу (з накладанням КЕП).

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Перевіряє валідність токену доступу

    2. Наявність відповідного скоупу

    3. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення для запису про медичний виріб:

      1. Назва медичного виробу-names

        1. name - назва МВ

        2. type - тип назви МВ,

      2. Тип медичного виробу - Type,

      3. Статус запису про МВ - Status,

      4. Працівник що створив запис- recorder

    4. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення для запису про асоціацію медичного виробу:

      1. Посилання на запис про медичний виріб - device_id

      2. Статус асоціації медичного виробу з пацієнтом - association_status

      3. Частина тіла куди було імплантовано пристрій - body_site

      4. Працівник, що створив запис- recorder

      5. Дата дата встановлення напрямку відношення девайсу до пацієнта (recorded)

    5. Виконує необхідні валідації введених параметрів запиту для медичного виробу

      1. Перевірка статусу Legal Entity до якого належить працівник 

        1. Legal Entity працівника має статус = “Active”;

      2. Перевірка на наявність активного запису для вказаного типу в довіднику типів

        1. Запис в довіднику типів (device_definition_classification_type) на який посилається створюваний запис має бути у статусі “активний”

      3. Якщо для медичного виробу заповнене значення “посилання на довідник device_definition”

        1. запис в довіднику device_definitions на який посилається створюваний запис має бути у статусі “активний”

        2. виконується перевірка на збіг вибраного для МВ типу (з довідника типів) та типу який зазначений в довіднику device_definition.

      4. Перевірка наявності серійного номера МВ (якщо його потрібно заповнювати згідно з обраним типом)

        1. Перевірка чи в конфігураційному параметрі, який містить перелік типів МВ, для яких потрібне вказання серійного номеру, міститься вказаний тип медичного виробу

        2. Якщо такий тип є в конфігураційному параметрі - перевірка заповненості серійного номеру.

      5. Перевірка статусу запису медичного виробу. Статус запису створюваного обладнання має бути “Активний” (status = “active“)

      6. Перевірка звʼязку медичного виробу з батьківським

        1. Якщо є посилання на батьківський МВ (parent), то запис про цей батьківський МВ повинен бути активним (status = “active“)

      7. Перевірка чи дата вказана в manufacture_date не перевищує сьогоднішню

      8. Якщо список property містить хоч одне значення то для кожного елементу списку виконуються такі валідації:

        1. Перевірка чи заповнені значення properties (type та value_codeable_concept\value_quantity\value_range\value_boolean\ value_string\value_integer)

        2. Перевірка чи відповідає вибране значення property_type довіднику еталонних “типів властивостей”

        3. Якщо тип даних вказаний у еталонному довіднику “типів властивостей” = “список” тоді перевірка співпадінь вибраних значень в атрибуті property_value з відповідним еталонним довідником

      9. Перевірка працівника медичного закладу (recorder). Обліковий запис співробітника не є неверифікований

      10. Перевірка наявності хоча б однієї асоціації, що посилається на цей медичний виріб в тому ж EDP

      11. Запис про пацієнта, для якого створюється медичний виріб має бути активний

    6. Виконує необхідні валідації введених параметрів запиту для асоціації медичного виробу

      1. Запис про пристрій, на який посилається асоціація має бути активний (state = active)

      2. Запис про пацієнта, для якого створюється асоціація медичного виробу має бути активний

      3. Запис в довіднику частин тіла, куди було імплантовано\прикріплено пристрій (body_site) на який посилається асоціація є активний

      4. Якщо поле “Дата імплантації\прикріплення МВ до пацієнта” (association_date) заповнене, то це значення менше, або рівне сьогоднішній даті.

      5. Дата встановлення напрямку відношення девайсу до пацієнта (recorded)

        1. Є більшою за дату останньої асоціації для МВ

        2. Є меншою за поточну дату

      6. Якщо статус асоціації association_status=implanted - у МВ, на який посилається ця асоціація, не повинно бути іншої асоціації в будь-якому статусі облікованої раніше в межах іношого EDP

      7. Якщо статус асоціації association_status=attached

        1. У МВ, на який посилається ця асоціація, не повинно бути іншої асоціації в статусі Implanted\Explanted

        2. У МВ, на який посилається ця асоціація, поточний статус асоціації повинен бути Unattached

    7. Виконує необхідні валідації введених параметрів запиту для процедури якою було імплантовано медичний виріб пацієнту:

      1. Якщо облікована процедура і в ній заповнене поле focal_device:

        1. Заповнені обидва поля:

          1. focal_device.action

          2. focal_device.manipulated

        2. Статус процедури повинен мати значення “Completed”;

        3. Значення параметру FocalDevice.action повинно відповідати значенням з довідника

        4. Параметр Focal Device.manipulated повинен мати посилання на запис імплантованого медичного виробу

        5. Значення пацієнта вказаного в процедурі повинно відповідати значенню пацієнта вказаному в медичному виробі та асоціації МВ.

    8. Виконує необхідні валідації введених параметрів запиту для видачі МВ в ЗОЗ:

      1. Якщо облікована видача МВ з посиланням на екземпляр МВ то цей запис повинен бути

        1. активний (active)

        2. відноситься до того ж пацієнта (patient)

        3. тип екземпляру медичного виробу (device_reference.[].type) співпадає з типом медичного виробу призначення (device_request.code), якщо запис про облік видачі на створюється на основі призначення, що створено на тип виробу (based_on)

        4. модель екземпляру медичного виробу (device_reference.[].definition) співпадає з моделлю медичного виробу призначення (device_request.code_reference), якщо запис про облік видачі на створюється на основі призначення, що створено на модель виробу (based_on)

Експлантація\відкріплення пристрою

Ключові моменти

  • При подачі інформації про асоціацію медичного виробу в статусі “відкріплено” або “експлантовано”, вона обовʼязково повинна посилатися на медичний виріб, який був облікований раніше (в рамках іншого EDP), або в поточному EDP має бути створений запис про МВ і обліковано інформацію про імплантацію виробу

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

  • Разом з інформацією про МВ і асоціацію МВ лікар може також облікувати

    • процедуру, якою було експлантовано\відкріплено МВ

Опис бізнес-процесу

Крок

Опис

Крок

Опис

1

Пошук медичних виробів, асоціацій МВ, виявлених проблем МВ за параметрами

https://e-health-ua.atlassian.net/wiki/spaces/OMB2/pages/17752981608#%D0%9F%D0%BE%D1%88%D1%83%D0%BA-%D0%BC%D0%B5%D0%B4%D0%B8%D1%87%D0%BD%D0%B8%D1%85-%D0%B2%D0%B8%D1%80%D0%BE%D0%B1%D1%96%D0%B2%2C-%D0%B0%D1%81%D0%BE%D1%86%D1%96%D0%B0%D1%86%D1%96%D0%B9-%D0%9C%D0%92%2C-%D0%B2%D0%B8%D1%8F%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D1%85-%D0%BF%D1%80%D0%BE%D0%B1%D0%BB%D0%B5%D0%BC-%D0%9C%D0%92-%D0%B7%D0%B0-%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D0%B0%D0%BC%D0%B8

Користувач:

  1. В разі потреби виконує пошук облікованого раніше медичного виробу (див. “Пошук медичного виробу за параметрами”)

2

Облік експлантованих\відкріплених медичних виробів пацієнта в рамках Encounter Data Package

https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17061216257

Користувач:

  1. Виконує подачу інформації про асоціацію медичного виробу, вказуючи:

    1. Посилання на запис про медичний виріб (device_id) - обов'язковий параметр.

    2. Статус асоціації медичного виробу з пацієнтом (association_status) - обов'язковий параметр.

    3. Частина тіла куди було імплантовано пристрій (body_site) - обов'язковий параметр.

    4. Дата експлантації\відкріплення МВ від пацієнта(association_date)

    5. Дата встановлення напрямку відношення девайсу до пацієнта (recorded) - обов'язковий параметр

    6. Працівник що створив запис (recorder) - обов'язковий параметр

  2. За потреби виконує подачу інформації про процедуру, якою проводилася експлантація вказуючи

    1. Посилання на МВ який було імплантовано (focal_device.manipulated)

    2. Дія яка була виконана з імплантованим МВ (focal_device.action)

  3. Відправляє запит про облік експлантованих\відкріплених медичних виробів з накладанням КЕП.

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Перевіряє валідність токену доступу

    2. Наявність відповідного скоупу

    3. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення для запису про асоціацію медичного виробу:

      1. Посилання на запис про медичний виріб - device_id

      2. Статус асоціації медичного виробу з пацієнтом - association_status

      3. Частина тіла куди було імплантовано пристрій - body_site

      4. Працівник, що створив запис- recorder

      5. Дата встановлення напрямку відношення девайсу до пацієнта (recorded)

    4. Виконує необхідні валідації введених параметрів запиту для асоціації медичного виробу

      1. Перевірка статусу Legal Entity до якого належить працівник 

        1. Legal Entity працівника має статус = “Active”;

      2. Перевірка працівника медичного закладу (recorder). Обліковий запис співробітника не є неверифікований

      3. Запис про пацієнта, для якого створюється асоціація медичного виробу має бути активний

      4. Запис про пристрій, на який посилається асоціація має бути активний (state = active)

      5. Запис в довіднику частин тіла, куди було імплантовано пристрій (body_site) на який посилається асоціація є активний

      6. Якщо поле “Дата експлантації\відкріплення МВ від пацієнта” (association_date) заповнене, то це значення менше, або рівне сьогоднішній даті.

      7. Дата встановлення напрямку відношення девайсу до пацієнта (recorded)

        1. Є більшою за дату останньої асоціації для МВ

        2. Є меншою за поточну дату

      8. Якщо статус асоціації association_status=eхplanted - у МВ, на який посилається ця асоціація, повинна бути асоціація в статусі Implanted

      9. Якщо статус асоціації association_status=unattached

        1. У МВ, на який посилається ця асоціація, не повинно бути іншої асоціації в статусі Implanted\Explanted

        2. У МВ, на який посилається ця асоціація, поточний статус асоціації повинен бути attached

    5. Виконує необхідні валідації введених параметрів запиту для процедури якою було екплантовано медичний виріб пацієнту:

      1. Якщо облікована процедура і в ній заповнене поле focal_device:

        1. Заповнені обидва поля:

          1. focal_device.action

          2. focal_device.manipulated

        2. Статус процедури повинен мати значення “Completed”;

        3. Значення параметру FocalDevice.action повинно відповідати значенням з довідника

        4. Параметр Focal Device.manipulated повинен мати посилання на запис імплантованого медичного виробу

        5. Значення пацієнта вказаного в процедурі повинно відповідати значенню пацієнта вказаному в медичному виробі та асоціації МВ.

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

Опис бізнес-процесу

Крок

Опис

Крок

Опис

1

Пошук медичних виробів, асоціацій МВ, виявлених проблем МВ за параметрами

https://e-health-ua.atlassian.net/wiki/spaces/OMB2/pages/17752981608#%D0%9F%D0%BE%D1%88%D1%83%D0%BA-%D0%BC%D0%B5%D0%B4%D0%B8%D1%87%D0%BD%D0%B8%D1%85-%D0%B2%D0%B8%D1%80%D0%BE%D0%B1%D1%96%D0%B2%2C-%D0%B0%D1%81%D0%BE%D1%86%D1%96%D0%B0%D1%86%D1%96%D0%B9-%D0%9C%D0%92%2C-%D0%B2%D0%B8%D1%8F%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D1%85-%D0%BF%D1%80%D0%BE%D0%B1%D0%BB%D0%B5%D0%BC-%D0%9C%D0%92-%D0%B7%D0%B0-%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D0%B0%D0%BC%D0%B8

Користувач:

  1. В разі потреби виконує пошук облікованого раніше медичного виробу (див. “Пошук медичного виробу за параметрами”)

2

Облік зламаного медичного виробу в рамках Encounter Data Package

https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17061216257

Користувач:

  1. Виконує подачу інформації про виявлену проблему МВ, вказуючи:

    1. Пристрій з яким виникла проблема (subject) - обов'язковий параметр.

    2. Пристрій який спричинив проблему (implicated)

    3. Статус виявленої проблеми (status) обов'язковий параметр

    4. Ідентифікація проблеми (code)

    5. Додатковий опис (detail)

    6. Автор виявленої проблеми (author)

    7. Працівник що створив запис (recorder) - обов'язковий параметр

    8. Документ DetectedIssue на який посилається поточний DetectedIssue (based_on)

  2. Відправляє запит на облік зламаного медичного виробу з накладанням КЕП.

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Перевіряє валідність токену доступу

    2. Наявність відповідного скоупу

    3. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення для запису про виявлену проблему медичного виробу:

      1. Посилання на запис про медичний виріб - device_id

      2. Працівник, що створив запис- recorder

      3. Статус виявленої проблеми - status

      4. Автор виявленої проблеми - author

      5. Пристрій з яким виникла проблема - subject

    4. Виконує необхідні валідації введених параметрів запиту

      1. Перевірка статусу Legal Entity до якого належить працівник 

        1. Legal Entity працівника має статус = “Active”;

      2. Перевірка працівника медичного закладу (recorder). Обліковий запис співробітника не є неверифікований

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

      4. Запис про пристрій, на який посилається сутність Виявлена проблема МВ має бути активний (state = active)

      5. Посилання в полі “Автор виявленої проблеми”:

        1. Посилатиється на активний запис про пацієнта
          або

        2. Посилається на обліковий запис співробітника нє активний

      6. Якщо параметр based_on заповнений, тоді він повинен посилатися на документ Detected Issue який стосується того ж МВ, що вказаний в поточному документі

3

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

Користувач:

  1. В разі потреби виконує пошук облікованого раніше запису про поломку медичного виробу (див. “Пошук Виявлених проблем МВ в контексті пацієнта за параметрами”)

4

Облік відремонтованого медичного виробу в рамках Encounter Data Package

https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17061216257

Користувач:

  1. Виконує подачу інформації про виправлену проблему МВ, вказуючи:

    1. Посилання на запис про медичний виріб (device_id) - обов'язковий параметр.

    2. Пристрій з яким була виявлена проблема (subject)

    3. Статус виправленої проблеми МВ (status) обов'язковий параметр

    4. Додатковий опис (detail)

    5. Працівник що створив запис (recorder) - обов'язковий параметр

    6. Автор виявленої проблеми (author)

    7. Документ DetectedIssue на який посилається поточний DetectedIssue (based_on)

  2. Відправляє запит про облік відремонтованого медичного виробу з накладанням КЕП.

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Перевіряє валідність токену доступу

    2. Наявність відповідного скоупу

    3. Перевіряє валідність заповнених полів щодо обов'язковості та формату введення для запису про вирішену проблему медичного виробу:

      1. Посилання на запис про медичний виріб - device_id

      2. Пристрій з яким була виявлена проблема (subject)

      3. Працівник, що створив запис- recorder

      4. Статус проблеми - status (mitigated)

      5. Автор виявленої проблеми - author

    4. Виконує необхідні валідації введених параметрів запиту

      1. Перевірка статусу Legal Entity до якого належить працівник 

        1. Legal Entity працівника має статус = “Active” або “Suspended”;

      2. Перевірка працівника медичного закладу (recorder). Обліковий запис співробітника не є неверифікований

      3. Запис про пацієнта, для якого створюється запис про вирішення проблеми медичного виробу має бути активний

      4. Запис про пристрій, на який посилається сутність виявленої проблеми МВ має бути активний (state = active)

      5. Посилання в полі “Автор виявленої проблеми”:

        1. Посилатиється на активний запис про пацієнта
          або

        2. Посилається на обліковий запис співробітника не є неверифікований

      6. Якщо параметр based_on заповнений, тоді він повинен посилатися на документ Detected Issue який стосується того ж МВ, що вказаний в поточному документі

Позначення запису про імплантацію\прикріплення медичного виробу як помилкового

 

Опис бізнес-процесу

Крок

Опис

Крок

Опис

1

Пошук медичних виробів, асоціацій МВ, виявлених проблем МВ за параметрами

https://e-health-ua.atlassian.net/wiki/spaces/OMB2/pages/17752981608#%D0%9F%D0%BE%D1%88%D1%83%D0%BA-%D0%BC%D0%B5%D0%B4%D0%B8%D1%87%D0%BD%D0%B8%D1%85-%D0%B2%D0%B8%D1%80%D0%BE%D0%B1%D1%96%D0%B2%2C-%D0%B0%D1%81%D0%BE%D1%86%D1%96%D0%B0%D1%86%D1%96%D0%B9-%D0%9C%D0%92%2C-%D0%B2%D0%B8%D1%8F%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D1%85-%D0%BF%D1%80%D0%BE%D0%B1%D0%BB%D0%B5%D0%BC-%D0%9C%D0%92-%D0%B7%D0%B0-%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D0%B0%D0%BC%D0%B8

Користувач:

  1. В разі потреби виконує пошук облікованого раніше медичного виробу або асоціації які потрібно позначити помилковими (див. “Пошук медичного виробу за параметрами”)

2

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

https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17061314561

Користувач:

  1. Обирає сутності, які хоче позначити помилковими

  2. Обирає причину встановлення помилкового статусу

  3. Відправляє запит на позначення призначення помилковим з накладанням КЕП.

Система e-Health:

  1. Перевіряє наявність прав на виконання запиту

    1. Перевіряє валідність токену доступу

    2. Наявність відповідного скоупу

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

  2. Перевіряє валідність заповнених значень

    1. Позначити сутність медичного виробу, асоціації МВ чи виявленої проблем МВ помилковим можна в будь-якому статусі, крім уже позначеного помилковим

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

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

    4. Причина встановлення помилкового статусу відповідає значенню зі словника причин

  3. Змінює статус призначення (відповідно до статусної моделі) на Позначений помилковим (ENTERED_IN_ERROR)

  4. Повертає результати успішного виконання запиту (сутності з оновленим статусом) або причину його відхилення.

 

ЕСОЗ - публічна документація