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

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

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

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

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

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

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

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

В названиях элементов нельзя использовать заглавные буквы. Например, элемент Image не будет обработан, image — будет.

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

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

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

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

Размер файла каталога — 2,52 МБ. Рекомендуем открывать его в текстовых редакторах, например 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>

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

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

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

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

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

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

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

wheel Расположение руля.
Строго ограниченные значения:
  • левый;
  • правый.
bus_type Тип автобуса.

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

Строго ограниченные значения:
  • Вахтовый;
  • Городской;
  • Междугородный;
  • Пригородный;
  • Специальный;
  • Туристический;
  • Школьный.
wheel_drive Колесная формула.
Возможные значения:
  • 4x2;
  • 4x4;
  • 6x2;
  • 6x4;
  • 6x6;
  • 8x2;
  • 8x4;
  • 8x8;
  • 10x6;
  • 10x10.
seats Количество мест.

В качестве значения используется произвольное положительное целое число.

engine_power Мощность двигателя в лошадиных силах.
engine_volume Объем двигателя в кубических см.
engine_type Тип двигателя.

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

Возможные значения:
  • дизельный;
  • бензиновый.
gearbox Коробка переключения передач.
Возможные значения:
  • Автоматическая;
  • Механическая;
  • Автомат вариатор;
  • Автомат робот.
extras

Опции.

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

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

Возможные значения для автобусов
  • Антиблокировочная система (ABS);
  • Багажное отделение;
  • Вход для инвалидов;
  • Горный тормоз;
  • Занавески;
  • Кондиционер;
  • Навигационная система;
  • Подруливающая ось;
  • Светильники у пассажиров;
  • Телевизор;
  • Тонированные стекла;
  • Туалет;
  • Холодильник.
Возможные значения для грузовиков
  • EBS;
  • Автономный отопитель салона;
  • Антиблокировочная система (ABS);
  • Аэродефлектор;
  • Бортовой компьютер;
  • Горный тормоз (интардер);
  • Горный тормоз (ретардер);
  • Кондиционер (есть);
  • Кондиционер (климат);
  • Корректор фар;
  • Круиз-контроль;
  • Магнитола (CD);
  • Магнитола (DVD);
  • Магнитола (Кассетная);
  • Магнитола (Радио);
  • Навигационная система;
  • Обогрев электрозеркал;
  • Подогрев сидений (водительское);
  • Подогрев сидений (оба);
  • Подруливающая ось;
  • Подушка безопасности;
  • Подъемная ось;
  • Предпусковой подогрев;
  • Привод электрозеркал (все);
  • Привод электрозеркал (левый);
  • Привод электрозеркал (правый);
  • Противотуманные фары;
  • Тахограф;
  • Телевизор;
  • Тяговосцепное устройство;
  • Холодильник;
  • Электростеклоподъемники (все);
  • Электростеклоподъемники (левый);
  • Электростеклоподъемники (правый).
Возможные значения для легкого коммерческого транспорта
  • Антиблокировочная система (ABS);
  • Антипробуксовочная система;
  • Бортовой компьютер;
  • Кондиционер;
  • Круизконтроль;
  • Легкосплавные диски;
  • Магнитола (CD);
  • Магнитола (DVD);
  • Магнитола (Кассетная);
  • Магнитола (Радио);
  • Обогрев зеркал;
  • Обогрев сидений;
  • Охранная система;
  • Подушки безопасности (1);
  • Подушки безопасности (2);
  • Подушки безопасности (4);
  • Регулировка руля;
  • Усилитель рулевого управления;
  • Центральный замок;
  • Электрозеркала;
  • Электростеклоподъемники.
Возможные значения для прицепов
  • Антиблокировочная система (ABS);
  • Дисковые тормоза;
  • Пневмоподвеска;
  • Подруливающая ось;
  • Подъемная ось.
Возможные значения для седельных тягачей
  • EBS;
  • Автономный отопитель салона;
  • Антиблокировочная система (ABS);
  • Аэродефлектор;
  • Бортовой компьютер;
  • Горный тормоз (интардер);
  • Горный тормоз (ретардер);
  • Кондиционер (есть);
  • Кондиционер (климат);
  • Корректор фар;
  • Круиз-контроль;
  • Магнитола (CD);
  • Магнитола (DVD);
  • Магнитола (Кассетная);
  • Магнитола (Радио);
  • Навигационная система;
  • Обогрев электрозеркал;
  • Подогрев сидений (водительское);
  • Подогрев сидений (оба);
  • Подруливающая ось;
  • Подушка безопасности;
  • Подъемная ось;
  • Предпусковой подогрев;
  • Привод электрозеркал (все);
  • Привод электрозеркал (левый);
  • Привод электрозеркал (правый);
  • Противотуманные фары;
  • Тахограф;
  • Телевизор;
  • Холодильник;
  • Электростеклоподъемники (все);
  • Электростеклоподъемники (левый);
  • Электростеклоподъемники (правый).
