15.08.2022
Передумови
Передумови для процесу погашення рецепту в аптечному закладі (далі АЗ) в робочому місці фармацевта (РМФ):
рецепт виписаний за програмою;
АЗ, який має право відпускати ліки згідно чинного законодавства, зареєстровано в системі eHealth через будь-яку МІС, що надає такі можливості та яка підключена до ЦБД ЕСОЗ;
аптечний підрозділ, який має право відпускати ліки згідно чинного законодавства, зареєстровано через-будь яку МІС, що надає такі можливості та яка підключена до ЦБД ЕСОЗ;
співробітник аптеки, який має право відпускати ліки згідно чинного законодавства, зареєстрований в системі ЦБД ЕСОЗі через будь-яку МІС, що надає такі можливості та МІС підключена до ЦБД ЕСОЗ;
аптечний заклад має створені healthcare services з відповідною ліцензією.
Додаткові передумови до погашення рецептів за програмами реімбурсації:
АЗ уклав договір з НСЗУ на відповідні програми реімбурсації;
аптечний підрозділ наявний у активних зобов’язаннях за відповідною програмою, за якою здійснюється погашення ЕР.
Якщо МІС має намір реалізовувати функціонал РМФ без Адміністративного модуля або використовувати свій функціонал для аптечних закладів, які можуть також реєструватись в Адміністративному модулі в іншому МІС, то даний МІС повинен забезпечити реалізацію запиту оновлення даних про аптечний заклад Сreate/update legal entity.
В рамках запиту Сreate/update legal entity керівник АЗ повинен заповнити реєстраційну форму з таким же самим набором полів, як і при реєстрації АЗ в іншому МІС і підписати його своїм КЕП. МІС повинен збагатити запит параметрами, яких не вистачає в запиті згідно API системи.
На рівні ЦБД ЕСОЗ після успішного виконання запиту проводиться запис ще одного connections для АЗ, а користувачі АЗ отримують право працювати через даний МІС.
Подробиці функціоналу описані в даній статті.
Загальні посилання на джерела даних
Загальне API щодо погашення електронних рецептів представлено за посиланням:
https://ehealthmisapi1.docs.apiary.io/#reference/public.-reimbursement/medication-dispense
Процес погашення рецепту
1 Отримання інформації щодо рецепту
Пацієнт, який бажає отримати ліки за рецептом, повинен назвати/показати співробітнику аптеки номер рецепта (request_number) у форматі:
0000-243P-1X53-EH38
або у вигляді штрих-коду для зчитування номеру рецепту сканером.
За отриманим номером рецепта (request_number) МІС виконує запит:
...
У відповідь МІС отримує інформацію згідно API системи щодо виписаного рецепту, в тому числі інформацію про залишок ліків до погашення та статус рецепту, які необхідно відобразити співробітнику аптеки:
ACTIVE- рецепт активний та може бути погашений частково або повністю;
COMPLETED – рецепт вже повністю погашено;
REJECTED – рецепт відізвано лікарем;
EXPIRED – сплив термін дії рецепту.
...
При отриманні статусу рецепта COMPLETED, REJECTED або EXPIRED, співробітник аптеки повинен проінформувати пацієнта про неможливість погасити рецепт та назвати причину згідно отриманого статусу рецепту.
У разі отримання статусу ACTIVE, слід візуалізувати отриману інформацію з рецепту (який лікарський засіб виписано; де; ким; за якою програмою; кількість, що залишилась до погашення remaining_qty у одиницях виміру container.numerator_unit; загальну кількість, на яку виписано ЕР medication_qty у одиницях виміру container.numerator_unit тощо) та виконати наступний етап.
За тим же запитом можна отримати й унікальний ID рецепту для подальших дій з рецептом без використання request_number.
...
reject_reason_code (required) - відповідний код з довідника;
reject_reason (optional) - опційне текстове поле для введення користувачем додаткової інформації.
У випадку, якщо рецепти знаходяться в статусі is_blocked=true, МІС у відповідь на запити щодо рецепту за його id (Get Medication request by ID by Pharmacy User) та щодо переліку рецептів (Get Medication Requests List) за кожним рецептом буде отримувати параметри:
is_blocked: true
block_reasosan: "…"
Таке блокування рецептів доступне користувачам, які є (і) працівниками НСЗУ та (іі) працівниками аптеки в рамках фармацевтичної опіки.
Рецепти зі статусом is_blocked: true не можуть бути відпущені в АЗ. В свою чергу МІС при запиті користувачем (фармацевтом) інформації щодо ЕР повинен відобразити інформацію, що рецепт заблоковано НСЗУ з вказанням причини блокування з параметру block_reason.
...
23.05.2023
Передумови
Передумови для процесу погашення рецепту в аптечному закладі (далі АЗ) в робочому місці фармацевта (РМФ):
рецепт виписаний за програмою;
АЗ, який має право відпускати ліки згідно чинного законодавства, зареєстровано в системі eHealth через будь-яку МІС, що надає такі можливості та яка підключена до ЦБД ЕСОЗ;
аптечний підрозділ, який має право відпускати ліки згідно чинного законодавства, зареєстровано через-будь яку МІС, що надає такі можливості та яка підключена до ЦБД ЕСОЗ;
співробітник аптеки, який має право відпускати ліки згідно чинного законодавства, зареєстрований в системі ЦБД ЕСОЗі через будь-яку МІС, що надає такі можливості та МІС підключена до ЦБД ЕСОЗ;
аптечний заклад має створені healthcare services з відповідною ліцензією.
Додаткові передумови до погашення рецептів за програмами реімбурсації:
АЗ уклав договір з НСЗУ на відповідні програми реімбурсації;
аптечний підрозділ наявний у активних зобов’язаннях за відповідною програмою, за якою здійснюється погашення ЕР.
Якщо МІС має намір реалізовувати функціонал РМФ без Адміністративного модуля або використовувати свій функціонал для аптечних закладів, які можуть також реєструватись в Адміністративному модулі в іншому МІС, то даний МІС повинен забезпечити реалізацію запиту оновлення даних про аптечний заклад Сreate/update legal entity.
В рамках запиту Сreate/update legal entity керівник АЗ повинен заповнити реєстраційну форму з таким же самим набором полів, як і при реєстрації АЗ в іншому МІС і підписати його своїм КЕП. МІС повинен збагатити запит параметрами, яких не вистачає в запиті згідно API системи.
На рівні ЦБД ЕСОЗ після успішного виконання запиту проводиться запис ще одного connections для АЗ, а користувачі АЗ отримують право працювати через даний МІС.
Подробиці функціоналу описані в даній статті.
Загальні посилання на джерела даних
Загальне API щодо погашення електронних рецептів представлено за посиланням:
https://ehealthmisapi1.docs.apiary.io/#reference/public.-reimbursement/medication-dispense
Процес погашення рецепту
1 Отримання інформації щодо рецепту
Пацієнт, який бажає отримати ліки за рецептом, повинен назвати/показати співробітнику аптеки номер рецепта (request_number) у форматі:
0000-243P-1X53-EH38
або у вигляді штрих-коду для зчитування номеру рецепту сканером.
За отриманим номером рецепта (request_number) МІС виконує запит:
Get Medication request by ID by Pharmacy User
У відповідь МІС отримує інформацію згідно API системи щодо виписаного рецепту, в тому числі інформацію про залишок ліків до погашення та статус рецепту, які необхідно відобразити співробітнику аптеки:
ACTIVE- рецепт активний та може бути погашений частково або повністю;
COMPLETED – рецепт вже повністю погашено;
REJECTED – рецепт відізвано лікарем;
EXPIRED – сплив термін дії рецепту.
...
При отриманні статусу рецепта COMPLETED, REJECTED або EXPIRED, співробітник аптеки повинен проінформувати пацієнта про неможливість погасити рецепт та назвати причину згідно отриманого статусу рецепту.
У разі отримання статусу ACTIVE, слід візуалізувати отриману інформацію з рецепту (який лікарський засіб виписано; де; ким; за якою програмою; кількість, що залишилась до погашення remaining_qty у одиницях виміру container.numerator_unit; загальну кількість, на яку виписано ЕР medication_qty у одиницях виміру container.numerator_unit тощо) та виконати наступний етап.
За тим же запитом можна отримати й унікальний ID рецепту для подальших дій з рецептом без використання request_number.
При спробі отримати інформацію по відкликаному ЕР (статус REJECTED) за методом Get Medication request by ID by Pharmacy UserМІС отримає наступну інформацію, яку необхідно візуалізувати користувачу з метою подальшої передачі пацієнту:
reject_reason_code (required) - відповідний код з довідника;
reject_reason (optional) - опційне текстове поле для введення користувачем додаткової інформації.
У випадку, якщо рецепти знаходяться в статусі is_blocked=true, МІС у відповідь на запити щодо рецепту за його id (Get Medication request by ID by Pharmacy User) та щодо переліку рецептів (Get Medication Requests List) за кожним рецептом буде отримувати параметри:
is_blocked: true
block_reasosan: "…"
Таке блокування рецептів доступне користувачам, які є працівниками НСЗУ та (іі) працівниками аптеки в рамках фармацевтичної опіки.
Рецепти зі статусом is_blocked: true не можуть бути відпущені в АЗ. В свою чергу МІС при запиті користувачем (фармацевтом) інформації щодо ЕР повинен відобразити інформацію, що рецепт заблоковано НСЗУз вказанням причини блокування з параметру block_reason.
2 Проведення фармопіки та відміна рецепта
2.1 Фармацевт перевіряє електронний рецепт в розрізі фармопіки.
У випадку, якщо рецепт не відповідає нормативними, медичними або іншим стандартам, фармацевт має можливість відмінити рецепт, використовуючи метод Reject Medication request by Pharmacy User, вказуючи reject_reason_code - одну з причин словника MEDICATION_REQUEST_REJECT_REASON (обовя'язково):
NO_REQUEST_NEEDED - прохання пацієнта виписати новий електронний рецепт за тією ж МНН через відсутність достатньої кількості виписаного лікарського засобу в аптечному закладі
NO_SMS - пацієнту не надходить СМС-повідомлення з інформацією про призначення
PATIENT_REJECT - відмова пацієнта приймати виписаний лікарський засіб
WRONG_DOSAGE - виписана невірна кількість доз лікарського засобу
WRONG_QTY - виписана невірна лікарська форма лікарського засобу
WRONG_PERIOD - виписана невірна кількість днів курсу лікування
WRONG_SIGNATURE - невірно заповнена сигнатура
а також reject reason опційно.
2.2 Фармацевт підписує запит КЕП
2.3 Якщо передані дані валідні та електронний рецепт знаходиться у статусі, який допускає скасування (відповідно до статусної моделі), - система змінює статус запису на “REJECTED” - “Відмінено”
3 Отримання інформації щодо торгових назв, які можна відпустити за рецептом
Лікар виписує лікарській засіб на МНН у визначеній формі, що визначається в системі як medication_id, та у визначеній кількості medication_qty у одиницях виміру container.numerator_unit.В окремих випадках, лікар може визначити кількість лікарського засобу в первинній упаковці (наприклад, для парантеральних лікарських форм: об'єм ампули, флакону, небули, тощо).
Для отримання можливих торгових назв для відпуску за даним рецептом слід виконати запит з доступною в АЗ для відпуску кількістю medication_qty, що дорівнює або менше remaining_qty за рецептом:
Get Medication request by ID by Pharmacy User за унікальним ID отриманого рецепту
...
participants.daily_dosage: добова доза лікарського засобу, рекомендована ВООЗ у одиницях виміру container.numerator_unit.
ВАЖЛИВО!
Додатково для програм реімбурсації до перелічених вище параметрів відповіді на Qualify Medication Request by ID за унікальним ID зазначатимуться також ціни учасників медичних програм, а саме:
participants.wholesale_price: оптово-відпускна ціна за упаковку, грн;
...
Для програм за межами реімбурсації значення ціни не вказуються.
2. Для лікарських засобів, для яких лікарем визначено кількість лікарського засобу в первинній упаковці додатково буде відображатися інформація щодо цієї кількості у параметрах:
container_dosage.numerator_value: зі значенням зі словника Medication Unit, наприклад PIECE, MG, ML;
container_dosage.numerator_unit: зі значенням об'єму необхідної для пацієнта первинної упаковки.
Наприклад, якщо без вказання цих значень в реєстрі присутні ампули з 1 мл, 2 мл, 5 мл, а пацієнту необхідно ЛЗ у ампулах 5 мл, то в цьому випадку параметри:
container_dosage.numerator_value: 10
container_dosage.numerator_unit: ML
В даному випадку у відповіді методу будуть присутні тільки ті торгові назви, які задовольняють умові об'єму первинної упаковки, а саме, ампули, об'ємом 5 мл.
...
4 Процес вибору торгової назви та кількості препарату
Процес вибору торгової назви з можливого переліку до погашення повинен проходити за рамками процесів ЦБД ЕСОЗ та може залежати від декількох додаткових факторів, наприклад:
...
Таким чином, в МІС на даному етапі повинно бути визначено:
Medication ID - ID обраного торгового найменування зі списку, що було отримано на запит Qualify Medication Request by ID.
| Note |
|---|
ВАЖЛИВО! У випадку, коли лікарем буде визначено кількість лікарського засобу в первинній упаковці, при відпуску ліків в аптеці перелік ліків повинен бути відфільтрованим за даним параметром. |
...
Якщо в результаті даного етапу є згода, то співробітник через МІС повинен створити заявку на погашення рецепту.
...
5 Погашення електронного рецепту
Заявка на погашення рецепту може бути в наступних статусах:
...
skip_medication_dispense_sign = False, то створена заявка за методом Create Medication Dispense переходить у статус NEW та повинна бути підписана КЕП для успішного погашення ЕР (частково або повністю) за методом Process medication dispense.
...
5.1 Погашення електронного рецепту з КЕП
За умови якщо параметром налаштування програми, за якою виписано рецепт, накладення КЕП є обов’язковим (параметр skip_medication_dispense_sign = False), процесс погашення рецепту проходить за наступними кроками.
...
5.1.1 Створення заявки
Для створення заявки на погашення рецепту співробітнику необхідно запитати у пацієнта код погашення рецепту, що складається з 4 цифр та виконати запит з необхідними параметрами згідно API:
Create Medication Dispense by Pharmacy User.
При успішному виконанні запиту МІС отримає збагачену інформацією відповідь з ID запиту (Medication Dispense Response Identifier) та статусом заявки Status= NEW.
...
При спробі виконання нового запиту Create Medication Dispense by Pharmacy Userта за умови, що кількість ЛЗ в цьому новому запиті дорівнює або менше кількості, що вказана в ЕР, та в системі існують інші незавершені запити Create Medication Dispense by Pharmacy User на кількість ЛЗ, яка в сумі з новим запитом перевищує кількість ЛЗ в ЕР, то на такий запит користувач отримує помилку: "message": "dispensed medication quantity must be equal to medication quantity in Medication Request", що означає знаходження ще незавершених запитів Create Medication Dispense by Pharmacy Userі користувача необхідно повернути до завершення виконання погашення незавершених запитів.
Строк життя незавершених запитів Create Medication Dispense by Pharmacy User - 10 хвилин, та у разі, якщо даний запит не буде завершений, наприклад, якщо пацієнт відмовився на даному етапі від ліків, то заявка на погашення перейде у Status = EXPIRED, арецепт буде автоматично розблоковано.
Також фармацевт може здійснити відхилення заявки на погашення рецепту вручну за допомогою запиту не чекаючи 10 хвилин:
Reject Medication Dispense by Pharmacy User.
При цьому рецепт буде переведено у Status=ACTIVE, а заявка на погашення - у Status=Rejected.
...
5.1.2 Оформлення оплати
Оформлення оплати є внутрішніми процесами АЗ.
В результаті даного етапу в МІС повинні бути сформовані 2 параметри:
payment_amount – сума в чеку, яку заплатив пацієнт;
payment_id – номер фіскального чеку (опціонально).
...
5.1.3 Завершення погашення рецепту
Для завершення погашення рецепту МІС повинна:
Мати сформований json, який можна:
або отримати з відповіді на запит Get Medication Dispense by ID https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/583405321,
або з відповіді на успішний запит Create Medication Dispense by Pharmacy Userhttps://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17046112151/RC+Rx+Create+Medication+Dispense+by+Pharmacy+User.
2. Збагатити отриманий json параметрами:
...
3. Підписати отриманий json за допомогою КЕП співробітника аптечного закладу та перекодувати підписаний json у base64 формат.
4. Виконати запит:
Process medication dispense by Pharmacy User.
5. У разі успішного виконання запиту заявка переходить у статус: Status= PROCESSED, рецепт переходить у статус: Status=COMPLETED та в системі ЦБД ЕСОЗ відбувається запис про рецепт за даним АЗ.
...
5.2 Погашення електронного рецепту без КЕП
4.2.1 Оформлення оплати
Оформлення оплати є внутрішніми процесами АЗ.
...
payment_amount – сума в чеку, яку заплатив пацієнт (обов'язково для рецептів за програмами за власні кошти пацієнта);
payment_id – номер фіскального чеку (опціонально).
...
5.2.2. Створення заявки на погашення з одночасним погашенням рецепту
Для створення заявки на погашення рецепту співробітнику необхідно запитати у пацієнта код погашення рецепту, що складається з 4 цифр та виконати запит з необхідними параметрами згідно API, включаючи сформовані параметри payment_amount (обов'язково для рецептів за програмами за власні кошти пацієнта) та payment_id (опційно) на етапі проведення оплати:
Create Medication Dispense by Pharmacy User.
При успішному виконанні запиту МІС отримає збагачену інформацією відповідь з ID запиту (Medication Dispense Response Identifier) та статусом заявки Status= PROCCESSED.
Рецепт є погашеним даним АЗ.
...
6 Відпуск ліків пацієнту
Виконати відпуск ліків пацієнту за процедурою в аптечному закладі.
...
7 Отримання переліку заявок на погашення рецептів та інформації про відпущені ліки
Для зручності користування можна отримати перелік заявок на погашення рецептів про відпущені рецепт доступне з використанням наступних методівза запитами:
(Старі методи https://uaehealthapi.docs.apiary.io/#reference/public.-reimbursement/medication-dispense/get-medication-dispenses-list , https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/583405324/Get+Medication+Dispenses ).
2. Get Medication dispense details by Pharmacy User.
Get Medication Dispenses ListGet Medication Dispenses by search params by Pharmacy User
Запит можна налаштовувати в залежності від потреб за фільтром з одним або кількома параметрами:
...
dispensed_to – Дата, до якої проводиться погашення.
2.Get Medication dispense details by Pharmacy User
Для виконання запиту Get Medication dispense details by Pharmacy User необхідно знати ID погашення рецепту. На запит у відповіді буде інформація щодо даного погашеного рецепту.
8 Блокування рецептів
В рамках фармацевтичної опіки працівник аптеки має можливість відмінити заблокувати рецепт вказавши причину відміни. такого блокування.
При цьому, перед тим, як дозволити фармацевту заблокувати рецепт, МІС повинна попередити користувача наступним повідомленням
|
Для блокування рецептів працівник аптеки використовує метод
Block Medication Request by Pharmacy User
...
8 Інші допоміжні запити
Для реалізації свого унікального інтерфейсу, додаткових можливостей для погашення рецептів, МІС може скористатися всіма іншими доступними запитами, які не були описані або описані часткового в даному документі, але присутні в Апіарі: http://ehealthmisapi1.docs.apiary.io та в базі знань: https://e-health-ua.atlassian.net/wiki/spaces/EH/overview
Електронний рецепт (етап 2-3_наркотики, програми).
...