Формат XML

Описание формата полного списка товаров

Заголовок документа (XML header)

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE dc_catalog SYSTEM "http://www.delivery-club.ru/xml/dc.dtd">

Стандартный XML-заголовок со ссылкой на файл описания формата (DTD). Заголовок должен начинаться с первой строки, с нулевого символа. Вторая строка заголовка XML-документа определяет ссылку на файл описания формата данных (DTD).

Элемент dc_catalog

<dc_catalog last_update="2000-11-16 20:17">
<delivery_service>
...
</delivery_service>
</dc_catalog>

Любой XML-документ может содержать только один корневой элемент. Формат YML в качестве корневого использует элемент dc_catalog. Атрибут date элемента dc_catalog должен соответствовать дате и времени генерации XML-файла на стороне магазина. Дата должна иметь формат YYYY-MM-DD HH:mm. Ежедневно система автоматически проверяет изменения в дате после последнего обновления данных и в случае изменения даты производит выгрузку обновленных данных на сайт delivery-club.ru.

Элемент delivery_service

<delivery_service >
<categories> ... </categories>
<products> ... </products>
</delivery_service >

В элементе delivery_service содержится описание продуктов.

Элемент categories

<categories>
<category id="1">Завтраки</category>
<category id="2">Пицца</category>
<category id="3" parentId="2">Пицца 23 см</category>
<category id="4" parentId="2">Пицца 36 см</category>
<category id="5">Напитки</category>
</categories>

В элементе categories содержится список категорий службы доставки. Каждая категория описывается отдельным элементом category. Описание категории должно включать ее идентификатор (параметр id) для всех категорий и идентификатор категории более высокого уровня для подкатегорий.
Идентификатор категории должен быть уникальным положительным целым числом. Ни у одной категории параметр id не может быть равен "0". Если элемент parentId не указан, то категория считается корневой.

Параметры:

id - идентификатор Вашей категории продуктов
parentId - идентификатор предыдущей по иерархии категории продуктов

*после каждой родительской категории должны идти дочерние, либо сначала необходимо описать родительские категории, а после описывать дочерние. В любом случае, если сначала идет описание дочерней категории, а после – родительской, то корректное отображение дерева невозможно.

Элемент products

<products>
<product>...</product>
...
</products>
В элементе products содержится список предложений службы доставки. Каждое предложение описывается отдельным элементом product.
Описание элемента product

<product id="6015">
<category_id>0</category_id>
<name>Морепродукты в соусе Том Ям</name>
<description>Острый суп с морепродуктами со специальными приправами. Подается с рисом.</description>
<weight>50</weight>
<volume>100</volume>
<energy>105</energy>
<price>250</price>
<picture>https://wokker.ru/bitrix/templates/wokker/images/vok.png</picture>
<ingredients>
<ingredient id="179" title="Свинина" price="95"/>
<ingredient id="169" title="Шампиньоны" price="30"/>
<ingredient id="174" title="Курица" price="95"/>
<ingredient id="9150" title="Морепродукты" price="95"/>
<ingredient id="1168" title="Креветки &amp;quot;Коктейль&amp;quot;" price="145"/>
</ingredients>
<variants>
<variants_group title="Выберите основу">
<variant title="Лапша яичная" price="0" id="9030"/>
<variant title="Лапша стеклянная" price="0" id="9010"/>
<variant title="Лапша пшеничная" price="0" id="9020"/>
<variant title="Лапша гречневая" price="0" id="9000"/>
<variant title="Пропаренный рис" price="0" id="9040"/>
</variants_group>
<variants_group title="Выберите остроту">
<variant title="Не острый" price="0" id="3027"/>
<variant title="Острее" price="0" id="3021"/>
<variant title="Очень остро" price="0" id="3022"/>
</variants_group>
<variants_group title="И вот еще что">
<variant title="Кунжут" price="0" id="3028"/>
<variant title="Зеленый лук" price="0" id="3030"/>
<variant title="Без овощей" price="0" id="3020"/>
<variant title="Без посыпки" price="0" id="3031"/>
</variants_group>
</variants>
</product>

Параметры:

id
Внутренний идентификатор продукта в системе. Передается в Delivery Club для отображения правильных позиций в поступающих заказах.
name
Наименование продукта.
weight
Вес продукта.  Можно не указывать, если заполнен volume
volume
Объем продукта.  Можно не указывать, если заполнен weight
energy
Калорийность продукта.  Указывается на 100 грамм
description
Описание позиции.
price
Стоимость (округление происходит в большую сторону)
ingredients
Дополнительные ингредиенты, которые клиент может добавить по желанию. Каждый должен содержать ID, название и стоимость.
variants
Обязательные для выбора модификаторы. Могут быть объединены в одну или несколько групп. Каждый вариант должен содержать ID, название и стоимость.
picture
По указанному URL-адресу должна находиться картинка в формате jpeg или png наилучшего качества. Изменение размеров картинки происходит автоматически на стороне Delivery Club. Ссылка на HTML с картинкой недопустима.