/medication/create-reject | СКАРБ Cloud

Створити відхилення рецепта

URI: /medication/create-reject

Використовується для створення відхилення рецепта.

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

Заголовки

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

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

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

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

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

Ім'я	Тип	Обов'язковий	Опис
id	string	Так	Ідентифікатор рецепта в uuid форматі
reasonCode	object	Так	Код причини відхилення рецепта отриманий запитом `/get-reject-reasons`
reasonText	string	Ні	Текст причини відхилення рецепта, обов'язковий тільки для reasonCode = OTHER

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

Запит: /medication/create-and-send-reject
{
    "id": "d31135d1-17c0-4dd5-83bf-68385e964fbf",
    "reasonCode": "OTHER",
    "reasonText": "причина відхилення"
}

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

Ім'я	Тип	Опис
category	string
context	object
context.identifier	object
context.identifier.type	object
context.identifier.type.coding	list[object]
context.identifier.type.coding.code	string
context.identifier.type.coding.system	string
context.identifier.value	string
created_at	string	Дата створення рецепта
dispense_valid_from	string	Дата з якого дозволений відпуск ліків
dispense_valid_to	string	Дата до якої дозволений відпуск ліків
dosage_instruction	list[object]	Містить інструкцію по дозуванню ліків
dosage_instruction. max_dose_per_administration	object	Містить інформацію про максимальне дозування за прийом
dosage_instruction. max_dose_per_administration.code	string	Код дозування
dosage_instruction. max_dose_per_administration.system	string	Система з якої беруться параметри
dosage_instruction. max_dose_per_administration.unit	string	Одиниця виміру дозування
dosage_instruction. max_dose_per_administration.value	integer	Значення дозування
dosage_instruction.max_dose_per_period	object	Містить інформацію про максимальне дозування за період
dosage_instruction. max_dose_per_period.denominator	object	Містить параметри періоду дозування
dosage_instruction. max_dose_per_period.denominator.code	string	Код періоду
dosage_instruction. max_dose_per_period.denominator.system	string	Система з якої беруться параметри
dosage_instruction. max_dose_per_period.denominator.unit	string	Одиниця виміру періоду
dosage_instruction. max_dose_per_period.denominator.value	integer	Значення періоду
dosage_instruction. max_dose_per_period.numerator	object	Містить параметри дозування за період
dosage_instruction. max_dose_per_period.numerator.code	string	Код дозування
dosage_instruction. max_dose_per_period.numerator.system	string	Система з якої беруться параметри
dosage_instruction. max_dose_per_period.numerator.unit	string	Одиниця виміру дозування
dosage_instruction. max_dose_per_period.numerator.value	integer	Значення дозування
dosage_instruction.sequence	string	Код послідовності прийому ліків
dosage_instruction.text	string	Текстовий опис послідовності прийому ліків
ended_at	string	Дата закінчення дії рецепта
id	string	Ідентифікатор рецепта в форматі uuid
intent	string	Намір
is_blocked	boolean	Признак заблокованого рецепта
medical_program	object	Параметри медичної програми
medical_program.funding_source	string	Джерело фінансування
medical_program.id	string	Ідентифікатор медичної програми
medical_program.mr_blank_type	string	Тип бланка
medical_program.name	string	Назва бланка
medication_info	object	Містить інформацію про ліки
medication_info.dosage	object	Містить інформацію про лікарську форму ліків
medication_info.dosage. denumerator_unit	string	Одиниця виміру лікарської форми
medication_info.dosage. denumerator_value	integer	Значення лікарської форми
medication_info.dosage. numerator_unit	string	Одиниця виміру дозування
medication_info.dosage. numerator_value	integer	Значення виміру дозування
medication_info.form	string	Тип пакування ліків
medication_info.ingredients	list [object]	Містить перелік інгредієнтів ліків
medication_info.ingredients.dosage	object	Містить параметри дозування ліків
medication_info.ingredients. dosage.denumerator_unit	string	Одиниця виміру лікарської форми
medication_info.ingredients. dosage.denumerator_value	integer	Значення лікарської форми
medication_info.ingredients. dosage.numerator_unit	string	Одиниця виміру дозування
medication_info.ingredients. dosage.numerator_value	integer	Значення дозування
medication_info.ingredients.id	string	Ідентифікатор інгредієнта
medication_info.ingredients.is_primary	boolean	Признак основного інгредієнта
medication_info.ingredients.name	string	Назва інгредієнта
medication_info.ingredients. name_original	string	Назва інгредієнта в оригіналі
medication_info.ingredients.sctid	null	ТКІД
medication_info.medication_id	string	Ідентифікатор ліків
medication_info.medication_name	string	Повна назва ліків
medication_info.medication_qty	integer	Кількість ліків
medication_info. medication_remaining_qty	integer	Кількість ліків яка є в наявності
person	object	Інформація про клієнта
person.age	integer	Вік
person.short_name	string	Коротке ім'я клієнта
request_number	string	Номер рецепта
started_at	string	Дата початку дії рецепта
status	string	Поточний статус рецепта
reject_reason_code	string	Код причини відхилення рецепта
reject_reason	string	Текст причини відхилення рецепта

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

