Elbuz сам забирає прайс vs trade з vstrade.kz — ціну в тенге, точний залишок, бренд, партномер, назву, категорію з деревом і фото товару. Логін не потрібен, колонки розмічати не треба.
Коли це знадобиться:
- Прайс VS Trade розмічений руками — інтеграція розмічає колонки однаково й не ламається від випадкових правок.
- Каталог VS Trade потрібен деревом — категорії приходять з батьківськими розділами.
- Залишки на сайті мають відставати від складу мінімально — файл приходить за секунди, оновлювати можна кілька разів на день.
З чого почати: майстер нового джерела → крок «Звідки» → плитка «API» → «VS Trade».
Що вміє інтеграція з VS Trade
- Прайс без ручної розмітки — код VS Trade, партномер, назва, бренд, опис, ціна в тенге, залишок і категорія.
- Фото товару — у прайсі VS Trade по одному фото на товар.
- Каталог деревом — категорії з батьківськими розділами: «Компьютеры, ноутбуки / Моноблоки».
- Точний залишок — у штуках, лише для наявних товарів.
Ціни й наявність оновлюються за розкладом, як у будь-якого джерела прайсу. Загальна механіка готових інтеграцій — у статті Як підключити постачальника за API.
Де це і хто має доступ
- Меню
- Довідники → Обробка прайс-листів → Список прайс-листів
- Нове джерело
- майстер нового джерела, крок «Звідки» → плитка «API» → «VS Trade»
- Адреса прайсу
- картка джерела, секція «Джерело» → «Налаштування параметрів API» → «Посилання на сервер API»
- Право доступу
- вікно «Список прайс-листів» плюс «Налаштування завантаження» і «…файл із прайс-листом»
- Підготувати
- нічого: прайс VS Trade відкритий за посиланням
Звідки програма бере прайс VS Trade
Програма бере прайс за адресою https://www.vstrade.kz/export/exportspec.xml — це той самий файл, який дилери VS Trade підключають посиланням. Логін і пароль не потрібні.
Якщо менеджер VS Trade дав вам інше посилання на прайс, впишіть його в поле «Посилання на сервер API» — програма завантажуватиме за ним.
Як підключити VS Trade
- У майстрі нового джерела на кроці «Звідки» оберіть плитку «API» і «VS Trade» у списку.
- Натисніть «Імпортувати» — прайс приїде за кілька секунд.
Програма сама підставляє адресу прайсу, ставить формат XML, вказує вузол товару offer і вузол категорій category, розмічає колонки, вмикає завантаження фото і ставить валюту KZT (що робить привʼязка).
Якщо ви вже підключали прайс VS Trade посиланням і розмічали колонки руками, нове джерело можна завести поруч, порівняти результат і вимкнути старе.
Що приходить від VS Trade
Колонки XML-прайсу — це імена тегів. У прайсі VS Trade немає окремого тегу з назвою: повна назва товару лежить у тегу model, тому привʼязка бере назву звідти.
| Колонка | Що в ній | Поле в Elbuz |
|---|---|---|
| [id] | код товару VS Trade (атрибут offer) | «Артикул контрагента» |
| partnomer | партномер виробника | «Артикул виробника» |
| model | повна назва товару | «Найменування» |
| vendor | бренд | «Виробник» |
| description | опис (здебільшого повторює назву) | «Опис короткий» |
| quantity | залишок на складі, штук | «Статус наявності (з прайсу)» і «Кількість» |
| categoryId | код категорії VS Trade | категорія з прайсу |
| price | ціна, тенге | «Ціна» |
Бренд у прайсі VS Trade часто написаний малими літерами («hp»); довідник виробників зводить його до того самого виробника, що й «HP» з інших прайсів. Характеристик у прайсі VS Trade немає.
1
Фото з прайсу2
Наявність і кількість3
Виробник- Фото товару з прайсу VS Trade.
- У прайсі VS Trade — точний залишок, він стає кількістю.
- Виробник з тегу vendor; «hp» і «HP» зводяться до одного.
Що буде з товаром, який закінчився у VS Trade
Товар, який закінчився, просто зникає з прайсу — і програма обробляє його як відсутній у постачальника, за тими правилами, які у вас налаштовані для зниклих товарів (що буде з товаром, якого не стало в прайсі).
У прайсі VS Trade тільки товари, які є на складі, з точним залишком у тегу quantity. Стандартні статуси розпізнають це число як «В наявності» і ставлять його кількістю (наявність товару в прайсі постачальника).
Сценарії
Перейти з ручного прайсу на інтеграцію
Що зробити. Заведіть нове джерело з інтеграцією «VS Trade», завантажте його й порівняйте кількість товарів і ціни зі старим джерелом. Потім вимкніть старе.
Що вийде. Колонки, валюта, категорії й фото будуть розмічені однаково в усіх, хто підключає VS Trade, і не зламаються, якщо хтось випадково змінить розмітку.
Оновлювати залишки кілька разів на день
Що зробити. У розкладі джерела VS Trade задайте завантаження кожні дві-три години (імпорт і розклад).
Що вийде. Прайс невеликий і приходить одним файлом за кілька секунд, тож часте оновлення не навантажує програму, а залишки на сайті відстають від складу VS Trade щонайбільше на кілька годин.
Розкласти товари VS Trade по своїх категоріях
Що зробити. Відкрийте вкладку «Категорії» джерела й зіставте категорії VS Trade зі своїми (зіставлення категорій постачальника).
Що вийде. Нові товари VS Trade самі потраплятимуть у ваші категорії при додаванні в каталог.
Що робити, коли прайс VS Trade не приїхав
Чому прайс не оновився
Якщо VS Trade не віддав прайс — посилання закрите, змінилося або сайт недоступний, — у журналі джерела зʼявиться «Помилка API постачальника: VS Trade: …» з кодом відповіді сервера, наприклад «HTTP 403», і початком сторінки, яку повернув сайт. Програма в такому разі не затирає прайс: ціни й наявність лишаються з попереднього завантаження (загальна механіка).
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| «Помилка API постачальника: VS Trade: HTTP 403 …» | VS Trade закрив посилання або змінив адресу прайсу | Взяти актуальне посилання в менеджера VS Trade і вписати в «Посилання на сервер API» (звідки прайс) |
| Кілька товарів без категорії | У прайсі VS Trade товар посилається на категорію, якої в цьому ж прайсі немає | Розкласти такі товари вручну або дочекатися, поки VS Trade виправить прайс |
| Товар зник із прайсу VS Trade | Він закінчився на складі: у прайсі тільки наявне | Нічого: товар повернеться, щойно зʼявиться на складі (наявність) |
Часті запитання
Чи потрібен логін і пароль VS Trade?
Ні. Програма бере прайс за посиланням, яке VS Trade викладає для дилерів (звідки прайс).
У якій валюті ціни VS Trade?
У тенге. Привʼязка ставить валюту KZT за кодом.
Чи приходять з VS Trade характеристики?
Ні, у прайсі VS Trade їх немає. Фото — по одному на товар.
Чому бренд VS Trade «hp» малими літерами?
Так його пише VS Trade. Довідник виробників зводить «hp» до того самого виробника, що й «HP» з інших прайсів.
Чи можна відправити замовлення у VS Trade з Elbuz?
Ні. Прайс VS Trade — тільки файл, замовлення оформлюють на сайті VS Trade.
Суміжні теми
- Якщо потрібна загальна картина готових інтеграцій і вікна параметрів — Як підключити постачальника за API.
- Якщо прайс завантажився і треба налаштувати розклад та імпорт — імпорт прайсу.
- Якщо категорії VS Trade треба розкласти по своїх — зіставлення категорій постачальника.
- Якщо потрібні ще й характеристики від дистрибʼютора Казахстану — Як підключити прайс Comportal.