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

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

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

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

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

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

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

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

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

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

    Як підключити EVA: від шаблону до товарів на майданчику

    1. Підготуйте картки. Українські назва й опис, виробник, фото й характеристики — за вимогами EVA.
    2. Створіть шаблон вивантаження типу «EVA.UA (XML)». Elbuz одразу ставить мову шаблону українську й ліміт 15 фото на товар. Попереджає форма про адресу-заглушку https://site.com — замініть її в шаблоні XML адресою свого сайту.
    3. Звузьте асортимент фільтром, якщо на EVA йде не весь каталог.
    4. Сформуйте файл вручну кнопкою «Вивантажити» й відкрийте його за посиланням: чи всі товари потрапили, чи заповнені назви, бренди й залишки.
    5. Вставте посилання на фід у кабінеті EVA й увімкніть автооновлення.
    6. Поставте шаблон на розклад в 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.

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

    Як увімкнути автооновлення в кабінеті EVA

    Фід сам нічого не оновлює — його має забирати EVA. У кабінеті продавця EVA:

    1. Розділ «Товари» → «Імпорт товарів».
    2. У рядку «Адреса XML файлу» — посилання на ваш фід з Elbuz.
    3. Оберіть потрібні опції оновлення — хоча б одну.
    4. Позначте «Автоматичне оновлення увімкнено» і натисніть «Зберегти».

    Статус автооновлення зміниться з «Неактивне» на «Активне», і ціна й наявність товарів оновлюватимуться щогодини. Нові товари з файлу автооновлення не додає: щоб вони потрапили в кабінет, натисніть у розділі «Імпорт» кнопку «Оновити каталог».

    Розкладів два: в 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.

    Форма шаблону вивантаження «EVA.UA (XML) #992669»: вкладки й склад даних
    1Назва і тип шаблону
    2Кнопка «Вивантажити»
    3Склад даних фіда
    1. Назва і тип шаблону — EVA.UA (XML), номер шаблону й ім'я файлу export_eva.xml.
    2. Кнопка «Вивантажити» збирає файл одразу, не чекаючи розкладу.
    3. Склад даних: категорії й товари; фото й характеристики шаблон EVA везе своїми підстановками в рядку товару.

    Суміжні теми

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

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

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

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

    Зміст статті

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

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