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

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

Для размещения объявлений на Авто.ру необходимо составить прайс-лист в формате 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, каждый из которых содержит информацию из одного объявления.

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

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

Внимание. Каталог Авто.ру регулярно обновляется. Рекомендуем следить за изменениям и вовремя редактировать свои прайс-листы. Объявления с устаревшими данными перестают отображаться на сайте.

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

Марка автомобиля.

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

folder_id

Модель автомобиля.

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

modification_id

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

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

complectation_nameНазвание комплектации.

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

Чтобы увидеть название комплектации, выберите марку, модель, поколение автомобиля и перейдите на вкладку Комплектации.

Примечание. Обязательно для новых автомобилей.
body_type

Тип кузова.

Строго ограниченные значения
  • Кабриолет;
  • Компактвэн;
  • Купе;
  • Купе-хардтоп;
  • Фастбек;
  • Фургон;
  • Хэтчбек;
  • Ландо;
  • Лифтбек;
  • Лимузин;
  • Микровэн;
  • Минивэн;
  • Внедорожник;
  • Фаэтон-универсал;
  • Пикап;
  • Родстер;
  • Седан;
  • Тарга;
  • Седан-хардтоп;
  • Спидстер;
  • Внедорожник открытый;
  • Универсал;
  • Фаэтон;
  • Универсал.
wheel

Расположение руля.

Строго ограниченные значения:
  • левый;
  • правый.
color

Цвет автомобиля.

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

Признак цвета металлик.

Строго ограниченные значения:
  • да;
  • нет.
availability

Наличие автомобиля.

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

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

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

Состояние автомобиля.

Обязательный элемент для б/у автомобилей.

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

Количество владельцев по ПТС.

Обязательный элемент для б/у автомобилей.

Строго ограниченные значения для б/у автомобилей:
  • Один владелец;
  • Два владельца;
  • Три и более.
Строго ограниченные значения для новых автомобилей:
  • Не было владельцев.
Внимание. Значение Не было владельцев применяется только для новых автомобилей.
runПробег в км.

Обязательный элемент для б/у автомобилей.

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

year

Год выпуска.

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

Год первой регистрации по ПТС.

Обязательный элемент для б/у автомобилей.

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

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

Цена.

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

Чтобы в объявлении дополнительно отображалась цена с учетом скидок, следует передавать элементы credit_discount, insurance_discount, tradein_discount, max_discount.

Цена со скидкой равна разнице price и max_discount.

credit_discountСкидка при покупке в кредит.
insurance_discountСкидка при покупке со страховкой.
tradein_discountСкидка про покупке по программе Trade-In.
max_discount

Максимальная суммарная скидка на автомобиль, возможная при выполнении условий всех действующих в этот момент акций. Если поле не заполнено, скидка будет рассчитываться как сумма всех переданных скидок.

discount_priceЦена с учетом всех акций, одновременно действующих на данный момент. Отображается как справочная информация внутри объявления в мобильной версии сайта и приложении.
currency

Валюта.

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

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

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

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

extras

Опции.

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

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

