Правила для создания YML-файлов для RIA.com

Загрузка объявлений на RIA.com с помощью YML-файлов предназначена для автоматизации процесса загрузки и доступна только для коммерческих пользователей сайта (владельцев интернет-магазинов).

YML-файлы должны соответствовать общим требования, которые доступны по ссылке: Описание YML.

Обратите внимание, что действуют следующие ограничения по количеству товара: YML-файл может содержать информацию о не более 30 000 товаров (<offer>...</offer>). Если количество товаров превышают эти лимиты, разбейте YML-файл на несколько частей.

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

Во время синхронизации товаров в YML-файле с объявлением на сайте:

- для нового товара - создание нового объявления

- для товара, который был добавлен ранее - обновление информации (например, цены)

- для товара, который был и пропал - объявление будет перемещено в архив

Как будет происходить распределение товаров по категориям сайта?

Распределение товаров в YML-файле по категориям сайта может происходить:

- по категориям в YML-файле

Обратите внимание, что нет необходимости в своем YML-файле повторять структуру сайта. В YML-файле можно передавать свои категории, которые отличаются от категорий на сайте RIA.com. Соответствие между категориями в YML-файле и категориями на сайте будет происходить на стороне сайта RIA.com персональным менеджером коммерческого пользователя сайта.

- по заголовкам предложений в YML-файле (игнорируя категории)

Обратите внимание, этот вариант работает только для автомобильных запчастей.

Система игнорирует категории в YML-файле и ищет каталог для каждого предложение на основе анализа заголовка предложения.
Поэтому мы настоятельно рекомендуем в заголовке каждого предложения указывать:

состояние запчасти
название запчасти
марку, модель и год выпуска автомобиля, для которого эта запчасть подходит

Примеры правильных заголовков:

Б/у двигатель на Audi A6 3.0 TDI quattro 2006-2008

Новый двигатель на Audi A6 3.0 TDI quattro 2006, 2007, 2008

Для того, чтобы помочь системе в определении типа транспорта, марки, модели, а также каталожного номера запчасти, рекомендуем передавать эти параметры через param name.

Пример

<param name="Тип транспорта">Грузовики</param>
<param name="Марка">VOLVO</param>
<param name="Модель">FH</param>
<param name="Каталожный номер">88018FE010, 88018-FE010</param>
 или 
<param name="Код запчасти">88018FE010, 88018-FE010</param>
 или 
<param name="Код производителя">88018FE010, 88018-FE010</param>

Можно передавать несколько каталожных номеров.
Ограничение 500 символов.
В качестве разделителя следует использовать символ ",".

Для <param name="Тип транспорта"> можно использовать следующие значения: легковые, легкові, мототранспорт, водный транспорт, водний транспорт, спецтехника, спецтехніка, прицепы, причепи, грузовики, вантажівки, автобусы, автобуси.

Обратите внимание! В <param name="Марка"> и <param name="Модель"> будут прочитаны первые три слова.

Особенности работы с ценами в валюте и курсом валюты

В своем YML-файле вы можете указывать стоимость предложений в валюте, а также курс валюты.

<currencies>
   <currency id="USD" rate="6"/>
   <currency id="UAH" rate="1"/>
</currencies>

Объявления на сайт будут добавляться уже в грн., а весь пересчет будет происходить на основе курса, который указан в YML-файлі.

Структура файла

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="хххх-хх-хх хх:хх">
<shop>
   <currencies>
      <currency id="USD" rate="28.00"/>
      <currency id="UAH" rate="1"/>
   </currencies>
   <categories>
      <category id="x">x</category>
      <category id="x">x</category>
   </categories>
   <offers>
      <offer>...</offer>
      <offer>...</offer>
   </offers>
</shop>
</yml_catalog>

Подробнее о <categories>

<categories> содержит список ваших категорий и может выглядеть одним из следующих образов:

<categories>
    <category id="1">Все для транспорта</category>
    <category id="2" parentId="1">Запчасти</category>
    <category id="3" parentId="2">Легковое авто</category>
    <category id="4" parentId="3">Audi</category>
    <category id="5" parentId="4">A6</category>
    <category id="6" parentId="5">Электрооборудование кузова</category>
    <category id="7" parentId="6">Фара</category>
</categories>
<categories>
    <category id="8">Фара</category>
    <category id="9" parentId="8">Audi A6</category>
</categories>
<categories>
    <category id="11">Фары для Audi A6</category>
</categories>
<categories>
    <category id="12">Фары для Audi</category>
    <category id="14" parentId="12">A6</category>
</categories>
<categories>
    <category id="15">Детский мир</category>
    <category id="16" parentId="15">Автокресла</category>
    <category id="17" parentId="16">Новые</category>
</categories>

Подробнее об <offers>

<offers> должен содержать следующую информацию: заголовок, описание, цена, фото

