Шаг 1. Создайте YML-файл
Вы можете создать YML-файл следующими способами
• Вручную (если у вас небольшое количество товаров);
• Через CMS вашего корпоративного сайта (используя встроенные возможности);
• Экспортировать информацию о товарах из вашей базы данных в YML-файл.
Для обновления товаров или цен вам нужно периодически создавать новый YML-файл и выкладывать его на сайт или поставить скрипт, который будет делать это автоматически.
Если вы указываете YML-ссылку, данные загружаются автоматически с периодичностью, которую вы укажите.
Требования к YML-файлу
Для импорта допускаются документы в формате XML. Документы не должны быть заархивированы.
Описание формата XML
Документ формата XML — это текстовый документ, состоящий из элементов, составляющих иерархическую структуру.
Объявление
Начинаться документ должен с объявления (XML declaration) — строки, в которой указывается версия документа и кодировка.
<?xml version="1.0" encoding="UTF-8"?>
Допустимые кодировки — UTF-8, windows-1251.
Элементы
Строки, начинающиеся с открывающего тега, заканчивающиеся закрывающим.
<section>Это элемент</section>
Строка внутри тега называется содержимым тега.
Атрибуты
Пара имя-значение, которая задает свойства элементов. Размещается внутри открывающего или пустого тегов.
<section id=«1»>Это элемент</section>
В примере атрибут id со значением 1, значение заключается в кавычки.
Структура документа
Элемент yml_catalog
Любой XML-документ может содержать только один корневой элемент. Формат YML в качестве корневого использует элемент yml_catalog.
<yml_catalog>
<shop>
...
</shop>
</yml_catalog>
Элемент shop
Следующий в иерархии элемент shop. Для него должно быть определено поле url. Значение поля - url главной страницы интернет-магазина. Используется для формирования ссылки на товар на оригинальном сайте в случае отсутствия ссылки на собственную страницу товара.
<shop>
<url>http://site.ru</url>
...
<offers>
...
</offers>
</shop>
Элемент currencies
Элемент задает список валют магазина. Каждая валюта задается отдельным элементом currency. Каждый элемент должен иметь параметр id (код валюты), который может иметь значения: "RUR" для рублей, "UAH" для гривен, "BYR" для белорусских рублей, "KZT" для тенге, "USD" для долларов, "EUR" для евро, “DOG” для договорной цены.
Элемент currencies используется при формировании цен товаров.
<currencies>
<currency id="RUR"/>
<currency id="USD"/>
<currency id="EUR"/>
...
</currencies>
Элемент categories
В элементе categories содержится список категорий магазина. Каждая категория описывается отдельным элементом category. Описание категории должно включать ее идентификатор (параметр id) для всех категорий и идентификатор категории более высокого уровня для подкатегорий. Идентификатор категории должен быть уникальным положительным целым числом. Ни у одной категории параметр id не может быть равен "0". Если элемент parentId не указан, то категория считается корневой.
Параметры:
id — идентификатор вашей категории товаров
parentId — идентификатор предыдущей по иерархии категории товаров
<categories>
<category id="1">Книги</category>
<category id="2">Видео</category>
<category id="3" parentId="1">Детективы</category>
...
</categories>
На портале BLIZKO элемент categories используется при формировании групп товара на вашем сайте.
Элемент offers
В элементе offers содержится список товарных предложений магазинов. Каждое товарное предложение описывается отдельным элементом offer.
У элемента offer могут быть следующие атрибуты: id, available.
В атрибуте id указывается идентификатор товарного предложения. Атрибут может содержать только цифры и латинские буквы. Максимальная длина id — 20 символов. Идентификатор предложения должен быть уникальным среди всех товарных предложений одного прайс-листа. Если у двух и более товарных предложений указать одинаковые атрибуты id, то идентификатор будет присвоен только первому из этих предложений. Для остальных будет выводиться предупреждающее сообщение об отсутствии идентификатора.
В атрибуте available указывается статус доступности товара:
• «false» — товарное предложение под заказ;
• «true» — товарное предложение в наличии.
Описание элементов, которые BLIZKO импортирует из YML:
Элемент в YML файле |
Описание |
Поле на BLIZKO |
Значение |
Обязательный |
<categoryId> |
Идентификатор категории товара |
Группа товара |
Должен быть уникальным положительным целым числом, не может быть равен «0». Максимальная длина - 75 символов |
Да |
<group_id> |
На карточках товаров выводятся селекты с пользовательскими характеристиками, лимит 8 значений |
ID группы мультитовара |
Может содержать только цифры. Максимальная длина — 9 символов |
Нет |
<currencyId> |
Идентификатор валюты товара |
Валюта у товара |
RUR, USD, EUR, DOG, BYR, KZT, UAH |
Да |
<id> |
Уникальный идентификатор товара |
|
Может содержать только цифры и латинские буквы. Максимальная длина — 20 символов. |
Да |
<url> |
Адрес страницы товара |
|
http(s)-ссылка. Максимальная длина - 1000 символов. |
Нет |
<name> |
Наименование товара |
Название товара |
Максимальная длина - 120 символов |
Да |
<typePrefix> |
Группа товара |
Название товара |
|
Нет |
<vendor> |
Производитель |
Название товара |
|
Нет |
<model> |
Модель |
Название товара |
|
Нет |
<announce> |
Краткое описание товара |
Краткое описание |
Максимальная длина - 255 символов |
Нет |
<price> |
Цена товара |
Цена/Новая цена |
Числовое значение |
Нет |
<oldprice> |
Цена без скидки |
Старая цена |
Числовое значение |
Нет |
<discount_expires_at> |
Срок действия скидки |
Действует до |
Дата |
Нет |
<price_min> |
Минимальная цена |
Цена от |
Числовое значение |
Нет |
<price_max> |
Максимальная цена |
Цена до |
Числовое значение |
Нет |
<measure_unit> |
Единица измерения товара |
Единица измерения товара |
Возможные значения: шт., уп., ед., пара, мешок, рулон, бухта, комплект, чел., секция, т, ц, кг, г, мг, м3, л, мл, бр, гал, кв.м, га, сот, км, м, см, мм, п.м., мин, ч, сут, нед, мес, год, день, маш.смен. |
Нет |
<wholesale_price> |
Оптовая цена (нестандартный тег, работает для BLIZKO) |
Оптовая цена |
Числовое значение |
Нет |
<wholesale_price_min> |
Оптовая цена от (нестандартный тег, работает для BLIZKO).
Перед ценой выводится предлог "от" |
Оптовая цена |
Числовое значение |
Нет |
<wholesale_currency> |
Валюта для оптовой цены (нестандартный тег, работает для BLIZKO) |
Оптовая цена |
RUR, USD, EUR, DOG, BYR, KZT, UAH |
Нет, но обязательный для Оптовой цены |
<wholesale_measure_unit> |
Единица измерения оптовой цены (нестандартный тег, работает для BLIZKO) |
Оптовая цена |
Возможные значения: шт., уп., ед., пара, мешок, рулон, бухта, комплект, чел., секция, т, ц, кг, г, мг, м3, л, мл, бр, гал, кв.м, га, сот, км, м, см, мм, п.м., мин, ч, сут, нед, мес, год, день, маш.смен. |
Нет, но обязательный для Оптовой цены |
<wholesale_min_qty> |
При заказе от для оптовой цены (нестандартный тег, работает для BLIZKO). Обязательное поле, если вы хотите указывать оптовую ценуна BLIZKO |
Оптовая цена |
Числовое значение |
Нет, но обязательный для Оптовой цены |
<vendorCode> |
Артикул |
Артикул |
|
Нет |
<picture> |
Ссылка на изображение |
Фото |
Максимальное число загружаемых изображений - 5 |
Нет |
<description> |
Полное описание товара |
Описание |
Максимальная длина - 20 000 символов |
Нет |
<param> |
Позволяет передавать свойства (характеристики) товаров |
Характеристики на портале |
Формат <param name="название характеристики">значение характеристики</param> Например: <param name="Материал:">ПВХ характеристики</param> |
Нет |
<min_qty> |
Минимальный размер заказа |
Минимальный размер заказа |
Числовое значение |
Нет |
<qty_measure_unit> |
Наименование единицы минимальной партии |
Минимальный размер заказа |
|
Нет |
<sales_notes> |
Условия оплаты |
Условия оплаты |
Максимальная длина - 75 символов |
Нет |
<available> |
Статус доступности товара в наличии/под заказ |
Наличие |
true/false |
Нет |
<delivery> |
Условия доставки |
Доставка |
true/false |
Нет |
<local_delivery_cost> |
Стоимость доставки |
Доставка |
Числовое значение |
Нет |
<delivery_field> |
Условия доставки |
Доставка |
Максимальная длина - 75 символов |
Нет |
Правила заполнения поля “Название товара”
1. Название товара формируется из тега <name>
2. Если тег <name> отсутствует, то название товара формируется из тегов <typePrefix> + <vendor> + <model>
Правила заполнения поля “Условия доставки”
• Если значение тега <delivery> = false, то в товаре в поле “Доставка” будет выводиться - самовывоз;
> • Если значение тега <delivery> = true, то в товаре в поле “Доставка” будет выводиться - Доставка возможна;
> • Если значение тега <delivery> = true и есть тег <local_delivery_cost>, то в товаре в поле “Доставка” будет выводиться - сумма указанная в теге <local_delivery_cost> руб. в пределах города.
> • Если значение тега <delivery> = true/false и есть тег <delivery_field>, то в товаре в поле “Доставка” будет выводиться информация из тега <delivery_field>.
Правила заполнения поля “Изображения”
Через YML к одному товару можно подгрузить до 5 изображений, для этого каждую ссылку необходимо указывать в отдельном теге
Пример содержания YML файла.
<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog >
<shop>
<!-- Адрес главной страницы интернет-магазина -->
<url>http://mysite.ru</url>
<!-- Список валют интернет-магазина -->
<currencies>
<currency id="RUR"/>
<currency id="USD"/>
<currency id="EUR"/>
</currencies>
<!-- Список категорий товарных предложений -->
<categories>
<category id="1">Часы</category>
<category id="2" parentId="1">Наручные женские часы</category>
<category id="3" parentId="1">Наручные мужские часы</category>
</categories>
<!-- Список товарных предложений -->
<offers>
<!-- ==================== 1 ==================== -->
<offer id="1" available="true" >
<url>http://mysite.ru/product_page.asp?pid=12348</url>
<price>699.54</price>
<measure_unit>шт.</measure_unit>
<currencyId>USD</currencyId>
<categoryId>2</categoryId>
<picture>http://mysite.ru/img/device12345.jpg</picture>
<delivery>false</delivery>
<name> Золотые наручные часы </name>
<announce> Регулируемый ремешок тесьма с металлической застежкой </announce>
<min_qty>1</min_qty>
<qty_measure_unit>шт.</qty_measure_unit>
<description> Изящные золотые часы </description>
<sales_notes> Необходима предоплата </sales_notes>
<rubricId>https://www.pulscen.ru/price/332302-naruchnye-chasy<rubricId></rubricId>
</offer>
<!-- ==================== 2 ==================== -->
<offer id="2" available="true" >
<url>http://mysite.ru/product_page.asp?pid=12351</url>
<price>700</price>
<is_exact_price>false</is_exact_price>
<price_max>1000</price_max>
<measure_unit>шт.</measure_unit>
<currencyId>USD</currencyId>
<categoryId>3</categoryId>
<picture>http://mysite.ru/img/device12346.jpg</picture>
<delivery>true</delivery>
<local_delivery_cost>300</local_delivery_cost>
<typePrefix>Часы наручные мужские</typePrefix>
<vendor> Longines </vendor>
<model> A1234485B </model>
<announce> Классические мужские часы с кожаным ремешком </announce>
<description> Классические механические мужские часы с автоподзаводом на кожаном ремешке </description>
<min_qty>1</min_qty>
<qty_measure_unit>шт.</qty_measure_unit>
<sales_notes> Необходима предоплата </sales_notes>
</offer>
<!-- ==================== 3 ==================== -->
<offer id="3" available="false" >
<url>http://mysite.ru/product_page.asp?pid=15570</url>
<price>700</price>
<discount_expires_at>20.02.2015</discount_expires_at>
<measure_unit>шт.</measure_unit>
<currencyId>USD</currencyId>
<categoryId>2</categoryId>
<picture>http://mysite.ru/build.strojmir/200806/10180545.html/02.jpg</picture>
<picture>http://mysite.ru/ui/10213852/image/17-1.jpg</picture>
<picture>http://mysite.ru/images/foto/c/0/apps/4/87/4087503_purple-decoration-25.jpg</picture>
<picture>http://mysite.ru/uploads/posts/2008-11/1225613551_3.jpg</picture>
<picture>http://mysite.ru/imgcache/64104.jpg</picture>
<delivery_field>По согласованию с поставщиком</delivery_field>
<name> Женские наручные часы Longines A1211157B </name>
<announce> Механические женские наручные часы на кожаном ремешке </announce>
<description> Элегантные механические женские наручные часы с автоподзаводом на кожаном ремешке </description>
<sales_notes> Необходима предоплата </sales_notes>
<min_qty>1</min_qty>
<qty_measure_unit>шт.</qty_measure_unit>
</offer>
</offers>
</shop>
</yml_catalog>
Шаг 2. Переход в раздел
Перейти на страницу загрузки YML можно из нескольких разделов
сайта:
• из меню настроек, в разделе
Товары и услуги, выбрав пункт
Импортировать товары из YML/XML
• или из левого меню на
сайте, кликнув на ссылку
Загрузить YML/YRL:
• из Каталога, нажав на
ссылку Загрузить из YML:
• Или через Редактор товаров
и услуг, в поле Добавить товары, выберите
Загрузить YML:
Шаг 3. Настройка импорта
На странице импорта товаров из YML есть несколько вкладок:
Загрузка и
Расширенные настройки.
В первый вкладке Загрузка, выберите тип
загружаемых данных: ссылка или
файл:
• Если вы загружаете ссылку, пропишите
саму ссылку (п. 1) и
формат данных: YML или
YRL (п. 2):
• Для загрузки файла в
формате YML, YRL или XML нажмите на кнопку
Выбрать и
загрузите соответствующий файл с вашего
компьютера:
Для успешного импорта YML, YRL или XML файл должен
соответствовать формату Яндекс.Маркета.
В поле Сайт магазина пропишите ссылку на ваш
сайт:
Ссылка в поле «Сайт магазина» актуальна только
для магазинов с подключенными переходами и
на платном размещении.
Затем вам нужно указать есть ли на сайте товары, которых нет в
загружаемом файле.
Выберите кнопку Нет, если такие товары
отсутствуют:
Если в файле, есть товары, уже размещенные на сайте, нажмите
кнопку Да и выберите,
что нужно сделать с этими позициями:
• Оставить опубликованными
• Удалить
После настройки импорта нажмите кнопку
Загрузить.
Во вкладке Расширенные настройки вы можете
дополнительно настроить следующие параметры:
• выборочное обновление полей, которое
позволяет обновлять только некоторые поля из файла
• получение отчетов о загрузке товаров на
e-mail
• название товара в каталоге на вашем
сайте
После сохранения расширенных настроек, они будут автоматически
применяться каждый раз
при обновлении YML-файла.
Обратите внимание!
На бесплатном размещении возможность расширенной настройки
отсутствует.
Для подключения данной функции вам нужно перейти на
платный пакет.
Если в результате загрузки возникли ошибки, вы увидите
уведомление:
Для того, чтобы подробно ознакомиться с ошибками, которые
возникли при импорте YML-файла,
перейдите на вкладку Ошибки:
На данной вкладке указаны ошибки, допущенные при загрузке файла
YML.
Пример критической ошибки:
файле размещена недействующая ссылка на фотографию товара,
поэтому товар будет опубликован на сайте, но без изображения к
нему.
Пример некритической ошибки:
в файле содержаться слишком длинные названия товаров.
Такой файл также будет опубликован, но длинные названия
автоматически обрежутся
до необходимой длины.
В случае, если были обнаружены ошибки при загрузке,
скорректируйте файл YML и
повторно загрузите его на ваш сайт.
После успешного импорта ваши товары будут доступны для привязки
к рубрикатору BLIZKO,
редактирования и публикации на сайте.