suspension_cabin Подвеска кабины.
Возможные значения:
  • механическая;
  • пневматическая.
eco_class Класс выхлопа EURO.
Возможные значения:
  • 0;
  • 1;
  • 2;
  • 3;
  • 4;
  • 5;
  • Зеленый сертификат.
fuel_tanks Количество топливных баков.
Возможные значения:
  • 1;
  • 2;
  • 3.
fuel_tanks_volume Общий объем топливных баков.
fuel_tanks_material Материал топливных баков.
Возможные значения:
  • Алюминий;
  • Сталь.
body_type Тип кузова.

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

Значения для грузовиков
  • Автовоз;
  • Автотопливозаправщик;
  • Автоцистерна;
  • Бортовой грузовик;
  • Вакуумная машина;
  • Вахтовый автобус;
  • Газовоз;
  • Для перевозки скота;
  • Изотермический кузов;
  • Контейнеровоз;
  • КУНГ;
  • Лесовоз;
  • Ломовоз/металловоз;
  • Плетевоз;
  • Рефрижератор;
  • Рыбовоз;
  • Самосвал;
  • Самосвал с 2-х разгрузкой;
  • Самосвал с 3-х разгрузкой;
  • Сортиментовоз;
  • Тент;
  • Термокузов;
  • Трубовоз;
  • Фургон;
  • Цементовоз;
  • Шасси;
  • Эвакуатор.
Значения для легкого коммерческого транспорта
  • Бортовой грузовик;
  • Изотермический кузов;
  • Микроавтобус;
  • Пикап;
  • Промтоварный автофургон;
  • Рефрижератор;
  • Самосвал;
  • Скорая помощь;
  • Цельнометаллический фургон;
  • Цистерна;
  • Шасси;
  • Эвакуатор.
cabin_type Тип кабины.
Возможные значения:
  • 2-х местная без спального;
  • 2-х местная с 1 спальным;
  • 2-х местная с 2 спальными;
  • 3-х местная без спального;
  • 3-х местная с 1 спальным;
  • 6-ти местная;
  • 7-и местная;
  • двухрядная.
loading Грузоподъемность в кг.
suspension_chassis Подвеска шасси.
Возможные значения:
  • рессора-рессора;
  • рессора-пневмо;
  • пневмо-пневмо;
  • торсионная.
drive Привод.

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

Строго ограниченные значения:
  • Заднеприводный с подключаемым передним;
  • Задний;
  • Передний;
  • Полный;
  • Полный подключаемый;
  • Постоянный привод на все колеса.
axis Количество осей прицепа.
trailer_type Тип прицепа.

Обязательное значение для прицепов.

Строго ограниченные значения
  • полуприцеп бортовой;
  • полуприцеп для перевозки птиц;
  • полуприцеп для перевозки скота;
  • полуприцеп для перевозки сыпучих грузов;
  • полуприцеп-зерновоз;
  • полуприцеп изотермический;
  • полуприцеп-комбикормовоз;
  • полуприцеп раздвижной;
  • полуприцеп самосвальный;
  • полуприцеп специальный;
  • полуприцеп шторный;
  • полуприцеп-автовоз;
  • полуприцеп-бетоносмеситель;
  • полуприцеп-битумовоз;
  • полуприцеп-контейнеровоз;
  • полуприцеп-лесовоз;
  • полуприцеп низкорамный трал;
  • полуприцеп-панелевоз;
  • полуприцеп-рефрижератор;
  • полуприцеп-роспуск;
  • полуприцеп-сортиментовоз;
  • полуприцеп-стекловоз;
  • полуприцеп-тяжеловоз;
  • полуприцеп-фермовоз;
  • полуприцеп-фургон;
  • полуприцеп-цементовоз;
  • полуприцеп-цистерна;
  • полуприцеп-щеповоз;
  • полуприцеп-эвакуатор;
  • полуприцепы для перевозки газа;
  • прицеп бортовой;
  • прицеп для перевозки водной техники;
  • прицеп для перевозки мотоцикла;
  • прицеп для перевозки птиц;
  • прицеп для перевозки скота;
  • прицеп для перевозки снегохода;
  • прицеп для перевозки транспортных средств;
  • прицеп к легковому автомобилю;
  • прицеп кабельная тележка;
  • прицеп подкатная тележка;
  • прицеп рекламный;
  • прицеп самосвальный;
  • прицеп тентованный;
  • прицеп-ассенизатор;
  • прицеп-балковоз;
  • прицеп-битумовоз;
  • прицеп-коневоз;
  • прицеп-контейнеровоз;
  • прицеп-палатка;
  • прицеп-рефрижератор;
  • прицеп-роспуск;
  • прицеп-сортиментовоз;
  • прицеп-трейлер;
  • прицеп-фургон;
  • прицеп-цистерна;
  • прицепы для перевозки газа.
