Як вивантажити каталог на Prom.ua файлом XLSX

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

• Шаблон формату Prom одразу містить повний набір колонок Prom — складати їх вручну не треба.
• Два аркуші файлу — товари й групи — у тій самій структурі, яку Prom віддає при власному експорті.
• Ідентифікатор товару в кожному рядку — Prom упізнає наявні позиції й не плодить копії.
• Колонка «Наявність» рахується з поточного статусу наявності товару в Elbuz.
• Склад колонок шаблону вирішує, які поля поїдуть на Prom, а які лишаться за кабінетом.
• Розклад і стоп-правила оновлюють файл без вас і не віддають зіпсований.

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

Меню

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

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

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

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

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

Підготувати

каталог, завантажений із Prom імпортом XLSX

Як створити шаблон Prom

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

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

Що потрапляє у файл і звідки беруться значення

Два аркуші

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

• «Export Products Sheet» — товари з повним набором колонок Prom (назва, ціна, наявність, ідентифікатори, характеристики й десятки додаткових полів).
• «Export Groups Sheet» — структура груп (категорій): номери, назви, ідентифікатори та зв'язок «батько–дитина».

Поля картки і сталі значення

Колонки заповнюються з полів картки товару. Частина — з рідних полів (назва, ціна, кількість, габарити, GTINЗагальна назва номерів штрихкодів товару — EAN, UPC та інших. Маркетплейси й Google за ним упізнають товар., категорія, виробник, опис, meta). Десятки Prom-специфічних колонок — із додаткових полів, які створив імпорт при першому завантаженні: оптова ціна, знижки, тип товару, спосіб пакування, ярлики, подарунки. Вивантаження віддає назад те, що прийшло з Prom, плюс ваші зміни.

Шість колонок віддають не поле картки, а сталу, прописану при створенні шаблону:

• Тип_товару — r (роздріб);
• Валюта — код вашої базової валюти;
• Одиниця_виміру — «шт.»;
• Мінімальний_обсяг_замовлення і Можливість_поставки — 1;
• Термін_поставки — «день».

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

Колонка «Наявність»

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

За довідкою Prom порожня «Наявність», нульовий залишок і & («Очікується») дають на Prom статус «Немає в наявності». Prom розуміє ще @ — послуга, ! — «Готово до відправки» (лише для компаній із високими показниками) і цифру — скільки днів на доставку товару під замовлення. Щоб товар «Очікування 2-3 дні» був на Prom доступним до замовлення, змініть для нього символ у формулі на 3 (власні статуси).

Стандартні статуси формула впізнає не за назвою, тож перейменування їх не ламає. Якщо ви раніше правили цю формулу під свої статуси, вона лишається вашою. Сама формула лежить у вікні «Налаштування формул для полів базового каталогу».

Формула виконується не в момент вивантаження, а коли ви зберігаєте картку товару або коли товари проходять пакетну обробку прайс-листів. Тому у файл їде значення, збережене в картці на цю мить.

Знижки й акції у файлі Prom

У файлі Prom знижку несуть три колонки поруч зі звичайною ціною: розмір знижки і строк її дії. Ціну зі знижкою Prom рахує сам.

Звідки Elbuz бере знижку

Колонки знижки беруть значення з полів картки «Скидка_xls», «Cрок действия скидки от» і «Cрок действия скидки до», які з'являються разом із шаблоном Prom. Заповнювати їх руками не треба — це робить застосування правил «Акції/Знижки»:

• правило з відсотком дає в «Скидка» цей відсоток без знака (-7 → 7%); правило з фіксованою ціною, коефіцієнтом чи сумою — різницю між звичайною й акційною ціною (12.50);
• знижку дають лише правила для роздрібної групи (за замовчуванням) і не «Тільки для авторизованих»; ручна акційна ціна з картки в «Скидка» не йде;
• дати знижки — «Дата початку» й «Дата закінчення» правила; порожня дата дає порожню клітинку. Знижка з майбутньою датою початку потрапляє у файл одразу разом із датами — на відміну від поля «Ціна акція», яке чекає дати початку;
• поля заповнюються лише для справжньої знижки — коли акційна ціна нижча за звичайну. Правило з додатним відсотком (націнка) знижки на Prom не дає;
• коли дата закінчення минула або правило вимкнули чи видалили, застосування правил очищає всі три поля — у наступному файлі знижки вже не буде.
• усе це працює, лише коли для поля «Ціна акція» немає активної формули: з формулою колонки знижки правила не заповнюють і не очищають.