Возможные значения
  • ABS;
  • AUX;
  • Bluetooth;
  • ESP;
  • Isofix / LATCH;
  • USB;
  • 1 подушка безопасности;
  • 2 подушки безопасности;
  • 4 подушки безопасности;
  • автоматический корректор фар;
  • адаптивный круиз-контроль;
  • активный усилитель руля;
  • алюминиевые накладки на педали;
  • антипробуксовочная система;
  • аэрография;
  • блокировка замков задних дверей;
  • бортовой компьютер;
  • бронированный;
  • велюровый салон;
  • вентиляция задних сидений;
  • вентиляция передних сидений;
  • газобаллонное оборудование;
  • галогеновые фары;
  • голосовое управление;
  • датчик давления в шинах;
  • датчик дождя;
  • датчик проникновения в салон (датчик объема);
  • датчик света;
  • датчик усталости водителя;
  • декоративные молдинги;
  • дистанционный запуск двигателя;
  • запуск двигателя с кнопки;
  • защита картера;
  • иммобилайзер (не штатный);
  • камера 360°;
  • камера заднего вида;
  • климат-контроль;
  • климат-контроль 1-зонный;
  • климат-контроль 2-зонный;
  • климат-контроль 3-зонный;
  • кожаный салон;
  • количество мест: 2;
  • количество мест: 4;
  • количество мест: 5;
  • количество мест: 6;
  • количество мест: 7;
  • комбинированный салон;
  • кондиционер;
  • круиз-контроль;
  • ксеноновые/биксеноновые фары;
  • лакокрасочное покрытие металлик;
  • ламинированные боковые стекла;
  • легкосплавные диски;
  • легкосплавные диски 12";
  • легкосплавные диски 13";
  • легкосплавные диски 14";
  • легкосплавные диски 15";
  • легкосплавные диски 16";
  • легкосплавные диски 17";
  • легкосплавные диски 18";
  • легкосплавные диски 19";
  • легкосплавные диски 20";
  • легкосплавные диски 21";
  • легкосплавные диски 22";
  • легкосплавные диски 23";
  • легкосплавные диски 24";
  • легкосплавные диски 25";
  • легкосплавные диски 26";
  • легкосплавные диски 27";
  • легкосплавные диски 28";
  • люк;
  • мультимедиа система для задних пассажиров;
  • мультифункциональное рулевое колесо;
  • накладки на пороги;
  • обогрев зеркал;
  • обогрев рулевого колеса;
  • обогрев сидений;
  • обратная связь;
  • омыватель фар;
  • отделка кожей рулевого колеса;
  • отделка кожей рычага КПП;
  • отделка потолка черной тканью;
  • охлаждаемый перчаточный ящик;
  • память передних сидений;
  • панорамная крыша / лобовое стекло;
  • парктроник;
  • передний центральный подлокотник;
  • пневмоподвеска;
  • подогрев задних сидений;
  • подогрев передних сидений;
  • подрулевые лепестки переключения передач;
  • подушка безопасности водителя;
  • подушка безопасности для защиты коленей водителя;
  • подушка безопасности пассажира;
  • подушки безопасности (5);
  • подушки безопасности (6);
  • подушки безопасности (7);
  • подушки безопасности (8 и более);
  • подушки безопасности боковые;
  • подушки безопасности боковые задние;
  • подушки безопасности оконные (шторки);
  • прикуриватель и пепельница;
  • программируемый предпусковой отопитель;
  • противотуманные фары;
  • регулировка руля по вылету;
  • регулировка руля по высоте;
  • регулировка руля по высоте и вылету;
  • регулировка сидений водителя по высоте;
  • регулировка сидений пассажира по высоте;
  • регулируемый педальный узел;
  • рейлинги на крыше;
  • розетка 12V;
  • светлый салон;
  • светодиодные фары;
  • сиденье водителя: ручная регулировка;
  • сиденье водителя: с памятью положения;
  • сиденье водителя: с памятью положения;
  • сиденье водителя: электро регулировка;
  • сиденье пассажира: ручная регулировка;
  • сиденье пассажира: электро регулировка;
  • система “старт-стоп”;
  • система автоматической парковки;
  • система адаптивного головного освещения в повороте;
  • система адаптивного освещения;
  • система доступа без ключа;
  • система контроля за полосой движения;
  • система контроля слепых зон;
  • система ночного видения;
  • система помощи при парковке (задняя);
  • система помощи при парковке (передняя);
  • система помощи при старте в гору;
  • система предотвращения столкновения;
  • система распознавания дорожных знаков;
  • система управления дальним светом;
  • складной столик на спинках передних сидений;
  • складывающееся заднее сидение (опция);
  • солнцезащитная шторка на заднем стекле;
  • солнцезащитные шторки в задних дверях;
  • спортивные передние сидения;
  • стальные диски;
  • темный салон;
  • тканевый салон;
  • тонированные стекла;
  • третий задний подголовник;
  • третий ряд сидений;
  • усилитель руля;
  • фаркоп;
  • функция складывания спинки сиденья пассажира;
  • центральный замок;
  • штатная аудиоподготовка;
  • штатная аудиосистема (без CD);
  • штатная аудиосистема с CD;
  • штатная аудиосистема с TV;
  • штатная аудиосистема Hi-Fi;
  • штатная навигационная система;
  • штатная сигнализация;
  • штатный иммобилайзер;
  • электрообогрев зоны стеклоочистителей;
  • электрообогрев лобового стекла;
  • электрообогрев форсунок стеклоомывателей;
  • электроподъемники задние;
  • электроподъемники передние;
  • электропривод зеркал;
  • электропривод крышки багажника;
  • электрорегулировка задних сидений;
  • электрорегулировка руля;
  • электрорегулировка сидений;
  • электроскладывание зеркал;
  • электростеклоподъемники все.
