Часткове вивантаження залишків аптеки для попереднього замовлення

URI: /api/v1/marketplace/stock/{drugstoreId}/import/partial?preorder=1

Метод використовується для часткового вивантаження на сервер даних про товари, яких немає в наявності на складі аптеки, але доступні для попереднього замовлення.

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

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

Параметри URI

URI запиту має містити змінну:

Ім'я	Тип	Обов'язковий	Опис
drugstoreId	string	Так	Ідентифікатор аптеки
preorder	boolean	Так	Параметр, що показує, що дане вивантаження містить товари для попереднього замовлення. 🛈 Має містити тільки товари для попереднього замовлення без позицій, доступних в аптеці. Використовуйте значення 1

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

Ім'я	Тип	Обов'язковий	Опис
drugstore_goods_id	string	Так	ID позиції залишку в аптеці (може співпадати з goods_id)
goods_id	string	Так	ID товару яке вивантажено в довіднику аптек
quantity	float	Так	Залишок товару 🛈 Якщо кількість товару невідома або неможливо визначити, слід передавати значення 9999
preorder	boolean	Так	Прапорець, що вказує, чи є товар доступним для попереднього замовлення: true – значення встановлюється за замовчуванням і завжди повинно передаватися як true для товарів попереднього замовлення false — буде записаний як наявний в аптеці залишок. НЕ використовується
delivery_date	string	Ні	Дата очікуваної доставки товару в пункт видачі (торгову точку) в форматі Y-m-d 🛈 У випадку, коли цей параметр не передається, за замовчуванням буде застосовано дату, що на 7 днів пізніше від дати передачі
series	string | null	Ні	Серія товару
expire_date	string | null	Ні	Дата закінчення терміну придатності в форматі Y-m-d
vat	integer	Так	Відсоток ПДВ
online_price_vat	float	Так	Вартість онлайн з ПДВ
drugstore_price_vat	float	Так	Вартість в аптеці з ПДВ

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

Запит: /api/v1/marketplace/stock/255/import/partial

[
    {
        "drugstore_goods_id": "777",
        "goods_id": "17",
        "quantity": 1,
        "preorder": false,
        "delivery_date": "2025-08-01",
        "series": "123123",
        "expire_date": "2021-12-31",
        "vat": 20,
        "online_price_vat": 150,
        "drugstore_price_vat": 160.8,
    },
    {
        "drugstore_goods_id": "555",
        "goods_id": "17",
        "quantity": 0.92,
        "preorder": false,
        "delivery_date": "2025-08-05",
        "series": "123123",
        "expire_date": "2021-12-31",
        "vat": 7,
        "online_price_vat": 154,
        "drugstore_price_vat": 164.8,
    }
]

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

Ім'я	Тип	Опис
data	object	Інформація про імпорт
data.id	integer	Ідентифікатор імпорту
data.status	string	Статус імпорту: NEW - пакет даних прийнято AWAIT - пакет даних в черзі на обробку PROCESSING - пакет даних оброблюється ERROR - пакет даних оброблено з помилкою DUPLICATE - пакет даних повністю дублює попередній SUCCESS - пакет даних оброблено вдало
data.processed_rows	integer	Кількість оброблених рядків
data.imported_rows	integer	Кількість імпортованих рядків
data.skipped_rows	integer	Кількість пропущених рядків
data.validation_errors	array	Помилки валідації
data.skipped_goods	array	Кількість пропущених товарів

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

200 OK

Відповідь: /api/v1/marketplace/stock/255/import/partial

{
    "data": {
        "id": 4,
        "status": "new",
        "processed_rows": 0,
        "imported_rows": 0,
        "skipped_rows": 0,
        "validation_errors": [],
        "skipped_goods": []
    }
}