← Назад
catalogСередній⏱️ 4 хв читання

Отримання товарів з ціною та наявністю

П'ять способів отримати ціну й наявність товарів через API — коли який використовувати.

#prices#catalog#warehouses#in_stocks

Ціну й наявність товарів можна отримати кількома методами — вибір залежить від того, скільки товарів потрібно за раз оновлювати.

МетодТоварів за разАктуальністьНайкраще для
GET /search/productsсторінка результатівреальний часкаталог, пошук, лістинги
POST /search/productsбагато, за відомими UUIDреальний часмасовий lookup конкретних товарів
GET /product/{uuid}1реальний чассторінка товару, кошик, checkout
GET /product/{uuid}/in_stocks1 (лише наявність, без ціни)реальний часшвидка перевірка залишку
POST /prices/listувесь каталогна момент генерації файлурегламентна синхронізація

Пошук — GET /search/products

GET /search/products?q=турбіна&per_page=10&warehouses=ACF9000C2947F7AE11E28A2B02C4AD32

Ціна й in_stocks вже в кожному товарі результату. За замовчуванням наявність — по вашому основному складу; інші склади — через warehouses.

Пошук по UUID — POST /search/products

Якщо UUID товарів вже відомі (кошик, збережений список), одним запитом замість циклу з GET /product/{uuid}:

{ "product_uuids": ["90DFDE6FDE75833F4ECFF1B18F3EDD86", "<інший_uuid>"] }

Конкретний товар — GET /product/{uuid}

GET /product/90DFDE6FDE75833F4ECFF1B18F3EDD86?warehouses=all

Найповніша інформація по одному товару. warehouses=all — особливе значення, доступне тільки тут: наявність одразу по всіх складах.

Тільки наявність — GET /product/{uuid}/in_stocks

Те саме, що й GET /product/{uuid}, але без ціни та інших полів — легша відповідь, коли ціна вже відома. Ціну окремо дає GET /product/{uuid}/price.

Повний прайс — POST /prices/list

Для регламентної синхронізації всього каталогу (наприклад, раз на добу) точкові методи вище не підходять — надто багато запитів. Цей метод генерує CSV з цінами й наявністю по обраних складах для всього каталогу одразу. Деталі — «Отримання прайсу».


Типова комбінація: повна синхронізація з первною частотою(наприклад раз на добу або раз тиждень) через /prices/list + точкове уточнення через GET /product/{uuid} перед переглядом ціни в кошику чи відвантаження.

Є ще розсилка прайсу на email — окрема інтеграція, яку вмикає лише регіональний менеджер BM Parts, не через API. Відправка прайсів відбувається 1 раз на добу.

Пошук

Пошук ендпоінтів, гайдів, туторіалів, реліз-ноутів по всьому порталу