Формат XML-файла

<!DOCTYPE yml_catalog SYSTEM "shops.dtd">

<yml_catalog date="2021-03-01 13:12">

    <shop>

  <name>Чарiвна мить</name>

  <company>Интернет-магазин Чарiвна мить</company>

  <url>https://charivna-mit.com.ua/</url>

  <currencies>

      <currency id="UAH" rate="1"/>

  </currencies>

  <categories>

<category id="34728"  parentId="34727">Аксессуары для валяния</category>

<category id="204"  parentId="93">Аксессуары для создания игрушек</category>

<category id="210"  parentId="94">Аксессуары для художников</category>

<category id="163"  parentId="43">Акссесуары</category>

<category id="197"  parentId="93">Альбомы/заготовки для скрапбукинга</category>

<category id="11" >Бисер</category>

<category id="110"  parentId="11">Бисер</category>

<category id="146"  parentId="11">Бисер круглый</category>

<category id="209"  parentId="94">Блокноты/альбомы/бумага</category>

<category id="34733"  parentId="173">Булавки</category>

<category id="34737"  parentId="34736">Бумага для квиллинга</category>

<category id="198"  parentId="93">Бумага для скрапбукинга</category>

<category id="193"  parentId="93">Бумага/салфетки для декупажа</category>

<category id="112"  parentId="11">Бусины</category>

<category id="130"  parentId="93">Все для игрушек</category>

<category id="95" >Все для моделирования</category>

<category id="141"  parentId="97">Все для праздника</category>

<category id="177"  parentId="83">Вспарыватели</category>

<category id="28" >Вышивка</category>

<category id="142" >Вышивка на заказ</category>

<category id="43" >Вязание</category>

<category id="34741"  parentId="28">Готовые изделия под вышивку</category>

<category id="140"  parentId="97">Декор</category>

<category id="199"  parentId="93">Декоративные элементы</category>

<category id="149"  parentId="11">Декоративный бисер</category>

<category id="127"  parentId="93">Декупаж</category>

<category id="132"  parentId="95">Деревянные конструкторы</category>

<category id="133"  parentId="95">Детское творчество</category>

<category id="98" >Детское творчество</category>

<category id="145" >Другие услуги</category>

<category id="196"  parentId="93">Заготовки для декупажа</category>

<category id="187"  parentId="83">Зажимы</category>

<category id="184"  parentId="83">Змейки</category>

<category id="150"  parentId="11">Иглы</category>

<category id="168"  parentId="28">Иглы</category>

<category id="150"  parentId="83">Иглы</category>

<category id="34742"  parentId="113">Иглы для бисера</category>

<category id="34732"  parentId="34727">Иглы для валяния</category>

<category id="34734"  parentId="121">Иглы для ручного шитья</category>

<category id="34735"  parentId="125">Иглы для швейных машин</category>

<category id="180"  parentId="83">Игольницы</category>

<category id="144" >Изготовление рамок</category>

<category id="173"  parentId="83">Измерительные приспособления</category>

<category id="201"  parentId="93">Ингридиенты</category>

<category id="137"  parentId="96">Ингридиенты и украшения</category>

<category id="143" >Индивидуальный пошив</category>

<category id="151"  parentId="11">Инструменты</category>

<category id="34738"  parentId="34736">Инструменты для квиллинга</category>

<category id="120"  parentId="28">Инструменты и аксессуары для вышивания</category>

<category id="115"  parentId="43">Инструменты и аксессуары для вязания</category>

<category id="200"  parentId="93">Инструменты и аксессуары для скрапбукинга</category>

<category id="131"  parentId="94">Инструменты и аксессуары для художников</category>

<category id="121"  parentId="83">Инструменты и аксессуары для шитья</category>

<category id="113"  parentId="11">Инструменты и фурнитура для создания украшений</category>

<category id="118"  parentId="28">Канва для вышивания</category>

<category id="160"  parentId="11">Канитель</category>

<category id="192"  parentId="83">Кант</category>

<category id="175"  parentId="83">Карандаши/маркеры/меловые колесики</category>

<category id="34736"  parentId="98">Квиллинг</category>

<category id="212"  parentId="94">Кисти/мастихины</category>

<category id="194"  parentId="93">Клеи/структурные пасты/кракелюры</category>

<category id="186"  parentId="83">Кнопки</category>

<category id="136"  parentId="96">Кондитерская упаковка</category>

<category id="138"  parentId="96">Кондитерский инвентарь</category>

