↑↓ вибірEnter відкритиEsc закрити

    1. Elbuz
    2. Керівництво користувача Elbuz
    3. Вивантаження та маркетплейси
    4. Фіди й маркетплейси

    Як вивантажити товари на Kasta: XML-фід

    7 хв читанняОновлено

    Elbuz збирає з каталогу XML-фід для Kasta і кладе його за постійним посиланням, а Kasta HUB сам забирає з нього нові товари, ціни й залишки.

    Коли це знадобиться:

    • Ви виходите на Kasta — шаблон «Kasta (XML)» уже має теги з інструкції Kasta.
    • Категорії вже зіставлені для Rozetka — Kasta сама зіставить їх зі своїми за кодом Rozetka.
    • Товари в наявності без точного залишку — у фід іде кількість за статусом, і Kasta не ховає їх.
    • Ціни й залишки міняються щодня — фід перезбирається за розкладом, Kasta підхоплює зміни щогодини.

    З чого почати: порядок підключення — від шаблону в Elbuz до фіда в Kasta HUB.

    Що вміє вивантаження на Kasta

    Замовлення фід не приносить. Їх забирає окреме підключення — завантаження замовлень з Kasta.

    Як підключити Kasta: від шаблону до товарів у HUB

    1. Підготуйте картки. Українські назва й опис, виробник, артикул, фото; для одягу й взуття — характеристики «Колір» і «Розмір» (чому).
    2. Зіставте категорії з Rozetka, якщо ще не зробили: їхні коди підуть у фід (зіставлення категорій).
    3. Створіть шаблон вивантаження типу «Kasta (XML)». Elbuz ставить мову шаблону українську (якщо вона ввімкнена в акаунті) і ліміт 20 фото на товар. Адресу сайту в шапку шаблон бере з ваших даних; лишилася заглушка https://site.com — форма попередить, замініть її. Заглушки MyStore у тегах name і company шапки замініть назвою магазину.
    4. Сформуйте файл кнопкою «Вивантажити» й відкрийте його за посиланням.
    5. Додайте посилання в Kasta HUB й увімкніть потрібні оновлення (як).
    6. Поставте шаблон на розклад в 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 обріже сама.

    Картка «Шаблон XML» з блоком offer у шаблоні Kasta (XML)
    1Рядок товару offer
    2Залишок stock_quantity
    3Стара ціна (GREATEST)
    1. Початок блоку товару: id та наявність підставляються з даних товару.
    2. Кількість на залишку підставляється в тег stock_quantity.
    3. Стара ціна береться як більше з 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

    1. У кабінеті HUB: «Товари» → «Імпорт новинок» → вкладка «XML» → «Додати новий фід».
    2. Вставте посилання на фід з Elbuz і позначте налаштування:
      • «Завантажити товари з xml» — вмикає фід: нові товари й оновлення;
      • «Оновлювати ціни», «Оновлювати стоки», «Оновлювати контент» — що брати з файлу надалі;
      • «Зняти з продажу товари, які відсутні в фіді» — товарам, яких немає у файлі, залишок обнулиться;
      • «Використати ціну продажу, якщо немає рекомендованої ціни» — для шаблону Elbuz не потрібна, price_old у ньому є завжди.
    3. Збережіть. Фід отримає свій номер, яким позначаться всі завантажені з нього товари.

    Обмеження 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, артикул і виробник, «Колір» і «Розмір» для одягу

    Загальна механіка шаблонів — відбір, файл за посиланням, розклад, журнал — у статті про вивантаження товарів.

    Форма шаблону вивантаження «Kasta (XML)» з вибором складу даних
    1Назва та тип шаблону
    2Галочки складу даних
    1. Назва шаблону та його тип — Kasta (XML).
    2. Галочки складу даних: Категорії, Товари, Фото, Атрибути.

    Суміжні теми

    Чи була стаття корисною?

    Не вистачає функції? Напишіть нам.

    Ми додамо її безкоштовно, якщо вона знадобиться й іншим.

    Якщо це потрібно тільки вам — домовимося окремо.

    Зміст статті

    Запропонувати доробку

    Спробувати безкоштовно