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

Отримання прайсу

Як отримати прайс товарів та залишки по складах через API.

#prices#catalog

Для отримання прайсу через API використовується параметризований метод, який дозволяє:

  • отримати наявність по конкретних складах;
  • задати валюту;
  • передати список товарів для вибірки (products).

⚠️ Найближчим часом з’являться додаткові параметри для фільтрації товарів за виробниками авто (наприклад, BMW). Про оновлення буде повідомлено окремо в реліз-ноутах.

Ендпоінт

POST /prices/list

Параметри

NameTypeDescription
currencystringвалюта — UUID валюти (EUR, ГРН, USD)
warehousesarrayмасив UUID-ів необхідних складів
productsarrayмасив UUID-ів необхідних товарів

Заголовки

{
  "Content-Type": "application/json",
  "Authorization": "<token>",
  "User-Agent": "<НазваВашогоЗастосунку>/1.0"
}

Як отримати токен — дивіться Як отримати API-ключ.

Для роботи з тестовими даними додайте заголовок X-Test-Mode — детальніше про нього в «Як перейти в тестовий режим».

Тіло запиту

{
  "currency": "<UUID валюти>",
  "warehouses": ["<UUID складу>"],
  "products": ["<UUID товару>"]
}

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

curl --request POST \
  -H "Content-Type: application/json" \
  -H "Authorization: <token>" \
  -H "User-Agent: <НазваВашогоЗастосунку>/1.0" \
  https://api.bm.parts/prices/list \
  --data '{
    "currency": "A358000C2947F7AE11E23F5617780B16",
    "warehouses": ["81F4005056AC66D611EAD7173350C7AA"]
  }'

Формат відповіді

Запит повертає дані у форматі CSV. Перший рядок — людські назви колонок, другий — технічні (для стовпця з кількістю сюди ж закодовано короткий код і UUID складу, до якого належить залишок: QTY:<код_складу>:<uuid_складу>). Далі — по одному рядку на товар:

ІД,Артикул,Бренд,Назва,Ціна ГРН,Дніпро ДАГ
UUID,Article,Brand,Name,Price,QTY:DAG:81EE005056AC66D611EA758E79EBACF9
"80006E98C49AE02F4CB01012B3CA9C36","VM41023","VIBRA MASTER","Підшипник підвісний Land Rover Freelander 98-06 (d=30mm) (з підшипником FAG)","1206.96","1"
"8001FBE703F98FB947F19E8AACB88834","02.53.071","TRUCKTEC AUTOMOTIVE","Ручка дверей (передніх/задньої/ззовні) MB Sprinter/VW LT 96-","277.44","1"
"800227FC8C8B4D304502B1C1D153453F","29-16 060 0008/HD","MEYLE","Тяга стабілізатора (переднього) (L) Chevrolet Lacetti 05-","417.24","1"
"8002A089C3E7A1FC44426BF56ED29AA3","810016","FRENKIT","Направляюча супорта (переднього/к-кт) Daewoo Nubira/Chevrolet Aveo 1.2-2.0 97- (Dac)","243.72","8"

Якщо в запиті вказано декілька складів (warehouses — масив), для кожного з них у файлі буде окрема колонка кількості зі своїм QTY:<код>:<uuid> заголовком.

Обмеження

Повний і актуальний список полів запиту дивіться в інтерактивній Документації API — цей гайд описує типовий сценарій використання.

Пошук

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