200 OK

Відповідь: /medication/create-and-send-reject
{
    "data": {
        "category": "community",
        "context": {
            "identifier": {
                "type": {
                    "coding": [
                        {
                            "code": "encounter",
                            "system": "eHealth/resources"
                        }
                    ]
                },
                "value": "165e0c64-2475-4aec-9ae3-a062add2622a"
            }
        },
        "created_at": "2023-05-25",
        "dispense_valid_from": "2023-05-25",
        "dispense_valid_to": "2023-06-24",
        "dosage_instruction": [
            {
                "max_dose_per_administration": {
                    "code": "MG",
                    "system": "eHealth/ucum/units",
                    "unit": "MG",
                    "value": 20
                },
                "max_dose_per_period": {
                    "denominator": {
                        "code": "day",
                        "system": "eHealth/ucum/units",
                        "unit": "доба",
                        "value": 1
                    },
                    "numerator": {
                        "code": "MG",
                        "system": "eHealth/ucum/units",
                        "unit": "MG",
                        "value": 20
                    }
                },
                "sequence": 1,
                "text": "1 таб. 1 раз на добу"
            }
        ],
        "ended_at": "2023-08-23",
        "id": "6fbd3e4c-5191-47ee-81c4-58cd65d00185",
        "intent": "order",
        "is_blocked": false,
        "medical_program": {
            "funding_source": "PERSON",
            "id": "1318eabc-1a1a-42f6-8450-61e11c19eede",
            "mr_blank_type": "F-1",
            "name": "рецептарні лікарські засоби"
        },
        "medication_info": {
            "dosage": {
                "denumerator_unit": "PIECE",
                "denumerator_value": 1,
                "numerator_unit": "MG",
                "numerator_value": 20
            },
            "form": "MODIFIED-RELEASE_CAPSULE",
            "ingredients": [
                {
                    "dosage": {
                        "denumerator_unit": "PIECE",
                        "denumerator_value": 1,
                        "numerator_unit": "MG",
                        "numerator_value": 20
                    },
                    "id": "405a19ff-c172-40eb-8dd4-86ccc545f7aa",
                    "is_primary": true,
                    "name": "омепразол",
                    "name_original": "omeprazole",
                    "sctid": null
                },
                {
                    "dosage": {
                        "denumerator_unit": "PIECE",
                        "denumerator_value": 1,
                        "numerator_unit": "MG",
                        "numerator_value": 30
                    },
                    "id": "427a8329-c5ee-44ec-8d4b-fd80bef81351",
                    "is_primary": true,
                    "name": "домперидон",
                    "name_original": "domperidone",
                    "sctid": null
                }
            ],
            "medication_id": "02b79142-85da-4f30-9535-bc2519db5f87",
            "medication_name": "омепразол 20 мг, домперидон 30 мг, капсули з модифікованим вивільненням",
            "medication_qty": 20,
            "medication_remaining_qty": 20
        },
        "person": {
            "age": 23,
            "short_name": "Артеменко А."
        },
        "request_number": "0000-HAK2-A71H-PEMA",
        "started_at": "2023-05-25",
        "status": "ACTIVE",
        "reject_reason_code": "OTHER",
        "reject_reason": "тест"
    }
}

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

Відхилений

422 Unprocessable Entity (WebDAV) (RFC 4918)

Відповідь: /medication/create-and-send-reject
{
    "errors": {
        "eHealth": "Відхилений: OTHER: тест ііі",
        "message": "Відхилений: OTHER: тест ііі"
    }
}

Не заповнений код відхилення

422 Unprocessable Entity (WebDAV) (RFC 4918)

Відповідь: /medication/create-and-send-reject
{
    "errors": {
        "reasonCode": "reasonCode: Обязательно к заполнению",
        "message": "reasonCode: Обязательно к заполнению"
    }
}

Код відхилення рецепта відсутній у довіднику

422 Unprocessable Entity (WebDAV) (RFC 4918)

Відповідь: /medication/create-and-send-reject
{
    "errors": {
        "reasonCode": "reasonCode: Код відхилення рецепта відсутній у довіднику",
        "message": "reasonCode: Код відхилення рецепта відсутній у довіднику"
    }
}

Створити відхилення рецепта​

Заголовки​

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

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

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

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

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

Відхилений​

Не заповнений код відхилення​

Код відхилення рецепта відсутній у довіднику​

Створити відхилення рецепта

Заголовки

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

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

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

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

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

Відхилений

Не заповнений код відхилення

Код відхилення рецепта відсутній у довіднику