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

Символ, который нужно заменить

Код для файла XML

"

"

&

&

>

>

<

&lt;

'

&apos;

Элемент

Описание

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.

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

doors_count*

Количество дверей.

currency*

Валюта.

Строго ограниченные значения:

• RUR;
• EUR;
• USD.

vin*

VIN-номер.

Значение из 17 символов. В VIN-номере могут быть только символы латинского алфавита и арабские цифры:

• A B C D E F G H J K L M N P R S T U V W X Y Z
  Среди разрешенных символов нет букв I, O, Q, потому что они похожи на единицу и ноль.
• 0 1 2 3 4 5 6 7 8 9

Если VIN-номера нет (такое бывает у праворульных и произведенных до 1995 года автомобилей), укажите в поле для VIN-номер кузова или оставьте его пустым.

price*

Цена.

Используйте только целые числа больше 1 500.

Чтобы передать скидки, используйте элементы:

• credit_discount,
• insurance_discount,
• tradein_discount,
• max_discount.

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

credit_discount

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

insurance_discount

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

tradein_discount

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

max_discount

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

description

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

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

extras

Опции.

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

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

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

images

Фотографии.

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

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

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

Формат — JPG.

Размер одного файла — не более 20 Мб.

Соотношение сторон фотографии — 4:3 (фото с другими пропорциями будет автоматически обрезано).

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

video

Видео.

Ссылка на видео с YouTube, Rutube или VK Видео.

Примеры ссылок для YouTube:

• https://www.youtube.com/watch?v=JCGHJxBJpI4
• https://youtube.com/watch/6I4522h8lus
• http://youtu.be/QHKam8sJdvs

Примеры ссылок для Rutube:

• https://rutube.ru/video/1f09d3329956568cc15bb63074034105
• https://rutube.ru/shorts/4baf276716c551a75b911631fd41bb3f
• https://rutube.ru/play/embed/a2d4416fa8c5263103de190674fafdfc

Примеры ссылок для VK Видео:

• https://vk.com/video-29892778_456243908
• https://vk.com/video?z=video-29892778_456243878
• https://vk.com/feed?z=video-29892778_456243307

poi_id

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

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

sale_services

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

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

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

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

• premium;
• special;
• package_turbo

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/>
    <sip_url/>
    <time/>
  </contact>
</contact_info>

sip_url (SIP-адрес) необходим для передачи на АТС дилера номера телефона пользователя, соединение с которым устанавливает Авто.ру по заявке на обратный звонок.

contact

Данные контактного лица.

name

Имя контактного лица.

phone

Номер телефона контактного лица.

Пример: 80123456789.

time

Время работы в виде интервала: 00:00-23:59.

warranty_expire

Срок истечения гарантии.

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

Можно применить только в разделе «С пробегом».

Пример: 03.2017.

warranty_type

Тип гарантии.

Значения:

• Гарантия производителя.
• Гарантия дилера.
• Уточняйте условия гарантии (для случаев, когда гарантия отсутствует или отличается от привычных условий).

Пример:

<warranty_type>Гарантия дилера</warranty_type>

sts

Серия и номер СТС.

Можно указать только в разделе «В пробегом».

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

armored

Признак бронированного автомобиля.

Варианты значения:

• да;
• нет.

unique_id

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

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

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

action

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

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

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

• hide— деактивировать объявление;
• show — возобновить показ.

exchange

Обмен.

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

• Нет;
• Рассмотрю варианты.

panoramas_autoru

Панорама экстерьера автомобиля.

• Используйте видео 360°, снятое с помощью специального стенда или в приложении Авто.ру.

• По ссылке видео должно скачиваться.

• Можно использовать короткие ссылки на Я.Диск.

• Ссылку нужно указать в теге <url> внутри panoramas_autoru.

  <panoramas_autoru>
       <url>ссылка на видео-файл</url>
  </panoramas_autoru>
  

panoramas

Панорама салона автомобиля.

• Используйте фотографию 360°, её можно снять на специальную экшн-камеру.
• По ссылке снимок должен скачиваться.
• Можно использовать короткие ссылки на Я.Диск.
• Ссылку нужно указать в теге <url> внутри <interior_urls>.
• К объявлению можно добавить только одну панораму салона.

<panoramas>
  <interior_urls>
    <url>https://yadi.sk/i/dsLjgIveI8HTSA</url>
  </interior_urls>
</panoramas>

tech_param_id

Код модификации из каталога Авто.ру.

engine_volume

Объем двигателя в см³.

Нельзя передавать одновременно с modification_id.

engine_power

Мощность двигателя с указанием единиц измерения л.с. либо кВт.

Нельзя передавать одновременно с modification_id.

engine_type

Тип двигателя:

• Бензин;
• Дизель;
• Гибрид;
• Электро;
• ГБО;
• Водородный.

Нельзя передавать одновременно с modification_id.

gearbox

Коробка передач:

• Автоматическая;
• Механическая;
• Автомат вариатор;
• Автомат робот.

Нельзя передавать одновременно с modification_id.

drive

Привод:

• Задний;
• Передний;
• Полный.

Нельзя передавать одновременно с modification_id.

nameplate

Значение из каталога Авто.ру.

delivery_info

Адрес доставки.

Можно передать до 10 адресов.

<delivery_info>
  <delivery>
    <address>Москва, Льва Толстого 16</address>
  </delivery>
  <delivery>
    <address>Санкт-Петербург, Невский проспект 1</address>
  </delivery>
</delivery_info>

Чтобы удалить адреса, передайте пустой элемент delivery_info.

Если передать фид без delivery_info, прошлые адреса останутся в объявлении.

accepted_autoru_exclusive

Укажите элемент, если вы не размещаете объявления о продаже этого авто на других сайтах. В публикации может появиться значок «Только на «Авто.ру».

Значения:

• true — включен,
• false — выключен.

<accepted_autoru_exclusive>true</accepted_autoru_exclusive>

autoru_expert

Укажите элемент, если вы хотите разместить объявление бесплатно в разделе «Авто.ру Эксперт».

Только для легковых авто с пробегом.

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

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

• true — разместить в разделе «Авто.ру Эксперт»;
• false — не размещать в разделе «Авто.ру Эксперт».

<autoru_expert>true</autoru_expert>

online_view_available

В объявлении появится значок «Онлайн-показы по видеосвязи».

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

• true — включить значок;
• false — отключить значок.

<online_view_available>true</online_view_available>

Если в фиде нет тега, а на форме подачи вручную проставлена галочка «Готов показать онлайн», значок останется активен.

with_nds

В объявлении появится информация о том, что цена указана с НДС.

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

• true — включить;
• false — отключить.

<with_nds>true</with_nds>

Удаление тега из фида не отключит блок. Нужно обязательно передавать значение false.

pledge_number

Номер залога автомобиля.

Номер можно найти на сайте ФНП.

Пример:

<pledge_number>2019-334-231232-123</pledge_number>

not_registered_in_russia

Автомобиль не стоит на учёте в РФ.

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

• true — автомобиль не стоит на учете.
• false — стоит на учете.
  Можно не указывать.