Excel из Пром → YML для Розетка :: Полная инструкция
Полное руководство по использованию excel-приложения с макросами vba, генерирующего YML для Розетки из экспортного xlsx-файла с Prom.
В макрос периодически добавляется новый функционал, в связи с чем дописываются новые пункты. Недавние обновления подсвечиваются красным цветом.
До макроса↑
У Розетки требования к оформлению товаров гораздо строже чем у Пром, поэтому прежде чем генерировать YML из экспортного prom-файла, стоит навести некоторый первичный порядок.
Правка товаров на Prom↑
Непосредственно на своём prom-сайте делаются изменения с товарами, чтобы у модераторов Розетки было меньше поводов придираться. Например, можно названия товаров сделать по их схеме или проследить чтобы фото было без ватермарков. Самому prom-сайту это пойдёт только на пользу.
Выгрузка экспортного Excel-файла с Prom↑
- Авторизируйтесь в своём личном кабинете на Prom.
- Выберите в левом вертикальном меню
«Товары и услуги» >>> «Управление товарами и услугами» . - В верхнем горизонтальном панельном меню кликните по кнопке «Экспорт».
- Во диалоговом окне выберите пункты:
- Настройки групп и позиций для экспорта --> Экспортировать все группы и все позиции.
- Настройки видимости позиций для экспорта --> Опубликованные позиции.
- Формат для экспорта --> Excel-файл (формат .xlsx).
- Нажмите кнопку «Экспортировать группы и позиции».
- Сохраните экспортный excel-файл на своём компьютере.
Редактирование экспортного Excel-файла с Prom↑
Правится полученный на предыдущем этапе экспортный Excel-файл – контент-менеджер подправляет категории, описания, названия и т.п. таким образом, чтобы модераторы Розетки не возмущались.
На этом этапе делаются именно те правки, соответствующие требованиям Розетки, но нежелательные на самом prom-сайте.
Макрос↑
Подготовленный на предыдущих этапах excel-файл можно прогнать через макрос. Сохраните изменения в экспортном файле с Пром и закройте его. Откройте excel-приложение «_prom_rozetka.xlsm» (в режиме выполнения макросов, разумеется).
Настройки↑
Прежде чем запустить макрос на выполнение – необходимо убедиться, что на листах «options» и «category» все параметры прописаны правильно. На остальных листах ничего менять не нужно: «temp-product» и «temp-category» технические, а в «log» записываются логи при формировании YML.
Лист options↑
Это основной (но не единственный) лист, где указываются почти все настройки макроса.
В зелёной области прописываются глобальные настройки, в синей области ничего менять не нужно, в жёлтой области указываются настройки для тегов.
Общие настройки↑
- «Короткое название магазина» – содержимое для основного тега <name> (наименование интернет-магазина) в финальном YML-файле для Розетки.
- «Наименование компании» – содержимое для основного тега <company> (форма собственности и официальное название юридического лица, владеющего интернет-магазином).
- «Веб-сайт магазина» – содержимое для основного тега <url> (базовая ссылка для интернет-магазина).
- «id для offer (№ столбца)» – Из какого столбца на листе «Export Products Sheet» в экспортном excel-файле с Пром брать значение для атрибута id тега <offer> (уникальный идентификатор товара). Обычно это столбец №21.
- «id для групп разновидностей (№ столбца)» – Из какого столбца на листе «Export Products Sheet» в экспортном excel-файле с Пром брать идентификаторы групп разновидностей (вариантов товара). Обычно это столбец №28.
- «rate для UAH» – Курс основной валюты по отношение к гривне. Так как основная валюта – гривна, то курс, скорее всего, нужно установить равным 1.
- «rate для EUR» – Курс основной валюты (украинская гривна) по отношение к евро.
- «rate для USD» – Курс основной валюты (украинская гривна) по отношение к доллару.
- «rate для RUB» – Курс основной валюты (украинская гривна) по отношение к рублю.
- «Товары, первая строка» – начиная с какой строки на листе «Export Products Sheet» переносить товары в YML для Розетки. Обычно нужно здесь указать значение 2, потому что, скорее всего, на первой строке на листе «Export Products Sheet» будут заголовки столбцов.
- «Товары, последняя строка (необязательно)» – заканчивая на какой строке на листе «Export Products Sheet» переносить товары в YML для Розетки. Таким образом, в макросе можно указать диапазон строк, из которых товары будут перенесены в YML, остальные строки будут проигнорированы. Если значение этой опции равно 0 (это также значение по умолчанию), то произойдёт обработка товаров до последней строки.
- «Добавлять товары с критическими ошибками (0 или 1)» – В случае если указано значение 0, то товары с отсутствующей обязательной информацией (цена, название, категория и т.п.) в YML добавлены не будут. Если значение равно 1, то то товар всё равно попадёт в YML. При этом сообщения об этих инфидентах в любом случае допишутся на лист «log».
- «Универсальное значение для offer[available] (0 или 1)» – Товар по умолчанию сразу доступен или нет? 0 означает false, а 1 означает true.
- «Добавлять товары, которых нет в наличии? (0 или 1)» – Если указано значение 0, то отсутствующие товары (см. две предыдущие опции) добавлены не будут. Если указано значение 0, то добавление товара в YML зависит от других факторов, но не от наличия.
- «Лист с товарами» – Название листа с товарами в экспортном excel-файле с Пром. Если этот лист не переименован, то он называется «Export Products Sheet».
- «Лист с категориями» – Название листа с категориями. Если этот лист не переименован, то он называется «Export Groups Sheet».
- «Номер строки, с которой начинаются категории» – с какой строки на листе «Export Groups Sheet» начинаются категории. Обычно со второй, потому что на первой строке заголовки столбцов.
- «Категории - categoryId (номер столбца)» – порядковый номер столбца на листе «Export Groups Sheet», в котором хранятся уникальные идентификаторы категорий. Обычно это столбец №1.
- «Категории - название (номер столбца)» – порядковый номер столбца на листе «Export Groups Sheet», в котором хранятся названия категорий. Обычно это столбец №2.
- «Категории - parentId (номер столбца)» – порядковый номер столбца на листе «Export Groups Sheet», в котором хранятся идентификаторы родителей для категорий. Обычно это столбец №4.
Категории↑
На листе «options» вообще не нужно трогать синюю облать, макрос её заполняет сам.
Теги↑
В жёлтой области перечислены теги, для которых нужно указать столбец на листе «Export Products Sheet» в экспортном excel-файле с Пром, в котором у товаров указаны значения для этих тегов. Также можно указать значения по умолчанию, на случай у товара значение не заполнено или же такой столбец у тега вообще отсутствует.
- «url» – Откуда брать значение для тега <url> (Ссылка на товар)? Обычно это столбец №2 на листе «Export Products Sheet» в экспортном excel-файле с Пром.
- «price» – Откуда брать значение для тега <price> (Цена)? Обычно это столбец №6.
- «currencyId» – Откуда брать значение для тега <currencyId> (Валюта)? Обычно это столбец №7.
- «categoryId» – Откуда брать значение для тега <categoryId> (Идентификатор категории)? Обычно это столбец №15.
- «picture» – Откуда брать значение для тегов <picture> (Ссылки на изображения)? Обычно это столбец №12.
- «vendor» – Откуда брать значение для тега <vendor> (Производитель)? Обычно это столбец №15.
- «stock_quantity» – Откуда брать значение для тега <stock_quantity> (Количество товара на складе)? Обычно это столбец №14. Также в столбце «По умолчанию» стоит указать дефолтное значение, которое будет применено к товару, если данное значение для него на листе «Export Products Sheet» отсутствует.
- «name» – Откуда брать значение для тега <name> (Наименование товара)? Обычно это столбец №2.
- «description» – Откуда брать значение для тега <description> (Описание товара)? Обычно это столбец №4.
- «param=Артикул» – Откуда брать значение для тега <param> с атрибутом name=Артикул (Артикул товара)? Обычно это столбец №1.
- «param=Страна» – Откуда брать значение для тега <param> с атрибутом name=Страна (Страна производителя)? Обычно это столбец №26.
- «param=Доставка/Оплата» – Откуда брать значение для тега <param> с атрибутом name=Доставка/Оплата (Условия доставки и оплаты)? Обычно в экспортном excel-файле с Пром нет данной информации, однако в столбце «По умолчанию» можно указать дефолтное значение, которое будет применено ко всем товарам.
- «param=Гарантия» – Откуда брать значение для тега <param> с атрибутом name=Гарантия (Гарантия на товар)? Обычно нет данной информации, однако в столбце «По умолчанию» можно указать дефолтное значение.
Дополнительные настройки↑
В красной области прописываются дополнительные настройки для тегов. Настройка должна быть указана в той же строке, что и соответствующий тег в жёлтой области.
- «Универсальный коэффициент для цены» – Универсальная скидка/наценка для всех товаров. Все цены умножаются на указанное число. По умолчанию равно 1. Если нужно указать скидку/наценку для товаров из конкретной категории, то это можно сделать на листе «category».
- «Переводить все цены в гривны? (0 или 1)» – Если 1, то в финальном YML все цены будут переведены в гривны (по тем курсам, что указаны в настройках выше). Если 0, то иные валюты останутся такими, как есть.
- «Максимальное количество фотографий» – сколько изображений <picture> прикреплять к торговому предложению. Согласно правилам Розетки, у товара не должно быть более 8-ми фото. Если имеется много фотографий, а указано в этой настройке, к примеру 2, то тогда в YML попадут первые две фотографии товара.
- «Только с производителями? (0 или 1)» – если значение этой настройки равно 1, то в YML попадут только те товары у которых указан производитель.
- «Столбец с наличием товара» – Колонка, в которой указано, доступен ли товар для немедленной доставки. Обычно это столбец №13.
- «Отсеять дубликаты по названию? (0 или 1)» – Если значение =1, то производится проверка, не вносили ли в YML уже товар с таким названием? Если уже есть, то товар не попадает в YML.
- «Брать только первые абзацы?» – В настройке указывается суммарное число – количество абзацев/параграфов <div>/<p>, обрезается весь текст, идущий после них.
- «Название характеристики, первый столбец» – С какого столбца на листе «Export Products Sheet» в экспортном excel-файле с Пром начинаются характеристики товара? Обычно это столбец №31.
Лист category↑
На этом листе указываются наценки к цене, которые применяеются к товарам из определённых категорий. Если для категории указывается наценка, то цены всех товаров из данной категории будут умножены на этот коэффициент. Что касается товары из тех категорий, у которых нет своей наценки, то их цены будут умножены на глобальную наценку, указанную на листе «options».
Применение макроса↑
После того, как все настройки проверены и правильно указаны, можно наконец-то применить макрос.
- Нажмите кнопку «Загрузить файл и создать XML».
- В открывшемся диалоговом окне выберите экспортный excel-файл с prom-товарами.
- Макрос автоматически преобразует excel в yml и закроет экспортный файл
- YML для Розетки будет автоматически сохранён в той же папке, где находится макрос. В названиии файла yml будет указано дата и время его создания.
- На листе «log» в файле с макросом появится отчёт о процессе генерации. Будут указаны какие товары попали в YML, а какие нет и по каким причинам (отсутствует цена, категория и проч.)
- На листе «temp-product» в файле с макросом строки добавленных в YML товаров закрасятся в зелёный цвет. Если товар не попал в YML в результате ошибки, то ячейка с ошибкой (название-дубликат, некорректная цена, отсутствие производителя и т.п.) будет закрашена в красный цвет.
После макроса↑
Можно ещё подредактировать товары непосредственно в сгенерированном YML, если это удобнее, чем в экспортном excel-файле.
После всех правок на всех этапах YML высылаеся в Розетку на проверку.