images

Фотографии.

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

<images>
  <image></image>
  <image></image>
</images>

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

Примечание. Чтобы обновить изображение в объявлении, замените его ссылку. Обновленное фото по прежней ссылке не будет доступно.
video

Видео.

Ссылка на ролик на Youtube или прямая ссылка на видеофайл (только для б/у автомобилей).

poi_id

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

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

Примечание. Чтобы указывать место осмотра отличное от адреса салона, свяжитесь со службой поддержки.
sale_services

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

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

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

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

  • premium;
  • special.
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.

badgesУслуга Стикеры.

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

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

К одному объявлению можно добавить не более трех стикеров.

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

В названии стикера можно использовать максимум 25 символов.

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

Пример: 80123456789.

timeВремя работы в виде интервала: 00:00-23:59.
warranty_expireСрок истечения гарантии.

Следует передавать месяц и год.

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

Пример: 03.2017.

ptsТип ПТС.

Обязательный элемент для б/у автомобилей.

Не используется для новых автомобилей.

Возможные значения:
  • оригинал;
  • дубликат.
stsСерия и номер СТС.

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

Пример: 77 УЕ 204623.

armoredПризнак бронированного автомобиля.
Варианты значения:
  • да;
  • нет.
unique_idУникальный идентификатор объявления.

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

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

actionСтатус продажи.

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

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

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

Если удалить элемент со значением hide, показ объявления не возобновится.

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

exchangeОбмен.
Возможные значения:
  • Нет;
  • Рассмотрю варианты.
brand_certificationПрограмма сертификации от производителя.

Элемент могут использовать только официальные дилеры.

Элемент следует передавать, если автомобиль прошел сертификацию по программе «BMW Premium Selection» или «Das WeltAuto».

Возможные значения:
  • BMWSelected;
  • DasWelt.
panoramasСсылка на панорамное изображение автомобиля на spincar.com
<panoramas>
    <spin_car_url>https://spins.spincar.com/autopragayug/01068471</spin_car_url>
</panoramas>
tech_param_idКод модификации из каталога Авто.ру.
engine_volumeОбъем двигателя в см³.
gearboxКоробка передач:
  • Автоматическая;
  • Механическая;
  • Автомат вариатор;
  • Автомат робот.
engine_powerМощность двигателя с указанием единиц измерения л.с. либо кВт.
drive
  • Задний;
  • Передний;
  • Полный.
nameplateЗначение из каталога Авто.ру.
doors_countКоличество дверей.

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

