Формат XML-файла для размещения объявлений от автосалонов

Описание формата XML-файлов для системы импорта объявлений о продаже автомобилей при помощи myTarget.

Заголовок

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

Общая структура и корневой элемент

<auto-catalog>
    <creation-date>...</creation-date>
    <host>...</host>
    <offers>
        <offer>
        ...
        </offer>
        ...
    </offers>
</auto-catalog>

Описание полей корневых элементов:

Элемент	Описание
creation-date	Необязательное поле. Дата в формате 2016-10-13 06:00:02 GMT+5 или 2016-10-13 12:07:25 MSK
host	Необязательное поле. Хост, например: au96.ru

Структура блока offer

Указание атрибута type оффера необязательно, но желательно:

если объявление представлено от физического лица
если объявление представлено от юридического лица

Элемент	Описание
id*	Уникальный идентификатор для каждого объявления. Вы можете использовать такой же идентификатор объявления, как и в вашей внутренней базе данных. Необходим для корректного определения изменений объявлений в вашем фиде.
mark*	Название марки. Для проверки названия можете воспользоваться справочником марок или посмотреть, как называется марка в нашем каталоге: https://cars.mail.ru/catalog
model*	Название модели. Для проверки названия можете посмотреть, как называется модель в нашем каталоге: https://cars.mail.ru/catalog
modification	Модификация автомобиля. Например: Polo V Sedan
image*	Ссылка на картинку с горизонтально расположенной фотографией автомобиля. Форматы: jpeg, jpg. Ограничение по размеру: 300кб. Эта картинка будет изображением для вашего баннера.
price*	Цена, например: 650000
currency-type*	Тип валюты. Например: RUR
url*	Ссылка на объявление на вашем сайте. Именно туда будет попадать клиент после клика на баннер
year*	Год выпуска автомобиля
run*	Пробег автомобиля, например: 0 или 40000
run-metric*	Единица измерения пробега (км, тыс. км, миль). Например: км
doors-count*	Количество дверей. Например: 5
displacement*	Объем двигателя. Например: 1598
engine-type*	Тип двигателя по топливу. Например: Бензиновый
transmission*	Тип КПП. Например: АТ
body-type*	Тип кузова. Например: седан
seller*	Название продавца. Например: Автосалон на Можайке
seller-phone*	Телефон продавца. Например: 8 495 1234567
seller-city*	Город или название населенного пункта продавца. Например: Санкт-Петербург
gear-type	Тип привода. Например: полный
color	Цвет автомобиля. Например: белый
equipment	Дополнительные опции автомобиля. Например: Антиблокировочная система тормозов, Подушка безопасности водителя. 1 элемент соответствует одной опции. Чтобы указать несколько опций, используйте несколько элементов
date	Дата публикации объявления, например: 2016-10-10 13:37:15 MSK
update-date	Дата изменения объявления, например: 2016-10-12 19:26:02 MSK
state	Состояние автомобиля. Например: Новый
additional-info	Текстовое описание, дополнительная информация
steering-wheel	Расположение руля. Например: Левый
haggle	Торг (возможен/невозможен). Например: Возможен
custom-house-state	Растаможен автомобиль или нет. Например: Растаможен

Звездочками * обозначены обязательные поля.

Пример XML с одним объявлением:

<?xml version="1.0" encoding="UTF-8"?>
<auto-catalog>
    <creation-date>2016-10-25 06:00:02 GMT+5</creation-date>
    <host>mail.ru</host>
    <offers>
        <offer type="private">
            <id>8358</id>
            <url>
                https://cars.mail.ru
            </url>
            <date>2015-10-24 19:51:34 GMT+5</date>
            <update-date>2016-10-20 21:21:11 GMT+5</update-date>
            <mark>Volkswagen</mark>
            <model>Polo</model>
            <year>2010</year>
            <run-metric>км</run-metric>
            <run>68000</run>
            <doors-count>4</doors-count>
            <modification>Polo V Sedan</modification>
            <state>Идеальное</state>
            <color>Серый</color>
            <body-type>Седан</body-type>
            <engine-type>Бензиновый</engine-type>
            <gear-type>Передний</gear-type>
            <displacement>1598</displacement>
            <transmission>Механика</transmission>
            <steering-wheel>Левый</steering-wheel>
            <haggle>Нет</haggle>
            <custom-house-state>Растаможен</custom-house-state>
            <equipment>Антиблокировочная система тормозов</equipment>
            <equipment>Система курсовой устойчивости</equipment>
            <equipment>Подогрев зеркал</equipment>
            <equipment>Регулировка руля</equipment>
            <equipment>Иммобилайзер</equipment>
            <equipment>Противоугонная сигнализация</equipment>
            <equipment>Центральный замок</equipment>
            <equipment>Ключ безконтактного доступа</equipment>
            <equipment>Магнитола</equipment>
            <image>
                https://auto.imgsmail.ru/content/photogallery/photos/7/1/71cfe2b947f1866c75f1de1714874c07_orig.jpg
            </image>
            <price>459000</price>
            <currency-type>RUR</currency-type>
            <seller>Ирина</seller>
            <seller-phone>+71230001122</seller-phone>
            <seller-city>Москва</seller-city>
        </offer>
    </offers>
</auto-catalog>

Служба поддержки Mail

Заголовок

Общая структура и корневой элемент

Структура блока offer

Помощь по другим проектам