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

Експорт товарів на Prom.ua

Як отримати прайс для Prom.ua через API, застосувати націнки з налаштувань B2B та імпортувати файл у кабінет продавця.

#prom.ua#export#integration#prices

Цей гайд описує наскрізний сценарій: отримати файл прайсу під конкретний бренд через 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 напряму)

  1. Відкрийте будь-який інструмент для відправки HTTP-запитів, наприклад Postman (можна скористатись веб-версією без встановлення).
  2. Створіть новий запит — New Request.
  3. Виберіть метод POST та вкажіть URL:
    https://api.bm.parts/prices/prom/PHILIPS
    (замість PHILIPS вкажіть потрібний вам бренд).
  4. Додайте заголовки Authorization: <token> та User-Agent: <НазваВашогоЗастосунку>/1.0 (без нього можливий 401/403).
  5. Перейдіть на вкладку Body → raw, оберіть формат JSON і вкажіть "with_extra": true для експорту з націнками. За потреби додайте UUID складів у warehouses, як у прикладі вище. Запит без тіла поверне дані по всіх складах без націнок.
  6. Надішліть запит.

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

Запит повертає дані у форматі 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

  1. Увійдіть в особистий кабінет продавця Prom.
  2. Перейдіть на вкладку Import.
  3. Натисніть «Завантажити файл з комп’ютера».
  4. Виберіть збережений на попередньому кроці CSV-файл і натисніть «Почати».

Після цього Prom.ua обробить файл і оновить каталог товарів для обраного бренду.

Націнка потрапляє безпосередньо в колонку Ціна CSV-файлу. Після зміни правил націнки в B2B сформуйте новий файл із with_extra=true та повторно імпортуйте його в Prom.ua, щоб оновити ціни.

Порада

Оскільки метод формує окремий файл під кожен бренд, для повного оновлення каталогу на Prom.ua цей сценарій потрібно повторити для кожного бренду, який ви продаєте на майданчику.

Пошук

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