Створення замовлення за ehealth рецептом

URI: /api/v1/online-drugstore/order/store-e-health-recipe-pick-up-order

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

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

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

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

Ім'я	Тип	Обов'язковий	Опис
customer_first_name	string	Так	Ім'я покупця
customer_last_name	string	Так	Прізвище покупця
customer_phone_number	string	Так	Номер телефону покупця
customer_email	string	Ні	Електронна адреса покупця
drugstore_id	numeric	Так	Ідентифікатор аптеки
total	numeric	Так	Загальна сума по замовленню
goods_id	numeric	Так	Ідентифікатор товарів
recipe_number	string	Так	Номер рецепта
delivery	object	Ні	Дані доставки
delivery.delivery_type_code	string	Ні	Код типу доставки: pick_up - Самовивіз ukr_post - Укрпошта nova_post - Нова Пошта meest_express - Meest Express justin - Justin uklon - Uklon i_post - iPost
delivery.ettn	string	Ні	Номер ТТН
delivery.postcode	string	Ні	Поштовий індекс отримувача
delivery.city	string	Ні	Місто отримувача
delivery.region	string	Ні	Область отримувача
delivery.district	string	Ні	Район отримувача
delivery.street	string	Ні	Вулиця отримувача
delivery.house_number	string	Ні	Номер будинку отримувача
delivery.apartment_number	string	Ні	Номер квартири отримувача
delivery.post_office_box	string	Ні	Номер поштової скриньки отримувача
payment	object	Ні	Дані про оплату замовлення
payment.payment_method_code	string	Ні	Код типу оплати: liq_pay - оплата карткою на сайті cash_on_delivery - оплата при отриманні товару cash_in_store - оплата в аптеці карткою або готівкою google_pay - оплата за допомогою Google Pay
payment.total_paid	float	Ні	Загальна оплачена сума
payment.terminal_id	string	Ні	Ідентифікатор термінала
payment.epz	string	Ні	Електронний платіжний засіб
payment.mid	string	Ні	Мерчант id
payment.card_type	string	Ні	Тип карти
payment.auth_code	string	Ні	Код авторизації
payment.rrn	string	Ні	Унікальний ідентифікатор банківської транзакції, який призначається банком Еквайєром під час ініціалізації платежу
payment.datetime	string	Ні	Дата та час операції у форматі: 2025-04-04 15:49:03
payment.name	string	Так	Тип оплати
payment.payment_system	string	Ні	Платіжна система

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

Запит: /api/v1/online-drugstore/order/store-e-health-recipe-pick-up-order

[
    {
        "customer_first_name": "TEST",
        "customer_last_name": "TEST",
        "customer_phone_number": "380000000000",
        "customer_email": "[email protected]",
        "drugstore_id": 17,
        "total": 0,
        "goods_id": 1791949,
        "recipe_number": "0000-TT98-X344-0AMK",
        "delivery": {
            "delivery_type_code": "PickUp",
            "ettn": "123456789",
            "postcode": "12345",
            "city": "Київ",
            "region": "Київська обл",
            "district": "Святошинський",
            "street": "Братиславська",
            "house_number": "11",
            "apartment_number": "145",
            "post_office_box": "1245"
        },
        "payment": {
            "payment_method_code": "LiqPay",
            "total_paid": 123.09,
            "terminal_id": "40904582",
            "epz": "4149XXXXXXXX5807",
            "mid": "493084867", 
            "card_type": "VISA GOLD",
            "auth_code": "538296",
            "rrn": "000018706638",
            "datetime": "2025-04-04 15:49:03",
            "name": "KARTKA",
            "payment_system": "Test pay system"
        },
    }
]

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

