Elbuz збирає з каталогу XML-фід для Kasta і кладе його за постійним посиланням, а Kasta HUB сам забирає з нього нові товари, ціни й залишки.
Коли це знадобиться:
- Ви виходите на Kasta — шаблон «Kasta (XML)» уже має теги з інструкції Kasta.
- Категорії вже зіставлені для Rozetka — Kasta сама зіставить їх зі своїми за кодом Rozetka.
- Товари в наявності без точного залишку — у фід іде кількість за статусом, і Kasta не ховає їх.
- Ціни й залишки міняються щодня — фід перезбирається за розкладом, Kasta підхоплює зміни щогодини.
З чого почати: порядок підключення — від шаблону в Elbuz до фіда в Kasta HUB.
Що вміє вивантаження на Kasta
- Готова структура фіда — теги з інструкції Kasta заповнюються з картки товару.
- Коди категорій Rozetka — у
rz_id, щоб Kasta зіставила категорії сама. - Залишок і стара ціна — завжди у фіді, щоб товар був у продажу.
- Постійне посилання — HUB забирає файл сам.
- Відбір асортименту — лише потрібні категорії чи виробники.
Замовлення фід не приносить. Їх забирає окреме підключення — завантаження замовлень з Kasta.
Як підключити Kasta: від шаблону до товарів у HUB
- Підготуйте картки. Українські назва й опис, виробник, артикул, фото; для одягу й взуття — характеристики «Колір» і «Розмір» (чому).
- Зіставте категорії з Rozetka, якщо ще не зробили: їхні коди підуть у фід (зіставлення категорій).
- Створіть шаблон вивантаження типу «Kasta (XML)». Elbuz ставить мову шаблону українську (якщо вона ввімкнена в акаунті) і ліміт 20 фото на товар. Адресу сайту в шапку шаблон бере з ваших даних; лишилася заглушка https://site.com — форма попередить, замініть її. Заглушки MyStore у тегах
nameіcompanyшапки замініть назвою магазину. - Сформуйте файл кнопкою «Вивантажити» й відкрийте його за посиланням.
- Додайте посилання в Kasta HUB й увімкніть потрібні оновлення (як).
- Поставте шаблон на розклад в Elbuz, щоб файл перезбирався зі свіжими цінами й залишками.
Що потрапляє у фід
| Тег фіда Kasta | Звідки береться в Elbuz |
|---|---|
offer id | номер товару в Elbuz — цифри, без кирилиці й пробілів, як вимагає Kasta |
category, атрибут rz_id | номер і назва вашої категорії; rz_id — код категорії Rozetka, лише якщо він у категорії заповнений |
available | статус наявності: «в наявності» — true, решта — false |
price | ціна товару |
price_old | більша зі старої ціни й ціни — тег є завжди |
stock_quantity | залишок (як рахується) |
picture | фото товару, до 20 штук |
vendor | виробник |
article | артикул виробника |
name_ua, description_ua | назва й повний опис українською |
name_ru, description | назва й опис російською — лише якщо в акаунті були ввімкнені українська й російська мови, коли шаблон створювали |
param | характеристики товару: назва, значення, одиниця виміру |
З описів Elbuz вирізає картинки й посилання разом із текстом посилання: Kasta забороняє їх в описі. Опис довший за 5000 символів Kasta обріже сама.
1
Рядок товару offer2
Залишок stock_quantity3
Стара ціна (GREATEST)- Початок блоку товару: id та наявність підставляються з даних товару.
- Кількість на залишку підставляється в тег stock_quantity.
- Стара ціна береться як більше з price_old та price за формулою GREATEST.
Kasta забороняє змінювати id товару після публікації, а id категорій мають лишатися незмінними. У шаблоні це номери з Elbuz, тож вони стабільні, поки ви не перестворюєте картки чи категорії.
Без rz_id категорію треба зіставити вручну файлом мапінгу в HUB (розділ «Категорія+»). Характеристики Kasta зіставляє за назвою; невідомі назви зіставляються там само, у «Каскад+». Кодів категорій і характеристик Kasta Elbuz не заповнює.
Як Kasta бачить наявність і ціну
Kasta бере залишок із stock_quantity, а з available="false" вважає його нулем за будь-якої кількості. Тому в шаблоні Kasta стоїть підстановка {stock_quantity}:
| Товар в Elbuz | Що йде у фід |
|---|---|
| є залишок, статус «в наявності» | реальний залишок, available="true" |
| залишку немає, статус «в наявності» | кількість із таблиці «Налаштування оновлення за наявністю товару», за замовчуванням 1000 |
| статус «під замовлення» | реальний залишок або 500 за замовчуванням, але available="false" — тож на Kasta залишок 0 |
| статус відсутності | 0 |
Кількості за статусами міняються кнопкою «Налаштування оновлення за наявністю товару» у формі шаблону (як працює ця таблиця).
Ціна. Kasta вимагає, щоб рекомендована (перекреслена) ціна була не нижчою за ціну продажу, а без неї пише помилку в репорт. Тому price_old у шаблоні — завжди більша зі старої ціни й ціни: товар без знижки йде з однаковими значеннями. Ціну продажу Kasta радить рахувати з урахуванням своєї комісії (роялті).
Як варіанти збираються в одну картку
Kasta групує товари в одну картку за набором Артикул + Бренд + Колір + Розмір: у варіантів однієї моделі однакові article, vendor і категорія, а колір і розмір передаються характеристиками.
- Одяг і взуття — характеристики «Колір» і «Розмір» обов'язкові. Заведіть їх у картках Elbuz саме з такими назвами: вони підуть у фід рядками
param. - Без розмірного ряду (шампунь, акумулятор) Kasta поставить розмір «-» сама, а за відсутності кольору — «комбінований» чи «не визначено».
- Колір у назві не пишіть — Kasta може прибрати з назви те, що передано окремою характеристикою.
- Габарити й вага в упаковці впливають на розрахунок доставки. У шаблоні їх немає; додайте характеристики з назвами «Габарити в упаковці, см» і «Вага в упаковці, кг» — без них Kasta підставить середні значення категорії.
Kasta фіксує цей набір за карткою. Змінили один із них у фіді — для Kasta це новий товар, який знову йде на модерацію. Щоб змінити, товар видаляють у HUB і завантажують заново.
Як додати фід у Kasta HUB
- У кабінеті HUB: «Товари» → «Імпорт новинок» → вкладка «XML» → «Додати новий фід».
- Вставте посилання на фід з Elbuz і позначте налаштування:
- «Завантажити товари з xml» — вмикає фід: нові товари й оновлення;
- «Оновлювати ціни», «Оновлювати стоки», «Оновлювати контент» — що брати з файлу надалі;
- «Зняти з продажу товари, які відсутні в фіді» — товарам, яких немає у файлі, залишок обнулиться;
- «Використати ціну продажу, якщо немає рекомендованої ціни» — для шаблону Elbuz не потрібна,
price_oldу ньому є завжди.
- Збережіть. Фід отримає свій номер, яким позначаться всі завантажені з нього товари.
Обмеження Kasta: файл до 1 ГБ, завантаження до 45 хвилин, одночасно — до 3 активних фідів. Вимкнути фід — зняти всі галочки: самого «Завантажити товари з xml» мало, якщо лишилося «Оновлювати стоки і ціни окремо». Видалити фід у HUB не можна.
Що й як часто оновлюється
| Що | Як часто |
|---|---|
| ціни й залишки | орієнтовно раз на годину; з режимом «Оновлювати стоки і ціни окремо» — кожні 30 хвилин |
| повна обробка фіда з новинками й контентом | у загальній черзі, орієнтовно до 6 годин; файл без зміни дати в шапці — раз на 4 години |
| назва, опис, фото, характеристики | лише з увімкненим «Оновлювати контент» і лише для товарів, завантажених цим фідом |
Дату в шапку шаблон Elbuz підставляє при кожному прогоні, тож HUB бачить, що файл новий. Розкладів два: в Elbuz фід перезбирається, у HUB — забирається. Перезбирати файл частіше за 30 хвилин немає сенсу. Як поставити розклад — «Запуск руками і за розкладом».
Сценарії
На Kasta — лише кілька категорій
На вкладці «Обмеження вивантаження (фільтр)» шаблону задайте умову за категоріями чи виробником. Товари, що випали з файлу, знімаються з продажу, лише якщо в HUB позначено «Зняти з продажу товари, які відсутні в фіді»; інакше вони лишаються з останнім залишком.
Тимчасово відсутній товар не має зникати
Лишіть товар у відборі й поставте статус відсутності. У фід він піде з залишком 0: картка на Kasta збережеться, купити товар не вийде. Повернете статус — Kasta підхопить наявність з наступним оновленням цін і стоків.
Одяг у кількох кольорах і розмірах
Кожен колір і розмір — окрема картка в Elbuz з однаковими артикулом, виробником і категорією та характеристиками «Колір» і «Розмір». У фіді це окремі offer, а на Kasta — одна картка з вибором кольору й розміру.
Що робити, коли Kasta не приймає товари
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| «Помилка завантаження або валідаціі xml структури фіду» | структура файлу не збігається з очікуваною — найчастіше змінено шаблон XML | поверніть типовий шаблон: створіть новий шаблон «Kasta (XML)» і порівняйте |
| HUB не може забрати файл | файл лежить на вашому сервері (шаблон копіює його туди по FTP), і захист блокує Kasta. Файл за посиланням Elbuz це не стосується | додайте в білий список IP 3.78.142.138, 18.196.145.164, 3.121.252.59, 52.59.104.195, 3.126.0.144 |
| Товари не зіставлені з категоріями Kasta | у категорії немає коду Rozetka — rz_id у фід не йде |
заповніть код Rozetka в категорії або зіставте її у файлі мапінгу HUB («Категорія+») |
| «Відсутній бренд» | бренду немає в довіднику Kasta | надішліть запит на moderator@kasta.ua |
| Варіанти не об'єдналися в одну картку | різні артикул, виробник чи категорія, або колір записано в назві | вирівняйте артикул і виробник, колір і розмір передайте характеристиками (як) |
| Назва чи фото на Kasta не оновлюються | у налаштуваннях фіда HUB вимкнено «Оновлювати контент» або товар створено не цим фідом | увімкніть «Оновлювати контент»; товари, створені іншим способом, оновлюйте тим самим способом |
| Товар задвоївся після зміни артикула чи кольору | Kasta сприймає зміну цих полів як новий товар | видаліть зайву позицію в HUB (що не оновлюється) |
Повний перелік помилок і стоп-слів — в інструкції Kasta із завантаження контенту в форматі XML, у кабінеті HUB.
Часті запитання
Чи підійде шаблон Rozetka для Kasta?
Kasta приймає фід зі структурою Rozetka, але для нових шаблонів беріть тип «Kasta (XML)»: у ньому числові offer id, до 20 фото й price_old у кожному товарі.
Чому не через API Kasta?
Kasta оновлює з фіда і новинки, і ціни з залишками, тому Elbuz передає каталог файлом. Через API підключення Elbuz забирає лише замовлення — замовлення з Kasta.
У мене давно є шаблон Kasta — він змінився?
Ні. Нова заготовка діє лише для шаблонів, створених тепер; наявні шаблони програма не чіпає.
Як швидко нова ціна з'явиться на Kasta?
Після наступного вивантаження в Elbuz і наступного оновлення в HUB — орієнтовно до години, з режимом «Оновлювати стоки і ціни окремо» — до 30 хвилин.
Чи передає Elbuz габарити й вагу?
Лише якщо ви додасте характеристики «Габарити в упаковці, см» і «Вага в упаковці, кг»: окремих тегів для них у шаблоні немає.
Де це і хто має доступ
- Меню
- Довідники → Операції → Вивантаження даних
- Створити
- «Додати» → тип «Kasta (XML)»
- Право доступу
- вікна «Вивантаження» і «Детальне налаштування шаблону вивантаження» у «Правах груп»
- Підготувати
- коди категорій Rozetka, артикул і виробник, «Колір» і «Розмір» для одягу
Загальна механіка шаблонів — відбір, файл за посиланням, розклад, журнал — у статті про вивантаження товарів.
1
Назва та тип шаблону2
Галочки складу даних- Назва шаблону та його тип — Kasta (XML).
- Галочки складу даних: Категорії, Товари, Фото, Атрибути.
Суміжні теми
- Якщо треба забирати замовлення з Kasta — замовлення з Kasta через API.
- Якщо категорії ще не мають кодів Rozetka — зіставлення категорій із маркетплейсами.
- Якщо поряд продаєте на Rozetka — вивантаження каталогу на Rozetka.