<offers>
  <offer id="24085">
    <price>1210</price>
    <currencyId>UAH</currencyId>
    <categoryId>1</categoryId>
    <picture>
      https://cdn.riastatic.com/photosnew/general/adv_photos/gp__48887497m.jpg
    </picture>
    <picture>
      https://cdn.riastatic.com/photosnew/general/adv_photos/gp__48887497m.jpg
    </picture>
    <name>Литые диски JT 123R R13 W5.5 PCD4x98 ET15 DIA58.6 GP</name>
    <param name="Диаметр">13</param>
    <param name="Ширина">5.5</param>
    <param name="ЕТ(вылет)">15</param>
    <param name="PCD">4x98</param>
    <vendor>JT</vendor>
    <description>
          Литые диски JT японского производителя Japan Industrial Co., Ltd изготавливаются из алюминиевых
          сплавов, имеют современный дизайн.
    </description>
  </offer>
</offers>

Заголовок объявления

Заголовок объявления необходимо передавать в теге <name> или <title>. Заголовок объявления не должен превышать 120 символов.

Если вы не используете теги <name> и <title>, тогда заголовок объявления будет создан из значений трех элементов: typePrefix, vendor и model ( typePrefix необязательный ).

В элементе typePrefix передается тип или категория товара, в элементе vendor — производитель, в элементе model — модель и важные параметры.

Примеры для формата YML:

<typePrefix>Смартфон</typePrefix>
<vendor>Apple</vendor>
<model>iPhone 6s 128gb розовое золото</model>

<typePrefix>Кроссовки</typePrefix>
<vendor>Adidas</vendor>
<model>(VLNEO) V RACER NYLON</model>

Описание объявления

В теге <description> необходимо передавать описание объявления (не более 65535 символов).

Для форматирования текста вы можете использовать следующие теги:
<ul>, <ol>, <li>, <table>, <tbody>, <th>, <tr>, <td>, <br>, <p>, <strong>

Пример

<description>
	<![CDATA[<p>Литые диски JT японского производителя <strong>Japan Industrial Co., Ltd<strong></p>
	<p>изготавливаются из алюминиевых сплавов, имеют современный дизайн.</p>]]>
</description>

Наличие

C помощью тега available вы можете передавать информацию о наличии товара.

1) available="true" - объявление будет добавлено на сайт с отметкой "В наличии"

2) available="false" - объявление будет добавлено на сайт с отметкой "Под заказ"

3) available="" - объявление не будет добавлено на сайт

Для объявлений, которые будут определены в категорию "Услуги", тег available учитываться не будет.

id — идентификатор предложения

В элементе id указывается идентификатор предложения. Идентификатор может содержать только цифры и латинские буквы. Максимальная длина id — 25 символов.

Внимание! Указание идентификатора обязательно. Идентификатор предложения должен быть:

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

Фото

Для передачи изображения используйте элемент picture. В элементе picture передайте ссылку на изображение товара, например:

<picture>
    https://cdn.riastatic.com/photosnew/general/adv_photos/gp__48887497m.jpg
</picture>

Для передачи нескольких изображений, каждую ссылку заключайте в свой элемент picture:

<picture>
    https://cdn.riastatic.com/photosnew/general/adv_photos/gp__48887497m.jpg
</picture>
<picture>
    https://cdn.riastatic.com/photosnew/general/adv_photos/gp__48887497m.jpg
</picture>

Для каждого объявления можно указать до 20 ссылок на изображения товара.

Первое изображение считается изображением по умолчанию, т.е. становится главным. Оно используется в качестве изображения товара в поиске и первым на странице предложения.

Допустимый формат файлов изображений: jpg, jpeg, png, bmp

Минимальный размер изображений — 200 пикселей по любой из сторон. Изображения с размером меньше 200 пикселей не будут добавлены.

Внимание! При обновлении изображения обязательно измените ссылку на него.

Список запчастей RIA.com

Список всех запчастей, которые вы можете использовать при импорте объявлений на сайт RIA.com, Вы можете получить в этом файле - Список запчастей RIA.com. Этот файл содержит актуальный список запчастей и периодически обновляется.

Список марок и моделей

Список всех марок и моделей автомобилей, которые вы можете использовать при импорте объявлений на сайт RIA.com, Вы можете получить в этом файле - Список марок и моделей RIA.com. Этот файл содержит актуальный список и периодически обновляется.

Доставка

Самовывоз true/false

<pickup>true</pickup>

Службы доставки профиля true/false

</delivery>true</delivery>

Пример YML-файла