Ім'я	Тип	Опис
data	object	Дані замовлення
data.order_number	string	Номер замовлення
data.order_delivery	object	Дані доставки
data.order_delivery.delivery_type_code	string	Код типу доставки
data.order_delivery.ttn	string	Номер ТТН
delivery.delivery_type_code	string	Код типу доставки: pick_up - Самовивіз ukr_post - Укрпошта nova_post - Нова Пошта meest_express - Meest Express justin - Justin uklon - Uklon i_post - iPost
data.order_delivery.ettn	string	Номер ТТН
data.order_delivery.postcode	string	Поштовий індекс отримувача
data.order_delivery.city	string	Місто отримувача
data.order_delivery.region	string	Область отримувача
data.order_delivery.district	string	Район отримувача
data.order_delivery.street	string	Вулиця отримувача
data.order_delivery.house_number	string	Номер будинку отримувача
data.order_delivery.apartment_number	string	Номер квартири отримувача
data.order_delivery.post_office_box	string	Номер поштової скриньки отримувача
data.order_data.order_payment	object	Дані про оплату замовлення
data.order_payment.payment_method_code	string	Код типу оплати: liq_pay - оплата карткою на сайті cash_on_delivery - оплата при отриманні товару cash_in_store - оплата в аптеці карткою або готівкою google_pay - оплата за допомогою Google Pay
data.order_payment.total_paid	float	Загальна оплачена сума
data.order_payment.terminal_id	string	Ідентифікатор термінала
data.order_payment.epz	string	Електронний платіжний засіб
data.order_payment.mid	string	Мерчант id
data.order_payment.card_type	string	Тип карти
data.order_payment.auth_code	string	Код авторизації
data.order_payment.rrn	string	Унікальний ідентифікатор банківської транзакції, який призначається банком Еквайєром під час ініціалізації платежу
data.order_payment.datetime	string	Дата та час операції у форматі: 2025-04-04 15:49:03
data.order_payment.name	string	Тип оплати
data.order_payment.payment_system	string	Платіжна система
data.order_number_for_customer	string	Номер замовлення для покупця
data.drugstore_order_id	string	Ідентифікатор замовлення для аптеки
data.created_at	string	Дата і час створення замовлення
data.updated_at	string	Дата і час останнього оновлення замовлення
data.export_source	object	Дані про експортування замовлення
data.export_source.label	string	Назва місця експортування замовлення
data.export_source.datetime	string	Дата експортування замовлення
data.status_history	list[object]	Історія статусу замовлення
data.status_history.code	string	Код статусу замовлення
data.status_history.label	string	Текстовий опис статусу
data.status_history.datetime	string	Дата і час формування статусу
data.export_expired	boolean	Ознака закінчення терміну для експорту замовлення (15 хв)
data.delivery_type	string	Тип доставки
data.customer_phone_number	string	Номер телефону покупця
data.customer_last_name	string	Прізвище покупця
data.customer_first_name	string	Ім'я покупця
data.customer_middle_name	string	По батькові покупця
data.comment	string	Коментар
data.internal_comment	string	Внутрішній коментар
data.source	array	Назва і код площадки, з якої надійшло замовлення: doc.ua - doc glovoapp.com - glovo telegram.org - telegram zdorovi.ua - zdorovi own site - own all - * atb.ua - atb liki.ua - liki viber.com - viber doko.ua - doko poisklekarstv - poisklekarstv aptekaskarb.ua - aptekaskarb tabletki.ua - tabletki apteki.ua - geoapteka medbrowse.com.ua - medbrowse liki24.com - liki24 mypharmacy.com.ua - mypharmacy
data.drugstore_id	numeric	Ідентифікатор аптеки
data.ext_drugstore_id	string	Зовнішній ідентифікатор аптеки
data.drugstore_name	string	Назва аптеки
data.address	string	Адреса аптеки
data.drugstore_phone	string	Номер телефону аптеки
data.drugstore_mobile_phone	string	Номер мобільного телефону аптеки
data.drugstore_email	string	Адреса електронної пошти аптеки
data.latitude	string	Координати аптеки (Широта)
data.longitude	string	Координати аптеки (Довгота)
data.total	numeric	Сума замовлення
data.status_comment	string	Поточний статус замовлення
data.status_name	string	Код поточного статусу замовлення
data.cancel_reason	string	Причина відмови
data.progress	object	Прогрес виконання замовлення
data.progress.step	numeric	Поточний етап виконання замовлення
data.progress.completed	boolean	Ознака завершення замовлення
data.progress.label	string	Назва етапу
data.goods	list[object]	Перелік товарів
data.goods.goods_id	numeric	Ідентифікатор товарів
data.goods.ext_goods_id	string	Зовнішній ідентифікатор товарів
data.goods.image_url	array	Посилання на зображення товарів
data.goods.morion_id	numeric	Ідентифікатор Моріон
data.goods.name	string	Назва товару
data.goods.producer	string	Виробник товару
data.goods.country	string	Країна виробник
data.goods.country_code	string	Код країни виробника
data.goods.release_form	string	Форма відпуску
data.goods.quantity	numeric	Кількість товару
data.goods.price	numeric	Вартість одиниці товару
data.goods.total	numeric	Загальна вартість
data.goods.comment	string	Коментар
data.initial_goods	list[object]	Початкове положення товарів в замовленні
data.initial_goods.goods_id	numeric	Ідентифікатор товарів
data.initial_goods.ext_goods_id	string	Зовнішній ідентифікатор товарів
data.initial_goods.image_url	array	Посилання на зображення товарів
data.initial_goods.morion_id	numeric	Ідентифікатор Моріон
data.initial_goods.name	string	Назва товару
data.initial_goods.producer	string	Виробник товару
data.initial_goods.country	string	Країна виробник
data.initial_goods.country_code	string	Код країни виробника
data.initial_goods.release_form	string	Форма відпуску
data.initial_goods.quantity	numeric	Кількість товару
data.initial_goods.price	numeric	Вартість одиниці товару
data.initial_goods.total	numeric	Загальна вартість
data.initial_goods.comment	string	Коментар