Пример корректного прайс-листа для новых автомобилей
<?xml version="1.0"?>
<data>
    <cars>
         <car>
	  <mark_id>Nissan</mark_id>
	  <folder_id>Juke, I Рестайлинг</folder_id>
	  <modification_id>1.6 CVT (117 л.с.)</modification_id>
	  <body_type>Внедорожник 5 дв.</body_type>
	  <complectation_name>LE</complectation_name>
         <wheel>Левый</wheel>
	  <color>белый</color>
	  <metallic>Нет</metallic>
	  <availability>в наличии</availability>
	  <custom>растаможен</custom>
         <owners_number>Не было владельцев</owners_number>
	  <year>2017</year>
	  <price>1216990</price>
	  <credit_discount>10000</credit_discount>
	  <insurance_discount>15000</insurance_discount>
	  <max_discount>50000</max_discount><price>1216990</price>
	  <currency>RUR</currency>
	  <registry_year>2017</registry_year>
	  <vin>SJNSSAF15U7368814</vin>
	  <description>Специальные предложения на модельный ряд Nissan! Звоните нам или оставьте заявку на нашем сайте, и мы свяжемся с вами в ближайшее время!"
         </description>
	  <extras>Антиблокировочная система (ABS), Бортовой компьютер, Климат (климат-контроль 1-зонный), Круиз-контроль</extras>
	  <images>
	        <image>http://price.site.ru/files/image1.jpg</image>
               <image>http://price.site.ru/files/image2.jpg</image>
         </images> 
	  <poi_id>г. Воронеж, Дорожная 125</poi_id>  
	  </car>
	  <car>
	  <mark_id>Nissan</mark_id>
	  <folder_id>Qashqai, II</folder_id>
	  <modification_id>2.0 CVT (144 л.с.)</modification_id>
	  <body_type>Внедорожник 5 дв.</body_type>
	  <complectation_name>LE</complectation_name> 
	  <wheel>Левый</wheel>
	  <color>серый</color>
	  <metallic>Нет</metallic>
	  <availability>в наличии</availability>
	  <custom>растаможен</custom>
	  <owners_number>Не было владельцев</owners_number>
	  <year>2017</year>
	  <price>1378000</price>
	  <discount_price>	  	
	  	  <price>1330000</price>
	  </discount_price>	  
	  <credit_discount>40000</credit_discount>
	  <insurance_discount>20000</insurance_discount>
	  <tradein_discount>60000</tradein_discount>
	  <max_discount>100000</max_discount>
	  <currency>RUR</currency>
	  <registry_year>2017</registry_year>
	  <vin>Z8NFBAJ22ES028746</vin>
	  <description>Специальные предложения на модельный ряд Nissan! Звоните нам или оставьте заявку на нашем сайте, и мы свяжемся с вами в ближайшее время!
         </description>
	  <extras>Климат (кондиционер), Круиз-контроль, Мультимедиа (CD), Обогрев сидений</extras>
	  <images>
		   <image>http://price.site.ru/files/image5.jpg</image>
		   <image>http://price.site.ru/files/image6.jpg</image>
         </images> 
	  <poi_id>г. Воронеж, Дорожная 125</poi_id>       
	    </car>
    </cars>
