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

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

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

Тип кузова.

Строго ограниченные значения
  • Кабриолет;
  • Компактвэн;
  • Купе;
  • Купе-хардтоп;
  • Фастбек;
  • Фургон;
  • Хэтчбек 3 дв.;
  • Хэтчбек 4 дв.;
  • Хэтчбек 5 дв.;
  • Ландо;
  • Лифтбек;
  • Лимузин;
  • Микровэн;
  • Минивэн;
  • Внедорожник;
  • Внедорожник 3 дв.;
  • Внедорожник 5 дв.;
  • Фаэтон-универсал;
  • Пикап;
  • Пикап Одинарная кабина;
  • Пикап Двойная кабина;
  • Пикап Полуторная кабина;
  • Родстер;
  • Седан;
  • Седан 2 дв.;
  • Тарга;
  • Седан-хардтоп;
  • Спидстер;
  • Внедорожник открытый;
  • Универсал;
  • Фаэтон;
  • Универсал 3 дв.;
  • Универсал 5 дв.
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.

credit_discount Сумма скидки при покупке в кредит.

Цена при покупке в кредит равна цене автомобиля минус значение из элемента credit_discount.

insurance_discount Сумма скидки при покупке со страховкой.

Цена при покупке со страховкой равна цене автомобиля минус значение из элемента insurance_discount.

tradein_discount Сумма скидки про покупке по программе Trade-In.

Цена при покупке по программе Trade-In равна цене автомобиля минус значение из элемента tradein_discount.

currency

Валюта.

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

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

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

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

extras

Опции.

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

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

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

Фотографии.

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

<images>
  <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 символов.

modification-code Коды модификации и комплектации от производителя.

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

Значение элемента следует передавать без пробелов и тире.

Пример: A2S6D1617D216.

color-code Код цвета автомобиля по каталогу производителя.

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

interior-code Код интерьера автомобиля по каталогу производителя.

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

equipment-code Код опций по каталогу производителя, которые не входят в модификацию автомобиля.

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

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

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

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

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

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

exchange Обмен.
Возможные значения:
  • Не интересует;
  • С вашей доплатой;
  • С моей доплатой;
  • Рассмотрю варианты.
discount_price Цена с учетом всех акций:
  • цена при продаже старого автомобиля по системе Trade-In;
  • цена при покупке в кредит;
  • цена по специальной акции импортера (скидка от представительства бренда);
  • скидка за лояльность (повторная покупка у дилера);
  • скидки по программе утилизации.

Следует указать в тексте объявления, при каких условиях действует цена.

brand_certification Программа сертификации от производителя.

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

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

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

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

Пример корректного прайс-листа для новых автомобилей
<?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>
	  <wheel>Левый</wheel>
	  <color>белый</color>
	  <metallic>Нет</metallic>
	  <availability>в наличии</availability>
	  <custom>растаможен</custom>
         <owners_number>Не было владельцев</owners_number>
	  <year>2017</year>
	  <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>
	  <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> 
	  <action>show</action> 
         </discount_price>
	  <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>