Як тримати каталог на Prom.ua свіжим XML-фідом

Що вміє XML-фід для Prom

• Постійне посилання — Prom забирає фід за ним сам, вивантажувати файл вручну не треба.
• Ідентифікатор товару — той самий UUIDДовгий унікальний код запису з літер і цифр, наприклад 3f2a…-9c1e. Програми використовують його, щоб однозначно впізнавати записи під час обміну., що й у файлі XLSXФормат файлу Excel. Звичайна таблиця, яку відкриває Excel, LibreOffice чи Google Таблиці., тож позиції не задвоюються.
• Редагований шаблон XML — склад пропозиції підганяєте під вимоги Prom.
• Характеристики й різновиди — передаються елементами param і group_id.
• Наявність атрибутом — товар без залишку лишається у фіді з available="false".
• Розклад і стоп-правила — фід оновлюється без вас і не перезаписується зіпсованим.

Де це і хто має доступ

Меню

Довідники → Операції → Вивантаження даних

Стоп-правила

бургер-меню списку → «Стоп-правила вивантаження»

Право доступу

вікно «Вивантаження даних»; для картки — «Детальне налаштування шаблону вивантаження»

Підготувати

доступ до кабінету Prom, щоб вставити посилання на фід

Як налаштувати фід

Prom XML — стандартний YML-фід: у корені yml_catalog, усередині — блок категорій і блок пропозицій (offers). Фід живе за адресою: оновили каталог у Elbuz — за тим самим посиланням лежать свіжі дані.