<category id="96" >Кондитеру</category>

<category id="152"  parentId="11">Контейнеры для храниения</category>

<category id="188"  parentId="83">Косая бейка</category>

<category id="165"  parentId="43">Косметички и сумки для хранения</category>

<category id="207"  parentId="94">Краски</category>

<category id="195"  parentId="93">Краски/лаки</category>

<category id="190"  parentId="83">Кружево</category>

<category id="162"  parentId="43">Крючки</category>

<category id="162"  parentId="83">Крючки</category>

<category id="156"  parentId="11">Лента</category>

<category id="191"  parentId="83">Ленты</category>

<category id="134"  parentId="95">Лепка</category>

<category id="154"  parentId="11">Леска</category>

<category id="167"  parentId="28">Лупы</category>

<category id="185"  parentId="83">Люверсы</category>

<category id="205"  parentId="93">Материалы</category>

<category id="114"  parentId="11">Материалы для создания украшений</category>

<category id="178"  parentId="83">Маты</category>

<category id="211"  parentId="94">Мольберты</category>

<category id="129"  parentId="93">Мыло и свечи</category>

<category id="111"  parentId="11">Наборы бисероплетения</category>

<category id="34729"  parentId="34727">Наборы для валяния</category>

<category id="117"  parentId="28">Наборы для вышивания</category>

<category id="34739"  parentId="34736">Наборы для квиллинга</category>

<category id="206"  parentId="93">Наборы для создания игрушек</category>

<category id="164"  parentId="43">Наборы спиц и крючков</category>

<category id="176"  parentId="83">Наперстки</category>

<category id="119"  parentId="28">Нитки для вышивания</category>

<category id="172"  parentId="83">Нитки для шитья</category>

<category id="179"  parentId="83">Нитковдеватели</category>

<category id="173"  parentId="83">Ножницы</category>

<category id="169"  parentId="28">Органайзеры</category>

<category id="202"  parentId="93">Основы</category>

<category id="123"  parentId="83">Отделочные материалы для шитья</category>

<category id="159"  parentId="11">Паетки</category>

<category id="34740"  parentId="93">Пенопластовые заготовки</category>

<category id="171"  parentId="28">Приспособления для вышивки</category>

<category id="34725"  parentId="11">Проволока</category>

<category id="34725"  parentId="114">Проволока</category>

<category id="116"  parentId="43">Пряжа для вязания</category>

<category id="183"  parentId="83">Пуговицы</category>

<category id="166"  parentId="28">Пяльцы</category>

<category id="182"  parentId="83">Различные инструменты для шитья</category>

<category id="147"  parentId="11">Рубка</category>

<category id="203"  parentId="93">Силиконовые формы</category>

<category id="128"  parentId="93">Скрап</category>

<category id="161"  parentId="43">Спицы</category>

<category id="148"  parentId="11">Стеклярус</category>

<category id="158"  parentId="11">Стразы</category>

<category id="189"  parentId="83">Тесьма</category>

<category id="124"  parentId="83">Ткани для шитья</category>

<category id="97" >Товары для дома и интерьера</category>

<category id="93" >Товары для творчества</category>

<category id="94" >Товары для художников</category>

<category id="34726"  parentId="114">Тросик</category>

<category id="34727"  parentId="95">Фелт</category>

<category id="34731"  parentId="34727">Фетр</category>

<category id="139"  parentId="97">Флористика</category>

<category id="135"  parentId="95">Фоамиран</category>

<category id="153"  parentId="11">Фурнитура</category>

<category id="122"  parentId="83">Фурнитура для шитья</category>

<category id="208"  parentId="94">Холсты</category>

<category id="157"  parentId="11">Цепь</category>

<category id="125"  parentId="83">Швейные машины и аксессуары к ним</category>

<category id="34730"  parentId="34727">Шерсть для валяния</category>

<category id="83" >Шитье</category>

<category id="181"  parentId="83">Шкатулки/органайзеры</category>

<category id="170"  parentId="28">Шкатулки/сумки</category>

<category id="155"  parentId="11">Шнур</category>

<category id="126"  parentId="83">Шторная фурнитура</category>

          </categories>

  <offers>

            <offer id="44662" available="true">

  <code>1071236</code>   

      <url>https://charivna-mit.com.ua/bp-286-nabor-dlya-izgotovleniya-broshi-crystal-art-quot-ostrolist-quot&a...;

  <price>194</price>

  <old_price>259</old_price>

  <discount_percent>25</discount_percent>

  <currencyId>UAH</currencyId>

  <categoryId>117</categoryId>

