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

Medication dispense/Get medication request data​

URI: /medication/get-data/

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

Запит виконується методом POST у json форматі з даними.

Заголовки​

Запит обов'язково повинен мати заголовок Content-Type: application/json, інакше запит буде вважатися некоректним навіть при валідному JSON у ньому.

Для підтвердження запиту користувача API необхідно передавати заголовок API-Key.

Для автентифікації користувача, який обробив запит API, потрібно передати заголовок авторизації з токеном у форматі Bearer.

Наприклад: Authorization = "Bearer TOKEN".

Параметри запиту​

Ім'яТипОбов'язковийОпис
idstringТакНомер рецепта наданий покупцем (клієнтом)

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

Запит: /account/login/
{
    "id": "0000-K4E1-THE0-064A"
}

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

Ім'яТипОпис
skip_signboolean
multi_medication_dispense_allowedboolean
skip_contract_provision_verifyboolean
medicationRequestobjectПараметри медичного запиту
medicationRequest.categorystringКатегорія запиту
medicationRequest.created_atstringДата створення запиту
medicationRequest.dispense_valid_fromstringДата з якої дійсний відпуск ліків
medicationRequest.dispense_valid_tostringДата до якої дійсний відпуск ліків
medicationRequest.divisionobjectПараметри відділення
medicationRequest.division.addresseslist[object]Містить параметри адреси відділення
medicationRequest.division.addresses.apartmentstringНомер квартири
medicationRequest.division.addresses.areastringОбласть
medicationRequest.division.addresses.buildingstringНомер будинку
medicationRequest.division.addresses.countrystringКраїна
medicationRequest.division.addresses.regionstringРайон
medicationRequest.division.addresses.settlementstringНаселений пункт
medicationRequest.division.addresses.settlement_idstringІдентифікатор населеного пункту
medicationRequest.division.addresses.settlement_typestringТип населеного пункту
medicationRequest.division.addresses.streetstringВулиця
medicationRequest.division.addresses.street_typestringТип вулиці
medicationRequest.division.addresses.typestringТип закладу
medicationRequest.division.addresses.zipstringПоштовий індекс
medicationRequest.division.emailstringАдреса електронної пошти
medicationRequest.division.external_idstringЗовнішній ідентифікатор
medicationRequest.division.idstringІдентифікатор відділення
medicationRequest.division.legal_entity_idstringІдентифікатор юридичної особи
medicationRequest.division.locationobjectМісцеположення відділення
medicationRequest.division.location.latitudefloatШирота
medicationRequest.division.location.longitudefloatДовгота
medicationRequest.division.namestringНазва відділення
medicationRequest.division.phoneslist[object]Містить параметри номерів телефона
medicationRequest.division.phones.numberstringНомер телефона
medicationRequest.division.phones.typestringТип телефона
medicationRequest.division.typestringТип відділення
medicationRequest.division.working_hoursobjectМістить інформацію про робочий час відділення
medicationRequest.division.working_hours.monarrayРобочий час у понеділок
medicationRequest.division.working_hours.tuearrayРобочий час у вівторок
medicationRequest.division.working_hours.wedarrayРобочий час в середу
medicationRequest.division.working_hours.thuarrayРобочий час у четвер
medicationRequest.division.working_hours.friarrayРобочий час у п'ятницю
medicationRequest.dosage_instructionlist[object]Містить інструкцію по дозуванню ліків
medicationRequest.dosage_instruction.
max_dose_per_administration		objectМістить інформацію про максимальне дозування за прийом
medicationRequest.dosage_instruction.
max_dose_per_administration.code		stringКод дозування
medicationRequest.dosage_instruction.
max_dose_per_administration.system		stringСистема з якої беруться параметри
medicationRequest.dosage_instruction.
max_dose_per_administration.unit		stringОдиниця виміру дозування
medicationRequest.dosage_instruction.
max_dose_per_administration.value		floatЗначення дозування
medicationRequest.dosage_instruction.
max_dose_per_period		objectМістить інформацію про максимальне дозування за період
medicationRequest.dosage_instruction.
max_dose_per_period.denominator		objectМістить параметри періоду дозування
medicationRequest.dosage_instruction.
max_dose_per_period.denominator.code		stringКод періоду
medicationRequest.dosage_instruction.
max_dose_per_period.denominator.system		stringСистема з якої беруться параметри
medicationRequest.dosage_instruction.
max_dose_per_period.denominator.unit		stringОдиниця виміру періоду
medicationRequest.dosage_instruction.
max_dose_per_period.denominator.value		integerЗначення періоду
medicationRequest.dosage_instruction.
max_dose_per_period.numerator		objectМістить параметри дозування за період
medicationRequest.dosage_instruction.
max_dose_per_period.numerator.code		stringКод дозування
medicationRequest.dosage_instruction.
max_dose_per_period.numerator.system		stringСистема з якої беруться параметри
medicationRequest.dosage_instruction.
max_dose_per_period.numerator.unit		stringОдиниця виміру дозування
medicationRequest.dosage_instruction.
max_dose_per_period.numerator.value		integerЗначення дозування
medicationRequest.dosage_instruction.sequenceintegerКод послідовності прийому ліків
medicationRequest.dosage_instruction.textstringТекстовий опис послідовності прийому ліків
medicationRequest.employeeobjectПараметри працівника
medicationRequest.employee.idstring
medicationRequest.employee.partyobject
medicationRequest.employee.party.first_namestringІм'я працівника
medicationRequest.employee.party.idstring
medicationRequest.employee.party.last_namestringПрізвище працівника
medicationRequest.employee.party.phoneslist[object]Містить номера телефонів працівника
medicationRequest.employee.party.phones.numberstringНомер телефона працівника
medicationRequest.employee.party.phones.typestringТип телефона
medicationRequest.employee.party.second_namestringПо батькові працівника
medicationRequest.employee.positionstringПосада працівника
medicationRequest.ended_atstring
medicationRequest.idstring
medicationRequest.intentstringНамір
medicationRequest.legal_entityobjectПараметри юридичної особи
medicationRequest.legal_entity.accreditationstringАкредитація
medicationRequest.legal_entity.edrpoustringЄДРПОУ
medicationRequest.legal_entity.idstring
medicationRequest.legal_entity.licenseslist[object]Параметри ліцензії
medicationRequest.legal_entity.licenses.active_from_datestringДата з якої ліцензія активна
medicationRequest.legal_entity.licenses.expiry_datestringДата закінчення терміну дії ліцензії
medicationRequest.legal_entity.licenses.issued_bystringКим видана ліцензія
medicationRequest.legal_entity.licenses.issued_datestringДата видачі ліцензії
medicationRequest.legal_entity.licenses.license_numberstringНомер ліцензії
medicationRequest.legal_entity.licenses.order_nostringНомер замовлення
medicationRequest.legal_entity.licenses.what_licensedstringТип ліцензії
medicationRequest.legal_entity.namestringТип власності
medicationRequest.legal_entity.public_namestringЗагальне ім'я відділення
medicationRequest.legal_entity.short_namestringКоротке ім'я відділення
medicationRequest.legal_entity.statusstringПоточний статус відділення
medicationRequest.legal_entity.typestringТип відділення
medicationRequest.medical_programobjectПараметри медичної програми
medicationRequest.medical_program.idstringІдентифікатор медичної програми
medicationRequest.medical_program.namestringНазва медичної програми
medicationRequest.medical_program.medical_program_settingsobjectНалаштування медичної програми
medicationRequest.medical_program.
medical_program_settings.multi_medication_dispense_allowed
medicationRequest.medical_program.
medical_program_settings.skip_contract_provision_verify
medicationRequest.medical_program.
medical_program_settings.skip_medication_dispense_sign
medicationRequest.medication_infoobjectМістить інформацію про ліки
medicationRequest.medication_info.dosageobjectМістить інформацію про лікарську форму ліків
medicationRequest.medication_info.dosage.denumerator_unitstringОдиниця виміру лікарської форми
medicationRequest.medication_info.dosage.denumerator_valuefloatЗначення лікарської форми
medicationRequest.medication_info.dosage.numerator_unitstringОдиниця виміру дозування
medicationRequest.medication_info.dosage.numerator_valuefloatЗначення виміру дозування
medicationRequest.medication_info.formstringТип пакування ліків
medicationRequest.medication_info.medication_idstringІдентифікатор ліків
medicationRequest.medication_info.medication_namestringПовна назва ліків
medicationRequest.medication_info.medication_qtyintegerКількість ліків
medicationRequest.medication_info.medication_total_qtyintegerЗагальна кількість ліків
medicationRequest.medication_info.medication_remaining_qtyintegerКількість ліків яка є в наявності
medicationRequest.personobjectПараметри клієнта
medicationRequest.person.ageintegerВік клієнта
medicationRequest.person.idstringІдентифікатор клієнта
medicationRequest.person.short_namestringКоротке ім'я клієнта
medicationRequest.request_numberstringНомер рецепта
medicationRequest.started_atstringДата початку дії рецепта
medicationRequest.statusstringПоточний статус рецепта
participantslist[object]
participants.consumer_pricefloatСпоживча ціна
participants.container_dosageobject
participants.container_dosage.denumerator_unitstring
participants.container_dosage.denumerator_valueinteger
participants.container_dosage.numerator_unitstring
participants.container_dosage.numerator_valueinteger
participants.end_datestring
participants.estimated_payment_amountfloat
participants.formstringЛікарська форма
participants.idstring
participants.manufacturerobjectПараметри виробника ліків
participants.manufacturer.countrystringКраїна виробник ліків
participants.manufacturer.namestringНазва виробника ліків
participants.medication_idstringІдентифікатор ліків
participants.medication_namestringНазва ліків
participants.package_min_qtyintegerМінімальна кількість ліків в пакуванні
participants.package_qtyintegerКількість ліків в пакуванні
participants.registry_numberstringНомер наказу МОЗ
participants.reimbursement_amountfloat
participants.reimbursement_daily_dosagefloat
participants.start_datestring
participants.wholesale_pricefloatОптова ціна

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

