Elbuz збирає з каталогу XML-фід для EVA.UA і кладе його за постійним посиланням, а EVA сама щогодини забирає з нього ціни й наявність ваших товарів.
Коли це знадобиться:
- Ви виходите на EVA Marketplace — шаблон «EVA.UA (XML)» уже має обов'язкові теги EVA.
- Товари в наявності без точного залишку — у фід іде кількість за статусом, і EVA не ховає їх як відсутні.
- В описах є посилання й картинки — Elbuz прибирає їх із фіда сам, як того вимагає EVA.
- Ціни й залишки міняються щодня — фід перезбирається за розкладом, EVA підхоплює зміни без модерації.
З чого почати: порядок підключення — від шаблону в Elbuz до автооновлення в кабінеті EVA.
Що вміє вивантаження на EVA
- Готова структура фіда — обов'язкові теги EVA заповнюються з картки товару.
- Залишок у фіді — реальна кількість або кількість за статусом наявності.
- Чисті описи — картинки й посилання вирізаються.
- Постійне посилання — EVA забирає файл сама, ціни й наявність оновлюються щогодини.
- Відбір асортименту — частина каталогу, один склад.
Замовлення фід не приносить. Їх забирає окреме підключення — завантаження замовлень з EVA.UA.
Як підключити EVA: від шаблону до товарів на майданчику
- Підготуйте картки. Українські назва й опис, виробник, фото й характеристики — за вимогами EVA.
- Створіть шаблон вивантаження типу «EVA.UA (XML)». Elbuz одразу ставить мову шаблону українську й ліміт 15 фото на товар. Попереджає форма про адресу-заглушку https://site.com — замініть її в шаблоні XML адресою свого сайту.
- Звузьте асортимент фільтром, якщо на EVA йде не весь каталог.
- Сформуйте файл вручну кнопкою «Вивантажити» й відкрийте його за посиланням: чи всі товари потрапили, чи заповнені назви, бренди й залишки.
- Вставте посилання на фід у кабінеті EVA й увімкніть автооновлення.
- Поставте шаблон на розклад в Elbuz — щоб файл перезбирався зі свіжими цінами й залишками.
EVA зіставляє ваші категорії зі своїми за назвою, тож називайте категорії так, як на сайті EVA. Характеристики EVA теж зіставляє за назвою з довідником своєї категорії; значення, якого там ще немає, додає менеджер EVA на ваше прохання.
Що потрапляє у фід
| Тег фіда EVA | Звідки береться в Elbuz |
|---|---|
offer id | номер товару в Elbuz |
available | статус наявності: «в наявності» — true, решта — false |
price | ціна товару |
price_old | стара ціна — лише коли вона більша за ціну, інакше тегу немає |
stock_quantity | залишок (як рахується) |
currencyId | валюта за замовчуванням |
category, categoryId | номер і назва вашої категорії в Elbuz |
picture | фото товару, до 15 штук |
vendor | виробник |
article | артикул виробника |
name_ua, description_ua | назва й повний опис українською |
name, description | назва й опис російською — лише якщо в акаунті ввімкнено російську мову на момент створення шаблону |
param | характеристики товару: назва й значення |
З описів, що йдуть у фід, Elbuz вирізає картинки і посилання разом із текстом посилання: EVA забороняє їх в описі. HTML-розмітка абзаців і списків лишається — опис іде всередині CDATA, як радить EVA.
1
Початок блоку offer2
Кількість на складі3
Назва товару- Рядок offer відкриває опис одного товару: id і ознаку наявності.
- У рядку stock_quantity підставляється залишок товару.
- У рядку name_ua підставляється назва товару українською.
EVA забороняє змінювати id товарів і категорій після того, як товари з'явилися на сайті. У шаблоні це номери з Elbuz, тому вони стабільні, поки ви не видаляєте й не перестворюєте картки чи категорії. Нова картка отримає новий номер, і для EVA це буде інший товар.
Як EVA бачить наявність
EVA показує товар «в наявності», лише поки stock_quantity більше нуля, а available — true. Позицію без тегу залишку EVA вважає відсутньою. Тому в шаблоні EVA стоїть окрема підстановка {stock_quantity}:
| Товар в Elbuz | Що йде в stock_quantity |
|---|---|
| є залишок, статус наявності дає ненульову кількість | реальний залишок |
| залишку немає, статус «в наявності» | кількість із таблиці «Налаштування оновлення за наявністю товару», за замовчуванням 1000 |
| статус «під замовлення» | реальний залишок, а без нього — 500 за замовчуванням; available при цьому false, тож EVA покаже товар відсутнім |
| статус відсутності (у типовому довіднику — «Немає на складі») | 0, навіть якщо залишок у картці є |
Кількості за статусами міняються кнопкою «Налаштування оновлення за наявністю товару» у формі шаблону (як працює ця таблиця). Поставте 0 статусу, з яким товар не можна продавати на EVA, — і він піде у фід відсутнім.
Після замовлення залишок у вашому фіді сам не змінюється — EVA прямо просить продавця стежити за цим. Нова кількість дійде на майданчик з наступним файлом, тому частота розкладу в Elbuz визначає, як швидко EVA побачить, що товар закінчився.
Вимоги EVA до товарів
EVA перевіряє не лише структуру файлу, а й зміст карток. Зведення вимог, через які найчастіше відмовляють:
| Що | Вимога EVA |
|---|---|
| Файл | кодування UTF-8, статичне посилання, до 300 МБ |
| Назва українською | обов'язкова, до 255 символів; дві однакові назви у файлі заборонені; бренд у назві має збігатися з vendor. Формула: тип товару + бренд + модель + характеристики + колір + (артикул) |
| Назва лише російською | заборонена; без російської назви товар показується тільки на українській версії сайту |
| Опис українською | обов'язковий, від 30 символів, без посилань, телефонів, адрес, цін і акцій |
| Бренд | обов'язковий; товар без торгової марки — No Brand і справжня країна виробництва в характеристиках |
| Фото | від 1 до 15, квадратні, не менше 512×512 (рекомендовано 2048×2048), до 10 МБ; посилання без кирилиці й пробілів; без водяних знаків і чорного фону |
| Характеристики | щонайменше 2, назва й значення заповнені, значення до 255 символів |
| Стара ціна | більша за поточну й відповідає реальній знижці |
| Різновиди | кожен колір, розмір, об'єм — окремий товар зі своїм offer id |
Розмір фото Elbuz не змінює: у фід ідуть посилання на ті зображення, що є в картці. Квадратні фото потрібної роздільності готуйте заздалегідь.
Вимоги змінюються, тож за спірними питаннями звіряйтеся з довідкою EVA:
- Підготовка прайс-листу XML — теги, обов'язкові поля, обмеження.
- Назва товару, Опис товару, Зображення товару, Параметри товару, Бренд товару.
Як увімкнути автооновлення в кабінеті EVA
Фід сам нічого не оновлює — його має забирати EVA. У кабінеті продавця EVA:
- Розділ «Товари» → «Імпорт товарів».
- У рядку «Адреса XML файлу» — посилання на ваш фід з Elbuz.
- Оберіть потрібні опції оновлення — хоча б одну.
- Позначте «Автоматичне оновлення увімкнено» і натисніть «Зберегти».
Статус автооновлення зміниться з «Неактивне» на «Активне», і ціна й наявність товарів оновлюватимуться щогодини. Нові товари з файлу автооновлення не додає: щоб вони потрапили в кабінет, натисніть у розділі «Імпорт» кнопку «Оновити каталог».
Розкладів два: в Elbuz фід перезбирається, у EVA — забирається щогодини. Перезбирати файл частіше за годину немає сенсу. Як поставити розклад — «Запуск руками і за розкладом».
Кожне завантаження фіда повністю замінює перелік ваших товарів на EVA: усе, чого немає в поточному файлі, EVA знімає з публікації. Не діліть каталог на кілька файлів: EVA читає одне посилання, і все, що лежить в іншому файлі, для неї відсутнє.
Які зміни відправляють товар на повторну модерацію
EVA перевіряє товар повторно, коли змінюється його вміст, і не перевіряє, коли змінюються ціна й наявність:
| Без модерації | Повторна модерація |
|---|---|
ціна, стара ціна, залишок, available, артикул, курси валют | назва, опис, бренд, фото, категорія чи її назва, характеристики |
Модерацію запускає й зміна структури файлу — навіть заміна одного тегу іншим за того самого значення. Тому шаблон XML EVA без потреби не правте: типовий уже відповідає формату EVA. А масові правки назв, описів чи фото краще робити порціями, щоб товари не зникали з продажу всі одночасно.
Сценарії
На EVA — лише кілька категорій
На вкладці «Обмеження вивантаження (фільтр)» шаблону задайте умову за категоріями чи виробником. У файл підуть лише товари, що пройшли умову, а все, що випало з файлу, EVA зніме з публікації при наступному завантаженні. Повернете умову — товари повернуться з тими самими номерами.
Продавати лише те, що є на одному складі
На вкладці «Вибір даних для вивантаження» оберіть склад у полі «ID складу». У файл підуть тільки товари, які на цьому складі є. Закінчився товар — він зникне з файлу, і EVA зніме його з публікації, а не покаже «немає в наявності».
Склад відбирає лише товари: кількість у stock_quantity і наявність беруться із загального залишку й статусу товару, а не з цього складу.
Тимчасово відсутній товар не має зникати з EVA
Лишіть товар у відборі шаблону й поставте йому статус відсутності («Немає на складі»). У фід він піде з available="false" і залишком 0: картка на EVA збережеться, але купити товар не вийде. Коли товар з'явиться, поверніть статус — EVA підхопить наявність протягом години без модерації.
Товари постачальника без точного залишку
Товари з прайсів постачальників часто мають статус «в наявності», але порожній залишок. У фід вони підуть із кількістю зі статусу (за замовчуванням 1000). Хочете обережніше — поставте меншу кількість статусу «в наявності» в таблиці «Налаштування оновлення за наявністю товару» цього шаблону.
Що робити, коли EVA не завантажує фід
Помилки етапу завантаження EVA показує в кабінеті продавця. Найчастіші:
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| «403 Заборонено», «429 Забагато запитів», «Помилка з'єднання» | файл лежить на вашому сервері (шаблон копіює його туди по FTP), і захист від ботів блокує EVA. Файл за посиланням Elbuz це не стосується | додайте в білий список IP 138.197.179.150 і 164.92.129.224 та User-Agent EvaMerchantBot/1.0 |
| «404 Ресурс не знайдено» | за посиланням у кабінеті EVA немає файлу — у шаблоні змінили ім'я файлу, шаблон видалили або ще жодного разу не вивантажували | запустіть вивантаження й звірте посилання в кабінеті з посиланням у шаблоні до знака «?» — хвіст після нього змінюється з кожним прогоном і на адресу не впливає |
| «401 Доступ обмежено» | файл захищено паролем, а EVA забирає фід без авторизації | дайте EVA публічне посилання без логіна й пароля |
| «Неможливо декодувати вміст XML-файлу за допомогою UTF-8» | файл збережено не в UTF-8 | перевірте, що в шаблоні не змінено кодування заголовка <?xml … encoding="UTF-8"?> |
| «Розмір файлу не повинен перевищувати 300 МБ» | у фіді забагато товарів або великі описи | приберіть зайве фільтром шаблону; ділити фід на частини не можна (чому) |
| Товари на EVA «немає в наявності», хоча в Elbuz є | available false — статус товару не «В наявності» (наприклад, «Під замовлення») або в таблиці статусів для нього вписано свій текст; stock_quantity 0 — статусу в таблиці стоїть кількість 0 |
перевірте статус наявності й таблицю кількостей шаблону (як рахується) |
| Товари раз у раз ідуть на модерацію | змінюються назви, описи, фото або сам шаблон XML | не правте шаблон без потреби; контент змінюйте порціями (що запускає модерацію) |
| Частина товарів зникла з EVA | їх немає в останньому файлі: випали з фільтра або закінчилися на вибраному складі | поверніть товари у відбір шаблону; тимчасово відсутні лишайте у фіді зі статусом відсутності |
Підтримка EVA просить для розбору точний текст помилки, посилання на фід і час спроби імпорту — повний перелік помилок у довідці EVA.
Часті запитання
Чому не через API, як замовлення?
API EVA не вміє товари, ціни й залишки — лише замовлення. Каталог EVA приймає тільки XML-фідом за посиланням.
Чи потрібна російська назва?
Ні, обов'язкові українські назва й опис. Без російських товар показується лише на українській версії сайту EVA. Шаблон додає їх сам, якщо російська мова була ввімкнена в акаунті, коли шаблон створювали.
Чи заповнює Elbuz коди категорій і характеристик EVA?
Ні. Шаблон передає ваші категорії й характеристики назвами, а EVA зіставляє їх зі своїми за назвою. Атрибутів eva_id, paramid і valueid у шаблоні немає.
Як швидко нова ціна з'явиться на EVA?
Після наступного вивантаження в Elbuz і наступного щогодинного зчитування на EVA. Модерація для ціни не потрібна.
Як отримати замовлення з EVA?
Окремим шаблоном завантаження за логіном і паролем кабінету — замовлення з EVA.UA. Позиції замовлень знаходять ваші картки за тим самим номером товару, що й у фіді.
Де це і хто має доступ
- Меню
- Довідники → Операції → Вивантаження даних
- Створити
- «Додати» → тип «EVA.UA (XML)»
- Право доступу
- вікна «Вивантаження» і «Детальне налаштування шаблону вивантаження» у «Правах груп»
- Підготувати
- українські назви й описи, виробника, квадратні фото від 512×512
Один шаблон — один фід. Загальна механіка шаблонів — відбір, файл за посиланням, розклад, журнал — у статті про вивантаження товарів; тут — лише те, що стосується EVA.
1
Назва і тип шаблону2
Кнопка «Вивантажити»3
Склад даних фіда- Назва і тип шаблону — EVA.UA (XML), номер шаблону й ім'я файлу export_eva.xml.
- Кнопка «Вивантажити» збирає файл одразу, не чекаючи розкладу.
- Склад даних: категорії й товари; фото й характеристики шаблон EVA везе своїми підстановками в рядку товару.
Суміжні теми
- Якщо треба забирати замовлення з EVA — замовлення з EVA.UA через API.
- Якщо товар не потрапив у файл або треба налаштувати відбір і розклад — вивантаження товарів на маркетплейс, сайт і у файл.
- Якщо ви виставляєте товари ще й на Епіцентрі — вивантаження каталогу на Епіцентр.
