Используемый формат основан на формате YML от market.yandex.ru Дополнительно включены несколько полей, расширяющих информацию о товаре|услуге в tu.market (список ниже).
Об использовании XML файлов и Авторизации в API - смотрите в
документации API.
Пример файла
<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2020-09-08 01:13">
<shop>
<name>Аграрник</name>
<company>ЗАО Аграрник</company>
<url>https://website.net</url>
<categories><category id="2">Двери</category> <category id="3" parentId="2">Двери металлические</category> </categories>
<delivery-options> <option cost="200" days="1"/> </delivery-options>
<offers>
<offer id="34663" available="true">
<url>https://website.net/shop/34663-kompressor-benz-parma-k-1500-50rm-1500vt-50l-202l-min.product</url>
<price>23400.00</price>
<currencyId>RUR</currencyId>
<categoryId>3</categoryId>
<picture>https://website.net/images/products/85150f47dc0ce73a7f11640e35796b8e.jpg</picture>
<picture>https://website.net/images/products/9a43e6674c9e6b49ddda7c4051b5bced/0.jpg</picture>
<picture>https://website.net/images/products/9a43e6674c9e6b49ddda7c4051b5bced/1.jpg</picture>
<name>Компрессор бенз. ПАРМА К-1500/50РМ(1500Вт,50л,202л/мин)</name>
<description>
<h3>Компрессор бенз. ПАРМА К-1500/50РМ(1500Вт,50л,202л/мин)</h3><p>Пониженный уровень шума<br />Высокая надежность и роизводительность<br />Двухцилиндровый V-образный компрессор<br />Манометр для контроля давления на выходе<br />Манометр для контроля давления в ресивере<br />Регулятор давления с предохранительным клапаном<br />Термозащита двигателя<br /></p>
</description>
<param name="Страна-производитель">Россия</param>
<param name="Тип">Компрессор</param>
<param name="Марка">ПАРМА</param>
<param name="Мощность" unit="Вт">1500</param>
<param name="Напряжение" unit="В">220</param>
</offer>
</offers>
</shop>
</yml_catalog>
Поддерживаемые поля YML
- name
Короткое название магазина
- company
Полное наименование компании, владеющей магазином. Не публикуется.
- url
URL главной страницы магазина
Примечание: вышеуказанные поля используются для идентификации Организации при настройке автообновления и принудительном обновлении. При наличии филиалов и самостоятельном подключении из своей учетной программы - будьте внимательны с передачей обновлений в Прайс своего соответствующего филиала в Маркете.
- date
Дата и время генерации файла
Примечание: определяет необходимость обновления, наряду с «периодичностью» при указании ссылки на файл в настройке Автообновления (подробнее).
- сategories
Список категорий магазина
Примечание: раздел с категориями также используется при загрузке списка категорий в диалоге Сопоставления категорий. Для успешного создания новых товаров|услуг или изменения категории у существующих - это Сопоставление следует выполнить заранее (подробнее).
- delivery-options
Опции доставки
- pickup-options
Опции самовывоза
Примечание: в опциях delivery-options и pickup-options учитывается только количество дней (атрибут days), минимальное из которых считается длительностью ожидания товара в маркете. Они же определяют количество товара: если ожидание составляет 1 день или более, то товар считается отсутствующим. Иначе - присутствует неопределенное количество товара. Рекомендуем использовать поля товара quantity и wait, которые переопределяют эти значения (список доп.полей, см.ниже).
- offers
Список товаров
Поля описания товара (тег < offer>):
- categoryId
id категории магазина
Примечание: соответствует полю Маркета «Идентификатор категории магазина» (crmCtuId)
- id
id товара в магазине
Примечание: соответствует полю Маркет «Артикул» (crmID). ОБЯЗАТЕЛЕН.
- name
название товара
Примечание: соответствует полю Маркета «Название товара|услуги» (nameTU)
- description
описание товара
Примечание: соответствует полю Маркета «Большая аннотация» (annotation) При использовании HTML - символы " & < > ' следует заменять на эквивалентные коды:
" |
" |
& |
& |
> |
> |
< |
< |
‘ |
' |
- oldprice
старая цена товара
- price
актуальная цена товара
Примечание: поля oldprice и price соответствуют полям ю Маркета «Базовая цена» и «Цена со скидкой» (priceBase и price2). Указание значения только для одного поля oldprice или price - приводит к указанию в Маркете Базовой цены, без указания скидки
- sales_notes
условия продажи товара
Примечание: соответствует полю Маркета «Примечание к цене» (priceDesc)
- param
характеристики товара
Примечание: соответствует полю Маркета «Характеристики товара» (impCharacts), принимаются значения формата yml: Name - Название характеристики; Unit - Единица измерения характеристики (необязательна); Values - значение характеристики или список значений, Маркет дополнительно принимает указание диапазона значений в виде строки формата “от X до Y”
- picture
изображения товара
Примечание: совокупность ссылок на картинки во всех тегах для одного экземпляра соответствует полю Маркета «Ссылки на фото» (linkPhoto). Указание namePhoto и загрузка файлов картинок в xml невозможна, для этого используйте формат json (см.«Варианты импорта»)
- pickup-options
опции самовывоза
- delivery-options
опции доставки
Примечание к полям pickup-options и delivery-options в разделах shop и offer: поля available и quantity, указанные для товара в разделе offer, переопределяют поля, указанные в разделе shop.
- available
доступность
Значение false атрибута available переопределяет поля shop и offer: товар считается не в наличии и имеет неопределенную дату доставки (30 дней)
Примечание: при указанном значении в поле quantity игнорируются (переопределяются) и параметры pickup-options, и delivery-options, и значение атрибута available.
- url
ссылка на страницу товара. Можно использовать только ссылки на сайт, указанный в контактах фирмы.
Подробное описание полей YML смотрите в
документации Яндекс.Маркета.
Дополнительные поля, используемые в TU.Market
Дополнительные атрибуты тега <yml_catalog>
- partialImport
Режим частичной выгрузки данных.
Если установлено значение false, считается, что база товаров импортируется полностью, поэтому товары, которые уже есть на маркете, но отсутствуют в данных импорта, снимаются с публикации. При значении true с такими товарами ничего не произойдет. Значение по умолчанию: true.
Атрибут является альтернативой одноименного параметра API.
Дополнительные поля внутри тега <offer></offer>
- annotationShort
краткая аннотация товара|услуги
- ctuID
ID категории Маркета
Примечание: при указании значения в ctuID игнорируются значение categoryId из секции сategories
- dopPrice
альтернативная цена
- si
единица измерения товара|услуги
- dopSi
альтернативная единица измерения товара|услуги.
- dopSiUse
где показывать Альтернативную цену и ее Единицу измерения
- idTU
идентификатор товара|услуги в маркете
Примечание: при указании значения в idTU игнорируется значение id из секции offers. Позволяет переопределить артикул товара|услуги.
- ordInCTU
важность в категории товара|услуги внутри Категории (пп№)
- prefPrice
префикс цены
- quantity
количество «в наличии»
- wait
количество «дней ожидания»
- status
статус: Публиковать или Заблокировать, или Удалить
Детальное описание значений и ограничений доп.полей
Указание пустых значений XML
Пустые поля обрабатываются по следующим правилам:
- Если поле опущено - оно игнорируется
- Если поле присутствует в виде пустого тега - его значение удаляется