Введите ваш вопрос

Описание формата импорта и экспорта YML

Ниже описаны все теги, которые могут быть использованы при импорте в формате YML. Дополнительные, не описанные в данной документации теги, присутствующие в файле экспорта будут проигнорированы во время импорта.

Также обратите внимание на то, что в формате YML существует два варианта формирования названия товара:

  1. Склейка названия из параметров «typePrefix» (приставка названия товара) + vendor (производитель) + model (модель товара), например «Принтер» + «HP» + «Color LaserJet 3000». Для этого в описании товара указывайте <offer type='vendor.model'>.
  2. Использование тега <name>. Тег <name> игнорируется, если указан параметр <offer type='vendor.model'>.
Пример поля Описание
Общий заголовок магазина
<!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, BYR, KZT, EUR, USD. Множитель_курса указывает соотношение между стоимостью данной валюты и основной валюты, взятой за единицу (валюта, для которой Множитель_курса='1').
<currencies> Конец описания блока валют.
Группы товаров на сайте компании
<categories> Начало описания блока групп товаров. На основе названий групп в данном файле импорта:
  • На сайте вашей компании будут созданы группы и подгруппы для импортируемых товаров.
  • На портале (в каталоге) Prom.ua для входящих в группы/подгруппы позиций будут автоматически определены категории (рубрики каталога).
<category id="Номер_группы">Название_группы</category> Название группы на сайте компании, а также уникальный номер группы в файле импорта.
<category id="Номер_группы/подгруппы" parentId="Номер_родительской_группы" portal_id="ID_категории_на_портале" portal_url="Cсылка_на_категорию_портала" > Название_группы/подгруппы</category>
  • Название_группы/подгруппы — название группы или подгруппы товаров на сайте компании.
  • Номер_группы/подгруппы — уникальный номер группы или подгруппы товаров в файле импорта.
  • Номер_родительской_группы — номер родительской группы товаров в файле импорта. Используется для создания вложенной структуры групп на сайте компании.
  • ID_категории_на_портале — уникальный идентификатор категории портала, в которой будут опубликованы все товары данной группы после импорта.
  • Cсылка_на_категорию_портала — ссылка на категорию портала, в которой будут опубликованы все товары данной группы после импорта.
    Примечания:
    • Если указаны оба значения 'portal_id' и 'portal_url', будет использовано значение первого верного параметра.
    • Тег 'portal_id' имеет приоритет перед 'portal_url'.

    Внимание! Данный параметр используется только на Prom.ua. Файл с данным параметром может вызывать ошибку при импорте в другие системы.

Обратите внимание: фотографии групп товаров не импортируются.

</categories> Конец описания блока групп.
Товары и услуги
<offers> Начало описания блока импортируемых товаров/услуг.
<offer id="ID_позиции" available="Наличие" type="vendor.model" selling_type="Тип_товара" group_id="ID_разновидности">

Начало описания блока товарной позиции. Указывается уникальный порядковый номер товара/услуги в файле импорта (ID), по которому в дальнейшем будет выполняться обновление данной позиции. 

Параметр selling_type ― это тип товара на Prom.ua. Тип_товара определяет размещение товара в каталоге по признаку оптовой продажи. Тип «Услуга» предназначен для размещения услуг, предоставляемых частным лицам или компаниям. Внимание!Данный параметр используется только на Prom.ua. Файл с данным параметром может вызывать ошибку при импорте в другие системы. Возможные значения: r, w, u, s.

  • r — «Товар продается только в розницу» для потребительских и промышленных товаров с розничными ценами.
  • w — «Товар продается только оптом» для потребительских и промышленных товаров, которые продаются только оптом.
  • u — «Товар продается оптом и в розницу» для товаров, которые продаются и оптом и в розницу.
  • s — услуга.

Параметр "available" используется для указания статуса наличия товара. Значение «склад» или «true» соответствует статусу товара «В наличии», значение «false» — статусу «Под заказ». Если в данном поле пусто — товар будет импортирован в статусе «Нет в наличии».

Параметр presence_sure="true"указывает статус «Гарантированное наличие». Пример: <offer available="true" id="660912008" presence_sure="true">

Параметр type='vendor.model' используется для «склейки» названия импортируемой позиции на Prom.ua по принципу «typePrefix + vendor + model». При указании type='vendor.model' должен быть обязательно установлен параметр «Название_модели».

Параметр "group_id" — это уникальный номер, который используется для маркировки основного товара и его  разновидностей. Позиция, у которой есть номер "group_id", а также указаны характеристики через параметры "param name" считается разновидностью основного товара, который имеет такой-же номер "group_id". При этом основной товар не имеет параметров "param name". Все товары с одинаковым номером "group_id"  будут импортированы в качестве разновидностей. Внимание! Данный параметр используется только на Prom.ua. Файл с данным параметром может вызывать ошибку при импорте в другие системы. 

<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>.
<oldprice>Цена товара без скидки</oldprice> Если у товара есть скидка, в данном поле указывается цена без учета скидки. При наличии данного тега тег <price> является обязательным. Тег <oldprice> нельзя использовать совместно с тегом <discount>.
Внимание! Данный параметр используется только на Prom.ua. Файл с данным параметром может вызывать ошибку при импорте в другие системы.

<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> все товары будут загружены в статусе «Под заказ». 
Внимание! Данный параметр используется только на Prom.ua. Файл с данным параметром может вызывать ошибку при импорте в другие системы.
<price>
Розничная_цена
</price>
<prices>
  <price>
    <value>Оптовая_цена</value>
   <quantity>Количество</quantity>
  </price>
</prices>
Указание оптовых цен для типов товаров «Товар продается оптом и в розницу». 
Внимание! Данный параметр используется только на Prom.ua. Файл с данным параметром может вызывать ошибку при импорте в другие системы.
<discount>Скидка</discount> Если у товара есть скидка, в данном поле указывается величина скидки или процент. Пример: 12.5, 30%. При наличии данного тега тег <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> Характеристика товара. Чтобы добавить характеристику, предустановленную для категории товара, необходимо скопировать её название и название единиц измерения из блока «Характеристики» на странице добавления/редактирования товара. Смотреть пример
Кроме этого, вы можете добавить через импорт до 20 пользовательских характеристик. Пользовательские характеристики будут показаны на странице товара в блоке «Другие характеристики». Смотреть пример
Значение характеристики может быть простым или множественным. Например, множественная характеристика «Материал корпуса» (Алюминий, Пластмасса) или «Стандарт связи» (GSM, CDMA). Значения множественных характеристик в файле импорта разделяйте символом «|».
<description>Описание_товара</description> Описание товара. Обязательное поле. Текст описания товара может содержать HTML-теги и обязательно должен быть заключён в тег <![CDATA[...]]>. Пример:<description><![CDATA[<p>Сапоги, как сапоги.<br>Материал верха: юфть, юфть с кирзой.<br>Подошва — резина.</p>]]></description>
<available>Наличие</available> Указание наличия для товара. Значение «склад» или «true» соответствует статусу товара «В наличии», значение «false» — статусу «Под заказ». Если в данном поле пусто — товар будет импортирован в статусе «Нет в наличии».
<keywords>Ключевое_слово_1, Ключевое_слово_2, ..., Ключевое_слово_N</keywords> Ключевые слова (поисковые запросы, теги) товарной позиции или услуги.
</offer> Конец описания блока позиции.
</offers> Конец описания блока импортируемых товаров/услуг.
</shop> Конец описания файла импорта.

Смотрите также: