Ця стаття — про зворотний бік обміну з майданчиками EVO (Prom.ua, satu.kz, deal.by): як вивантажити каталог із Elbuz у файл Excel того самого формату Prom, щоб завантажити його назад на маркетплейс. Формат вивантаження й формат завантаження в Prom однакові, тож імпорт та експорт тут — єдиний цикл. Про завантаження з такого файлу читайте парну статтю імпорт каталогу з XLSX (Prom/EVO), а про вивантаження загалом — шаблони вивантаження.
Офіційний опис на боці майданчика: Експорт товарів та груп товарів і формат файлу XLS(X)/CSV. Загальний розділ обміну — Імпорт та експорт у довідці Prom.
Де це у програмі
У вікні вивантаження ви створюєте шаблон і обираєте формат Prom. Elbuz одразу заповнює шаблон повним набором колонок Prom — вам не треба складати їх вручну. Далі ви обираєте, які товари вивантажувати (весь каталог, окремі категорії чи за правилами відбору), і формуєте файл. Формувати його можна вручну кнопкою «Вивантажити» або за розкладом; на майданчик готовий файл ви віддаєте самі — до Prom програма не звертається.
Що формує вивантаження: два аркуші
Файл на виході має ту саму структуру, що й файл завантаження Prom — два аркуші:
- «Export Products Sheet» — товари з повним набором колонок Prom (назва, ціна, наявність, ідентифікатори, характеристики й десятки додаткових полів).
- «Export Groups Sheet» — структура груп (категорій): номери, назви, ідентифікатори та зв'язок «батько–дитина».
Саме тому файл, вивантажений із Elbuz, Prom приймає без переробки: це той самий формат, який майданчик віддає при власному експорті.
Звідки беруться значення
Колонки файлу заповнюються з полів картки товару. Частина — з рідних полів (назва, ціна, кількість, габарити, GTIN, категорія, виробник, опис, meta), а десятки Prom-специфічних колонок — із тих додаткових полів, які створив імпорт при першому завантаженні (оптова ціна, знижки, тип товару, спосіб пакування, ярлики, подарунки тощо). Тому вивантаження нічого не «вигадує»: воно віддає назад те, що прийшло з Prom, плюс ваші зміни.
Частина колонок віддає не поле картки, а сталу, прописану при створенні шаблону: Тип_товару — r (роздріб), Валюта — код вашої базової валюти, Одиниця_виміру — «шт.», Мінімальний_обсяг_замовлення і Можливість_поставки — 1, Термін_поставки — «день». Стала лежить у колонці «Формула» на вкладці «Вибір полів» шаблону, і поки вона там стоїть, вона перекриває значення однойменного поля картки: у кожному рядку файлу буде те саме. Хочете віддавати справжні значення з карток — очистіть клітинку «Формула» у цієї колонки.
Колонка Наявність влаштована складніше, ніж здається. Вона бере значення не зі статусу наявності напряму, а з окремого поля картки товару — воно так і називається, «Наличие_xls», і з'являється разом із prom-шаблоном. Заповнює його формула, яку створює завантаження каталогу з Prom: вона зіставляє назву статусу наявності із символом Prom: «В наличии» → +, «Нет в наличии» → -, «Ожидание 2-3 дня» → &, «Предзаказ» → 5. Формула виконується не в момент вивантаження, а коли ви зберігаєте картку товару або коли товари проходять пакетну обробку прайс-листів; сама вона лежить у вікні «Налаштування формул для полів базового каталогу», і її можна виправити під свої статуси.
Статус наявності, назва якого не збіглася з жодною гілкою формули, дає порожню клітинку «Наявність» — формула в такому разі повертає порожнє значення, і вивантаження нічого не додумує. А порожню «Наявність» Prom читає як «немає в наявності». Тому перейменований статус або власний, доданий вами («Під замовлення», «Очікується постачання»), здатен тихо погасити на майданчику весь каталог: файл зібрався, помилок у журналі немає, а товари на Prom стали недоступними. Якщо ви правили довідник статусів — допишіть нові назви у формулу поля «Наличие_xls».
Окремий випадок — каталог, який у Elbuz ніколи не завантажували з Prom, а вели самі. Тоді формули немає взагалі: її створює саме завантаження. Поле «Наличие_xls» залишиться порожнім, поки ви не заповните його вручну або не заведете формулу самі.
Ідентифікатори на виході — найважливіше
Саме ідентифікатори роблять обмін надійним. У файл вивантаження вони лягають так:
| Колонка Prom | Звідки береться в Elbuz |
|---|---|
| Ідентифікатор_товару | наш UUID товару — унікальний ключ позиції в каталозі. Заповнюється завжди, для кожного товару. |
| Унікальний_ідентифікатор | внутрішній номер Prom із додаткового поля. Якщо його немає (товар створено в Elbuz, а не прийшов з Prom) — колонка йде порожня. |
| Ідентифікатор_групи | однойменне поле картки товару. Якщо воно порожнє або дорівнює нулю — у файл іде UUID категорії, у якій лежить товар. |
| Ідентифікатор_підрозділу | однойменне поле картки товару. Якщо воно порожнє або дорівнює нулю — береться номер категорії на Prom, збережений у самій категорії. |
Ключове тут — що Elbuz завжди проставляє Ідентифікатор_товару (наш UUID) у кожен рядок. Це принципово важливо для наступного розділу.
Ті самі prom-поля прогін заповнює й у картках товарів, перш ніж збирати файл, — але тільки там, де вони порожні. Що саме й за яких умов, розібрано нижче, у розділі «Що прогін змінює у вашому каталозі».
Чому Elbuz не задвоює товари на Prom
У Prom є відома пастка: якщо редагувати файл вручну й завантажувати назад без ідентифікаторів, майданчик не може відрізнити наявні товари від нових — і дублює їх (додає ще раз, як нові). Саме тому в довідці Prom радять спершу зробити експорт із кабінету, щоб у файлі проставились ідентифікатори, а вже потім вносити зміни.
З Elbuz цієї проблеми немає: вивантаження завжди кладе в колонку Ідентифікатор_товару наш UUID — для кожного товару, зокрема й для тих, що ви щойно створили в каталозі. Тому Prom бачить ідентифікатор у кожному рядку, впізнає наявні позиції й оновлює саме їх, а не плодить копії. Вам не треба «спершу експортувати з Prom, щоб отримати ідентифікатори» — Elbuz дає їх сам.
Порядок обміну з Prom крок за кроком
Повний цикл роботи виглядає так:
- 1. Завантаження. Заберіть каталог з Prom у Elbuz — імпортом XLSX. Кожен товар отримає UUID, що дорівнює його Ідентифікатору_товару на Prom.
- 2. Робота в Elbuz. Змінюйте ціни й наявність, редагуйте картки, додавайте нові товари. Нові позиції отримують власний UUID; поля «Унікальний_ідентифікатор» у них немає.
- 3. Вивантаження. Сформуйте файл вивантаження у форматі Prom. У ньому в кожного товару вже проставлено Ідентифікатор_товару (UUID), а в нових — порожній Унікальний_ідентифікатор.
- 4. Завантаження на Prom. Віддайте файл на майданчик. Наявні товари (чий Ідентифікатор_товару Prom знає) оновляться, нові — додадуться, і Prom присвоїть їм свій внутрішній номер.
Далі цикл повторюється: наступні вивантаження знову несуть ті самі UUID, тож Prom оновлює ті самі позиції. Повторно робити експорт із кабінету Prom, щоб «підхопити» ідентифікатори, не обов'язково — Elbuz уже проставляє їх сам.
Для того щоб оновлення на Prom проходили без дублів, зворотний імпорт не потрібен: зіставлення тримається на нашому UUID. Але періодично заново завантажувати каталог із Prom у Elbuz корисно з іншої причини — щоб підхопити зміни, зроблені на боці Prom (модерація, ручні правки в кабінеті, привласнений майданчиком Унікальний_ідентифікатор). Це «гігієна» синхронізації, а не умова її роботи.
Що прогін змінює у вашому каталозі
Вивантаження здебільшого тільки читає каталог, але три речі воно в ньому таки змінює — ще до того, як почне збирати рядки файлу.
- Перераховує дерево категорій. При запуску кнопкою оновлюються рівні та шляхи категорій. А посилання на батьківську категорію проставляється заново там, де воно порожнє або розійшлося з батьківською, — це вже при будь-якому запуску, зокрема за розкладом.
- Заповнює prom-поля карток — Номер_групи, Ідентифікатор_групи, Ідентифікатор_підрозділу, Адреса_підрозділу. Значення береться з категорії товару, а якщо і в категорії порожньо — з іншого товару тієї ж категорії, у якого це поле заповнене. Заповнюються тільки порожні поля (у Номера_групи й Ідентифікатора_групи — ще й ті, де стоїть нуль): те, що вже має значення, прогін не чіпає.
- Роздає внутрішні артикули — якщо ви це вмикали. Коли в налаштуваннях увімкнено «Створювати унікальні значення для поля внутрішній» (розділ «Товари базового каталогу»), прогін проставляє випадковий номер усім товарам із порожнім внутрішнім артикулом, а товарам з однаковими артикулами дописує до артикула суфікс. Якщо налаштування вимкнене — нічого не відбувається.
Назву, ціну, опис, кількість, статус наявності й фото прогін не змінює: він їх лише читає. Формули полів картки під час вивантаження теж не перераховуються.
Оскільки prom-поля заповнюються тільки порожні, виправити вже записане значення повторним прогоном не вийде: поки в полі щось є, вивантаження його не чіпає. Щоб підставити нове — очистіть поле в картці товару (або пакетною обробкою за відбором), і наступний прогін заповнить його заново з категорії.
Повторний прогін поверх правок у кабінеті Prom
Кожен прогін збирає файл наново, з поточних значень каталогу. Пам'яті про попередній файл у нього немає: що зараз у картці, те й поїде на майданчик. Старий файл із тим самим ім'ям видаляється на початку прогону, тож двох версій не буває.
Звідси просте правило: у файл потрапляють рівно ті колонки, які перелічені на вкладці «Вибір полів» шаблону, і кожна з них несе поточне значення з Elbuz. Порожнє поле в картці дає порожню клітинку у файлі — вигадувати значення вивантаження не буде.
Якщо якесь поле ви ведете в кабінеті Prom і не хочете віддавати його з Elbuz, приберіть відповідну колонку зі шаблону кнопкою «Видалити поле». Тоді її не буде у файлі взагалі — ні заголовка, ні значень. Що майданчик робить із колонкою, якої у файлі немає, вирішує він сам: це правило Prom, і в Elbuz воно не налаштовується.
Зворотний бік — ваші правки в самому Elbuz. Тут перезаписати значення може не вивантаження, а формули полів: вони спрацьовують, коли ви зберігаєте картку товару або коли товари проходять пакетну обробку прайс-листів, і кладуть у поле розраховане значення поверх того, що там було. Товари з позначкою «Не оновлювати» (група «Захист під час імпорту» в картці товару) формули пропускають — це і є спосіб закріпити своє значення за конкретним товаром.
Правили ідентифікатори у файлі руками й на Prom з'явилися дублі — у самому Elbuz лагодити нічого не треба: сформуйте файл заново. Ідентифікатор_товару береться з UUID картки, тож у новому файлі він знову буде рідним, і наступне завантаження оновить правильні позиції.
Помилкове значення у prom-полі картки повторний прогін не виправить — очистіть поле, і воно заповниться заново з категорії. Щоб підтягнути номери, які майданчик присвоїв позиціям, зробіть завантаження каталогу з Prom: на завантаженні товари зіставляються саме за колонкою Ідентифікатор_товару.
А от прибрати зайву картку на самому Prom можна лише в кабінеті майданчика — вивантаження туди не звертається й видаляти нічого не вміє.
Чому товару немає у файлі
Товар мовчки не потрапляє у вивантаження, якщо не виконано хоча б одну умову. Окремого рядка в журналі про це не буде — зникнення видно лише за цифрами: скільки товарів пішло у файл.
- У картці товару знято позначку «Вивантажувати у файл (на сайт)».
- Категорія товару вимкнена або в ній знято ту саму позначку «Вивантажувати у файл (на сайт)». Товар без категорії у файл не потрапляє взагалі: рядки будуються від зв'язки «товар — категорія».
- У шаблоні задано відбір за категоріями, і категорія товару в нього не входить.
- У товару немає опису мовою, якою формується вивантаження.
- Товар не проходить умови на вкладці «Обмеження вивантаження (фільтр)».
- У шаблоні обрано магазин, а товар не входить до складу цього магазину.
- У шаблоні обрано склад — тоді у файл ідуть лише товари, що є на цьому складі з ненульовим залишком або зі статусом «в наявності».
- Демо-акаунт: вивантаження обмежене 100 товарами, про що в журналі є окремий рядок.
Перевірити відбір, не запускаючи прогін, можна у вікні «Що буде вивантажено», яке відкривається кнопкою «Вивантажити»: воно показує, скільки товарів піде у файл, скільки з них у наявності, скільки без ціни, без фото, без характеристик, без опису, без штрихкоду, і дає перелік умов відбору словами. Звідти ж є перехід «Показати ці товари в каталозі» — з тим самим відбором, що й у шаблоні.
Elbuz не позначає на Prom товари, яких не стало у файлі. У шаблоні є колонки «Товар на удаление» і «Причина удаления товара» — саме так вони називаються в наборі полів, — але вивантаження нічого в них не проставляє: значення беруться з однойменних полів картки товару, які заповнюєте ви. Як майданчик поводиться з позиціями, відсутніми в черговому файлі, — правило Prom; дивіться довідку майданчика за посиланнями на початку статті.
Як переконатися, що файл зібрався
Журнал прогону відкривається в «Операціях» (права панель) і живе далі в кнопці «Історія запусків» у шаблоні. Дивитися треба на п'ять рядків.
- Передпольотне зведення — рядок на початку прогону: «Передпольотне зведення: усього товарів N, в наявності N, немає в наявності N, під замовлення N, без статусу наявності N». Одразу за ним — «Минулого прогону: усього N, в наявності N», щоб було з чим порівняти.
- Прогрес — «Вивантажено рядки N із M», рядок додається на кожній тисячі товарів і ще раз наприкінці.
- Підсумок — «Вивантаження даних завершено» і «Витрачено часу: ГГ:ХХ:СС».
- Посилання — «Завантажити файл <ім'я файлу>». Це те саме постійне посилання, що й у списку шаблонів.
- Провал — «Вивантаження даних НЕ завершено: файл не сформовано». Рядок червоний, операція закривається помилкою, а дата останнього вивантаження не оновлюється. Якщо впав запит по товарах (наприклад, через помилку у формулі колонки), перед ним буде «Помилка отримання товарів!».
У списку шаблонів результат видно без відкриття журналу. Колонка «Файл» — ім'я файлу посиланням на завантаження, під ним розмір у МБ. Колонка «Останнє вивантаження» — «сьогодні, 06:40» (або «ще не вивантажувався») і тривалість «за 2 хв 14 с». Колонка «В наявності» — скільки товарів останнього прогону були в наявності, поряд різниця з попереднім прогоном, а під нею «Усього товарів: N». Саме ця пара цифр і ловить обвал: файл зібрався, а товарів у ньому стало вдвічі менше.
Перед тим, як віддавати файл на майданчик, зміст колонок можна перевірити на одному товарі: кнопка з колбою в шаблоні — «Пробне вивантаження одного товару: показати результат і знайдені помилки». Вона будує окремий тестовий файл, показує пари «колонка = значення» і знайдені помилки, не чіпаючи ні бойовий файл, ні посилання, ні FTP.
Перед кожним прогоном працюють три перевірки: обвал наявності щодо минулого прогону (поріг 30%), обвал загальної кількості товарів (50%) і порожня вивантаження (менше одного товару). За замовчуванням вони лише попереджають — у журналі з'являється «Увага, дані виглядають підозріло: …», і прогін іде далі. Якщо перемкнути правило на зупинку, замість цього буде «Вивантаження зупинено стоп-правилом: …», файл не збереться, а попередній залишиться на посиланні. Пороги налаштовуються на всі шаблони або на окремий.
Якщо прогін обірвався або його зупинили
Файл стає «тим самим файлом» лише наприкінці прогону. Спочатку рядки пишуться у тимчасову теку, потім готовий файл іде на FTP (якщо FTP налаштовано), потім у хмару, і тільки після цього в шаблон записується нове посилання, розмір і дата. Обрив на будь-якому кроці до цього означає одне: на постійному посиланні лишається попередній файл, а «Останнє вивантаження» в списку не зсувається.
Повторний запуск після обриву безпечний. Elbuz під час вивантаження нічого нікуди не відправляє — він збирає файл, тож задвоїтися немає чому. Файл із тим самим ім'ям видаляється й будується з нуля, а в хмарі перед заливанням нового файлу тека шаблону очищається, тож на посиланні завжди рівно один, останній файл.
Кнопка зупинки ставить прапорець, який перевіряється між шаблонами в режимі «Вивантажити всі шаблони»: черга зупиняється, у журналі з'являється «Вивантаження перервано користувачем!». Прогін окремого шаблону Prom цього прапорця не читає — він добудує файл до кінця, хоч ви й натиснули «Стоп». Рядок про переривання в журналі при цьому з'явиться: його пише сама кнопка, а не прогін. Тобто зовні виглядає як зупинка, а насправді нічого не сталося — файл усе одно оновиться.
Два вивантаження за розкладом одночасно не запускаються: якщо в цю мить уже йде інше, друге завдання скасовується з рядком «Скасовано вивантаження за розкладом, причина - вивантажується інший шаблон (конфлікт обробки даних)». Ручний запуск кнопкою такої перевірки не має.
Вимкнути шаблон чи видалити
Стан шаблону перемикається пілюлею в його шапці й видно в колонці «Стан» списку: «Активний» або «Вимкнений». Вимкнення — не видалення, і воно не однакове для різних способів запуску.
- Розклад вимкнений шаблон мовчки пропускає: ні помилки, ні рядка в журналі — програма вважає це вашим рішенням, а не збоєм. Це найчастіша причина сюжету «файл за розкладом більше не оновлюється, а чому — незрозуміло».
- «Вивантажити всі шаблони» бере лише активні, вимкнений у пакет не потрапляє.
- Кнопка «Вивантажити» на самому шаблоні спрацює й на вимкненому: ручний запуск стану не перевіряє.
Усе інше вимкнення зберігає: останній файл і посилання на нього, розмір, дату й тривалість останнього прогону, цифри прогонів, склад колонок, фільтр, розклад. Вмикаєте назад — розклад підхоплює шаблон наступного разу, нічого перенастроювати не треба.
Видалення шаблону — інша річ. Разом із ним зникають склад колонок, налаштування FTP, обраний відбір категорій і прив'язка до завдання розкладу, а разом із рядком списку зникає й посилання на останній файл. Відновити це можна тільки створивши шаблон заново й наповнивши його з нуля.
Межі та обсяги
Обмеження на кількість рядків у файлі в програмі немає — вивантажується стільки товарів, скільки пройшло відбір. Обмежень, про які варто знати, чотири.
- Демо-акаунт — 100 товарів. У журналі про це пишеться окремим рядком, файл збереться, але буде обрізаний.
- Клітинка XLSX — 32 767 символів. Довший текст (зазвичай опис) обрізається на цій межі, решта у файл не поїде.
- Фото — перші 10 посилань. У колонку «Посилання_зображення» потрапляють десять фотографій товару за порядком сортування, решта відсікаються.
- Масовий прогін — одна година. «Вивантажити всі шаблони» запускається окремим процесом, шаблони йдуть один за одним, і на весь цей процес відведено годину.
Вікно вивантаження на час прогону тримати відкритим не треба: журнал іде в «Операції», а програма не блокується — після запуску з'являється підказка, що вивантаження почалося і стежити за ним треба в «Операціях», і ви можете працювати далі. У хмарному режимі тимчасовий файл видаляється одразу після заливання в хмару, а в локальній теці вивантаження зберігаються три останні файли.
XLSX чи XML/YML — що обрати
Prom підтримує обидва формати, і в кожного своя роль:
- XLSX (цей формат) — повний двобічний обмін: усі поля Prom, ідентифікатори проставляються автоматично, зручно, коли ви ведете каталог у Elbuz як головній системі й вивантажуєте на Prom усе, зокрема нові товари. Файловий обмін, ви керуєте кожним полем.
- XML / YML — простіший, фідовий формат. Prom оновлює позиції з YML «на порядок легше»: ви задаєте періодичність, і майданчик сам підтягує свіжі дані з фіда. Полів менше, зате оновлення автоматичні. Добре, коли треба переважно тримати актуальними ціни й наявність.
Практичне правило: якщо Elbuz — ваша головна система і ви керуєте повним каталогом (з новими товарами, характеристиками, усіма полями) — беріть XLSX. Якщо потрібне переважно автоматичне оновлення цін і наявності з мінімумом налаштувань — зручніший YML-фід. Обидва працюють через один і той самий принцип стабільного ідентифікатора; головне — не змішувати формати наосліп в одному напрямку, щоб не заплутати відповідність позицій.
Якщо ті самі товари йдуть і XLSX, і фідом
У самому Elbuz конфлікту тут не виникає. Обидва шаблони читають ту саму картку товару, тож різних цін чи різних залишків вони принести не можуть — різниця лише в наборі колонок і в тому, як майданчик забирає дані. Файли теж не б'ються: у кожного шаблону своя тека в сховищі, тож посилання різні навіть за однакового імені файлу, і прогін одного шаблону не чіпає файл іншого.
Спільне в них одне — prom-поля карток (Номер_групи, Ідентифікатор_групи, Ідентифікатор_підрозділу, Адреса_підрозділу). Їх заповнює прогін будь-якого prom-шаблону, і заповнює тільки порожні, тож другий шаблон бачить уже проставлені значення й не перезаписує їх. Ще одне спільне обмеження: за розкладом два вивантаження одночасно не йдуть — друге завдання скасовується з рядком про конфлікт обробки даних.
Чиє значення залишиться на самому Prom, якщо той самий товар приїхав і файлом, і фідом, вирішує майданчик, а не Elbuz. Тому якщо обидва формати ведуть одні й ті самі позиції, залиште одному з них роль «повний каталог», а другому — те, чого в першому немає; або розведіть їх фільтром шаблону, щоб вони не перетиналися товарами.
Не редагуйте вручну колонки Ідентифікатор_товару та Унікальний_ідентифікатор у файлі. Це ключі синхронізації: Elbuz заповнює їх сам, а ручна зміна UUID наявного товару змусить Prom визнати його новим і задвоїти позицію.
Чого вивантаження не робить
- Не звертається до Prom. Прогін складає файл і кладе його на постійне посилання, а якщо налаштовано FTP — ще й туди. Далі файл треба віддати майданчику; жодних запитів у Prom Elbuz при цьому не робить.
- Не позначає позиції на видалення. Колонки «Товар на удаление» і «Причина удаления товара» у файлі є, але заповнюєте їх ви — у картці товару. Сам прогін нічого туди не пише.
- Не забирає зміни з Prom. Модерація, ручні правки в кабінеті, присвоєні майданчиком номери в Elbuz самі не з'являться — для цього є завантаження каталогу з XLSX.
- Не перераховує формули полів. Значення, які рахуються формулами (та сама «Наявність»), беруться такими, якими вони збережені в картці. Оновлює їх збереження картки або пакетна обробка прайс-листів, а не вивантаження.
- Не перезаписує вже заповнені prom-поля. Порожні заповнить, наявні лишить як є — навіть якщо там помилкове значення.
Розбір частих проблем
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| «Останнє вивантаження» не зсунулося, а в журналі «Вивантаження даних НЕ завершено: файл не сформовано» | Прогін упав до збереження файлу — дата й посилання оновлюються лише після успіху | На посиланні лишився попередній файл, віддавати його на Prom не можна. Подивіться рядок над помилкою (як читати журнал) і перевірте шаблон кнопкою пробного вивантаження |
| У файлі порожня колонка «Наявність», на Prom товари стали «немає в наявності» | Назва статусу наявності не збіглася з жодною гілкою формули поля «Наличие_xls» | Допишіть свої статуси у формулу (звідки беруться значення) і збережіть картки або запустіть пакетну обробку, щоб значення перерахувалися |
| Товар є в каталозі, але його немає у файлі, і в журналі про нього нічого | Він не пройшов одну з умов відбору — позначку вивантаження, категорію, фільтр, магазин або склад | Пройдіть перелік умов і звірте цифри у вікні «Що буде вивантажено» |
| Файл за розкладом не оновлюється, помилок у журналі немає | Шаблон вимкнений — розклад пропускає його мовчки. Або в цю мить уже йшло інше вивантаження | Подивіться колонку «Стан» у списку: «Вимкнений» — увімкніть (докладніше). Якщо стан «Активний», шукайте в журналі рядок про конфлікт обробки даних |
| Натиснули «Стоп», а файл усе одно оновився | Прапорець зупинки перевіряється між шаблонами пакетного прогону; окремий prom-шаблон його не читає | Дочекайтеся кінця прогону — перезапуск безпечний і нічого не задвоює (що буває при обриві) |
| Опис товару у файлі обірваний на півслові | Клітинка XLSX вміщає 32 767 символів, довший текст обрізається | Скоротіть опис у картці: більше в клітинку не вміститься (межі формату) |
Часті питання
Чому при ручному редагуванні файлу Prom задвоює товари, а через Elbuz — ні?
Prom дублює позиції, коли у файлі немає ідентифікаторів товарів і він не може відрізнити наявні від нових. Elbuz же завжди проставляє Ідентифікатор_товару (наш UUID) у кожен рядок вивантаження, тож Prom упізнає наявні товари й оновлює саме їх.
Чи треба знову експортувати з Prom після додавання нових товарів?
Для коректного оновлення без дублів — ні: Elbuz сам проставляє ідентифікатори. Заново завантажити каталог із Prom варто лише щоб підхопити зміни, зроблені на боці майданчика (модерація, ручні правки, номери, які Prom присвоїв новим товарам).
Як Prom підхопить новий товар, створений у Elbuz?
Такий товар вивантажується з власним UUID у колонці Ідентифікатор_товару й порожнім Унікальним_ідентифікатором. Prom бачить невідомий йому ідентифікатор і додає товар як новий, присвоївши свій внутрішній номер. Наявні товари при цьому оновлюються.
XLSX чи XML — що надійніше?
Це не про надійність, а про задачу. XLSX — повний двобічний обмін з усіма полями й автоматичними ідентифікаторами, коли Elbuz веде весь каталог. YML — простіший фід для автоматичного оновлення цін і наявності за розкладом. Обидва працюють на тому самому принципі стабільного ідентифікатора.
Чому наявність у файлі не така, як була при завантаженні?
Бо у файл іде не статус товару напряму, а значення поля картки «Наличие_xls». Його рахує формула, і виконується вона при збереженні картки або під час пакетної обробки прайс-листів, а не в момент вивантаження. Тому у файл поїде те, що збережено в картці на цю мить; якщо назва статусу не збіглася з жодною гілкою формули, клітинка буде порожня.
Які поля потрапляють у файл вивантаження?
Повний набір колонок Prom: рідні поля картки (назва, ціна, кількість, габарити, GTIN, категорія, виробник, опис, meta) плюс десятки Prom-специфічних полів із додаткових полів, створених імпортом. Набір колонок можна скоригувати в налаштуваннях шаблону вивантаження.
Що станеться з правками, які я зробив у кабінеті Prom, після наступного вивантаження?
Наступний файл понесе на майданчик поточні значення з Elbuz по всіх колонках, які є на вкладці «Вибір полів» шаблону. Якщо поле ви ведете в кабінеті Prom, приберіть відповідну колонку зі шаблону кнопкою «Видалити поле» — тоді її у файлі не буде взагалі. Як майданчик поводиться з колонкою, якої у файлі немає, вирішує Prom.
Я натиснув «Стоп» — вивантаження зупиниться?
Прогін окремого шаблону Prom — ні: він добудує файл до кінця, прапорець зупинки перевіряється лише між шаблонами в режимі «Вивантажити всі шаблони». Дочекайтеся кінця; перезапуск нічого не задвоює, файл збирається наново.
Що буде, якщо вимкнути шаблон?
Розклад пропустить його мовчки, без помилки й без рядка в журналі, а пакетне «Вивантажити всі шаблони» його не візьме. Кнопка «Вивантажити» на самому шаблоні спрацює й на вимкненому. Останній файл, посилання, склад колонок, фільтр і розклад зберігаються — увімкнули назад, і все працює як раніше.