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

Отримання всіх необроблених замовлень

URI: /api/v1/marketplace/order?status={status}

Метод використовується для отримання всіх не оброблених замовлень.

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

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

Параметри URI

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

Ім'яТипОбов'язковийОпис
statusstringНіСтатус замовлення:
  • created - передано в обробку
  • canceled_by_marketplace - скасування з площадки
  • check_by_online_site - продано через онлайн сайт

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

/api/v1/marketplace/order?status=created

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

Ім'яТипОпис
datalist[object]Дані замовлень
data.order_numberstringНомер замовлення
data.order_number_for_customerstringНомер замовлення для покупця
data.drugstore_order_idstringНомер замовлення аптеки
data.online_marketplace_order_codestringНомер замовлення онлайн площадки
data.fiscal_numberstringФіскальний номер чека продажу, присвоєний фіскальним реєстратором (ПРРО / РРО) або програмним забезпеченням
🛈 Присутній, якщо замовлення було успішно фіскалізовано
data.refund_fiscal_numberstringФіскальний номер чека повернення, присвоєний фіскальним реєстратором (ПРРО / РРО)
🛈 Присутній, якщо по замовленню була здійснена операція повернення коштів
data.order_deliveryobjectДані доставки
data.order_delivery.delivery_type_codestringКод типу доставки
data.order_delivery.ttnstringНомер ТТН
data.order_paymentobjectДані про оплату замовлення
data.order_payment.payment_method_codestringКод методу оплати
data.order_payment.total_paidfloatЗагальна оплачена сума
data.order_payment.terminal_idstringІдентифікатор термінала
data.order_payment.epzstringЕлектронний платіжний засіб
data.order_payment.midstringМерчант id
data.order_payment.card_typestringТип карти
data.order_payment.auth_codestringКод авторизації
data.order_payment.rrnstringУнікальний ідентифікатор банківської транзакції, який призначається банком Еквайєром під час ініціалізації платежу
data.order_payment.datetimestringДата та час операції у форматі: 2025-04-04 15:49:03
data.order_payment.namestringТип оплати
data.order_payment.payment_systemstringПлатіжна система
data.order_payment.cash_register_numberstringНомер касового апарату
data.pick_up_codestringНомер замовлення для видачі кур'єру
data.created_atstringДата і час створення замовлення
data.updated_atstringДата і час останнього оновлення замовлення
data.drugstoreobjectДані аптеки
data.drugstore.idstringУнікальний ідентифікатор аптеки аптечної мережі
data.drugstore.namestringНазва аптеки
data.drugstore.addressstringАдреса аптеки
data.sourceobjectНазва і код площадки, з якої поступило замовлення:
  • all - *
  • tabletki.ua - tabletki
  • aptekaskarb.ua - aptekaskarb
  • liki24.com - liki24
  • apteki.ua - geoapteka
  • glovoapp.com - glovo
  • telegram.org - telegram
  • own site - own
  • zdorovi.ua - zdorovi
  • atb.ua - atb
  • liki.ua - liki
  • viber.com - viber
  • helsi.me - helsi
