Требования к прайс-листу для мототехники

Требования к передаче данных

Для размещения объявлений на Авто.ру необходимо составить прайс-лист в формате XML (Extensible Markup Language).

Формат XML не позволяет использовать первые 32 ASCII-символа в текстовых полях. Исключения — табуляция, перевод строки, возврат каретки. Также стандарт строго требует кодировать в тексте следующие символы:

Символ, который нужно заменить Код для файла XML
" "
& &
> >
< &lt;
' &apos;

Кодировка: UTF-8.

Прайс-лист в формате XML должен начинаться с нулевого символа первой строки со стандартного заголовка.

<?xml version="1.0" encoding="utf-8"?>

Требования к объявлениям

Перед составлением прайс-листа ознакомьтесь с Правилами составления объявлений.

Корневой элемент data содержит родительский элемент cars. В cars входят элементы car, каждый из которых содержит информацию из одного объявления.

Внимание. Элементы со строго ограниченным набором значений могут содержать только перечисленные варианты. Использование других значений приведет к ошибке при обработке прайс-листа.

Размер файла каталога — 2,32 МБ. Рекомендуем открывать его в текстовых редакторах, например Notepad++ для Windows и Sublime Text для Mac OS.

Элемент Обязательный элемент Описание
car Элемент объявления.
mark_id

Марка.

Значение из каталога.

group_id Группа.

Значение из каталога.

model_id

Модель.

Значение из каталога или произвольное.

modification_id

Модификация.

Значение из каталога.

color

Цвет.

Строго ограниченные значения
  • Бежевый;
  • Бежевый металлик;
  • Белый;
  • Белый металлик;
  • Голубой;
  • Голубой металлик;
  • Желтый;
  • Желтый металлик;
  • Зеленый;
  • Зеленый металлик;
  • Золотой;
  • Золотой металлик;
  • Коричневый;
  • Коричневый металлик;
  • Красный;
  • Красный металлик;
  • Оранжевый;
  • Оранжевый металлик;
  • Пурпурный;
  • Пурпурный металлик;
  • Розовый;
  • Розовый металлик;
  • Серебряный;
  • Серебряный металлик;
  • Серый;
  • Серый металлик;
  • Синий;
  • Синий металлик;
  • Фиолетовый;
  • Фиолетовый металлик;
  • Черный;
  • Черный металлик.
availability

Наличие.

Строго ограниченные значения:
  • В наличии;
  • На заказ.
custom

Таможенный статус.

Обязательный элемент для транспорта с пробегом.

Строго ограниченные значения:
  • Растаможен;
  • Не растаможен.
state

Состояние.

Обязательный элемент для транспорта с пробегом.

Строго ограниченные значения:
  • Отличное;
  • Хорошее;
  • Среднее;
  • Требует ремонта.
haggle Торг.

Обязательный элемент для транспорта с пробегом.

Строго ограниченные значения:
  • возможен;
  • не возможен.
exchange Обмен.

Обязательный элемент для транспорта с пробегом.

Возможные значения:

  • Не интересует;
  • С вашей доплатой;
  • С моей доплатой;
  • Рассмотрю варианты.
run Пробег в км.

Обязательный элемент для транспорта с пробегом.

В качестве значения используется целое число больше 0.

year

Год выпуска.

В качестве значения используется целое число больше 0:
  • для б/у транспорта — не раньше 1970;
  • для нового — не более трех лет назад с текущего года.
price

Цена.

В качестве значения используется целое число больше 1 500.

currency

Валюта.

Строго ограниченные значения:
  • RUR;
  • EUR;
  • USD.
vin VIN номер.

Значение из 17 символов.

description Дополнительная информация.

Описание в свободной форме до 30 000 символов.

images

Фотографии.

Можно передавать несколько элементов.

<images>
  <image/>
</images>

Максимальное количество — 30 фотографий.

sale_services

Дополнительные услуги по продвижению объявления: Премиум и Спецпредложение.

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

Возможные значения:

  • premium;
  • special.
unique_id Уникальный идентификатор объявления.

Элемент используется, если не указан VIN номер.

Произвольный набор цифр, букв, знаков «-» и «_» до 50 символов.

type Тип.
Строго ограниченные значения:
  • Allround;
  • Naked bike;
  • Speedway;
  • Supermotard;
  • Внедорожный Эндуро;
  • Детский;
  • Дорожный;
  • Кастом;
  • Классик;
  • Кросс;
  • Круизер;
  • Минибайк;
  • Мотоцикл повышенной проходимости;
  • Питбайк;
  • Спортбайк;
  • Спорттуризм;
  • Спортивный Эндуро;
  • Суперспорт;
  • Трайки;
  • Триал;
  • Трицикл;
  • Туризм;
  • Туристический Эндуро;
  • Чоппер.
engine_type Тип двигателя.

Возможные значения для мотоциклов:

  • Дизель;
  • Инжектор;
  • Карбюратор;
  • Турбо.
Возможные значения для скутеров:
  • Карбюратор;
  • Инжектор;
  • Дизель;
  • Бензиновый;
  • Электродвигатель;
  • Гибрид.
engine_power Мощность двигателя в лошадиных силах.

В качестве значения используется целое число больше 0.

engine_volume Объем двигателя в кубических см.
cylinders Число цилиндров.

Элемент используется для мотоциклов.

cylinders_type Тип расположения цилиндров.

