Експорт: Prom YML

Тип Prom YML збирає XML-файл для маркетплейсу Prom. Спільні поля експорту, режими, фільтри, накрутка і AI описані на сторінці Експорт.

Офіційний опис формату: Prom YML.

Налаштування

На вкладці Налаштування типу Prom YML є один перемикач: Лише категорії, прив'язані до товарів. За замовчуванням вимкнений, підпис Да / Нет.

Коли він вимкнений, у файл пишуться всі активні категорії магазину. Коли увімкнений, лишаються категорії, які стоять на товарах цього вивантаження.

Якщо тип не входить у тариф, над полем показано попередження, а в списку експортів поруч жовтий знак Не доступний для поточного тарифного плану.

Файл

Файл має розширення xml. Корінь yml_catalog з датою в часовому поясі Європи/Київ. Усередині shop три блоки: валюта, категорії, товари.

Валюта завжди одна: UAH з курсом 1.

Категорії

У блок потрапляють лише активні категорії.

  • назва категорії
  • id — зовнішній id правила категорії, якщо він заповнений. Інакше id категорії в системі
  • parentId — id батьківської категорії в системі. Зовнішній id батька сюди не підставляється
  • portal_id — категорія Prom першого товару цієї категорії, у якого вона заповнена. Без неї атрибута немає

Товар

Товари йдуть спочатку в наявності, далі за id.

  • id — id товару з урахуванням режиму ID і поля Перезаписати ID товару
  • available — true, якщо товар у наявності. false, якщо це передзамовлення. Інакше атрибут порожній
  • group_id — лише коли він є в товара
  • name і name_ua, якщо українська назва заповнена
  • categoryId — той самий id, що в категорії: зовнішній або системний
  • quantity_in_stock — кількість товару. Якщо кількість порожня, а товар у наявності, пишеться 1
  • price — роздрібна ціна після накрутки і округлення. Перезаписати Ціну з правил товару замінює її
  • оптові ціни, якщо вони є: блок prices, у кожному price поля value і quantity
  • oldprice, якщо стара ціна заповнена
  • currencyId — UAH
  • vendor — виробник
  • vendorCode — артикул, не більше перших 25 символів
  • country
  • description і description_ua, якщо український опис заповнений
  • keywords_ua, якщо заповнені, і keywords
  • характеристики param. Перший завжди Состояние зі значенням Новое. Далі, якщо в товара є характеристики Prom, у файл йдуть вони: назва, одиниця і значення через |. Звичайні характеристики тоді не дублюються. Без характеристик Prom пишуться характеристики товару. Назва і значення беруться з полів Prom, а якщо вони порожні — зі звичайних
  • preorder — true, якщо є кількість, товар у наявності або це передзамовлення. Інакше false
  • in_stock="true", коли кількість не менше 10
  • regions — регіони постачальника. У постачальника це вкладка Prom, поле Регіони Prom, не більше трьох. Без них блока немає
  • dimensions — вага в kg, ширина, висота і довжина в cm. Пишеться лише те, що заповнене
  • portal_category_id — id категорії Prom товару, якщо вона заповнена

Якщо в системі нема каталогу Prom, на вкладці AI показано: Для використання синхронізації з Prom потрібно встановити модуль. Будь ласка, зв’яжіться з техпідтримкою. Якщо нема довідника регіонів, на вкладці Prom постачальника показано: Щоб скористатися цим функціоналом, необхідно підключити модуль Region. Будь ласка, зв’яжіться з техпідтримкою.

Група за характеристикою

Якщо в товара заповнена Характеристика як група і в неї є значення, кожне значення стає окремим товаром у файлі.

До id такого товару додається v і номер значення, починаючи з нуля. group_id — перші 9 символів id основного товару. У характеристиці групи лишається лише це значення.

Зображення

Доступно з версії 9.7.0

Якщо для товару заповнені зображення Prom, у YML потрапляють вони. Якщо набір порожній, використовуються звичайні зображення товару. У файл додається не більше 10 тегів picture. Порожні адреси пропускаються.

Як підготувати ці зображення, дивіться Товари.

Prom API

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