<picture>https://charivna-mit.com.ua/products.thumbnail/65109-2500-2500-lq--8d2a6c81dfac08c1fa57349aed17e88c/...;

  <name>БП-286 Набор для изготовления броши Crystal Art Остролист </name>

  <vendor>Crystal Art</vendor>

  <stock_quantity>38</stock_quantity>

  <description>

  <![CDATA[В набор входит: инструкция, цветная схема, бисер Preciosa Ornela (Чехия) - 2 цветов (2 размеров), бусины Crystal Art - 2 цветов (2 размеров), канитель - 1шт, мулине Madeira - 3 цветов, фетр - 1 цвет, застежка и игла. 

Размер 10*10см

Авторские права защищены законом.

Копирование материалов запрещено торговой маркой Crystal Art.Размер: 10x10 см</p>]]>

  </description>

<param name="Производители ">Crystal Art</param>

<param name="Страна производитель">Украина</param>

<param name="Вид">вышивка</param>

<param name="Техника">гладь|смешанная вышивка|бисер</param>

<param name="Тематика">аксессуары|брошь|цветы</param>

<param name="Уровень сложности ">сложный</param>

<param name="Артикул">4823069644079</param>

<param name="Размер">10x10 см</param>

<param name="Маркер">sale</param>

    </offer>

  </offers>       

    </shop>

</yml_catalog>

Элемент

Значение

yml_catalog

Обязательный элемент

Корневой элемент формата YML. Атрибут date указывает дату и время генерации или изменения XML (YML). Дата должна иметь формат YYYY-MM-DD hh:mm.

shop

Обязательный элемент

Содержит описание магазина и его товарных предложений.

name

Необязательный элемент

Короткое название магазина. Не публикуется, используется для внутренней идентификации.

Максимальное количество символов ━ 255.

company

Необязательный элемент

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

Максимальное количество символов ━ 255.

url

Необязательный элемент

URL главной страницы существующего магазина.

Максимальное количество символов ━ 255.

currencies

Обязательный элемент

Список курсов валют магазина. Каждая из валют описывается отдельным элементом currency.

Пример:

<currencies>

<currency id="UAH" rate="1"/>

<currency id="USD" rate="24.50"/>

<currency id="EUR" rate="28.50"/>

<currency id="RUR" rate="0.31"/>

</currencies>

Цены на сайте отображаются только в гривнах. Только у гривны rate="1".

В качестве разделителя целой и дробной частей любых чисел в YML независимо от региональных установок используется точка или запятая.

Значение в атрибуте currency id="..." указывается по стандарту ISO 4217 в виде трёхбуквенного алфавитного (alfa-3) кода валюты.

categories

Обязательный элемент

Список категорий маркетплейса. Каждой категории присвоен уникальный номер, нумерация — по версии маркетплейса.

• при любых изменениях в прайс-листе id категорий должны оставаться неизменными;

• перед указанием необходимо подобрать конечные категории товара;

• рекомендуем указывать название категории согласно названию на нашем сайте;

• в одной категории магазина не должно быть товаров из двух разных категорий на нашем сайте.

offers

Обязательный элемент

Список товаров магазина. Открывается один раз, после тега </categories> . Закрывается в конце документа, перед тегом </shop>

Пример:

<categories>

<category id="28">Вышивка</category>

<category id="43">Вязание</category>

</categories>

<offers>

...

...

...

</offers>

</shop>

</yml_catalog>

Обратите внимание, тег не должен повторяться в пределах прайс-листа.

offer

Обязательный элемент

Карточка товара. Закрывается тегом </offer>.

• каждый товар описывается отдельным элементом offer;

• каждому предложению необходимо присвоить уникальный номер id="...", нумерация – на усмотрение магазина;

• offer id должен оставаться неизменным, допускается использование символов: Aa-Zz и 0-9, не допускается использование кириллицы и пробелов;

• Запрещается существующий id одного товара менять на другой товар;

• атрибут available — указывает наличие товара: true — товар в наличии, false — товар не в наличии.

На каждую разновидность товара: цвет, размер, объем, комплектацию и т.д., должен быть создан отдельный уникальный offer. Пример:

<offer id="74279" available="true">

...

</offer>

stock_quantity

Обязательный элемент

Остатки товара. Товар будет в наличии на сайте до тех пор, пока этот параметр больше 0.

