Перейти до основного вмісту

Отримання рецепту Ehealth​

URI: /api/v1/marketplace/prescription/ehealth/{recipeNumber}

Метод використовується для отримання рецепту Ehealth за номером.

Запит виконується методом GET.

⚠️ Запит повинен містити заголовок Accept: application/json

Параметри URI​

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

Ім'яТипОбов'язковийОпис
recipeNumberstringТакНомер рецепта

Приклад запиту​

/api/v1/marketplace/prescription/ehealth/0000-0000-0000-0000

Параметри відповіді​

Ім'яТипОпис
dataobjectДані відповіді
data.medicationRequestobjectДані запиту на медикамент (рецепт)
data.medicationRequest.categorystringКатегорія рецепта
data.medicationRequest.contextobjectКонтекст рецепта
data.medicationRequest.context.identifierobjectІдентифікатор контексту
data.medicationRequest.context.identifier.typeobjectТип ідентифікатора
data.medicationRequest.context.identifier.type.codinglist[object]Кодування типу ресурсу
data.medicationRequest.context.identifier.type.coding.codestringКод
data.medicationRequest.context.identifier.type.coding.systemstringСистема кодування
data.medicationRequest.context.identifier.valuestringЗначення ідентифікатора
data.medicationRequest.created_atstringДата створення рецепта
data.medicationRequest.dispense_valid_fromstringПочаток терміну дії рецепта для відпуску
data.medicationRequest.dispense_valid_tostringКінцевий термін дії рецепта для відпуску
data.medicationRequest.dosage_instructionlist[object]Інструкції щодо дозування
data.medicationRequest.dosage_instruction.as_needed_booleanbooleanОзнака застосування лікарського засобу за потреби
data.medicationRequest.dosage_instruction.max_dose_per_administrationobjectМаксимальна доза за один прийом
data.medicationRequest.dosage_instruction.max_dose_per_administration.codestringКод дозування
data.medicationRequest.dosage_instruction.max_dose_per_administration.systemstringСистема кодування одиниці вимірювання, з якої беруться параметри
data.medicationRequest.dosage_instruction.max_dose_per_administration.unitstringОдиниця виміру дозування
data.medicationRequest.dosage_instruction.max_dose_per_administration.valueintegerЗначення дозування
data.medicationRequest.dosage_instruction.max_dose_per_periodobjectМістить інформацію про максимальне дозування за період
data.medicationRequest.dosage_instruction.max_dose_per_period.denominatorobjectМістить параметри періоду дозування
data.medicationRequest.dosage_instruction.max_dose_per_period.denominator.codestringКод одиниці періоду
data.medicationRequest.dosage_instruction.max_dose_per_period.denominator.systemstringСистема кодування одиниці періоду
data.medicationRequest.dosage_instruction.max_dose_per_period.denominator.unitstringОдиниця виміру періоду
data.medicationRequest.dosage_instruction.max_dose_per_period.denominator.valueintegerЗначення періоду
data.medicationRequest.dosage_instruction.max_dose_per_period.numeratorobjectМістить параметри дозування за період
data.medicationRequest.dosage_instruction.max_dose_per_period.numerator.codestringКод дозування
data.medicationRequest.dosage_instruction.max_dose_per_period.numerator.systemstringСистема одиниць, з якої беруться параметри
data.medicationRequest.dosage_instruction.max_dose_per_period.numerator.unitstringОдиниця виміру дозування
data.medicationRequest.dosage_instruction.max_dose_per_period.numerator.valueintegerЗначення дозування
data.medicationRequest.dosage_instruction.patient_instructionstringІнструкція для пацієнта
data.medicationRequest.dosage_instruction.sequenceintegerПорядковий номер інструкції
data.medicationRequest.dosage_instruction.textstringТекст інструкції щодо застосування
data.medicationRequest.ended_atstringДата завершення дії рецепта
data.medicationRequest.idstringУнікальний ідентифікатор рецепта
data.medicationRequest.inform_withstringІдентифікатор форми/способу інформування пацієнта
data.medicationRequest.intentstringНамір запиту
data.medicationRequest.medical_programobjectДані медичної програми
data.medicationRequest.medical_program.funding_sourcestringДжерело фінансування
data.medicationRequest.medical_program.idstringІдентифікатор медичної програми
data.medicationRequest.medical_program.mr_blank_typestringТип рецептурного бланка
data.medicationRequest.medical_program.namestringНазва медичної програми
data.medicationRequest.medical_program.medical_program_settingsobjectНалаштування медичної програми
data.medicationRequest.medical_program.medical_program_settings.care_plan_requiredbooleanОбов'язковість наявності плану лікування
data.medicationRequest.medical_program.medical_program_settings.conditions_icd10_am_allowedlist[string]Дозволені коди ICD-10-AM
data.medicationRequest.medical_program.medical_program_settings.conditions_icpc2_allowedlist[string]Дозволені коди ICPC-2
data.medicationRequest.medical_program.medical_program_settings.device_request_allowed_code_typeslist | nullДозволені типи кодів для запиту виробу
data.medicationRequest.medical_program.medical_program_settings.dispense_allowedbooleanЧи дозволений відпуск
data.medicationRequest.medical_program.medical_program_settings.dispense_period_dayintegerПеріод відпуску ліків (у днях)
data.medicationRequest.medical_program.medical_program_settings.employee_types_to_create_medication_requestlist[string]Типи працівників, що мають право створювати запит на медикамент
data.medicationRequest.medical_program.medical_program_settings.employee_types_to_create_requestlist[string]Типи співробітників, які можуть створювати запит
data.medicationRequest.medical_program.medical_program_settings.license_types_allowedlist | nullДозволені типи ліцензій. Якщо значення null, обмеження за типом ліцензії відсутні
data.medicationRequest.medical_program.medical_program_settings.medical_program_change_on_dispense_allowedboolean | nullДозвіл змінювати програмний напрямок при відпуску в аптеці (null / false — заборонено)
data.medicationRequest.medical_program.medical_program_settings.medication_dispense_period_dayintegerТермін дії рецепта для погашення в аптеці (у днях)
data.medicationRequest.medical_program.medical_program_settings.medication_request_max_period_dayintegerМаксимальний термін, на який лікар може виписати курс лікування (у днях)
data.medicationRequest.medical_program.medical_program_settings.medication_request_notification_disabledboolean | nullЧи вимкнено сповіщення пацієнту про рецепт
data.medicationRequest.medical_program.medical_program_settings.multi_medication_dispense_allowedbooleanЧи дозволений відпуск декількох препаратів за одним запитом (false — заборонено)
data.medicationRequest.medical_program.medical_program_settings.patient_categories_allowedlist | nullДозволені категорії пацієнтів
data.medicationRequest.medical_program.medical_program_settings.providing_conditions_allowedlist[string]Дозволені умови надання
data.medicationRequest.medical_program.medical_program_settings.request_allowedbooleanЧи дозволений запит
data.medicationRequest.medical_program.medical_program_settings.request_max_period_dayintegerМаксимальний період запиту (дні)
data.medicationRequest.medical_program.medical_program_settings.request_notification_disabledboolean | nullЧи вимкнено сповіщення про запит
data.medicationRequest.medical_program.medical_program_settings.skip_contract_provision_verifyboolean | nullПропуск перевірки умов договору аптеки (null — перевірка за замовчуванням)
data.medicationRequest.medical_program.medical_program_settings.skip_dispense_division_dls_verifyboolean | nullПропуск перевірки підрозділу DLS при відпуску
data.medicationRequest.medical_program.medical_program_settings.skip_employee_validationbooleanПропуск перевірки даних лікаря (false — перевірка обов'язкова)
data.medicationRequest.medical_program.medical_program_settings.skip_medication_dispense_signbooleanПропуск підпису при відпуску ліків (false — підпис КЕП обов'язковий)
data.medicationRequest.medical_program.medical_program_settings.skip_medication_request_employee_declaration_verifybooleanПропуск перевірки наявності декларації пацієнта з конкретним лікарем (true — перевірка ігнорується)
data.medicationRequest.medical_program.medical_program_settings.skip_medication_request_legal_entity_declaration_verifybooleanПропуск перевірки декларації з даною медустановою (true — перевірка ігнорується)
data.medicationRequest.medical_program.medical_program_settings.skip_mnn_in_treatment_periodbooleanПропуск обмежень за терміном лікування для одного МНН (false — обмеження діють)
data.medicationRequest.medical_program.medical_program_settings.skip_request_employee_declaration_verifybooleanПропуск перевірки декларації лікаря при запиті (true — дозволено виписку без декларації)
data.medicationRequest.medical_program.medical_program_settings.skip_request_legal_entity_declaration_verifybooleanПропуск перевірки декларації з медустановою при запиті (true — дозволено)
data.medicationRequest.medical_program.medical_program_settings.skip_treatment_periodbooleanПропуск контролю періоду лікування (false — період контролюється)
data.medicationRequest.medical_program.medical_program_settings.speciality_types_allowedlist | nullДозволені типи спеціальностей
data.medicationRequest.medical_program.medical_program_settings.speciality_types_care_plan_activity_allowedlist | nullДозволені типи спеціальностей для активності плану лікування
data.medicationRequest.medical_program.medical_program_settings.speciality_types_request_allowedlist[string]Дозволені типи спеціальностей, які мають право виписати рецепт
data.medicationRequest.medication_infoobjectІнформація про лікарський засіб
data.medicationRequest.medication_info.dosageobjectМістить інформацію про лікарську форму ліків
data.medicationRequest.medication_info.dosage.denumerator_unitstringОдиниця виміру лікарської форми
data.medicationRequest.medication_info.dosage.denumerator_valueintegerЗначення знаменника
data.medicationRequest.medication_info.dosage.numerator_unitstringОдиниця чисельника
data.medicationRequest.medication_info.dosage.numerator_valueintegerЗначення чисельника
data.medicationRequest.medication_info.formstringФорма випуску
data.medicationRequest.medication_info.ingredientslist[object]Склад лікарського засобу
data.medicationRequest.medication_info.ingredients.dosageobjectДозування інгредієнта
data.medicationRequest.medication_info.ingredients.dosage.denumerator_unitstringОдиниця знаменника
data.medicationRequest.medication_info.ingredients.dosage.denumerator_valueintegerЗначення знаменника
data.medicationRequest.medication_info.ingredients.dosage.numerator_unitstringОдиниця чисельника
data.medicationRequest.medication_info.ingredients.dosage.numerator_valueintegerЗначення чисельника
data.medicationRequest.medication_info.ingredients.idstringІдентифікатор інгредієнта
data.medicationRequest.medication_info.ingredients.is_primarybooleanОзнака основної діючої речовини
data.medicationRequest.medication_info.ingredients.namestringНазва інгредієнта
data.medicationRequest.medication_info.ingredients.name_originalstringОригінальна назва інгредієнта
data.medicationRequest.medication_info.ingredients.sctidstring | nullКод SCTID
data.medicationRequest.medication_info.medication_idstringІдентифікатор лікарського засобу
data.medicationRequest.medication_info.medication_namestringНазва лікарського засобу
data.medicationRequest.medication_info.medication_qtyintegerКількість лікарського засобу в рецепті
data.medicationRequest.medication_info.medication_remaining_qtyintegerКількість одиниць, яка залишилася для відпуску
data.medicationRequest.medication_info.medication_total_qtyintegerЗагальна призначена кількість одиниць
data.medicationRequest.request_numberstringНомер рецепта
data.medicationRequest.started_atstringДата початку дії рецепта
data.medicationRequest.statusstringСтатус рецепта
data.medicationRequest.participantslist[object]Перелік торгових назв препаратів, що беруть участь у програмі відшкодування
data.medicationRequest.participants.consumer_pricenumericРоздрібна ціна упаковки в аптеці (грн)
data.medicationRequest.participants.container_dosageobjectДозування в упаковці
data.medicationRequest.participants.container_dosage.denumerator_unitstringОдиниця знаменника
data.medicationRequest.participants.container_dosage.denumerator_valueintegerЗначення знаменника
data.medicationRequest.participants.container_dosage.numerator_unitstringОдиниця чисельника
data.medicationRequest.participants.container_dosage.numerator_valueintegerЗначення чисельника
data.medicationRequest.participants.drlz_sku_idstring | nullІдентифікатор SKU з Державного реєстру лікарських засобів
data.medicationRequest.participants.end_datestring | nullДата закінчення участі
data.medicationRequest.participants.estimated_payment_amountnumericОрієнтовна сума доплати пацієнтом (грн)
data.medicationRequest.participants.formstringФорма випуску препарату
data.medicationRequest.participants.idstringІдентифікатор учасника
data.medicationRequest.participants.manufacturerobjectДані про виробника
data.medicationRequest.participants.manufacturer.countrystringКод країни виробника
data.medicationRequest.participants.manufacturer.namestringНазва виробника
data.medicationRequest.participants.medication_idstringІдентифікатор лікарського засобу
data.medicationRequest.participants.medication_namestringТоргова назва лікарського засобу
data.medicationRequest.participants.package_min_qtyintegerМінімальна кількість одиниць для відпуску з упаковки
data.medicationRequest.participants.package_qtyintegerКількість одиниць у повній упаковці
data.medicationRequest.participants.package_qty_divisiblebooleanЧи можна ділити упаковку
data.medicationRequest.participants.registry_numberstringНомер реєстру
data.medicationRequest.participants.reimbursement_amountnumericСума реімбурсації
data.medicationRequest.participants.reimbursement_daily_dosagenumericСума реімбурсації за добову дозу
data.medicationRequest.participants.start_datestringДата початку участі за реєстром
data.medicationRequest.participants.wholesale_pricenumericОптово-відпускна ціна за упаковку (грн)
data.medicationRequest.participants.external_idstringІдентифікатор товару в обліковій системі аптечної мережі
data.skip_signbooleanПропуск підпису
data.multi_medication_dispense_allowedbooleanЧи дозволений відпуск декількох найменувань
data.skip_contract_provision_verifybooleanПропуск перевірки контрактного забезпечення
data.pharmacieslistПерелік аптек

Приклад успішної відповіді​

200 OK

Відповідь: /api/v1/marketplace/prescription/ehealth/0000-0000-0000-0000
{
    "data": {
        "medicationRequest": {
            "category": "community",
            "context": {
                "identifier": {
                    "type": {
                        "coding": [
                            {
                                "code": "encounter",
                                "system": "eHealth/resources"
                            }
                        ]
                    },
                    "value": "fdf8842f-bbd4-44a4-b729-b66e3385bd86"
                }
            },
            "created_at": "2026-08-18",
            "dispense_valid_from": "2026-08-18",
            "dispense_valid_to": "2026-09-17",
            "dosage_instruction": [
                {
                    "as_needed_boolean": true,
                    "max_dose_per_administration": {
                        "code": "PIECE",
                        "system": "eHealth/ucum/units",
                        "unit": "PIECE",
                        "value": 1
                    },
                    "max_dose_per_period": {
                        "denominator": {
                            "code": "day",
                            "system": "eHealth/ucum/units",
                            "unit": "day",
                            "value": 1
                        },
                        "numerator": {
                            "code": "PIECE",
                            "system": "eHealth/ucum/units",
                            "unit": "PIECE",
                            "value": 1
                        }
                    },
                    "patient_instruction": "1т-1р\\д",
                    "sequence": 1,
                    "text": "1т-1р\\д"
                }
            ],
            "ended_at": "2026-09-16",
            "id": "f7ba3aa3-0469-4e15-832d-7d95f02c5b10",
            "inform_with": "ef673c9c-ca8e-4cff-93b3-c60fd0faa619",
            "intent": "order",
            "medical_program": {
                "funding_source": "NHS",
                "id": "014d1d27-a0fc-4591-81cf-46fa6ea2999d",
                "mr_blank_type": "F-1",
                "name": "Цукровий діабет (пероральні гіпоглікемізуючі лікарські засоби)",
                "medical_program_settings": {
                    "care_plan_required": false,
                    "conditions_icd10_am_allowed": [
                        "E11.01",
                        "E11.02",
                        "E11.11",
                        "E11.12",
                        "E11.13",
                        "E11.14",
                        "E11.15",
                        "E11.16",
                        "E11.21",
                        "E11.22",
                        "E11.29",
                        "E11.31",
                        "E11.32",
                        "E11.33",
                        "E11.34",
                        "E11.35",
                        "E11.36",
                        "E11.39",
                        "E11.40",
                        "E11.41",
                        "E11.42",
                        "E11.43",
                        "E11.49",
                        "E11.51",
                        "E11.52",
                        "E11.53",
                        "E11.61",
                        "E11.62",
                        "E11.63",
                        "E11.64",
                        "E11.65",
                        "E11.69",
                        "E11.71",
                        "E11.72",
                        "E11.73",
                        "E11.8",
                        "E11.9",
                        "E13.01",
                        "E13.02",
                        "E13.11",
                        "E13.12",
                        "E13.13",
                        "E13.14",
                        "E13.15",
                        "E13.16",
                        "E13.21",
                        "E13.22",
                        "E13.29",
                        "E13.31",
                        "E13.32",
                        "E13.33",
                        "E13.34",
                        "E13.35",
                        "E13.36",
                        "E13.39",
                        "E13.40",
                        "E13.41",
                        "E13.42",
                        "E13.43",
                        "E13.49",
                        "E13.51",
                        "E13.52",
                        "E13.53",
                        "E13.61",
                        "E13.62",
                        "E13.63",
                        "E13.64",
                        "E13.65",
                        "E13.69",
                        "E13.71",
                        "E13.72",
                        "E13.73",
                        "E13.8",
                        "E13.9",
                        "E14.01",
                        "E14.02",
                        "E14.11",
                        "E14.12",
                        "E14.13",
                        "E14.14",
                        "E14.15",
                        "E14.16",
                        "E14.21",
                        "E14.22",
                        "E14.29",
                        "E14.31",
                        "E14.32",
                        "E14.33",
                        "E14.34",
                        "E14.35",
                        "E14.36",
                        "E14.39",
                        "E14.40",
                        "E14.41",
                        "E14.42",
                        "E14.43",
                        "E14.49",
                        "E14.51",
                        "E14.52",
                        "E14.53",
                        "E14.61",
                        "E14.62",
                        "E14.63",
                        "E14.64",
                        "E14.65",
                        "E14.69",
                        "E14.71",
                        "E14.72",
                        "E14.73",
                        "E23.2",
                        "N25.1",
                        "O24.0",
                        "O24.12",
                        "O24.13",
                        "O24.14",
                        "O24.19",
                        "O24.22",
                        "O24.23",
                        "O24.24",
                        "O24.29",
                        "O24.32",
                        "O24.33",
                        "O24.34",
                        "O24.39",
                        "O24.42",
                        "O24.43",
                        "O24.44",
                        "O24.49",
                        "O24.92",
                        "O24.93",
                        "O24.94",
                        "O24.99",
                        "E14.8",
                        "E14.9"
                    ],
                    "conditions_icpc2_allowed": [
                        "T90",
                        "T89"
                    ],
                    "device_request_allowed_code_types": null,
                    "dispense_allowed": true,
                    "dispense_period_day": 30,
                    "employee_types_to_create_medication_request": [
                        "SPECIALIST",
                        "DOCTOR"
                    ],
                    "employee_types_to_create_request": [
                        "SPECIALIST",
                        "DOCTOR"
                    ],
                    "license_types_allowed": null,
                    "medical_program_change_on_dispense_allowed": null,
                    "medication_dispense_period_day": 30,
                    "medication_request_max_period_day": 90,
                    "medication_request_notification_disabled": null,
                    "multi_medication_dispense_allowed": false,
                    "patient_categories_allowed": null,
                    "providing_conditions_allowed": [
                        "OUTPATIENT"
                    ],
                    "request_allowed": true,
                    "request_max_period_day": 90,
                    "request_notification_disabled": null,
                    "skip_contract_provision_verify": null,
                    "skip_dispense_division_dls_verify": null,
                    "skip_employee_validation": false,
                    "skip_medication_dispense_sign": false,
                    "skip_medication_request_employee_declaration_verify": true,
                    "skip_medication_request_legal_entity_declaration_verify": true,
                    "skip_mnn_in_treatment_period": false,
                    "skip_request_employee_declaration_verify": true,
                    "skip_request_legal_entity_declaration_verify": true,
                    "skip_treatment_period": false,
                    "speciality_types_allowed": null,
                    "speciality_types_care_plan_activity_allowed": null,
                    "speciality_types_request_allowed": [
                        "ENDOCRINOLOGY",
                        "PEDIATRIC_ENDOCRINOLOGY",
                        "THERAPIST",
                        "PEDIATRICIAN",
                        "FAMILY_DOCTOR"
                    ]
                }
            },
            "medication_info": {
                "dosage": {
                    "denumerator_unit": "PIECE",
                    "denumerator_value": 1,
                    "numerator_unit": "MG",
                    "numerator_value": 10
                },
                "form": "FILM_COATED_TABLET",
                "ingredients": [
                    {
                        "dosage": {
                            "denumerator_unit": "PIECE",
                            "denumerator_value": 1,
                            "numerator_unit": "MG",
                            "numerator_value": 10
                        },
                        "id": "c5d70870-1ca0-49de-8d22-425306ad442c",
                        "is_primary": true,
                        "name": "дапагліфлозин",
                        "name_original": "dapagliflozin",
                        "sctid": null
                    }
                ],
                "medication_id": "b4bbd548-f196-49d3-ac88-e9be1c600ba4",
                "medication_name": "дапагліфлозин 10 мг, таблетки, вкриті плівковою оболонкою",
                "medication_qty": 30,
                "medication_remaining_qty": 30,
                "medication_total_qty": 30
            },
            "request_number": "0000-0000-0000-0000",
            "started_at": "2026-08-18",
            "status": "ACTIVE",
            "participants": [
                {
                    "consumer_price": 1669.22,
                    "container_dosage": {
                        "denumerator_unit": "BLISTER",
                        "denumerator_value": 1,
                        "numerator_unit": "PIECE",
                        "numerator_value": 10
                    },
                    "drlz_sku_id": null,
                    "end_date": null,
                    "estimated_payment_amount": 834.61,
                    "form": "FILM_COATED_TABLET",
                    "id": "a33cf9fc-02bf-4928-8e21-a62d08aa248c",
                    "manufacturer": {
                        "country": "GB",
                        "name": "АстраЗенека ЮК Лімітед"
                    },
                    "medication_id": "5d2b1e03-d5e9-4eac-868b-0d6949490d96",
                    "medication_name": "ФОРКСІГА",
                    "package_min_qty": 30,
                    "package_qty": 30,
                    "package_qty_divisible": true,
                    "registry_number": "Наказ НСЗУ №194 від 28.04.2026",
                    "reimbursement_amount": 834.61,
                    "reimbursement_daily_dosage": 834.61,
                    "start_date": "2026-05-04",
                    "wholesale_price": 1256.05,
                    "external_id": "1226ec39-a65b-4edd-a41a-2ad632c0f901"
                }
            ]
        },
        "skip_sign": false,
        "multi_medication_dispense_allowed": false,
        "skip_contract_provision_verify": false,
        "pharmacies": []
    }
}