</data>
Пример корректного прайс-листа для б/у автомобилей
<?xml version="1.0"?>
<data>
    <cars>
        <car>
            <mark_id>Ford</mark_id>
            <folder_id>Fusion</folder_id>
            <modification_id>1.4d AT (68 л.с.)</modification_id>
            <body_type>Хэтчбек 5 дв.</body_type>
            <wheel>левый</wheel>
            <color>оранжевый</color>
            <metallic>да</metallic>
            <availability>в наличии</availability>
            <custom>растаможен</custom>
            <state>не требует ремонта</state>
            <owners_number>один владелец</owners_number>
            <run>60000</run>
            <year>2007</year>
            <price>550000</price>
            <currency>RUR</currency>
            <registry_year>2007</registry_year>
            <vin>XWBCA41ZXDK259107</vin>
            <description>Машина в идеальном состоянии, растоможена,ездил на своих,американских номерах. Сделано полное ТО. Ни одной проблемы и проблемки. Разумный торг при осмотре.</description>
            <extras>Антиблокировочная система (ABS), Тонированные стекла, Люк на крыше, Круиз-контроль, Ксеноновые фары</extras>
            <unique_id>da985dc132df21e765b7027f76133fdd</unique_id>
            <images>
                    <image>http://price.site.ru/files/image1.jpg</image>
                    <image>http://price.site.ru/files/image2.jpg</image>
            </images>
            <sale_services>special</sale_services>
            <poi_id>Москва, Тверская, 4</poi_id>
            <contact_info>
                <contact>
                    <name>Иван</name>
                    <phone>80123456789</phone>
                    <time>08:00-18:00</time>
                </contact>
            </contact_info>
            <sts>77 УЕ 204624</sts>
            <armored>Нет</armored>
        </car>
        <car>
            <mark_id>Ford</mark_id>
            <folder_id>Fusion</folder_id>
            <modification_id>1.4d AT (68 л.с.)</modification_id>
            <body_type>Хэтчбек 5 дв.</body_type>
            <wheel>левый</wheel>
            <color>красный</color>
            <metallic>нет</metallic>
            <availability>на заказ</availability>
            <custom>растаможен</custom>
            <state>не требует ремонта</state>
            <owners_number>два владельца</owners_number>
            <run>95000</run>
            <year>2005</year>
            <price>305000</price>
            <currency>RUR</currency>
            <registry_year>2006</registry_year>
            <vin>XWBCA41ZXDK259208</vin>
            <description>Машина в идеальном состоянии, растоможена,ездил на своих,американских номерах. Сделано полное ТО.Ни одной проблемы и проблемки.</description>
            <extras>Антиблокировочная система (ABS), Тонированные стекла, Люк на крыше, Круиз-контроль, Ксеноновые фары</extras>
            <images>
                    <image>http://price.site.ru/files/image1.jpg</image>
                    <image>http://price.site.ru/files/image2.jpg</image>
            </images>
            <badges>
                    <badge>
                      <name>Парктроник</name>
                    </badge>
                    <badge>
                      <name>Коврики в подарок</name>
                    </badge>
                    <badge>
                      <name>На гарантии</name>
                    </badge>
            </badges>
            <poi_id>Москва, Тверская, 4</poi_id>
            <contact_info>
                <contact>
                    <name>Иван</name>
                    <phone>89031234567</phone>
                    <time>08:00-18:00</time>
                </contact>
            </contact_info>
            <warranty_expire>03.2016</warranty_expire>
            <pts>Оригинал</pts>
            <sts>77 УЕ 204623</sts>
            <armored>Да</armored>
        </car>
    </cars>
</data>
Пример структуры прайс-листа для новых автомобилей
<?xml version="1.0"?>
<data>
    <cars>
        <car>
            <mark_id></mark_id>
            <folder_id></folder_id>
            <modification_id></modification_id>
            <body_type></body_type>
            <wheel></wheel>
            <color></color>
            <metallic></metallic>
            <availability></availability>
            <custom></custom>
            <year></year>
            <price></price>
            <currency></currency>
            <vin></vin>
            <description></description>
            <extras></extras>
            <images></images>
            <unique_id></unique_id>
            <sale_services></sale_services>
            <poi_id></poi_id>
            <contact_info>
                <contact>
                    <name></name>
                    <phone></phone>
                    <time></time>
                </contact>
            </contact_info>
            <warranty_expire></warranty_expire>
            <pts></pts>
            <sts></sts>
            <armored></armored>
            <color-code></color-code>
            <interior-code></interior-code>
            <modification-code></modification-code>
            <equipment-code></equipment-code>
        </car>
    </cars>
</data>
Пример структуры прайс-листа для б/у автомобилей
<?xml version="1.0"?>
<data>
    <cars>
        <car>
            <mark_id></mark_id>
            <folder_id></folder_id>
            <modification_id></modification_id>
            <body_type></body_type>
            <wheel></wheel>
            <color></color>
            <metallic></metallic>
            <availability></availability>
            <custom></custom>
            <state></state>
            <owners_number></owners_number>
            <run></run>
            <year></year>
            <price></price>
            <currency></currency>
            <registry_year></registry_year>
            <vin></vin>
            <description></description>
            <extras></extras>
            <unique_id></unique_id>
            <images></images>
            <sale_services></sale_services>
            <poi_id></poi_id>
            <contact_info>
                <contact>
                    <name></name>
                    <phone></phone>
                    <time></time>
                </contact>
            </contact_info>
            <warranty_expire></warranty_expire>
            <pts></pts>
            <sts></sts>
            <armored></armored>
            <brand_certification></brand_certification>
        </car>
    </cars>
</data>