Требования к прайс-листу для спецтехники и коммерческого транспорта
Требования к передаче данных
Для размещения объявлений на Авто.ру необходимо составить прайс-лист в формате XML (Extensible Markup Language).
Формат XML не позволяет использовать первые 32 ASCII-символа в текстовых полях. Исключения — табуляция, перевод строки, возврат каретки. Также стандарт строго требует кодировать в тексте следующие символы:
Символ, который нужно заменить |
Код для файла XML |
" |
" |
& |
& |
> |
> |
< |
< |
' |
' |
Кодировка: UTF-8.
Прайс-лист в формате XML должен начинаться с нулевого символа первой строки со стандартного заголовка.
<?xml version="1.0" encoding="utf-8"?>
В названиях элементов нельзя использовать заглавные буквы. Например, элемент Image
не будет обработан, image
— будет.
Требования к объявлениям
Перед составлением прайс-листа ознакомьтесь с Правилами составления объявлений.
Корневой элемент data
должен содержать родительский элемент cars
. В cars
вложены элементы car
, каждый из которых содержит информацию из одного объявления.
Внимание
Элементы со строго ограниченным набором значений могут содержать только перечисленные варианты. Использование других значений приведет к ошибке при обработке прайс-листа.
Размер файла каталога более 5 МБ. Рекомендуем открывать его в текстовых редакторах, например Notepad++ для Windows и Sublime Text для Mac OS.
Внимание
Каталог Авто.ру регулярно обновляется. Рекомендуем следить за изменениям и вовремя редактировать свои прайс-листы. Объявления с устаревшими данными перестают отображаться на сайте.
Элемент |
Описание |
|
Элемент объявления. |
|
Марка. Значение из каталога. |
|
Группа. Значение из каталога. |
|
Цвет. Строго ограниченные значения
|
|
Наличие. Строго ограниченные значения:
|
|
Таможенный статус. Обязательный элемент для транспорта с пробегом. Строго ограниченные значения:
|
|
Состояние. Обязательный элемент для транспорта с пробегом. Строго ограниченные значения:
|
|
Торг. Обязательный элемент для транспорта с пробегом. Строго ограниченные значения:
|
|
Обмен. Обязательный элемент для транспорта с пробегом. Возможные значения:
|
|
Пробег в км. Обязательный элемент для транспорта с пробегом. В качестве значения используется целое число больше 0. |
|
Год выпуска. В качестве значения используется целое число больше
|
|
Цена. Используйте только целые числа больше Чтобы передать скидки, используйте элементы:
Цена со скидкой равна разнице |
|
Скидка при покупке в кредит. |
|
Скидка при покупке со страховкой. |
|
Скидка про покупке по программе Trade-In. |
|
Максимальная суммарная скидка на автомобиль, возможная при выполнении условий всех действующих в этот момент акций. |
|
Валюта. Строго ограниченные значения:
|
|
В объявлении появится информация о том, что цена указана с НДС. Значения:
Удаление тега из фида не отключит блок. Нужно обязательно передавать значение |
|
VIN-номер. Значение из 17 символов. В VIN-номере могут быть только символы латинского алфавита и арабские цифры:
Если VIN-номера нет (такое бывает у праворульных и произведенных до 1995 года автомобилей), укажите в поле для VIN-номер кузова или оставьте его пустым. |
|
Дополнительная информация. Описание в свободной форме до 30 000 символов. |
|
Фотографии. Можно передавать несколько элементов.
Максимальное количество — 40 фотографий. Формат — JPG. Размер одного файла — не более 20 Мб. Соотношение сторон фотографии — 4:3 (фото с другими пропорциями будет автоматически обрезано). Чтобы изменить изображение в объявлении, вставьте новую ссылку. Обновленное фото по прежней ссылке не будет загружено. Внимание Не меняйте ссылки на фотографии, если вам не требуется заменить сами фото. Обработка фотографий замедляет загрузку прайс-листа и объявления будут отображаться без них. |
|
Дополнительные услуги по продвижению объявления: Премиум, Спецпредложение и Турбо-продажа Элемент указывается, если к объявлению должны быть применены дополнительные услуги. Возможные значения:
|
|
Уникальный идентификатор объявления. Элемент используется, если не указан VIN-номер. Произвольный набор цифр, букв, знаков |
|
Расположение руля. Строго ограниченные значения:
|
|
Тип автобуса. Элемент используется только для автобусов. Строго ограниченные значения
|
|
Колесная формула. Возможные значения
|
|
Количество мест. В качестве значения используется произвольное положительное целое число. |
|
Мощность двигателя в лошадиных силах. |
|
Объем двигателя в кубических см. |
|
Тип двигателя. Обязательный элемент для легкого коммерческого транспорта. Возможные значения:
|
|
Коробка переключения передач. Возможные значения:
|
|
Опции. Можно передавать несколько значений элемента. В качестве разделителя между значениями используется Возможные значения для автобусов
Возможные значения для грузовиков
Возможные значения для легкого коммерческого транспорта
Возможные значения для прицепов
Возможные значения для седельных тягачей
|
|
Подвеска кабины. Возможные значения:
|
|
Класс выхлопа EURO. Возможные значения:
|
|
Количество топливных баков. Возможные значения:
|
|
Общий объем топливных баков. |
|
Материал топливных баков. Возможные значения:
|
|
Тип кузова. Обязательный элемент для грузовиков, седельных тягачей и легкого коммерческого транспорта. Значения для грузовиков
Значения для легкого коммерческого транспорта
Значение для седельных тягачей
|
|
Тип кабины. Возможные значения
|
|
Грузоподъемность в кг. |
|
Подвеска шасси. Возможные значения:
|
|
Привод. Обязательный элемент для легкого коммерческого транспорта. Строго ограниченные значения:
|
|
Количество осей прицепа. |
|
Тип прицепа. Обязательный элемент для прицепов. Строго ограниченные значения
|
|
Тип тормозов. Возможные значения:
|
|
Нагрузка на сцепное устройство в кг. |
|
Высокое седельное устройство. Возможные значения:
|
|
Статус продажи. Элемент позволяет снять объявление с продажи или опубликовать повторно. Возможные значения:
Если удалить элемент со значением Если удалить объявление из прайс-листа, то при повторном добавлении его нужно оплатить, как размещенное впервые. |
|
Адрес места осмотра. Если не указан, в объявлении отображается адрес автосалона. Примечание Чтобы указывать место осмотра отличное от адреса салона, свяжитесь со службой поддержки. |
|
Набор элементов о контактах.
|
|
Данные контактного лица. |
|
Имя контактного лица. |
|
Номер телефона контактного лица. Пример: |
|
Время работы в виде интервала: |
|
Набор элементов, характеризующих автоприменение услуги «Поднятие в поиске». Услуга платная. Актуальная цена указана в разделе Стоимость размещения.
|
|
Услуга «Поднятие в поиске». Во вложенных элементах следует передавать условия оказания услуги. |
|
Подключение или отключение услуги. Возможные значения:
После подключения услуга предоставляется регулярно на выбранных условиях. Чтобы отключить услугу, следует изменить значение элемента на |
|
Дни недели, когда применяется услуга. Следует передавать порядковый номер дня недели от 1 до 7. Например, если значение элемента |
|
Время поднятия объявления в формате |
|
Частота оказания услуги по часам. В качестве значения используется число от 1 до 24. Например, если значение элемента Если переданы элементы |
|
Вылет стрелы в метрах. Для автокранов. |
|
Высота подъема в метрах. Для автокранов, автопогрузчиков. |
|
Тип автопогрузчика, обязателен для категории Автопогрузчики. Строго ограниченные значения
|
|
Моточасы |
|
Тип сельскохозяйственной техники, обязателен для этой категории. Строго ограниченные значения
|
|
Тип строительной техники, обязателен для этой категории. Строго ограниченные значения
|
|
Тип бульдозера, обязателен для этой категории. Строго ограниченные значения:
|
|
Тяговый класс бульдозера. Строго ограниченные значения
|
|
Тип коммунальной техники, обязателен для этой категории. Строго ограниченные значения
|
|
Тип экскаватора, обязателен для этой категории. Строго ограниченные значения
|
|
Объем ковша экскаватора в м³. |
|
Ссылка на панорамное изображение автомобиля на spincar.com.
|
|
Услуга Стикеры. Элемент указывается, если к объявлению должна быть применена услуга «Стикеры». Услуга платная. Актуальная цена указана в разделе Стоимость размещения. К одному объявлению можно добавить не более трех стикеров. Название стикера следует передавать во вложенном теге В названии стикера можно использовать максимум 25 символов.
|
|
Адрес доставки. Можно передать до 10 адресов.
Чтобы удалить адреса, передайте пустой Если передать фид без |
Примеры прайс-листов
Внимание
Для каждого типа спецтехники или коммерческого транспорта необходимо создавать отдельный фид.
Автобусы
<?xml version="1.0" encoding="utf-8"?>
<data>
<cars>
<car>
<mark_id>Shuchi</mark_id>
<group_id>Пригородный</group_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>
</cars>
Грузовики
<?xml version="1.0" encoding="utf-8"?>
<data>
<cars>
<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>
Седельные тягачи
<?xml version="1.0" encoding="utf-8"?>
<data>
<cars>
<car>
<mark_id>Sitrak</mark_id>
<group_id>C7H</group_id>
<availability>В наличии</availability>
<custom>Растаможен</custom>
<state>Хорошее</state>
<engine_volume>12419</engine_volume>
<engine_type>Дизель</engine_type>
<engine_power>480</engine_power>
<drive>Задний</drive>
<haggle>не возможен</haggle>
<seats>4</seats>
<wheel_drive>6x4</wheel_drive>
<cabin_type>двухрядная</cabin_type>
<suspension_chassis>пневмо-пневмо</suspension_chassis>
<suspension_cabin>пневматическая</suspension_cabin>
<eco_class>2</eco_class>
<loading>30000</loading>
<body_type>Седельный</body_type>
<gearbox>автоматическая</gearbox>
<wheel>Левый</wheel>
<color>Белый</color>
<description>супер аппарат</description>
<run>12345</run>
<year>2022</year>
<price>9999999</price>
<currency>RUR</currency>
<vin>XXX00000000000000</vin>
<extras/>
<images>
<image>http://price.site.ru/files/image4.jpg</image>
</images>
</car>
</cars>
Сельскохозяйственная
<?xml version="1.0" encoding="utf-8"?>
<data>
<cars>
<car>
<unique_id>1234567890</unique_id>
<mark_id>МТЗ</mark_id>
<group_id>МТЗ-82</group_id>
<year>1996</year>
<operating_hours>5000</operating_hours>
<agricultural_type>Колесный трактор</agricultural_type>
<engine_volume>5000</engine_volume>
<engine_power>80</engine_power>
<color>синий</color>
<price>350000</price>
<currency>RUR</currency>
<pts>оригинал</pts>
<owners_number>три и более</owners_number>
<haggle>возможен</haggle>
<custom>растаможен</custom>
<availability>в наличии</availability>
<state>отличное</state>
<description>супер аппарат</description>
</car>
</cars>
Строительная
<?xml version="1.0" encoding="utf-8"?>
<data>
<cars>
<car>
<unique_id>234567890</unique_id>
<mark_id>Bomag</mark_id>
<group_id>BW 24</group_id>
<year>1990</year>
<operating_hours>2222</operating_hours>
<construction_type>Каток</construction_type>
<color>желтый</color>
<price>750000</price>
<currency>RUR</currency>
<pts>оригинал</pts>
<owners_number>три и более</owners_number>
<haggle>возможен</haggle>
<custom>растаможен</custom>
<availability>в наличии</availability>
<state>отличное</state>
<description>супер аппарат</description>
<images>
<image>https://avatars.mds.yandex.net/get-autoru-all/50315/faafa52fd302df93e952b69ceb3b2076/1200x900</image>
</images>
</car>
</cars>
Aвтопогрузчики
<?xml version="1.0" encoding="utf-8"?>
<data>
<cars>
<car>
<unique_id>23456789</unique_id>
<mark_id>Lonking</mark_id>
<group_id>CDM</group_id>
<year>2018</year>
<operating_hours>2222</operating_hours>
<autoloader_type>Мини-погрузчики</autoloader_type>
<color>белый</color>
<price>1750000</price>
<currency>RUR</currency>
<pts>оригинал</pts>
<owners_number>три и более</owners_number>
<haggle>возможен</haggle>
<custom>растаможен</custom>
<availability>в наличии</availability>
<state>отличное</state>
<description>супер аппарат</description>
<images>
<image>https://avatars.mds.yandex.net/get-autoru-all/989636/1e164d7bcd5cfdb99bd0ba235afaa13b/1200x900</image>
</images>
</car>
</cars>
Aвтокраны
<?xml version="1.0" encoding="utf-8"?>
<data>
<cars>
<car>
<unique_id>23456890</unique_id>
<mark_id>Zoomlion</mark_id>
<group_id>QY30V</group_id>
<year>2013</year>
<run>12118</run>
<operating_hours>301</operating_hours>
<engine_type>дизель</engine_type>
<engine_volume>9700</engine_volume>
<engine_power>270</engine_power>
<load_height>50</load_height>
<loading>12000</loading>
<crane_radius>37</crane_radius>
<color>белый</color>
<price>10500000</price>
<currency>RUR</currency>
<pts>оригинал</pts>
<owners_number>два</owners_number>
<haggle>возможен</haggle>
<custom>растаможен</custom>
<availability>в наличии</availability>
<state>отличное</state>
<description>супер аппарат</description>
<images>
<image>https://avatars.mds.yandex.net/get-autoru-all/119174/098c19f72acc175a79fc5aff2d051a98/1200x900</image>
</images>
</car>
</cars>
Экскаваторы
<?xml version="1.0" encoding="utf-8"?>
<data>
<cars>
<car>
<unique_id>2345678</unique_id>
<mark_id>JCB</mark_id>
<group_id>3CX</group_id>
<year>2012</year>
<operating_hours>2300</operating_hours>
<dredge_type>Экскаватор-погрузчик</dredge_type>
<bucket_volume>1</bucket_volume>
<engine_type>дизель</engine_type>
<engine_volume>4000</engine_volume>
<engine_power>93</engine_power>
<color>желтый</color>
<price>3900000</price>
<currency>RUR</currency>
<haggle>возможен</haggle>
<custom>растаможен</custom>
<availability>в наличии</availability>
<state>отличное</state>
<description>супер аппарат</description>
<images>complectation_id
<image>https://avatars.mds.yandex.net/get-autoru-all/1346017/df7f39754cf2ca1c465a3bed3ae2d6c3/1200x900</image>
</images>
</car>
</cars>
Бульдозеры
<?xml version="1.0" encoding="utf-8"?>
<data>
<cars>
<car>
<unique_id>23456</unique_id>
<mark_id>Shehwa</mark_id>
<group_id>TY 165-2</group_id>
<year>2014</year>
<operating_hours>3500</operating_hours>
<bulldozer_type>Гусеничный</bulldozer_type>
<traction_class>10</traction_class>
<engine_type>дизель</engine_type>
<engine_volume>9700</engine_volume>
<engine_power>180</engine_power>
<color>желтый</color>
<price>3900000</price>
<currency>RUR</currency>
<haggle>возможен</haggle>
<custom>растаможен</custom>
<availability>в наличии</availability>
<state>отличное</state>
<description>супер аппарат</description>
<images>
<image>https://avatars.mds.yandex.net/get-autoru-all/1346017/df7f39754cf2ca1c465a3bed3ae2d6c3/1200x900</image>
</images>
</car>
</cars>
Коммунальная
<?xml version="1.0" encoding="utf-8"?>
<data>
<cars>
<car>
<unique_id>2890</unique_id>
<mark_id>Урал</mark_id>
<group_id>4320</group_id>
<municipal_type>Вакуумная</municipal_type>
<year>2018</year>
<color>голубой</color>
<price>3695000</price>
<currency>RUR</currency>
<run>4630</run>
<engine_volume>9700</engine_volume>
<engine_power>230</engine_power>
<pts>оригинал</pts>
<owners_number>три и более</owners_number>
<haggle>возможен</haggle>
<custom>растаможен</custom>
<availability>в наличии</availability>
<state>отличное</state>
<description>супер аппарат</description>
<images>
<image>https://avatars.mds.yandex.net/get-autoru-all/911135/d8129a227d2e6cc2d8023639c892a99f/1200x900</image>
</images>
</car>
</cars>
Обязательный элемент