Колонка «Ціна» при цьому лишається звичайною ціною — знижку віднімає Prom. Не підставляйте в «Цена» поле «Ціна акція»: інакше Prom зніме знижку вдруге.

Довідник колонок Prom

Усі колонки аркуша товарів за довідкою Prom і звідки їх бере шаблон Elbuz. Шаблон пише заголовки так, як їх віддавав експорт Prom, — російською («Скидка», «Cрок действия скидки от»), а актуальна довідка Prom перелічує українські назви. Якщо після імпорту Prom не підхопив якусь колонку (наприклад, строк знижки), перейменуйте її в шаблоні на українську назву з таблиці нижче. Склад і порядок колонок — на вкладці «Вибір полів» шаблону. «Поле Prom» означає додаткове поле картки, яке створив шаблон Prom і заповнило завантаження каталогу з Prom.

Аркуш груп несе Номер_групи, Назва_групи (та _укр), Ідентифікатор_групи, Номер_ та Ідентифікатор_батьківської_групи, зображення й SEO-поля групи. За довідкою Prom про YML, описи й фото груп за посиланням не передаються.

Як Elbuz оновлює товари на Prom без дублів

Обмін тримається на ідентифікаторах. У файл вивантаження вони лягають так:

Чому Prom не задвоює товари з Elbuz

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

З Elbuz цієї проблеми немає: вивантаження завжди кладе в Ідентифікатор_товару наш UUID — і для товарів, які ви щойно створили. Prom упізнає наявні позиції й оновлює саме їх. Експорт із Prom заради ідентифікаторів не потрібен.

Порядок обміну з Prom крок за кроком

1. Завантаження. Заберіть каталог з Prom у Elbuz — імпортом XLSX. Кожен товар отримає UUID, що дорівнює його Ідентифікатору_товару на Prom.
2. Робота в Elbuz. Змінюйте ціни й наявність, редагуйте картки, додавайте нові товари. Нові позиції отримують власний UUID; номера Prom у полі «Унікальний_ідентифікатор» у них немає.
3. Вивантаження. Сформуйте файл у форматі Prom. У кожного товару стоїть Ідентифікатор_товару (UUID), а в нових Унікальний_ідентифікатор порожній.
4. Завантаження на Prom. Віддайте файл на майданчик. Наявні товари оновляться, нові додадуться, і Prom присвоїть їм свій внутрішній номер.

Далі цикл повторюється: наступні вивантаження несуть ті самі UUID, тож Prom оновлює ті самі позиції.

Що прогін змінює в каталозі й що перезаписує на Prom

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

• Перераховує дерево категорій. При запуску кнопкою оновлюються рівні та шляхи категорій. Посилання на батьківську категорію проставляється заново там, де воно порожнє або розійшлося з батьківською, — при будь-якому запуску, зокрема за розкладом.
• Заповнює prom-поля карток — Номер_групи, Ідентифікатор_групи, Ідентифікатор_підрозділу, Адреса_підрозділу. Значення береться з категорії товару, а якщо і там порожньо — з іншого товару тієї ж категорії. Заповнюються тільки порожні поля (у Номера_групи й Ідентифікатора_групи — ще й ті, де стоїть нуль).
• Роздає внутрішні артикули — якщо ви це вмикали. З налаштуванням «Створювати унікальні значення для поля внутрішній» (розділ «Товари базового каталогу») прогін ставить випадковий номер товарам із порожнім внутрішнім артикулом, а однаковим артикулам дописує суфікс.

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

Повторний прогін поверх правок у кабінеті Prom

