Импорт товаров и услуг на сайт компании и на портал, а также экспорт с сайта и с портала может быть выполнен в одном из следующих форматов:
- файл YML в формате Яндекс.Маркет (описание этого формата импорта/экспорта см. ниже);
- электронная таблица Excel, файл в формате XLS, XLSX или CSV, подробное описание этого формата импорта/экспорта см. в документе Импорт позиций через Excel — формат файлов XLS(X) и CSV
Как сделать успешный импорт?
Пошаговые рекомендации для корректного импорта:
Обратите внимание: рекомендуемый размер yml-файла до 180 МБ. Для файлов большего размера нужно разделить yml-файл или yml-ссылку на несколько частей.
Список категорий портала
Для удобства подготовки файла импорта вы можете скачать полный перечень всех категорий портала. Чтобы сделать это, нажмите на ссылку Список категорий
В файле со списком категорий вы сможете найти прямые ссылки на нужные вам категории или номера (ID) нужных вам категорий для указания в вашем файле импорта.
Как выполнить экспорт?
О том, как экспортировать товары с сайта вашей компании см. документ Экспорт товаров и групп товаров
Описание формата импорта и экспорта YML
Ниже описаны все теги, которые могут быть использованы при импорте в формате YML. Дополнительные, не описанные в данной документации теги, присутствующие в файле экспорта будут проигнорированы во время импорта.
Также обратите внимание на то, что в формате YML существует два варианта формирования названия товара:
- Склейка названия из параметров «typePrefix» (приставка названия товара) + vendor (производитель) + model (модель товара), например «Принтер» + «HP» + «Color LaserJet 3000». Для этого в описании товара указывайте <offer type='vendor.model'>.
- Использование тега <name>. Тег <name> игнорируется, если указан параметр <offer type='vendor.model'>.
Важно!Дата скидки ссылкой не отправляется.При наличии скидки она будет загружена на сайт по умолчанию сроком на 31 день.Также не передаются ссылкой описания/фотографии групп.
Стандарт XML/YML не допускает использование специальных непечатных символов.Также символы ", &, >, <, ' нужно заменять эквивалентными кодами:
| Символ в тексте | Код для файла XML/YML |
| " | " |
| & | & |
| > | > |
| < | < |
| ' | ' |
| Пример поля | Описание |
|---|---|
| Общий заголовок магазина | |
| <!DOCTYPE yml_catalog SYSTEM "shops.dtd"> | Техническая информация. |
| <yml_catalog date="2010-04-01 17:00"> | Возможные значения: windows-1251, UTF-8. |
| <shop> | Начало описания файла импорта. |
| Кодировка файла XML | |
| <?xml version="1.0" encoding="Название_кодировки"?> | Возможные значения: windows-1251, UTF-8. |
| <currencies> | Начало описания блока валют. |
| <currency id="Валюта" rate="Множитель курса"/> | Множитель_курса используется для пересчета цены в указанную валюту. Возможные варианты валют: UAH, BYN, KZT, EUR, USD. Множитель_курса указывает соотношение между стоимостью данной валюты и основной валюты, взятой за единицу (валюта, для которой Множитель_курса='1'). |
| <currencies> | Конец описания блока валют. |
| Группы товаров на сайте компании | |
| <categories> | Начало описания блока групп товаров. На основе названий групп в данном файле импорта:
|
| <category id="Номер_группы">Название_группы</category> | Название группы на сайте компании, а также уникальный номер группы в файле импорта. |
| <category id="Номер_группы/подгруппы" parentId="Номер_родительской_группы" portal_category_id="ID_категории_на_портале" portal_url="Cсылка_на_категорию_портала" > Название_группы/подгруппы</category> |
Обратите внимание: фотографии групп товаров не импортируются. |
| </categories> | Конец описания блока групп. |
| Товары и услуги | |
| <offers> | Начало описания блока импортируемых товаров/услуг. |
| <offer id="ID_позиции" available="Наличие" type="vendor.model" selling_type="Тип_товара" group_id="ID_разновидности"> |
ID_позиции - обязательное поле Параметр selling_type ― это тип товара на Deal.by. Тип_товара определяет размещение товара в каталоге по признаку оптовой продажи. Тип «Услуга» предназначен для размещения услуг, предоставляемых частным лицам или компаниям. Внимание! Данный параметр используется только на Deal.by. Файл с данным параметром может вызывать ошибку при импорте в другие системы. Возможные значения: r, w, u, s.
Параметр "available" используется для указания статуса наличия товара. Значение «склад» или «true» соответствует статусу товара «В наличии», значение «false» — статусу «нет в наличии». Если в данном поле пусто — товар будет импортирован в статусе «Нет в наличии». Параметр type='vendor.model' используется для «склейки» названия импортируемой позиции на Deal.by по принципу «typePrefix + vendor + model». При указании type='vendor.model' должен быть обязательно установлен параметр «Название_модели». Параметр "group_id" — это уникальный номер, который используется для маркировки основного товара и его разновидностей. Все товары с одним и тем же номером "group_id" и заполненными полями <param name="Название характеристики" unit="Единица измерения значения"> Значение характеристики товара</param> считаются разновидностями товаров. Первый товар в списке — основной товар. Создавать разновидности необходимо на основе заполненных характеристик основного товара. Так как основной товар является одной из разновидностей и у него должны быть заполнены поля <param name="Название характеристики" unit="Единица измерения значения">Значение характеристики товара</param>. Значения характеристик, на которых построены разновидности должны быть уникальными для каждой разновидности и основного товара.
Параметр "group_id" (числовой параметр, от 1 до 999999999) – это уникальный номер, используемый для маркировки основного товара и его разновидностей. Внимание! Данный параметр используется только на Deal.by. Файл с данным параметром может вызывать ошибку при импорте в другие системы. |
| <name>Название_товара</name> | Название товара. Обязательное поле при отсутствии параметра type='vendor.model'. При использовании type='vendor.model' Название_товара не должно быть задано.В случае использования type='vendor.model', название товара будет сформировано из значений трех тегов по следующей формуле: typePrefix + vendor + model |
| <typePrefix>Приставка имени товара</typePrefix> | см. Название_товара. |
| <categoryId>Номер_группы</categoryId> | Обязательное поле Номер группы (подгруппы), в которой будет размещена позиция на сайте компании после импорта; соответствует номеру группы или номеру подгруппы в блоке описания групп <catalog> в начале данного файла импорта. Обязательное поле. |
| <portal_category_id> ID_категории_на_портале </portal_category_id> | ID_категории_на_портале — уникальный идентификатор категории портала, в которой будет опубликован данный товар после импорта. |
| <portal_category_url> Cсылка_на_категорию_портала </portal_category_url> |
Ссылка на категорию маркетплейса, в которой будет опубликован товар после импорта.
Внимание! Данный параметр используется только на Deal.by. Файл с данным параметром может вызывать ошибку при импорте в другие системы. |
| <price>Цена</price> |
Цена (число от 0.01 до 9999999999) или цена с учетом скидки. Цена или цена с учетом скидки. Параметр обязателен только при указании тега <oldprice>.
(цена товара без скидки). |
| <oldprice>Цена товара без скидки</oldprice> | Если у товара есть скидка, в данном поле указывается цена без учета скидки. При наличии данного тега тег <price> является обязательным. Тег <oldprice> нельзя использовать совместно с тегом <discount>. Внимание! Данный параметр используется только на Deal.by. Файл с данным параметром может вызывать ошибку при импорте в другие системы. |
| <minimum_order_quantity>Количество_товаров</minimum_order_quantity> | Используется для указания минимального количества (поле «При заказе от») для основной цены товаров с типом «Товар продается только оптом». |
| <quantity_in_stock>Количество товара на складе</quantity_in_stock> | Используется для указания остатка товаров на складе. |
| <prices> <price> <value>Оптовая_цена1</value> <quantity>Количество1</quantity> </price> <price> <value>Оптовая_цена2</value> <quantity>Количество2</quantity> </price> </prices> |
Указание оптовых цен для типов товаров «Товар продается только оптом». При наличии данного тега, тег <price> является обязательным, иначе при использовании тега <prices> и отсутствии цены в теге <price> Внимание! Данный параметр используется только на Deal.by. Файл с данным параметром может вызывать ошибку при импорте в другие системы. |
| <price> Розничная_цена </price> <prices> <price> <value>Оптовая_цена</value> <quantity>Количество</quantity> </price> </prices> |
Указание оптовых цен для типов товаров «Товар продается оптом и в розницу». Внимание! Данный параметр используется только на Deal.by. Файл с данным параметром может вызывать ошибку при импорте в другие системы. |
| <discount>Скидка</discount> |
Скидка задана в процентах или в абсолютных значениях.Пример: 30% или 20%. Скидка применяется на период 30 дней. Тег <price> обязателен. При использовании <oldprice> и <discount> значения скидки будут проигнорированы. |
| <currencyId>Валюта</currencyId> | Валюта, в которой указана цена (UAH, BYN, KZT, EUR, USD).. |
| <picture>Ссылка1</picture> • • • <picture>Ссылка10</picture> |
Ссылка на фотографию товара.Может быть указано от 1 до 10 ссылок. |
| <vendor>Название_производителя</vendor> |
Обязательно поле только при использовании параметра «vendor.model», поскольку участвует в формировании названия товара. Бренд, торговая марка или название предприятия-производителя, под знаком которого изготовлен товар (возможно значение «Собственное производство»).
|
| <vendorCode>Код(Артикул)</vendorCode> или <barcode>Код(Артикул)</barcode> | Код товара (артикул) необходим для быстрого и удобного поиска нужной позиции на сайте компании и в личном кабинете при телефонном обращении клиента. Длина артикула ― 25 символов (цифры, кириллица, латиница, знаки «-», «_», «.», «/» и пробел). |
| <country>Страна_производитель</country> | Необязательное поле. Импортируется в атрибут «Страна производитель» в описании товара. |
| <param name="Название_характеристики" unit="Единица_измерения_значения"> Значение_характеристики_товара</param> |
Лимит: до 100 характеристик на одну позицию Чтобы добавить портальную характеристику, установленную для категории товара, необходимо скопировать ее название, единицу измерения и значение из блока «Портальные характеристики» на странице добавления/редактирования товара. Выгрузка характеристик для категорий в формате XML Значение характеристики может быть простым или множественным. Например, множественная характеристика "Материал корпуса" (Алюминий, Пластмасса) или "Стандарт связи" (GSM, CDMA). Значения множественных характеристик в импортируемом файле разделяйте символом «|»- GSM |CDMA |
| <description>Описание_товара</description> | Описание товара. Обязательное поле. Текст описания товара может содержать HTML-теги и обязательно должен быть заключён в тег <![CDATA[...]]>. Пример:<description><![CDATA[<p>Сапоги, как сапоги.<br>Материал верха: юфть, юфть с кирзой.<br>Подошва — резина.</p>]]></description> |
| <available>Наличие</available> | Указание наличия для товара. Значение «склад» или «true» соответствует статусу товара «В наличии», значение «false» — статусу «нет в наличии». Если в данном поле пусто — товар будет импортирован в статусе «Нет в наличии». |
| <keywords>Ключевое_слово_1, Ключевое_слово_2, ..., Ключевое_слово_N</keywords> | Ключевые слова (поисковые запросы, тэги) разделены запятой. Максимальная длина строки при добавлении поисковых запросов импортом YML/XML составляет 1024 символа |
| <gtin>Код_маркировки</gtin> | Международный код маркировки и учёта логистических единиц (GTIN) для фида Google Merchant Center. Подробнее |
| <mpn>Номер_устройства</mpn> | Уникальный (каталожный) номер устройства (MPN) для фида Google Merchant Center. Подробнее |
| </offer> | Конец описания блока позиции. |
| </offers> | Конец описания блока импортируемых товаров/услуг. |
| </shop> | Конец описания файла импорта. |
Комментарии
0 комментариев
Войдите в службу, чтобы оставить комментарий.