1. Створіть шаблон вивантаження й оберіть формат «prom.ua (XML)».
2. Визначте, які товари вивантажувати: весь каталог, окремі категорії чи за правилами відбору.
3. За потреби відкоригуйте склад offer у розділі «Шаблон XML».
4. Натисніть «Перевірити» — побачите один товар таким, яким він піде у фід.
5. Запустіть вивантаження й скопіюйте посилання з колонки «Файл» у кабінет Prom (або віддавайте файл на FTPСпосіб передавати файли між комп'ютером і сервером. Постачальники іноді викладають на FTP-сервер прайси, а програма забирає їх звідти за логіном і паролем.).
6. Задайте розклад у «Налаштуваннях розкладу», а в кабінеті Prom — як часто майданчик забирає фід.

Перші кілька прогонів зазирніть у журнал і в кабінет Prom: чи фід формується без помилок і чи оновилися товари.

Що потрапляє у фід

Кожен товар — один offer. Набір елементів можна змінювати в шаблоні; за замовчуванням він такий:

Категорії за замовчуванням несуть ваші ідентифікатори: у категорії id="{uuid}" з прив'язкою до батьківської, у товарі — той самий ключ у categoryId. Щоб віддавати номер категорії самого Prom, є підстановки {category_id_prom} і {category_name_prom}: вони беруть значення, заповнені при зіставленні з довідником майданчика.

Ідентифікатор — той самий UUID, що і в XLSX

id пропозиції — наш UUID товару, той самий ключ, що йде в колонку «Ідентифікатор_товару» файлу XLSX. Prom упізнає товар за id і оновлює наявну позицію; новий товар зі своїм UUID додає як новий. Формати між собою не «сваряться». Чому це рятує від дублів — Як Elbuz оновлює товари на Prom без дублів.

Якщо id пропозиції все-таки змінили

1. Поверніть у шаблоні атрибут у вигляд id="{uuid}" — так він стоїть у шаблоні за замовчуванням.
2. Натисніть «Перевірити»: у id має стояти той самий довгий ідентифікатор, що й у колонці «Ідентифікатор_товару» вивантаження XLSX.
3. Запустіть вивантаження. Наступний фід знову посилатиметься на ті самі картки, що й до помилки.

Картки, які встигли створитися на Prom з іншим id, прибирають у кабінеті Prom: команд на видалення у фіді немає.

Звідки береться опис

За замовчуванням у фід іде поле «Опис повний» з картки: <description>{description_full}</description>. HTML-розмітка при цьому екранується, і теги потрапляють у файл як текст.

• Віддати HTMLМова розмітки веб-сторінок: з неї браузер будує те, що ви бачите — заголовки, абзаци, таблиці, картинки. як є — загорніть підстановку в CDATA: <description><![CDATA[{description_full}]]></description>.
• Віддати інший текст — замініть підстановку в розділі «Шаблон XML» на інше поле, наприклад {description_short} («Опис короткий»), або на власний текст.

Характеристики й різновиди

Характеристики виходять елементами param з атрибутами name і unit. Українські назви й значення виводять власним шаблоном рядка атрибута з макросами {Атрибут: Название_ua} та {Атрибут: Значение_ua}.

Різновиди зв'язуються через group_id: Prom складає їх в одну картку з вибором варіанта. Для Prom у фід ідуть самі різновиди (з галочкою «Опції» в шаблоні), а основний товар, у якого є різновиди, пропускається.

Акційна й стара перекреслена ціна на Prom

Щоб покупець на Prom бачив стару ціну перекресленою, а поруч нову, у offer мають бути дві ціни: <price> — ціна зі знижкою, <oldprice> — ціна без знижки. Шаблон «prom.ua (XML)» за замовчуванням передає лише одну ціну <price>{price}</price>, тому знижки на Prom немає, доки ви не додасте другий тег.

Як передати знижку з Elbuz

1. Розставте акційні ціни правилами «Акції/Знижки» або руками в картці товару. Акційна ціна лягає в поле каталогу «Ціна акція» ({price_special}). У правилі для знижки ставте відсоток зі знаком мінус (-7) і не ставте прапорець «Від кількості (опт)» — він робить ціну від кількості, яка у фід не йде.
2. Натисніть у вікні правил «Застосувати правила для товарів» і переконайтеся, що в сітці товарів колонка «Ціна акція» заповнилася.
3. У картці шаблону, розділ «Шаблон XML», замініть рядок <price>{price}</price> на два:

   <price>[[IF({price_special}>0 AND {price_special}<{price}, ROUND({price_special}, 2), ROUND({price}, 2))]]</price>
   <oldprice>[[IF({price_special}>0 AND {price_special}<{price}, ROUND({price}, 2), '')]]</oldprice>

4. Натисніть «Перевірити» на товарі з акцією: у price має стояти акційна ціна, в oldprice — звичайна. На товарі без акції price — звичайна, oldprice порожній.
5. Запустіть вивантаження. Prom підхопить знижку при найближчому оновленні за посиланням (як часто Prom забирає фід).

Умова {price_special}<{price} захищає від двох помилок: від «знижки», яка насправді дорожча за звичайну ціну, і від перекресленої ціни в товарів без акції. ROUND(…, 2) потрібен, бо в розрахункових блоках [[…]] дробова ціна інакше виходить із хвостом нулів: 699.50000000.

Як Prom читає ціни — правила майданчика

Що відбувається на Prom від початку до кінця акції

Застосування правил запускають кнопка у вікні правил, пакетне оновлення прайсів, збереження картки товару й зміна ціни в сітці. Прострочені акції прибирає будь-яке застосування по всьому каталогу, тож за щоденного оновлення прайсів кінець акції спрацює сам. Якщо за день жодного застосування не було, наступного дня після дати закінчення натисніть «Застосувати правила для товарів» — у сам день закінчення акція ще чинна. Ціна, введена руками в картці, лишається до її власної дати закінчення. Докладно — дати акції.

Інші джерела старої ціни

• Постійна перекреслена ціна без акції — наприклад, рекомендована ціна постачальника: <oldprice>[[IF({price_rrp}>{price}, ROUND({price_rrp}, 2), '')]]</oldprice>. Тоді price лишається {price}.
• Поле «Стара ціна» ({price_old}) — підставляйте, лише якщо самі ведете його як ціну до знижки: пакетне оновлення прайсів саме записує в нього попередню ціну при кожній зміні, тож воно буває рівним або навіть нижчим за поточну — перекреслення тоді не буде або буде неправдивим.
• Знижка відсотком замість двох цін: <discount>7%</discount> поруч зі звичайним <price>{price}</price>. Відсоток можна брати з поля товару через підстановку {Товар БК: назва поля}.

Довідник тегів Prom YML і підстановки Elbuz

Усі теги, які Prom приймає у файлі YML, за довідкою Prom, і чим їх заповнити в шаблоні Elbuz. Теги, яких немає в довідці, Prom при імпорті ігнорує. У вузлі товару працює будь-яке поле каталогу — підстановкою {код_поля} або {Товар БК: Назва поля}; перевіряйте результат кнопкою «Перевірити».

Групи (категорії)

Товар (offer)

Що перезаписує кожен прогін

Фід не дописується — щоразу він збирається з нуля. У кожному файлі стоїть поточне значення з Elbuz для кожного елемента шаблону: ціна, наявність, назва, опис, характеристики, фото. Elbuz не питає в Prom, що там правили руками.

Щоб лишити поле за собою, приберіть його елемент із «Шаблон XML»: чого немає в шаблоні, того немає й у файлі. Окремої галочки «не чіпати це поле» немає. Як Prom чинить із полями, яких у фіді немає, задає майданчик.

Галочка «Вивантажувати лише нові дані»

З нею у файл ідуть тільки товари без позначки «Вивантажено». Позначка ставиться в кінці успішного прогону товарам, які потрапили у файл, і знімається, щойно товар змінили — у картці чи в сітці.

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

Коли товар зникає з фіда

Товар не потрапляє у файл, якщо не пройшов відбір шаблону: позначка «Вивантажувати у файл (на сайт)», активна категорія, фільтр, обрані категорії, магазин, склад. Повний перелік — Чому товар не поїхав у файл. Для фіда Prom є ще дві причини:

• увімкнено «Вивантажувати лише нові дані», а товар уже позначений як вивантажений;
• це основний товар із різновидами: він пропускається завжди, а різновиди йдуть лише з галочкою «Опції».

Нуль на складі товар із фіда не прибирає. За замовчуванням available="true" отримує тільки статус «В наявності», решта статусів — available="false", а товар лишається у файлі. Що віддавати за кожним статусом, задають у вікні «Налаштування оновлення за наявністю товару» з картки шаблону.

Масове зникнення ловлять стоп-правила: за замовчуванням вони попереджають, якщо наявність упала більш ніж на 30%, загальна кількість — більш ніж на 50% або вивантажувати нічого. У режимі «Зупинити вивантаження» файл не перезапишеться. Детальніше — Стоп-правила.

1

Поріг

2

Режим

3

Показувати зведення перед запуском

1. Поріг — значення, при перевищенні якого правило спрацьовує.
2. Режим — що робити при спрацюванні: вимкнено, попереджати або зупинити вивантаження.
3. Перемикач показує зведення змін перед запуском вивантаження.

Що робить із позиціями, яких не стало у фіді, сам Prom, — правило майданчика.

Розклад, журнал і посилання на фід

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

Як іде прогін

1. Передпольотне зведення і стоп-правила: у режимі «Зупинити вивантаження» файл не чіпається зовсім.
2. Категорії («Вивантаження категорій товарів»), якщо їх увімкнено в шаблоні.
3. Товари: кожні 500 товарів у журналі рядок «Вивантаження товарів 500 із 12 340».
4. Файл іде спершу на FTP (якщо заповнено «Налаштування FTP»), потім у сховище; старі файли шаблону прибираються лише після заливання нового.
5. У шаблон записуються посилання, розмір і дата; останній рядок — «Вивантаження даних завершено».

Якщо прогін обірвався

Напівзібраного фіда Prom не отримає: публікація — остання дія прогону. Ознаки обриву — дата в «Останнє вивантаження» не зрушила, а в журналі «Вивантаження даних НЕ завершено: файл не сформовано» або «Вивантаження перервано користувачем!». Кнопка «Стоп» обриває фід Prom на найближчому товарі.

• Жоден товар не підійшов — файл не перезаписується, за посиланням попередній.
• Файл не залився у сховище — у журналі «Файл не завантажився в хмарне сховище…». На FTP новий файл уже лежить: туди він іде раніше.

Повторювати безпечно: файл збирається з нуля, а позначка «Вивантажено» ставиться лише в кінці успішного прогону. Завислий розклад сторож розблоковує, коли від старту минула година, а ознак життя немає понад пів години.

Як побачити, що відпрацювало

У списку шаблонів результат видно без відкриття картки: «Останнє вивантаження», «В наявності» з різницею щодо минулого прогону і «Файл» із кнопкою «Копіювати посилання» та розміром. Майже порожній фід помітний уже за розміром.

1

Останнє вивантаження

2

В наявності

3

Файл

1. Останнє вивантаження — дата й тривалість останнього прогону шаблону.
2. В наявності — скільки товарів потрапило у файл і як це змінилося щодо минулого прогону.
3. Файл — ім'я файлу, кнопка «Копіювати посилання» та розмір.

Кнопка «Перевірити» показує готовий offer одного товару і помилки: невалідний XML, помилку у формулі, нерозпізнані макроси. У бойовому прогоні нерозпізнаний макрос вирізається мовчки, і вузол виходить порожнім. Чи влаштують Prom назви, категорії й характеристики, вирішує сам Prom при імпорті.

Як часто Prom забирає фід

Розклад Elbuz лише кладе свіжий файл за посиланням. Коли Prom його прочитає, вирішує сам майданчик — за довідкою Prom:

• Ціна, наявність, кількість і знижка оновлюються раз на 4 години, з 6:00 до 22:00; точний час залежить від навантаження Prom.
• Решта полів і нові товари — раз на добу, вночі.
• У налаштуваннях імпорту в кабінеті Prom можна зняти поля, які майданчик не повинен оновлювати, і задати, що робити з товарами, яких немає у файлі.
• «Оновити примусово» і «Тільки оновлення» для періодичного імпорту за посиланням не діють — лише для ручного запуску.
• Якщо файл недоступний кілька днів поспіль, на 4-й день Prom надсилає лист, а на 6-й вимикає періодичний імпорт. Посилання в кабінеті лишається — імпорт треба ввімкнути знову.

Тому оновлювати фід в Elbuz частіше, ніж раз на кілька годин, немає сенсу: Prom однаково візьме найсвіжіший файл у своє вікно.

Вимкнути шаблон чи видалити

• Вимкнений шаблон не запускається за розкладом і в масовому прогоні, без рядка в журналі. За посиланням лишається останній фід, уже не свіжий. Кнопкою «Вивантажити» його можна запустити вручну.
• Видалення прибирає текст XML-шаблону, відбір, статуси наявності, FTP і розклад. Повернути — лише новим шаблоном із новим посиланням.

Межі та числа

• Стелі за кількістю товарів немає. На демо-акаунті — 100 товарів, про це є рядок у журналі.
• Фото — до десяти на товар. Менше задають у полі «Максимальна кількість фотографій» картки шаблону.
• Розклад — від години. Варіанта «щохвилини» в конструкторі розкладу немає.
• Масовий прогін — по черзі. «Вивантажити всі шаблони» бере активні шаблони один за одним.
• У кожного шаблону своє посилання, навіть за однакового імені файла.
• Розмір фіда для Prom — до 180 МБ (рекомендація майданчика). Більший каталог розбийте на кілька шаблонів за категоріями й додайте в кабінет Prom кілька посилань.

XML чи XLSX — коли що

Для щоденного автоматичного оновлення цін і наявності зручніший XML-фід: Prom забирає його сам. Для повного обміну з усіма колонками Prom — файл XLSX. Ключ товару в них однаковий, тож можна залити каталог файлом, а далі тримати свіжим фідом. Порівняння й що буває, коли ті самі товари йдуть обома шляхами, — XLSX чи XML/YML.

Фід — рух в один бік: із Prom у Elbuz він нічого не забирає. Для цього є імпорт XLSX (Prom/EVO).

Сценарії

Тримати ціни й наявність на Prom свіжими щодня

Що ввімкнути. Шаблон формату «prom.ua (XML)», розклад у «Налаштуваннях розкладу», а посилання з колонки «Файл» — у кабінет Prom. Галочку «Вивантажувати лише нові дані» лиште знятою.

Що вийде. Кожен прогін збирає файл з нуля з поточними цінами й статусами, і за тим самим посиланням лягає новий файл. Товар без залишку лишається у файлі з available="false".

Чого не буде. Позиції на Prom фід не видаляє: команди «прибрати» у файлі немає.

Продавати на Prom лише частину асортименту

Що ввімкнути. Оберіть для шаблону потрібні категорії, а вужчий відбір задайте на вкладці «Обмеження вивантаження (фільтр)». Окремий товар чи категорію прибирають галочкою «Вивантажувати у файл (на сайт)» у їхніх картках.

Що вийде. У файл іде тільки те, що пройшло відбір. Передпольотне зведення рахує товари за тим самим фільтром.

Чого не буде. Товари, що випали з відбору, з Prom не прибираються — фід просто перестає їх містити.

Товари з розмірами й кольорами

Що ввімкнути. Галочку «Опції» в шаблоні.

Що вийде. Кожен різновид іде окремим offer з group_id основного товару. Сам основний товар у фід для Prom не йде.

Чого не буде. Без галочки «Опції» різновиди у файл не потрапляють, а основний товар однаково пропускається — такий товар зникає з фіда повністю.

Не віддати Prom порожній фід через збій у каталозі

Що ввімкнути. Виділіть шаблон у списку, у меню «Додаткові операції» відкрийте «Стоп-правила вивантаження», для потрібного правила поставте «Зупинити вивантаження» і натисніть «Зберегти для цього шаблону».

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

Чого не буде. Зупинений або незавершений прогін не стає новою точкою порівняння: нею буває лише успішне вивантаження.

Назви й описи правлю в кабінеті Prom, від Elbuz потрібні лише ціна й наявність

Що ввімкнути. Приберіть із «Шаблон XML» елементи, які не хочете віддавати, — наприклад, опис. Атрибут id="{uuid}" не чіпайте.

Що вийде. Прибраного елемента у файлі немає.

Чого не буде. Elbuz не знає, що ви правили на Prom. Як майданчик поводиться з полями, яких немає у фіді, — правило самого Prom.

Акція мінус 7% на категорію до кінця місяця з перекресленою ціною

Що ввімкнути. У «Акції/Знижки» правило: «%» -7, прапорець «Від кількості (опт)» знятий, у «Додатковому фільтрі» — категорія, «Дата закінчення» — останній день місяця. Застосуйте правила. У шаблоні Prom замініть рядок ціни на пару price + oldprice з розділу про акційну ціну.

Що вийде. У товарів категорії у фіді price на 7% нижчий за oldprice. Після найближчого оновлення за посиланням Prom показує стару ціну перекресленою. Після дати закінчення наступне застосування правил обнуляє «Ціна акція», і фід віддає звичайну ціну без oldprice.

Чого не буде. Prom не бачить дату закінчення з фіда — знижка на ньому тримається, поки її несе фід; Prom за замовчуванням ставить знижці строк 45 днів. Прострочену акцію прибирає будь-яке застосування правил; якщо за день його не було, натисніть кнопку застосування наступного дня після дати закінчення.

Акція має початися в понеділок

Що ввімкнути. Правило з «Дата початку» — понеділок. У понеділок застосуйте правила кнопкою (або дочекайтеся пакетного оновлення прайсів, яке зачепить ці товари).

Що вийде. До дати початку «Ціна акція» не заповнюється, тож у фіді звичайна ціна. Застосування в день початку ставить акційну ціну, і вона йде у фід.

Чого не буде. Акція не ввімкнеться сама рівно опівночі: потрібне застосування правил у цей день.

Показувати на Prom перекреслену рекомендовану ціну постачальника

Що ввімкнути. Лишіть <price>{price}</price> і додайте <oldprice>[[IF({price_rrp}>{price}, ROUND({price_rrp}, 2), '')]]</oldprice>.

Що вийде. Товари, у яких РРЦ вища за вашу ціну, отримують на Prom перекреслену РРЦ. Решта — без перекреслення.

Чого не буде. Prom дає такій «знижці» той самий строк 45 днів. Якщо товар не в наявності, ціною на Prom стане oldprice, тобто РРЦ.

Знижка відсотком без розрахунку двох цін

Що ввімкнути. Поруч зі звичайною ціною додайте <discount>10%</discount> — сталою або з поля товару, якщо відсоток різний.

Що вийде. Prom сам рахує ціну зі знижкою від price і показує обидві.

Чого не буде. Якщо в тому ж offer є oldprice, discount Prom ігнорує. Каталог Elbuz про таку знижку нічого не знає: на вашому сайті й в інших фідах її немає.

Що робити, коли фід не оновився

Часті запитання

Який ідентифікатор товару у XML-фіді?

Атрибут id пропозиції — UUID товару в Elbuz, той самий ключ, що й «Ідентифікатор_товару» у XLSX. Тому Prom оновлює позиції без дублів.

Як Prom підхопить нові товари з фіда?

Новий товар іде у фід зі своїм UUID у id. Prom бачить невідомий ідентифікатор і додає товар як новий, а наявні позиції оновлює.

Чому у фіді не всі фото товару?

Для Prom кількість зображень у фіді обмежена десятьма на товар — це вимога майданчика. Перше фото вважається головним.

Чи треба щоразу вивантажувати фід вручну?

Ні. Задайте розклад шаблону, а Prom забирає фід за посиланням зі своєю періодичністю. Далі каталог на Prom оновлюється сам.

Як передаються різновиди (варіанти) товару?

Через атрибут group_id: Prom складає їх в одну картку з вибором варіанта. У фід ідуть самі різновиди з галочкою «Опції», а основний товар пропускається.

Що буде, якщо вивантаження обірветься посередині?

За посиланням лишиться попередній файл: новий потрапляє у сховище лише зібраним повністю. Повторний запуск безпечний — файл щоразу збирається з нуля.

Що дає вимкнення шаблону?

Шаблон не запускається за розкладом і в масовому прогоні, але за посиланням лишається останній фід, уже не свіжий. Після повернення в «Активний» налаштування не втрачаються.

Яке поле товару йде в опис (description) фіда Prom і як підставити своє?

За замовчуванням — «Опис повний» ({description_full}), HTML-теги екрануються. Для HTML як є загорніть підстановку в CDATA, для іншого тексту замініть її в «Шаблон XML» (звідки береться опис).

Як передати на Prom стару перекреслену й нову акційну ціну?

Розставте акційні ціни правилами «Акції/Знижки» (відсоток зі знаком мінус, без прапорця «Від кількості (опт)») і замініть у шаблоні рядок ціни на пару: price — «Ціна акція», якщо вона менша за звичайну, oldprice — звичайна ціна (готові рядки).

Чи повернеться на Prom звичайна ціна після закінчення акції?

Так. Після дати закінчення наступне застосування правил обнуляє «Ціна акція», фід віддає звичайну ціну без oldprice, і Prom оновить ціну при найближчому оновленні — раз на 4 години з 6:00 до 22:00. Дату з фіда Prom не читає: при імпорті за посиланням знижка діє, поки її несе фід, і не довше 45 днів (як іде акція).

Як швидко зміни ціни з Elbuz з'являться на Prom?

Ціну, наявність, кількість і знижку Prom оновлює за посиланням раз на 4 години з 6:00 до 22:00, решту полів і нові товари — раз на добу вночі (як часто Prom забирає фід).

Чому в товару, якого немає в наявності, на Prom немає знижки?

Це правило Prom: знижка діє лише в товару «в наявності». Для товару з available="false" Prom бере ціною значення oldprice.

Які ще теги Prom можна додати у фід?

Наприклад, name_ua і description_ua (українська назва й опис — лише парою), quantity_in_stock, portal_category_id, keywords, dimensions, gtin. Повний перелік із підстановками Elbuz — довідник тегів.

Суміжні теми

• Якщо потрібен повний обмін з усіма колонками Prom і новими товарами — Вивантаження на Prom файлом XLSX.
• Якщо треба забрати каталог або правки з Prom у Elbuz — Імпорт каталогу з XLSX (Prom/EVO).
• Якщо незрозуміло, чому товар не потрапив у фід або як налаштувати розклад — Шаблони вивантаження.