Кожен прогін збирає файл наново з поточних значень каталогу: що зараз у картці, те й поїде на майданчик. Старий файл із тим самим ім'ям видаляється на початку прогону.

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

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

Чому товару немає у файлі

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

• товар без категорії у файл не потрапляє: рядки будуються від зв'язки «товар — категорія»;
• у товару має бути опис мовою, якою формується вивантаження.

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

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

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

Як переконатися, що файл зібрався

Журнал прогону відкривається в «Операціях» і лишається в кнопці «Історія запусків» шаблону. Шаблон Prom пише прогрес рядком «Вивантажено рядки N із M» на кожній тисячі товарів. Успіх — «Вивантаження даних завершено» і посилання «Завантажити файл ‹ім'я›»; провал — «Вивантаження даних НЕ завершено: файл не сформовано». Як читати решту рядків — Журнал прогону.

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

1

Файл

2

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

3

В наявності

1. Файл — посилання на готовий файл вивантаження, під ним розмір у МБ.
2. Останнє вивантаження — дата прогону та скільки він тривав.
3. В наявності — кількість товарів у наявності, під нею загальна кількість товарів у вивантаженні.

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

Якщо прогін обірвався або його зупинили

Нове посилання, розмір і дата записуються в шаблон лише після успішного заливання файлу. Обрив на будь-якому кроці до цього лишає на посиланні попередній файл. Повторний запуск безпечний: файл збирається з нуля, і на Prom Elbuz нічого не відправляє.

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

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

Межі та обсяги

• Рядків у файлі — стільки, скільки товарів пройшло відбір; стелі немає. На демо-акаунті — 100 товарів, про це є рядок у журналі.
• Клітинка XLSX — 32 767 символів. Довший текст (зазвичай опис) обрізається на цій межі.
• Фото — перші 10 посилань. У колонку «Посилання_зображення» йдуть десять фотографій за порядком сортування.
• Масовий прогін — одна година. «Вивантажити всі шаблони» йде окремим процесом, шаблони один за одним, на весь процес — година.

XLSX чи XML/YML — що обрати

Prom приймає обидва формати, і обидва несуть той самий ідентифікатор товару — наш UUID.

Можна початково залити каталог файлом XLSX, а далі тримати його свіжим XML-фідом — позиції лишаться тими самими.

Якщо ті самі товари йдуть і XLSX, і фідом

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

Спільні в них prom-поля карток (Номер_групи, Ідентифікатор_групи, Ідентифікатор_підрозділу, Адреса_підрозділу): їх заповнює прогін будь-якого prom-шаблону, і тільки порожні. За розкладом два вивантаження одночасно не йдуть — друге скасовується з рядком про конфлікт обробки даних.

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

Сценарії

Каталог ведете в Elbuz і додаєте на Prom нові товари

Що ввімкнути. Спершу заберіть каталог з Prom завантаженням XLSX, потім створіть шаблон формату Prom і сформуйте файл кнопкою «Вивантажити». Колонку «Ідентифікатор_товару» на вкладці «Вибір полів» не прибирайте.

Що вийде. Позиції, що прийшли з Prom, майданчик упізнає за UUID і оновить. Товари, створені в Elbuz, підуть із порожнім «Унікальний_ідентифікатор», і Prom додасть їх як нові.

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

Опис і фото ведете в кабінеті Prom, з Elbuz — решту

Що ввімкнути. Відкрийте шаблон, вкладка «Вибір полів», і приберіть кнопкою «Видалити поле» колонки, які ведете на майданчику. «Ідентифікатор_товару» залиште.

Що вийде. Прибраних колонок у файлі не буде зовсім.

Чого не станеться. Правки з кабінету Prom у Elbuz самі не потраплять: для цього потрібне окреме завантаження каталогу.

Файл оновлюється за розкладом, і не можна віддати каталог, у якому зникла наявність

Що ввімкнути. Меню «Додаткові операції» у вікні вивантаження → «Стоп-правила вивантаження». Для правила «обвал наявності щодо минулого прогону» поставте режим «Зупинити вивантаження» і натисніть «Зберегти для цього шаблону». Поріг за замовчуванням — 30%.