brake_type Тип тормозов.
Возможные значения:
  • барабанные;
  • дисковые.
trail_loading Нагрузка на сцепное устройство в кг.
saddle_height Высокое седельное устройство.
Возможные значения:
  • 128;
  • 150;
  • 185;
  • 250.
action Статус продажи.

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

Возможные значения:
  • show;
  • hide.

Чтобы деактивировать объявление, следует передавать значение hide.

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

poi_id

Адрес места осмотра.

Если не указан, в объявлении отображается адрес автосалона.

contact_info Набор элементов о контактах.
<contact_info> 
    <contact>
        <name/>
        <phone/>
        <time/>
    <contact/>
</contact_info>
contact Данные контактного лица.
name Имя контактного лица.
phone Номер телефона контактного лица.

Пример: 80123456789.

time Время работы в виде интервала: 00:00-23:59.
service_auto_apply Набор элементов, характеризующих автоприменение услуги «Поднятие в поиске».

Услуга платная. Актуальная цена указана в разделе Стоимость размещения.

<service_auto_apply>
    <fresh> 
      <switch/>
      <weekdays/>
      <time/>
      <frequency/>
    </fresh>
</service_auto_apply>
fresh Услуга «Поднятие в поиске».

Во вложенных элементах следует передавать условия оказания услуги.

switch Подключение или отключение услуги.
Возможные значения:
  • on;
  • off.

После подключения услуга предоставляется регулярно на выбранных условиях.

Чтобы отключить услугу, следует изменить значение элемента на off. Если удалить элемент из прайс-листа, услуга не отключится.

weekdays Дни недели, когда применяется услуга.

Следует передавать порядковый номер дня недели от 1 до 7.

Например, если значение элемента 1, 3, 5, то объявление поднимется в поиске в понедельник, среду и пятницу.

time Время поднятия объявления в формате 00:00:00.
frequency Частота оказания услуги по часам.

В качестве значения используется число от 1 до 24.

Например, если значение элемента 2, то объявление будет подниматься один раз в два часа.

Если переданы элементы time и frequency, учитывается только frequency.

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

Пример корректного прайс-листа для коммерческого транспорта
<?xml version="1.0" encoding="utf-8"?>
<data>
	<cars>
		<car>
			<mark_id>Shuchi</mark_id>
			<group_id>Пригородный</group_id>
			<model_id>2</model_id>
			<modification_id>3</modification_id>
			<exchange>Не интересует</exchange>
			<currency>RUR</currency>
			<run>1</run>
			<state>Не требует ремонта</state>
			<year>1998</year>
			<custom>Растаможен</custom>
			<extras>Туалет</extras>
			<availability>В наличии</availability>
			<engine_volume>3000</engine_volume>
			<wheel>Левый</wheel>
			<color>Красный</color>
			<price>2000000</price>
			<bus_type>Школьный</bus_type>
			<haggle>Не возможен</haggle>
			<unique_id>10163894-6bd3ab42</unique_id>
		</car>
              <car>
			<mark_id>DAF</mark_id>
			<group_id>XF 95</group_id>
			<vin>X0202222SD1011111</vin>
			<exchange>Не интересует</exchange>
			<run>450</run>
			<currency>RUR</currency>
			<year>1993</year>
			<state>Требует ремонта</state>
			<loading>56000</loading>
			<custom>Не растаможен</custom>
			<engine_power>430</engine_power>
			<availability>В наличии</availability>
			<haggle>Не возможен</haggle>
			<engine_volume>5600</engine_volume>
			<wheel>Левый</wheel>
			<engine_type>Дизель</engine_type>
			<color>Синий</color>
			<price>8500000</price>
			<suspension_cabin>Пневматическая</suspension_cabin>
			<body_type>Самосвал</body_type>
			<cabin_key>2-х местная с 1 спальным</cabin_key>
			<suspension_chassis>Рессора-пневмо</suspension_chassis>
			<wheel_drive>6x2</wheel_drive>
			<images>
                     <image>http://price.site.ru/files/image2.jpg</image>
                     </images>
		</car>
              <car>
			<mark_id>BMC</mark_id>
			<group_id>Levend</group_id>
			<run>10</run>
			<year>1999</year>
			<state>Не требует ремонта</state>
			<availability>В наличии</availability>
			<currency>RUR</currency>
			<exchange>Не интересует</exchange>
			<price>1000000</price>
			<color>Белый</color>
			<custom>Растаможен</custom>
			<wheel>Левый</wheel>
			<extras>Антиблокировочная система (ABS)</extras>
			<body_type>Бортовой грузовик</body_type>
			<haggle>Не возможен</haggle>
			<loading>90000</loading>
			<engine_type>Бензиновый</engine_type>
			<drive>Постоянный привод на все колеса</drive>
			<engine_volume>9000</engine_volume>
			<engine_power>900</engine_power>
			<seats>90</seats>
			<unique_id>06971fdf</unique_id>
		</car>
</cars>
</data>