Обязательно наличие тега во всех товарах в прайс-листе, иначе товарам без указания данного тега будет присвоен статус “Нет в наличии”. Также обязательно следить за значением в теге available="...", если stock_quantity > 0 ━ true, если stock_quantity < 0 ━ false.

Пример:

<stock_quantity>10</stock_quantity>

url (in offer)

Необязательный элемент

Ссылка на товар на вашем сайте.

Пример:

<url>http://abc.ua/catalog/muzhskaya_odezhda/kurtki/kurtkabx.html</url>

Максимальное количество символов ━ 500.

price

Обязательный элемент

Цена товара.

В качестве разделителя целой и дробной частей любых чисел в YML используется точка. Цена указанная с копейками будет округлена на сайте.

Пример:

<price>4499</price>

old_price

Необязательный элемент

Старая цена товара, будет перечеркнута на сайте. Указывайте следом за тегом <price>. Если значения атрибутов <price> и <old_price> отличаются, также обязательно укажите атрибут <discount_percent>

Пример:

<price>80</price>

<old_price>100</old_price>

<discount_percent>80</discount_percent>

discount_percent

Необязательный элемент

Процент скидки на акционный товар. Указывайте следом за тегами <price> и <old_price>. 

Пример:

<discount_percent>80</discount_percent>

currencyId

Обязательный элемент

Валюта, в которой указана цена товара: UAH

Пример:

<currencyId>UAH</currencyId>

categoryId

Обязательный элемент

ID категории, к которой относится данный товар.

Пример:

<categoryId>122</categoryId>

picture

Обязательный элемент

Ссылка на фото товара.

Первая фотография в списке будет основной на странице товара. Ссылка не должна содержать кириллицу и пробелы, максимальное количество символов ━ 1999. Минимальное количество фото ━ 1, максимальное ━ 15. Максимальный размер 1 фотографии ━ 10 Мб.

Пример:

<picture>http://abc.ua/upload/iblock/a53/a5391cddb40be91705-1.jpg</picture>;

<picture>http://abc.ua/upload/iblock/a53/a5391cddb40be91705-2.jpg</picture>;

Если на вашем сервере установлено ограничение на загрузку фотографий, необходимо добавить в исключения следующие подсети:

82.117.232.0/24

37.57.12.0/24

vendor

Обязательный элемент

Бренд-производитель товара.

Пример:

<vendor>Чарiвна мить</vendor>

name

Обязательный элемент

Название товара.

При указании придерживайтесь наших требований и рекомендаций.

• в прайс-листе не может быть два товара с абсолютно одинаковым названием;

• бренд, указанный в названии и в теге <vendor> должен быть одинаковым.

Пример:

<name>БП-286 Набор для изготовления броши Crystal Art Остролист</name>

Максимальное количество символов ━ 255.

description

Обязательный элемент

Описание товара.

• описание может быть однотипным для всей категории;

• в описании должна присутствовать информация только про товар;

• описание не должно содержать ссылок, телефонов, адресов, предложений услуг, акций, цен, картинок, видеообзоров и т.д.;

• описание желательно отформатировать с помощью html тегов. Html теги закрыть в <![CDATA[...]]>;

• максимальное количество символов — 50 000.

description_ua — описание товара на украинском языке. Если в прайс-листе нет украинского описания, товар не будет доступен в украинской версии сайта.

Пример:

<description>

<![CDATA[В набор входит: инструкция, цветная схема, бисер Preciosa Ornela (Чехия) - 2 цветов (2 размеров), бусины Crystal Art - 2 цветов (2 размеров), канитель - 1шт, мулине Madeira - 3 цветов, фетр - 1 цвет, застежка и игла. 

Размер 10*10см

Авторские права защищены законом.

Копирование материалов запрещено торговой маркой Crystal Art.Размер: 10x10 см</p>]]>

</description>

<param name="..."> ...</param>

Обязательный элемент

Характеристики (параметры) товара. Название и значение характеристики обязательно должно быть заполнено, не допускается наличие пустых тегов. Название и значения атрибутов должны совпадать со значениями, принятыми на маркетплейсе.

Минимальное количество необходимых характеристик у товара — 3.

• в атрибуте name укажите название параметра (обязательно);

• в самом элементе <param name="...">...</param> укажите значение параметра.

Пример:

<param name="Цвет">Черный</param>

В многозначном параметре значения перечисляются через запятую и закрываются в CDATA.

Максимальное количество символов ━ 255.