Возможные значения:

  • V-образное;
  • Оппозитное;
  • Роторное;
  • Рядное.

Элемент используется для мотоциклов.

strokes Число тактов.
drive Привод.

Возможные значения:

  • Кардан;
  • Ремень;
  • Цепь.

Элемент используется для мотоциклов.

gearbox Коробка переключения передач.

Возможные значения для мотоциклов:

  • 1;
  • 2;
  • 2-скоростной автомат;
  • 3;
  • 3-скоростной автомат;
  • 4;
  • 4 прямых и задняя;
  • 5;
  • 5 прямых и задняя;
  • 6;
  • 6 прямых и задняя;
  • 7;
  • 8;
  • АКПП;
  • Роботизированная;
  • Роботизированная с двумя сцеплениями.
Возможные значения для скутеров:
  • 2;
  • 3;
  • 4;
  • 5;
  • 6;
  • АКПП;
  • Вариатор.
extras

Опции.

Можно передавать несколько значений элемента.

В качестве разделителя между значениями используется «,».

Возможные значения:
  • Антиблокировочная система (ABS);
  • Электростартер.

Примеры прайс-листов

Пример корректного прайс-листа для новой мототехники
<?xml version="1.0" encoding="utf-8"?>
<data>
	<cars>
		<car>
			<mark_id>JMC</mark_id>
			<group_id>125 MX</group_id>
			<model_id>125 MX</model_id>
			<modification_id>125 Cross</modification_id>
			<year>2016</year>
			<availability>В наличии</availability>
			<currency>RUR</currency>
			<price>69800</price>
			<color>Черный</color>
			<description>Гарантированная скидка при обмене на ваш мотоцикл.</description>
			<type>Кросс</type>
			<engine_type>Карбюратор</engine_type>
			<engine_volume>125</engine_volume>
			<engine_power>10</engine_power>
			<haggle>Не возможен</haggle>
			<vin>RUXVC201600308025</vin>
			<images>
                     <image>http://price.site.ru/files/image1.jpg</image>
                     <image>http://price.site.ru/files/image2.jpg</image>
                     </images>
		</car>
		 <car>
			<mark_id>Honda</mark_id>
			<group_id>Tact</group_id>
			<model_id>SZ 50 Tact</model_id>
			<modification_id>1996</modification_id>
			<year>2016</year>
			<availability>В наличии</availability>
			<state>Не требует ремонта</state>
			<currency>RUR</currency>
			<price>160000</price>
			<custom>Растаможен</custom>
			<color>Черный металлик</color>
			<description>Закажите у менеджера видеопрезентацию и доставку в другой город.</description>
			<engine_volume>49</engine_volume>
			<engine_power>22</engine_power>
                     <strokes>2</strokes>
			<haggle>Не возможен</haggle>
			<vin>122222MF081003899</vin>
			<images><image>http://price.site.ru/files/image3.jpg</image></images>
		</car>
	</cars>
</data>
Пример корректного прайс-листа для б/у мототехники
<?xml version="1.0" encoding="utf-8"?>
<data>
	<cars>
		<car>
			<mark_id>MV Agusta</mark_id>
			<group_id>F4 1000</group_id>
			<run>555</run>
			<year>1999</year>
			<availability>В наличии</availability>
			<state>Не требует ремонта</state>
			<exchange>Не интересует</exchange>
			<currency>RUR</currency>
			<price>8888888</price>
			<custom>Растаможен</custom>
			<color>Зеленый</color>
			<type>Дорожный</type>
			<engine_type>Карбюратор</engine_type>
			<engine_volume>445</engine_volume>
			<haggle>Возможен</haggle>
			<unique_id>2512578-af6c7cee</unique_id>
			<images><image>http://price.site.ru/files/image1.jpg</image></images>
		</car>
		<car>
			<mark_id>BMW</mark_id>
			<group_id>R 1200 GS</group_id>
			<model_id>3</model_id>
			<modification_id>4</modification_id>
			<run>27033</run>
			<year>2014</year>
			<availability>В наличии</availability>
			<state>Не требует ремонта</state>
			<currency>RUR</currency>
			<price>1060090</price>
			<custom>Растаможен</custom>
			<color>Белый металлик</color>
			<description>Позвоните нам и все узнайте!</description>
			<type>Чоппер</type>
			<engine_type>Инжектор</engine_type>
			<engine_volume>1200</engine_volume>
			<engine_power>125</engine_power>
			<haggle>Не возможен</haggle>
			<vin>WB10A056565144656</vin>
			<images><image>http://price.site.ru/files/image2.jpg</image></images>
		</car>
              <car>
			<mark_id>Honda</mark_id>
			<group_id>Forza</group_id>
			<model_id>3</model_id>
			<modification_id>4</modification_id>
			<year>2008</year>
			<run>34401</run>
			<availability>В наличии</availability>
			<state>Не требует ремонта</state>
			<currency>RUR</currency>
			<price>129000</price>
			<custom>Растаможен</custom>
			<color>Черный металлик</color>
			<description>Закажите у менеджера видеопрезентацию и доставку в другой город.</description>
			<engine_volume>249</engine_volume>
			<engine_power>22</engine_power>
			<haggle>Не возможен</haggle>
			<vin>122222MF081003899</vin>
			<images><image>http://price.site.ru/files/image3.jpg</image></images>
		</car>
	</cars>
</data>