data.source.namestringНазва площадки
data.source.codestringКод площадки
data.customerobjectДані покупця
data.customer.phone_numberstringНомер телефона покупця
data.customer.last_namestringПрізвище покупця
data.customer.first_namestringІм'я покупця
data.customer.middle_namestringПо-батькові покупця
data.customer.emailstringЕлектронна адреса покупця
data.customer.edrpoustringЄДРПОУ покупця
data.customer.insurance_card_numberstringНомер страхового полісу
data.customer.franchising_percentagenumericФраншиза
data.insuranceobjectДані страхової компанії
data.insurance.namestringНазва
data.insurance.codestringКод ЄДРПОУ
data.insurance.order_numberstringНомер замовлення
data.sales_agentobjectДані користувача який продав товар (якщо це користувач аптеки)
data.sales_agent.first_namestringІм'я
data.sales_agent.last_namestringПрізвище
data.sales_agent.middle_namestringПо-батькові
data.sales_agent.phonestringНомер телефона
data.doctorobjectДані лікаря
data.doctor.idstringІдентифікатор лікаря аптечної мережі
data.doctor.namestringПовне ім'я лікаря (ПІБ)
data.online_drugstore_sitestringДжерело замовлення
data.statusobjectСтатус замовлення
data.status.commentstringНазва статусу
data.status.namestringКод статусу
data.commentstringКоментар до замовлення
data.cancel_reasonstringПричина відмови
data.goodslist[object]Перелік товарів
data.goods.namestringНазва товару
data.goods.goods_idstringІдентифікатор товару
data.goods.goods_idsstringСписок ідентифікаторів товару (може містити один або кілька ID)
data.goods.preorderbooleanПрапорець, що вказує, чи є замовлення попереднім замовленням:
  • true — попереднє замовлення
  • false — ні
  • data.goods.quantitynumericКількість товару
    data.goods.pricenumericВартість одиниці товару
    data.goods.totalnumericЗагальна вартість товару
    data.goods.batchstringІдентифікатор партії товару
    data.goods.customer_bonusfloatСума бонусів, нарахована клієнту за всю позицію товару (у грн.)
    data.goods.customer_discountfloatСума знижки (у грн.), застосована до всієї позиції товару (загальна знижка, а не знижка за одиницю)
    data.goods.customer_paid_by_bonusfloatСума оплачена бонусами за позицію товару (у грн.)
    data.totalnumericЗагальна вартість замовлення
    data.total_include_franchising_percentagenumericЗагальна вартість замовлення з урахуванням франшизи

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

    200 OK

    Відповідь: /api/v1/marketplace/order?status=created
    {
    "data": [
    {
    "order_number": "58-63-72-43",
    "order_number_for_customer": "123456",
    "drugstore_order_id": "56699",
    "online_marketplace_order_code": "107613858",
    "fiscal_number": "123-HY",
    "refund_fiscal_number": "123-HYR",
    "order_delivery": {
    "delivery_type_code": "PickUp",
    "ttn": "123456"
    },
    "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",
    "cash_register_number": "001A"
    },
    "pick_up_code": "123",
    "created_at": "2021-04-14 17:25:54",
    "updated_at": "2021-04-14 17:25:54",
    "drugstore": {
    "id": "255",
    "name": "Аптека №Дн050",
    "address": "Кіровоградська область, м.Кропивницький, вул.Соборна, 27б"
    },
    "source": {
    "name": "apteki.ua",
    "code": "geoapteka"
    },
    "customer": {
    "phone_number": "380000000000",
    "last_name": "TEST",
    "first_name": "TEST",
    "middle_name": "TEST",
    "email": "[email protected]",
    "edrpou": "67859302"
    },
    "sales_agent": {
    "first_name": "test",
    "last_name": "test",
    "middle_name": "test",
    "phone": "380111111111"
    },
    "doctor": {
    "id": "123",
    "name": "Іванов Степан Вікторович"
    },
    "online_drugstore_site": "apteka-tas.com.ua",
    "status": {
    "comment": "Передан в обработку",
    "name": "created"
    },
    "comment": "ЭТО ТЕСТОВЫЙ ЗАКАЗ",
    "cancel_reason": null,
    "goods": [
    {
    "name": "Ергоферон табл.№20",
    "goods_id": "003ba928-16fe-4f6b-a751-747c645bd19a",
    "goods_ids": [
    "003ba928-16fe-4f6b-a751-747c645bd19a"
    ],
    "preorder": false,
    "quantity": 1,
    "price": 329.5,
    "total": 329.5,
    "batch": "59436ffd-b3b9-11f0-9026-005056962e80",
    "customer_bonus": 3.3,
    "customer_discount": 0,
    "customer_paid_by_bonus": 10
    }
    ],
    "total": 77.5,
    "total_include_franchising_percentage": 38.75
    }
    ]
    }