200 OK

Успішна відповідь: /medication/get-data/
{
    "data": {
        "skip_sign": false,
        "multi_medication_dispense_allowed" : false,
        "skip_contract_provision_verify" : false,
        "medicationRequest": {
            "category": "community",
            "created_at": "2019-08-05",
            "dispense_valid_from": "2019-08-05",
            "dispense_valid_to": "2019-09-04",
            "division": {
                "addresses": [{
                    "apartment": null,
                    "area": "РІВНЕНСЬКА",
                    "building": "18",
                    "country": "UA",
                    "region": "МЛИНІВСЬКИЙ",
                    "settlement": "МЛИНІВ",
                    "settlement_id": "b334e641-558b-4e06-b539-71a244dc470c",
                    "settlement_type": "TOWNSHIP",
                    "street": "Степана Бандери",
                    "street_type": "STREET",
                    "type": "RESIDENCE",
                    "zip": "35100"
                }],
                "email": "[email protected]",
                "external_id": "036596-48-62",
                "id": "5262396d-993e-4f6e-a7f9-d4660aa8e8e6",
                "legal_entity_id": "ede2b18c-1ffe-4c4f-bacc-7c35a870bffe",
                "location": {
                    "latitude": 50.5137987,
                    "longitude": 25.589175
                },
                "name": "Амбулаторія",
                "phones": [{
                    "number": "+380123456789",
                    "type": "LAND_LINE"
                }],
                "type": "AMBULANT_CLINIC",
                "working_hours": {
                    "mon": [[
                        "08.00",
                        "20.00"
                    ]],
                    "tue": [[
                        "08.00",
                        "20.00"
                    ]],
                    "wed": [[
                        "08.00",
                        "20.00"
                    ]],
                    "thu": [[
                        "08.00",
                        "20.00"
                    ]],
                    "fri": [[
                        "08.00",
                        "20.00"
                    ]]
                }
            },
            "dosage_instruction": [{
                "max_dose_per_administration": {
                    "code": "MG",
                    "system": "eHealth/ucum/units",
                    "unit": "MG",
                    "value": 0.5
                },
                "max_dose_per_period": {
                    "denominator": {
                        "code": "day",
                        "system": "eHealth/ucum/units",
                        "unit": "day",
                        "value": 1
                    },
                    "numerator": {
                        "code": "MG",
                        "system": "eHealth/ucum/units",
                        "unit": "MG",
                        "value": 1
                    }
                },
                "sequence": 1,
                "text": "По 1 т. 2 р/д під язик"
            }],
            "employee": {
                "id": "04ee251d-11b8-42eb-b66e-d4abe2d1d3e5",
                "party": {
                    "first_name": "Вячеслав",
                    "id": "978bee80-92f9-450d-acd9-54892f283462",
                    "last_name": "Вячеславов",
                    "phones": [{
                        "number": "+380123456789",
                        "type": "MOBILE"
                    }],
                    "second_name": "Вячеславович"
                },
                "position": "P7"
            },
            "ended_at": "2019-09-04",
            "id": "a983b524-3435-48a9-972d-0d20352df081",
            "intent": "order",
            "legal_entity": {
                "accreditation": null,
                "edrpou": "100500",
                "id": "ede2b18c-1ffe-4c4f-bacc-7c35a870bffe",
                "licenses": [{
                    "active_from_date": "2018-09-13",
                    "expiry_date": null,
                    "issued_by": "МОЗ України",
                    "issued_date": "2018-09-13",
                    "license_number": "№100500",
                    "order_no": "№100500",
                    "what_licensed": "Медична практика"
                }],
                "name": "Комунальне некомерційне підприємство",
                "public_name": null,
                "short_name": "КНП \"МЦ ПМСД\"",
                "status": "ACTIVE",
                "type": "MSP"
            },
            "medical_program": {
                "id": "63c1f32f-c8f4-4f5b-81a9-79b8452d6545",
                "name": "Доступні ліки",
                "medical_program_settings": {
                    "multi_medication_dispense_allowed": null,
                    "skip_contract_provision_verify": null,
                    "skip_medication_dispense_sign": null
                }
            },
            "medication_info": {
                "dosage": {
                    "denumerator_unit": "PILL",
                    "denumerator_value": 1,
                    "numerator_unit": "MG",
                    "numerator_value": 0.5
                },
                "form": "SUBLINGVAL_TABLET",
                "medication_id": "c93a1df0-df37-4bd7-a3b4-669da3343454",
                "medication_name": "Нітрогліцерин 0.5 MG таблетки сублінгвальні ",
                "medication_qty": 80,
                "medication_total_qty": 80,
                "medication_remaining_qty": 80
            },
            "person": {
               "age": 61,
               "id": "aa8cbd9b-adea-403f-8c1e-be34bcf70f66",
               "short_name": "Лащук В. С."
            },
            "request_number": "0000-316H-546H-EK3H",
            "started_at": "2019-08-05",
            "status": "ACTIVE",
        },
        "participants": [
            {
                "consumer_price": 47.1,
                "container_dosage": {
                    "denumerator_unit": "PILL",
                    "denumerator_value": 1,
                    "numerator_unit": "MG",
                    "numerator_value": 1000
                },
                "end_date": "2021-09-09",
                "estimated_payment_amount": 14.44,
                "form": "TABLET",
                "id": "e39c8211-7a7f-4159-a6b5-cb472e9616d2",
                "manufacturer": {
                    "country": " Індія",
                    "name": "Санофі Індія Лімітед "
                },
                "medication_id": "1c4576bb-f673-423d-b05e-805f8edb2040",
                "medication_name": "МЕТФОРМІН-САНОФІ",
                "package_min_qty": 30,
                "package_qty": 30,
                "registry_number": "Наказ МОЗ № 251",
                "reimbursement_amount": 32.66,
                "reimbursement_daily_dosage": 2.17,
                "start_date": "2021-02-16",
                "wholesale_price": 34.8
            },
        ]
    }
}

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

Помилка eHealth​

422 Unprocessable Entity (WebDAV) (RFC 4918)

Неуспішна відповідь: /medication/get-data/
{
    "errors": {
    "eHealth": "...ehealth error text..."
    }
}