Статуси замовлень

Статус	Опис
created	Передано в обробку
in_process_by_operator	Обробляється оператором (за наявності кол-центру)
processed_by_operator	Оброблено оператором (за наявності кол-центру)
got_in_pharmacy	Отримано в аптеці
in_process_by_pharmacy	Обробляється в аптеці
processed_by_pharmacy	Оброблено в аптеці
check	Продаж
canceled	Скасування
check_by_online_site	Продано через онлайн сайт
canceled_by_marketplace	Скасування з маркетплейсу (страхові замовлення)

інформація

При запиті про нові замовлення аптека отримуватиме замовлення зі статусами: created, canceled_by_marketplace, check_by_online_site

Аптека може передати наступні статуси: in_process_by_operator, processed_by_operator, got_in_pharmacy, in_process_by_pharmacy, processed_by_pharmacy, check, canceled

При отриманні замовлення в статусі canceled_by_marketplace, аптека повинна у себе скасувати замовлення і відправити статус canceled

При отриманні замовлення в статусі check_by_online_site, аптека повинна у себе відзначити, що замовлення продано і відправити статус check

Необхідно передавати всі статуси в їхній логічній послідовності для детального відстеження замовлення

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

200 OK

Відповідь: /api/v1/online-drugstore/order/store-e-health-recipe-pick-up-order

{
  "data": {
    "order_number": "0000-EM48-1XP7-PT22",
    "order_delivery": {
      "delivery_type_code": "PickUp",
      "ettn": "123456789",
      "postcode": "12345",
      "city": "Київ",
      "region": "Київська обл",
      "district": "Святошинський",
      "street": "Братиславська",
      "house_number": "11",
      "apartment_number": "145",
      "post_office_box": "1245"
    },
    "order_payment": {
       "payment_method_code": "LiqPay",
       "total_paid": 123.09,
       "terminal_id": "40904582",
       "epz": "4149XXXXXXXX5807",
       "mid": "493084867", 
       "card_type": "VISA GOLD",
       "auth_code": "538296",
       "rrn": "000018706638",
       "datetime": "2025-04-04 15:49:03",
       "name": "KARTKA",
       "payment_system": "Test pay system"
    },
    "order_number_for_customer": null,
    "drugstore_order_id": null,
    "created_at": "2023-11-10 16:04:30",
    "updated_at": "2023-11-10 16:04:31",
    "export_source": {
      "label": null,
      "datetime": null
    },
    "status_history": [
      {
        "code": "created",
        "label": "Передан в обработку",
        "datetime": "2023-11-10 16:04:30"
      }
    ],
    "export_expired": false,
    "delivery_type": "DTC_PICKUP",
    "customer_phone_number": "380999808056",
    "customer_last_name": "test",
    "customer_first_name": "test",
    "customer_middle_name": null,
    "comment": null,
    "internal_comment": null,
    "source": null,
    "drugstore_id": 34324,
    "ext_drugstore_id": null,
    "drugstore_name": "Аптека №93  \"Класна Аптека\"",
    "address": "Харківська обл. м. Харків, Донецький 18",
    "drugstore_phone": "380577869340",
    "drugstore_mobile_phone": null,
    "drugstore_email": null,
    "latitude": "49.981894",
    "longitude": "36.241981",
    "total": 0,
    "status_comment": "Передан в обработку",
    "status_name": "created",
    "cancel_reason": null,
    "progress": {
      "step": 1,
      "completed": null,
      "label": "Передан в обработку"
    },
    "goods": [
      {
        "goods_id": 1771822,
        "ext_goods_id": null,
        "image_url": [
          "goods_profile_photo/1771822/gD3h77Tve7zgU4Vd.png"
        ],
        "morion_id": 289655,
        "name": "Бісопрол табл. 5 мг блістер №30 (10х3)",
        "producer": "Фармак",
        "country": "Украина",
        "country_code": "ua",
        "release_form": "табл. 5 мг блистер",
        "quantity": 1,
        "price": 26.59,
        "total": 26.59,
        "comment": null
      }
    ],
    "initial_goods": [
      {
        "goods_id": 1771822,
        "ext_goods_id": null,
        "image_url": [
          "goods_profile_photo/1771822/gD3h77Tve7zgU4Vd.png"
        ],
        "morion_id": 289655,
        "name": "Бісопрол табл. 5 мг блістер №30 (10х3)",
        "producer": "Фармак",
        "country": "Украина",
        "country_code": "ua",
        "release_form": "табл. 5 мг блистер",
        "quantity": 1,
        "price": 26.59,
        "total": 26.59,
        "comment": null
      }
    ]
  }
}