Импорт товаров и услуг на сайт компании и на маркетплейс, а также экспорт с сайта и с маркетплейса может быть выполнен в одном из следующих форматов:
- файл 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 день. Также не передаются ссылкой описания/фотографии групп.
| Пример поля | Описание |
|---|---|
| Общий заголовок магазина | |
| <!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="Множитель курса"/> | Множитель_курса используется для пересчета цены в указанную валюту. Возможные варианты валют: RUB, UAH, BYN, KZT, EUR, USD. Множитель_курса указывает соотношение между стоимостью данной валюты и основной валюты, взятой за единицу (валюта, для которой Множитель_курса='1'). |
| <currencies> | Конец описания блока валют. |
| Группы товаров на сайте компании | |
| <categories> | Начало описания блока групп товаров. На основе названий групп в данном файле импорта:
|
| <category id="Номер_группы">Название_группы</category> | Название группы на сайте компании, а также уникальный номер группы в файле импорта. |
| <category id="Номер_группы/подгруппы" parentId="Номер_родительской_группы" portal_id="ID_категории_на_портале" portal_url="Cсылка_на_категорию_портала" > Название_группы/подгруппы</category> |
|
| </categories> | Конец описания блока групп. |
| Товары и услуги | |
| <offers> | Начало описания блока импортируемых товаров/услуг. |
| <offer id="ID_позиции" available="Наличие" type="vendor.model" selling_type="Тип_товара" group_id="ID_разновидности"> |
Начало описания блока товарной позиции. Указывается уникальный порядковый номер товара/услуги в файле импорта (ID), по которому в дальнейшем будет выполняться обновление данной позиции. Параметр selling_type ― это тип товара на Prom.ua. Тип_товара определяет размещение товара в каталоге по признаку оптовой продажи. Тип «Услуга» предназначен для размещения услуг, предоставляемых частным лицам или компаниям.
Параметр "available" используется для указания статуса наличия товара. Значение «склад» или «true» соответствует статусу товара «В наличии», значение «false» — статусу «Под заказ». Если в данном поле пусто — товар будет импортирован в статусе «Нет в наличии». Параметр presence_sure="true" указывает статус «Гарантированное наличие». Пример: <offer available="true" id="660912008" presence_sure="true"> Параметр "group_id" — это уникальный номер, который используется для маркировки основного товара и его разновидностей. Все товары с одним и тем же номером "group_id" и заполненными полями <param name="Название характеристики" unit="Единица измерения значения"> Значение характеристики товара</param> считаются разновидностями товаров. Первый товар в списке — основной товар. Создавать разновидности необходимо на основе заполненных характеристик основного товара. Так как основной товар является одной из разновидностей и у него должны быть заполнены поля <param name="Название характеристики" unit="Единица измерения значения">Значение характеристики товара</param>. Значения характеристик, на которых построены разновидности должны быть уникальными для каждой разновидности и основного товара.
|
| <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> | Cсылка_на_категорию_портала — ссылка на категорию маркетплейса, в которой будет опубликован данный товар после импорта. Примечания: Если в описании товара указаны оба тега 'portal_category_id' и 'portal_category_url', будет использовано значение первого верного тега. Тег 'portal_category_id' имеет приоритет перед 'portal_category_url'. Теги описания товара 'portal_category_id' и 'portal_category_url' имеют приоритет перед тегами описания группы 'portal_id' и 'portal_url'. Внимание! Данный параметр используется только на Prom.ua. Файл с данным параметром может вызывать ошибку при импорте в другие системы. |
| <price>Цена</price> | Цена или цена с учетом скидки. Параметр обязательный только при указании тега <oldprice>. Внимание! Если в файле импорта не указан тег <available> для товара, после импорта файла с такими же данными скидка на товар отображаться не будет. Цена товара будет взята из тега <oldprice> (цена товара без скидки). |
| <oldprice>Цена товара без скидки</oldprice> | Если у товара есть скидка, в данном поле указывается цена без учета скидки. При наличии данного тега тег <price> является обязательным. Тег <oldprice> нельзя использовать совместно с тегом <discount>. Внимание! Данный параметр используется только на Prom.ua. Файл с данным параметром может вызывать ошибку при импорте в другие системы. |
|
<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> все товары будут загружены в статусе «Под заказ». Внимание! Данный параметр используется только на Prom.ua. Файл с данным параметром может вызывать ошибку при импорте в другие системы. |
| <price> Розничная_цена </price> <prices> <price> <value>Оптовая_цена</value> <quantity>Количество</quantity> </price> </prices> |
Указание оптовых цен для типов товаров «Товар продается оптом и в розницу». Внимание! Данный параметр используется только на Prom.ua. Файл с данным параметром может вызывать ошибку при импорте в другие системы. |
| <discount>Скидка</discount> | Если у товара есть скидка, в данном поле указывается величина скидки или процент. Пример: 30%. После окончания периода действия текущей скидки, она применяется заново при следующем периодическом импорте. При наличии данного тега <discount>, тег <price> является обязательным. Внимание! Данный параметр используется только на Prom.ua. Файл с данным параметром может вызывать ошибку при импорте в другие системы. |
| <currencyId>Валюта</currencyId> | Валюта, в которой указана цена (RUB, UAH, BYR, KZT, EUR, USD). |
| <picture>Ссылка1</picture> • • • <picture>Ссылка10</picture> |
Ссылки на фотографию товара. Может быть указано от 1 до 10 ссылок, в зависимости от пакета услуг.
|
| <vendor>Название_производителя</vendor> | Необязательное поле. Бренд, торговая марка или название предприятия-производителя, под знаком которого изготовлен товар (возможно значение «Собственное производство»). Название производителя импортируется в атрибут «Производитель» в описании товара. Внимание! Указываемый вами производитель будет импортирован только если он есть в базе производителей маркетплейса. Проверить его наличие и добавить нового производителя можно при добавлении/редактировании товара в поле «Производитель» (блок «Портальные характеристики»). При использовании тега «vendor.model», тег <vendor> является обязательным, так как участвует в формировании названия товара. |
|
<vendorCode>Код(Артикул)</vendorCode> или <barcode>Код(Артикул)</barcode> |
Код товара (артикул) необходим для быстрого и удобного поиска нужной позиции на сайте компании и в личном кабинете при телефонном обращении клиента. Длина артикула ― 25 символов (цифры, кириллица, латиница, знаки «-», «_», «.», «/» и пробел). |
| <country>Страна_производитель</country> | Необязательное поле. Импортируется в атрибут «Страна производитель» в описании товара. |
| <param name="Название_характеристики" unit="Единица_измерения_значения"> Значение_характеристики_товара</param> |
Характеристика товара. Чтобы добавить портальную характеристику, предустановленную для категории товара, необходимо скопировать её название и название единиц измерения из блока «Портальные характеристики» на странице добавления/редактирования товара.
|
| <description>Описание_товара</description> | Описание товара. Обязательное поле. Текст описания товара может содержать HTML-теги и обязательно должен быть заключён в тег <![CDATA[...]]>. Пример:<description><![CDATA[<p>Сапоги, как сапоги.<br>Материал верха: юфть, юфть с кирзой.<br>Подошва — резина.</p>]]></description> |
| <available>Наличие</available> | Указание наличия для товара. Значение «склад» или «true» соответствует статусу товара «В наличии», значение «false» — статусу «Под заказ». Если в данном поле пусто — товар будет импортирован в статусе «Нет в наличии». |
| <keywords>Ключевое_слово_1, Ключевое_слово_2, ..., Ключевое_слово_N</keywords> |
Ключевые слова (поисковые запросы, теги) товарной позиции или услуги. Максимальная длина строки при добавлении поисковых запросов импортом YML/XML составляет 1 024 символа. |
| </offer> | Конец описания блока позиции. |
| </offers> | Конец описания блока импортируемых товаров/услуг. |
| </shop> | Конец описания файла импорта. |
