Цей гайд описує наскрізний сценарій: отримати файл прайсу під конкретний бренд через API у форматі, сумісному з Prom.ua, і завантажити його в кабінет продавця.
1. Отримання файлу імпорту через API
Ендпоінт
POST /prices/prom/<brand_name>
brand_name — будь-яке доступне значення бренду з каталогу B2B (наприклад, PHILIPS).
Заголовки
{
"Content-Type": "application/json",
"Authorization": "<token>",
"User-Agent": "<НазваВашогоЗастосунку>/1.0"
}
Як отримати токен — дивіться Як отримати API-ключ.
Фільтр по складах
Метод підтримує фільтрацію наявності по конкретних складах — передайте їхні UUID у тілі запиту (Body → raw → JSON):
{
"warehouses": ["ACF9000C2947F7AE11E28A2B02C4AD32"]
}
Якщо не вказати жодного складу, результат буде сформовано по всіх складах.
Ціни з націнкою: with_extra
За замовчуванням файл містить ціни клієнта з урахуванням його знижки, без націнок. Щоб застосувати збережені націнки з налаштувань B2B, передайте в JSON-тілі запиту "with_extra": true. Параметр можна поєднувати з фільтром warehouses або передати окремо:
{
"with_extra": true
}
Перед запитом налаштуйте націнки в B2B для логіна, якому належить API-ключ. Відсоток націнки в запиті передавати не потрібно. Докладніше — як налаштувати правила націнки.
Націнки застосовуються так:
- Спочатку перевіряється націнка для бренду товару. Якщо її не застосовано — перевіряється націнка для відповідного цінового інтервалу. Дві націнки не підсумовуються.
- Націнка розраховується від ціни після знижки клієнта. Наприклад, 100 грн після знижки та націнка 20% дадуть 120 грн.
- Ціна з націнкою округлюється до цілої грошової одиниці за правилами B2B: 90 грн + 5% = 94,50 грн → у CSV буде
95.00. - Якщо відповідного правила немає, ціна залишається без змін.
Щоб отримати ціни без націнок, не передавайте with_extra або вкажіть false. Використовуйте JSON-значення true / false без лапок.
Для with_extra=true потрібен API-ключ, пов’язаний з логіном. Сервісний ключ без логіна працює для експорту без націнок, але з with_extra=true повертає HTTP 422 з повідомленням: «Для with_extra=true потрібен API-ключ, пов’язаний з логіном».
Приклад запиту з націнкою та фільтром по складах
curl --request POST \
-H "Content-Type: application/json" \
-H "Authorization: <token>" \
-H "User-Agent: <НазваВашогоЗастосунку>/1.0" \
https://api.bm.parts/prices/prom/PHILIPS \
--data '{
"warehouses": ["ACF9000C2947F7AE11E28A2B02C4AD32"],
"with_extra": true
}'
Через Postman (якщо не працюєте з curl напряму)
- Відкрийте будь-який інструмент для відправки HTTP-запитів, наприклад Postman (можна скористатись веб-версією без встановлення).
- Створіть новий запит — New Request.
- Виберіть метод POST та вкажіть URL:
(замістьhttps://api.bm.parts/prices/prom/PHILIPSPHILIPSвкажіть потрібний вам бренд). - Додайте заголовки
Authorization: <token>таUser-Agent: <НазваВашогоЗастосунку>/1.0(без нього можливий401/403). - Перейдіть на вкладку Body → raw, оберіть формат JSON і вкажіть
"with_extra": trueдля експорту з націнками. За потреби додайте UUID складів уwarehouses, як у прикладі вище. Запит без тіла поверне дані по всіх складах без націнок. - Надішліть запит.
Формат відповіді
Запит повертає дані у форматі CSV. Збережіть відповідь на комп’ютер — цей файл і буде завантажуватись у Prom.ua на наступному кроці.
Колонки файлу:
| Колонка | Опис |
|---|---|
Код_товару | Код товару постачальника |
Назва_позиції / Назва_позиції_укр | Назва товару |
Опис / Опис_укр | Опис товару |
Посилання_зображення | Список URL фото товару через кому |
Тип_товару | Тип позиції (r — запчастина) |
Виробник / Країна_виробник | Бренд і країна бренду |
Ціна / Валюта | Ціна і валюта; при with_extra=true ціна враховує застосовану націнку |
Кількість / Наявність | Залишок і ознака наявності (+) |
Одиниця_виміру | Одиниця виміру кількості |
Ідентифікатор_товару | UUID товару |
Де_знаходиться_товар | Назва складу |
Назва_Характеристики / Одиниця_виміру_Характеристики / Значення_Характеристики | Трійка колонок на одну характеристику товару (код запчастини, вага, матеріал тощо) — повторюється в заголовку до 20 разів; порожні, якщо характеристик менше |
Приклад файлу без націнок (для стислості показано по 2 трійки характеристик замість 20 — реальна відповідь ширша):
Код_товару,Назва_позиції,Назва_позиції_укр,Опис,Опис_укр,Посилання_зображення,Тип_товару,Виробник,Країна_виробник,Ціна,Валюта,Кількість,Наявність,Одиниця_виміру,Ідентифікатор_товару,Де_знаходиться_товар,Назва_Характеристики,Одиниця_виміру_Характеристики,Значення_Характеристики,Назва_Характеристики,Одиниця_виміру_Характеристики,Значення_Характеристики,...
"103054","Фільтр повітряний Fiat Scudo/Citroen Jumpy 2.0 HDI 07-","Фільтр повітряний Fiat Scudo/Citroen Jumpy 2.0 HDI 07-","Фільтр повітряний Fiat Scudo/Citroen Jumpy 2.0 HDI 07-","Фільтр повітряний Fiat Scudo/Citroen Jumpy 2.0 HDI 07-","https://cdn.bm.parts/photo/h/s/g/x/j/eca636e6.jpeg, https://cdn.bm.parts/photo/i/u/b/w/b/d0764eeb.jpeg","r","SOLGY","Іспанія","149.04","UAH","2","+","шт.","800A18A9627A58AB43EAB555FA2CFD1D","Дніпро","Стан","","Новий","Код запчастини","","11-12 321 0023, 1444.WN, 26-0509, K 793, WA9559","",""
"114189","Патрубок інтеркулера (довгий) Opel Vivaro B/Renault Trafic III 1.6dCi 14-","Патрубок інтеркулера (довгий) Opel Vivaro B/Renault Trafic III 1.6dCi 14-","Патрубок інтеркулера (довгий) Opel Vivaro B/Renault Trafic III 1.6dCi 14-","Патрубок інтеркулера (довгий) Opel Vivaro B/Renault Trafic III 1.6dCi 14-","https://cdn.bm.parts/photo/w/k/m/b/t/0a51bc02.jpeg, https://cdn.bm.parts/photo/a/e/v/s/h/43e5baec.jpeg","r","SOLGY","Іспанія","1770.48","UAH","1","+","шт.","8040B37D15BBB7A04438159C61E64EA8","Дніпро","Стан","","Новий","Код запчастини","","144603145R, 2400630, 2400668, 4422245","Вес [г]","","591"
У другому рядку прикладу видно, що трійки характеристик заповнюються лише
там, де вони є в товару (Вес [г] / 591) — решта слотів до максимальних
20 залишаються порожніми.
2. Імпорт файлу в Prom.ua
- Увійдіть в особистий кабінет продавця Prom.
- Перейдіть на вкладку Import.
- Натисніть «Завантажити файл з комп’ютера».
- Виберіть збережений на попередньому кроці CSV-файл і натисніть «Почати».
Після цього Prom.ua обробить файл і оновить каталог товарів для обраного бренду.
Націнка потрапляє безпосередньо в колонку Ціна CSV-файлу. Після зміни правил націнки в B2B сформуйте новий файл із with_extra=true та повторно імпортуйте його в Prom.ua, щоб оновити ціни.
Порада
Оскільки метод формує окремий файл під кожен бренд, для повного оновлення каталогу на Prom.ua цей сценарій потрібно повторити для кожного бренду, який ви продаєте на майданчику.