https://www.ria.com/example-ria-import/yml-feed/

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2010-04-01 17:00">
    <shop>
        <currencies>
            <currency id="USD" rate="28.00"/>
            <currency id="UAH" rate="1"/>
        </currencies>
        <categories>
            <category id="1">Тормозная система</category>
            <category id="15">Детские кроватки</category>
        </categories>
        <offers>
            <offer available="true" id="1">
                <price>20</price>
                <currencyId>USD</currencyId>
                <categoryId>1</categoryId>
                <picture>
                    https://cdn3.riastatic.com/photosnew/general/adv_photos/zapchasti-dysk-tormoznoy-perednyy-mersedes-vyto-w-638-do-2003-g-v-orygynal-b-u__68422773m.webp
                </picture>
                <picture>
                    https://cdn3.riastatic.com/photosnew/general/adv_photos/zapchasti-dysk-tormoznoy-perednyy-mersedes-vyto-w-638-do-2003-g-v-orygynal-b-u__68422773m.webp
                </picture>
                <video>https://www.youtube.com/watch?v=ooMr8FPDoJc</video>
                <pickup>true</pickup>
                <delivery>true</delivery>
                <name>Тормозные диски для Audi A6 2007</name>
                <param name="Марка">Audi</param>
                <param name="Модель">A6</param>
                <param name="Тип запчасти">Оригинал</param>
                <param name="Каталожный номер">88018FE010, 88018-FE010</param>
            </offer>
            <offer available="true" id="2">
                <price>50</price>
                <currencyId>USD</currencyId>
                <categoryId>1</categoryId>
                <picture>
                    https://cdn3.riastatic.com/photosnew/general/adv_photos/zapchasti-dysk-tormoznoy-perednyy-mersedes-vyto-w-638-do-2003-g-v-orygynal-b-u__68422773m.webp
                </picture>
                <picture>
                    https://cdn3.riastatic.com/photosnew/general/adv_photos/zapchasti-dysk-tormoznoy-perednyy-mersedes-vyto-w-638-do-2003-g-v-orygynal-b-u__68422773m.webp
                </picture>
                <video>https://www.youtube.com/watch?v=ooMr8FPDoJc</video>
                <pickup>true</pickup>
                <delivery>true</delivery>
                <name>Тормозные диски для Audi A6 2007-2010-тест-импорт_статус_модерации_Тест_2_final_hope</name>
                <param name="Марка">Audi</param>
                <param name="Модель">A6</param>
                <param name="Тип запчасти">Оригинал</param>
                <param name="Код запчасти">88018FE010, 88018-FE010</param>
            </offer>
            <offer available="true" id="4">
                <price>50</price>
                <currencyId>USD</currencyId>
                <categoryId>1</categoryId>
                <picture>
                    https://cdn3.riastatic.com/photosnew/general/adv_photos/zapchasti-dysk-tormoznoy-perednyy-mersedes-vyto-w-638-do-2003-g-v-orygynal-b-u__68422773m.webp
                </picture>
                <picture>
                    https://cdn3.riastatic.com/photosnew/general/adv_photos/zapchasti-dysk-tormoznoy-perednyy-mersedes-vyto-w-638-do-2003-g-v-orygynal-b-u__68422773m.webp
                </picture>
                <video>https://www.youtube.com/watch?v=ooMr8FPDoJc</video>
                <pickup>true</pickup>
                <delivery>true</delivery>
                <name>Тормозные диски для Audi A6 2008</name>
                <param name="Марка">Audi</param>
                <param name="Модель">A3</param>
                <param name="Тип запчасти">Оригинал</param>
                <param name="Код производителя">88018FE011, 88018-FE011</param>
            </offer>
            <offer id="4">
                <price>3950</price>
                <currencyId>UAH</currencyId>
                <categoryId>15</categoryId>
                <picture>
                    https://cdn1.riastatic.com/photosnew/general/adv_photos/lyuksovaya-krovat-karyna-osen-ot-proyzvodytelya-vygodnoe-predlozhenye-super-tsen__98220876d.jpg
                </picture>
                <picture>
                    https://cdn1.riastatic.com/photosnew/general/adv_photos/lyuksovaya-krovat-karyna-osen-ot-proyzvodytelya-vygodnoe-predlozhenye-super-tsen__98220876d.jpg
                </picture>
                <video>https://www.youtube.com/watch?v=ooMr8FPDoJc</video>
                <name>Люксовая кровать Карина</name>
                <param name="Состояние">Новое</param>
                <param name="Высота" unit="см">80</param>
                <param name="Высота до начала спального места" unit="см">23</param>
                <param name="Высота бортиков" unit="см">45</param>
                <vendor>karinalux</vendor>
                <description>
                    <![CDATA[<p><strong>Карина</strong> это кровать трансформер, через некоторое время, когда дети выростут, верхнюю часть кровати можно будет просто снять и поставить ее на низ, таким образом у Вас вместо двухъярусной кровати станет две односпальные кровати. <p>После производства двухъярусная кровать Карина покрывается сертифицированным лаком, который не содержит формальдегидов, и поэтому не вредный для здоровья.</p><p>Дно двухъярусной кровати состоит из ортопедических ламелей — которые поддерживают матрас, и благодаря своему изгибу позволяют равномерно распределить нагрузку на матрас.</p>]]>
                </description>
            </offer>
        </offers>
    </shop>
</yml_catalog>

Для импорта объявлений в вашем аккаунте должны быть указаны область и город. Указать их можно тут - Редактирование профиля.