Выгрузка каталога

Готовые XML-файлы брендов HOKASU, 6063 и ULIGHT для вашего сайта или учётной системы. Выберите ассортимент, скачайте файл или скопируйте постоянную ссылку в настройки импорта. Регистрация и API-ключ не нужны.

Первая выгрузка готовится. Файлы появятся здесь после сборки.

Как подключить выгрузку

Выберите весь доступный ассортимент, бренд или категорию. В выгрузке доступны только HOKASU, 6063 и ULIGHT. Категория включает все подразделы. В каждом файле есть необходимые родительские категории и связанные коллекции.
Один раз импортируйте полный каталог. Затем обновляйте его ежедневно, а цены и остатки — каждые 15 минут из компактного файла. Ссылки остаются постоянными; XML.gz содержит тот же XML в сжатом виде.
Это XML ULIGHT, версия схемы 1. Формат не является YML Яндекс.Маркета. Вашему импорту нужно сопоставить поля, описанные ниже. Фотографии и документы передаются ссылками.

Полный каталог собирается ежедневно, цены и остатки — каждые 15 минут. Дата generated_at указана в файле. Сравнивайте ETag / Last-Modified: если файл не изменился, сервер ответит 304 без повторной передачи.

Структура и связи

categories: Дерево категорий: id — постоянный ID, parent_id — ID родительской категории. У корня parent_id отсутствует.
collections: Серии товаров: id, название, описание, фотографии и файлы серии. Коллекция объединяет артикулы; собственных цены и остатка у неё нет.
items: Одна запись item — один артикул. item/@id — постоянный ключ для обновления; article — артикул товара. Используйте ID: одинаковый артикул может встречаться у разных брендов.
identity: identity/@collection_id связывает артикул с коллекцией; category_id — основная категория. category_refs перечисляет все категории артикула. Артикул без коллекции не имеет collection_id. Категории коллекции определяются по её артикулам.
attributes: Справочник характеристик: ID, постоянный code, название, тип, единица и варианты option. parameters артикула ссылаются на attribute_id. Число хранится в указанной единице (например, 0.6 m = 600 мм); диапазон — min/max, логическое значение — true/false. Многозначные параметры повторяются.
images / files: images и files есть у артикулов и коллекций. Для артикула используйте также материалы его коллекции, удаляя повторы по ID файла. description содержит текст или HTML; обрабатывайте его как содержимое, а не исполняемый код.
market: pricing/@currency — валюта; price — текущая цена, old_price — цена до скидки. has_price=false означает, что цены нет. available_quantity — доступное количество с учётом резервов; available показывает наличие. Остатки — снимок на generated_at, они не резервируют товар.
removal: active=false в компактном файле означает, что артикул нужно скрыть. После успешного полного импорта скрывайте также ID, отсутствующие в новом полном снимке выбранного ассортимента. При изменении выбранного ассортимента выполните полный импорт заново.

<category id="20" parent_id="10"><name>…</name></category>
<collection id="42"><name>…</name></collection>
<item id="123" active="true">
  <identity category_id="20" collection_id="42" />
  <article>ABC-3000</article>
  <parameters>
    <parameter attribute_id="5" code="power" unit="W">
      <value>20</value>
    </parameter>
  </parameters>
  <pricing currency="RUB" has_price="true">
    <price>1250.00</price>
  </pricing>
  <available_quantity>5</available_quantity>
</item>