1

Обвал наявності щодо минулого прогону

2

Режим

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

Що вийде. Якщо товарів у наявності поменшало щодо минулого успішного прогону більше, ніж на поріг, прогін — і ручний, і за розкладом — закінчиться рядком «Вивантаження зупинено стоп-правилом: …». На посиланні лишиться попередній файл. Усі правила й режими — Стоп-правила.

Чого не станеться. Вимкнений шаблон розклад не запускає зовсім, і стоп-правила тут ні до чого. Стежте, щоб у колонці «Стан» стояло «Активний».

У вас власні статуси наявності

Що ввімкнути. Нічого: власний статус формула поля «Наличие_xls» віддає за кількістю — +, якщо вона більша за нуль, інакше -. Хочете для свого статусу інший символ Prom — допишіть гілку у формулу у вікні «Налаштування формул для полів базового каталогу», потім збережіть картки або проженіть пакетну обробку прайс-листів.

Що вийде. Колонка «Наявність» у наступному файлі отримає символ, заданий формулою.

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

На Prom іде лише частина каталогу

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

Що вийде. У файл підуть лише товари, що пройшли відбір.

Чого не станеться. Товари, які перестали проходити відбір, на Prom не позначаються на видалення: вони просто зникають із файлу.

Знижка 7% на категорію з 1 по 30 число

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

Що вийде. У рядках товарів категорії «Скидка» = 7% і дати правила. Prom застосовує знижку з 1-го по 30-те число й сам знімає її після дати закінчення.

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

Акцію треба зняти раніше строку

Що ввімкнути. Вимкніть правило у вікні «Акції/Знижки» — збереження вимкнення одразу перераховує акції. Сформуйте файл і віддайте його Prom.

Що вийде. У товарів правила колонки «Скидка» і строку знижки порожні, «Цена» — звичайна. Prom після імпорту показує ціну без знижки.

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

Що робити, коли файл вийшов не таким

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

Чому при ручному редагуванні файлу Prom задвоює товари, а через Elbuz — ні?

Prom дублює позиції, коли у файлі немає ідентифікаторів товарів. Elbuz завжди ставить Ідентифікатор_товару (наш UUID) у кожен рядок, тож Prom упізнає наявні товари й оновлює саме їх.

Чи треба знову експортувати з Prom після додавання нових товарів?

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

Як Prom підхопить новий товар, створений у Elbuz?

Такий товар іде з власним UUID в Ідентифікаторі_товару й порожнім Унікальним_ідентифікатором. Prom бачить невідомий ідентифікатор, додає товар як новий і присвоює свій номер.

Чому наявність у файлі не така, як зараз у картці?

У файл іде поле «Наличие_xls», а його формула перераховується при збереженні картки або пакетній обробці прайс-листів, не під час вивантаження. Збережіть картку — і наступний файл понесе свіжий символ (колонка «Наявність»).

Що станеться з правками, які я зробив у кабінеті Prom, після наступного вивантаження?

Файл понесе поточні значення з Elbuz по всіх колонках шаблону. Поле, яке ведете в кабінеті, приберіть зі шаблону кнопкою «Видалити поле» (повторний прогін).

Я натиснув «Стоп» — вивантаження зупиниться?

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

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

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

Як передати на Prom знижку з датами через файл XLSX?

Заведіть правило «Акції/Знижки» з відсотком зі знаком мінус і датами та застосуйте правила. Elbuz заповнить колонки «Скидка» і «Cрок действия скидки от/до»; Prom застосує знижку до ціни. Дати надійно працюють при ручному завантаженні файлу; за посиланням можуть не спрацювати (знижки у файлі).

Що буде зі знижкою на Prom, коли акція в Elbuz закінчиться?

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

Які колонки Prom обов'язкові?

«Назва_позиції», «Опис», «Ідентифікатор_товару», а для вже доданих товарів — ще «Унікальний_ідентифікатор». Шаблон Elbuz усі їх заповнює. Повний перелік — довідник колонок.

Суміжні теми

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