Чита
Смоленка...
ТУ.Маркет
по товарам и услугам
0 0
ТУ.Маркет
по товарам и услугам
0 0

Описание формата XML

Оглавление:

Используемый формат основан на формате YML от market.yandex.ru
Дополнительно включены несколько полей и параметров, расширяющих информацию о товаре|услуге и использование вашего фида данных в tu.market (например, для для указания остатков на складе или дней ожидания при заказе, оптовых цен и примечаний, итд, а также параметр "частичной выгрузки" при обновлении "только остатки-цены" или "частичная выгрузка") . Список доп.полей и параметров приведен ниже.

Об использовании XML файлов и Авторизации в API - смотрите в документации API.
Кратко о Битрикс:  развернуть
Если ваш сайт сделан в 1С-Битрикс, вы можете сформировать ссылку для автообновления в панели управления:
  • в Битриксе настриваете Профиль выгрузки и ее периодичность
  • на полученной ссылке скачиваете файл и проверяете его (загружаете в ТУ.Маркет в режиме тестирования)
  • делаете Сопоставление категорий (там же где тестировали) Можете сначала сделать Сопоставление а потом тестировать Загрузку
  • указываете свою ссылку и периодичность, с которой ТУ.Маркет будет забирать ваши даные по этой ссылке
О настройке Профиля выгрузки в админке Битрикса - погуглите (найдите инструкцию для своей версии). Одна из инструкций (с видео) - здесь
При обновлении данных внутри вашего фида должно быть указано актуальное время его формирования, с учетом часового пояса (в теге <yml_catalog date="..."></i>).
Оно сравнивается с предыдущей операцией обновления, если дата старая - фид будет отклонен.

Если установка верного часового пояса в вашей системе проблематична - скорректируйе его в "настройках для Организации" в маркете.

Пример файла

 развернуть
<?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>
<category id="4" 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>
    <categoryId>3</categoryId>
    <oldprice>21000.00</oldprice>
    <price>23400.00</price>
    <currencyId>RUR</currencyId>
    <count>9</count>
    <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>
<![CDATA[ <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>
<offer id="34664" available="false">
    ...
</offer>
</offers>
</shop>
</yml_catalog>

Поддерживаемые поля YML

 развернуть
  1. name
    Короткое название магазина
  2. company
    Полное наименование компании, владеющей магазином. Не публикуется.
  3. url
    URL главной страницы магазина
    Примечание: вышеуказанные поля используются для идентификации Организации при настройке автообновления и принудительном обновлении. При наличии филиалов и самостоятельном подключении из своей учетной программы - будьте внимательны с передачей обновлений в Прайс своего соответствующего филиала в Маркете.
  4. date
    Дата и время генерации файла
    Примечание: определяет необходимость обновления, наряду с «периодичностью» при указании ссылки на файл в настройке Автообновления подробнее.
  5. сategories
    Список категорий магазина
    Примечание: раздел с категориями также используется при загрузке списка категорий в диалоге Сопоставления категорий. Для успешного создания новых товаров|услуг или изменения категории у существующих - это Сопоставление следует выполнить заранее подробнее.
  6. delivery-options
    Опции доставки
  7. pickup-options
    Опции самовывоза
    Примечание: в опциях delivery-options и pickup-options учитывается только количество дней (атрибут days), минимальное из которых считается длительностью ожидания товара в маркете. Они же определяют количество товара: если ожидание составляет 1 день или более, то товар считается отсутствующим. Иначе - присутствует неопределенное количество товара. Рекомендуем использовать поля товара quantity и wait, которые переопределяют эти значения (список доп.полей, см.ниже).
  8. offers
    Список товаров
    Поля описания товара (тег < offer>):
    • categoryId
      id категории магазина
      Примечание: соответствует полю Маркета «Идентификатор категории магазина» (crmCtuId)
    • id
      id товара в магазине
      Примечание: соответствует полю Маркет «Артикул» (crmID). ОБЯЗАТЕЛЕН.
    • name
      название товара
      Примечание: соответствует полю Маркета «Название товара|услуги» (nameTU)
    • description
      описание товара
      Примечание: соответствует полю Маркета «Большая аннотация» (annotation) При использовании HTML - символы " & < > ' следует заменять на эквивалентные коды:
      " &quot;
      & &amp;
      > &gt;
      < &lt;
      ‘ &apos;
    • 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
      доступность
      - Атрибут available со значениеим false приводит к блокировке товара только при указании 0 в поле count (или отсутствии count). 
      - Атрибут available со значениеим true (при указании 0 в поле count или отсутствии count): товар считается "под заказ" с датой доставки "через Y дней" (Y определяет поле wait, по умолчанию "через 30 дней") 
      - Положительное значение в поле count переопределяет все значения: товар считается "в наличии".
    • count
      количество «в наличии». Использование поля в сочетании с тегом available описано выше
    • url
      ссылка на страницу товара. Можно использовать только ссылки на сайт, указанный в контактах фирмы.
Подробное описание полей YML смотрите в документации Яндекс.Маркета.

Дополнительные поля, используемые в TU.Market

 развернуть
Дополнительные атрибуты тега <yml_catalog>
  1. partialImport
    Режим частичной выгрузки данных.  При значении false, считается, что база товаров импортируется полностью: товары, которые уже есть на маркете, но отсутствуют в данных импорта, снимаются с публикации.
    При значении true выгрузка считается частичной, на другие товары не влияет.
    При отсутствии значения - применяется опция, установленная в настройках интерфейса (товары, отсутствующие в выгрузке Оставлять/Блокировать/Удалять).
    Атрибут является альтернативой одноименного параметра API.
Дополнительные поля внутри тега <offer></offer>
  1. annotationShort
    краткая аннотация товара|услуги
  2. ctuID
    ID категории Маркета
    Примечание: при указании значения в ctuID игнорируются значение categoryId из секции сategories
  3. dopPrice
    альтернативная цена
  4. si
    единица измерения товара|услуги
  5. dopSi
    альтернативная единица измерения товара|услуги.
  6. dopSiUse
    где показывать Альтернативную цену и ее Единицу измерения
  7. idTU
    идентификатор товара|услуги в маркете
    Примечание: при указании значения в idTU игнорируется значение id из секции offers. Позволяет переопределить артикул товара|услуги.
  8. ordInCTU
    важность в категории товара|услуги внутри Категории (пп№)
  9. prefPrice
    префикс цены
  10. wait
    количество «дней ожидания» (при quantity 0)
  11. status
    статус: Публиковать или Заблокировать, или Удалить

Детальное описание значений и ограничений доп.полей

См. в «Инструкции...» - раздел список колонок

Указание пустых значений XML

Пустые поля обрабатываются по следующим правилам:
  1. Если поле опущено - оно игнорируется
  2. Если поле присутствует в виде пустого тега - его значение удаляется
Инструкции API  развернуть

Продолжая использовать наш сайт, вы даете согласие на обработку файлов cookie, которые обеспечивают правильную работу сайта... Подробнее

Временно не доступно: функционал дорабатывается

Наличие и Цену - пожалуйста, уточните у Продавца

False

У Вашего браузера отключены Cookies, поэтому часть функций сайта будут недоступны или будут работать некорректно.