Экспорт объявлений в стандартном формате MaxPoster

Генерируется xml-файл с данными объявлений.

Структура xml-файла:

<?xml version="1.0″ encoding="UTF-8″ ?>
<vehicles>
    <vehicle> ... </vehicle>
    <vehicle> ... </vehicle>
    <vehicle> ... </vehicle>
</vehicles>
                

Описание элементов объявления в xml-файле:

Название Аттрибут ID Описание
id Идентификатор объявления
vin VIN
uin UIN
dealer да Автосалон
category да Категория транспортного средства
subcategory ** да Подкатегория
type Тип: Новое или подержанное ТС. Одно из значений: "used", "new"
year Год выпуска
brand да Марка
model да Модель
generation да Поколение
bodyConfiguration да Конфигурация кузова
modification да Модификация
complectation да Комплектация
brandComplectationCode Код комплектации
engineType * Тип двигателя. Одно из значений: "diesel", "electric", "hybrid", "petrol", "petrol_and_gas"
engineVolume Объём двигателя
enginePower Мощность двигателя
bodyNumber Номер кузова
bodyType * Тип кузова. Одно из значений: "cabriolet", "coupe", "hatchback", "long", "minivan", "pickup", "roadster", "sedan", "suv", "van", "universal", "fullmetal_van", "cargo_van", "tent_truck", "isothermal", "refrigerator", "ambulance", "minibus", "flatbed_truck", "chassis", "cistern", "tipper", "evacuator", "compactvan", "fastback", "liftback", "microvan", "phaeton", "speedster", "targa", "refueller", "flatbed_with_crane", "camper", "trade_van"
bodyDoorCount Количество дверей
bodyColor * Цвет кузова. Одно из значений: "beige", "white", "azure", "yellow", "green", "gold", "brown", "red", "orange", "purple", "pink", "silver", "grey", "blue", "violet", "black"
bodyColorMetallic Цвет кузова - металлик. Одно из значений, если указано: 0, 1
driveType * Тип привода. Одно из значений: "front", "rear", "full_4wd", "optional_4wd"
gearboxType * Тип коробки передач. Одно из значений: "automatic", "manual", "robotized", "variator"
gearboxGearCount Количество передач
steeringWheel * Левый/правый руль. Одно из значений: "left", "right"
mileage Пробег
mileageUnit Единица измерения пробега. Одно из значений: "km", "mile"
price Цена
specialOffer Отмечено как специальное предложение
specialOfferPreviousPrice Цена без специального предложения
priceWithDiscount Цена со скидкой
* только для новых ТС
tradeinDiscount Скидка за обмен
creditDiscount Скидка за кредит
insuranceDiscount Скидка за страховку
maxDiscount Максимальная скидка
* только для подержанных ТС
availability * Наличие. Одно из значений: "available", "order", "transit"
ptsType * ПТС. Одно из значений: "original", "electronic", "duplicate"
country ** да Страна производителя
operatingTime ** Наработка
ecoClass ** да Экологический класс двигателя
driveWheel ** да Колесная формула
axisCount ** Количество осей
brakeType ** да Тип тормозов
cabinType ** да Тип кабины
maximumPermittedMass ** Максимальная масса
saddleHeight ** да Высота седельного устройства
cabinSuspension ** да Подвеска кабины
chassisSuspension ** да Подвеска шасси
length ** Длина
width ** Рабочая ширина
bodyVolume ** Объем кузова
bucketVolume ** Объем ковша
tractionClass ** да Тяговый класс
refrigeratorClass ** да Класс рефрижератора
craneArrowRadius ** Вылет стрелы
craneArrowLength ** Длина стрелы
craneArrowPayload ** Грузоподъёмность стрелы
loadHeight ** Высота подъема
photoCount Количество фотографий
description Дополнительное описание, если есть
address Адрес осмотра ТС
ownersCount Количество владельцев по ПТС
vehicleCondition Состояние ТС. Одно из значений: "excellent", "good", "average", "broken".
equipment Доступные опции.
<equipment>
    <group id="id группы опций" name="Название группы опций">
        <element id="id опции">Название опции</element>
    </group>
</equipment>
                                    
photos Фотографии. Список вида
<photos>
    <photo>Ссылка на файл</photo>
    <photo>Ссылка на файл</photo>
    <photo>Ссылка на файл</photo>
</photos>
                                        
video Ссылка на видео на youtube.com
phones Контактные телефоны.
<phones>
    <phone
        number="номер телефона (только цифры)"
        callFrom="С какого часа можно звонить"
        callTo="До какого часа можно звонить"
    >форматированный номер телефона</phone>
</phones>
                                    
brandColorCode Код цвета
brandInteriorCode Код интерьера
certificationProgram да Программа сертификации
promoFeatures Ключевые особенности.
<promoFeatures>
    <promoFeature>особенность</promoFeature>
    <promoFeature>особенность</promoFeature>
</promoFeatures>
                                    
avitoId Id объявления на avito.ru
autoruId Id объявления на auto.ru
dromId Id объявления на drom.ru
avitoUrl Ссылка на объявление на avito.ru
autoruUrl Ссылка на объявление на auto.ru
dromUrl Ссылка на объявление на drom.ru
siteUrl Ссылка на объявление на сайте автосалона
acquisitionSource Тип контракта
manufactureDate Дата производства в формате Y-m-d
* Вывод значений всех этих полей возможен на русском
** Поля для коммерческого транспорта

Пример xml-файла:

<?xml version="1.0" encoding="UTF-8" ?>
<vehicles>
    <vehicle>
        <id>141</id>
        <vin>12345678901111141</vin>
        <dealer id="14">Название компании 103</dealer>
        <category id="1">Легковые</category>
        <type>used</type>
        <year>2015</year>
        <brand id="14">BmW</brand>
        <model id="4">320i F3x</model>
        <generation id="5">VI (F3x)</generation>
        <bodyConfiguration id="5">VI (F3x)</bodyConfiguration>
        <modification id="4">320i ED 1.6 AT (170 л.с.)</modification>
        <complectation id="20">cmp-1</complectation>
        <brandComplectationCode>EXTRA-PREMIUM#5</brandComplectationCode>
        <engineType>petrol</engineType>
        <engineVolume>2000</engineVolume>
        <enginePower>123</enginePower>
        <bodyNumber>12345678901111252</bodyNumber>
        <bodyType>sedan</bodyType>
        <bodyDoorCount>4</bodyDoorCount>
        <bodyColor>yellow</bodyColor>
        <bodyColorMetallic>1</bodyColorMetallic>
        <driveType>front</driveType>
        <gearboxType>manual</gearboxType>
        <gearboxGearCount>5</gearboxGearCount>
        <steeringWheel>left</steeringWheel>
        <mileage>120000</mileage>
        <mileageUnit>km</mileageUnit>
        <price>23000</price>
        <specialOffer>1</specialOffer>
        <specialOfferPreviousPrice>25000</specialOfferPreviousPrice>
        <photoCount>1</photoCount>
        <description><![CDATA[Описание из объявления]]></description>
        <address><![CDATA[Адрес осмотра автомобиля]]></address>
        <ownersCount>1</ownersCount>
        <vehicleCondition>excellent</vehicleCondition>
        <equipment>
            <group id="7" name="Мультимедиа и навигация">
              <element id="96">Навигационная система</element>
            </group>
        </equipment>
        <photos>
            <photo>http://www.maxposter.ru/photo/photo.jpg</photo>
        </photos>
        <video>http://www.youtube.com/watch?v=0u6tfN3E2dE</video>
        <phones>
            <phone number="74441110101" callFrom="10" callTo="12">+7 (444) 111-01-01</phone>
            <phone number="74441110102" callFrom="11" callTo="13">+7 (444) 111-01-02</phone>
        </phones>
        </brandColorCode>
        </brandInteriorCode>
        <certificationProgram id="1">Premium Selection</certificationProgram>
        <promoFeatures>
            <promoFeature>особенность</promoFeature>
            <promoFeature>особенность</promoFeature>
        </promoFeatures>
        <avitoId/>
        <autoruId/>
        <dromId/>
        <avitoUrl/>
        <autoruUrl/>
        <dromUrl/>
        <siteUrl>https://site.com/vehicles/12345678901111141</siteUrl>
        <manufactureDate>2020-01-01</manufactureDate>
    </vehicle>
    <vehicle>
        <id>152</id>
        <dealer id="14">Название компании 103</dealer>
        <category id="1">Легковые</category>
        <type>used</type>
        <year>2015</year>
        <brand id="14">BmW</brand>
        <model id="4">320i F3x</model>
        <steeringWheel>left</steeringWheel>
        <mileage>120000</mileage>
        <mileageUnit>km</mileageUnit>
        <price>23000</price>
        <ownersCount>2</ownersCount>
        <vehicleCondition>good</vehicleCondition>
        <phones>
            <phone number="74441110103" callFrom="10" callTo="18">+7 (444) 111-01-03</phone>
        </phones>
        </brandColorCode>
        </brandInteriorCode>
        </certificationProgram>
        <avitoId/>
        <autoruId/>
        <dromId/>
        <avitoUrl/>
        <autoruUrl/>
        <dromUrl/>
        <siteUrl/>
    </vehicle>
</vehicles>
                

Пример xml-файла cо значениями на русском:

<?xml version="1.0" encoding="UTF-8" ?>
<vehicles>
    <vehicle>
        <id>141</id>
        <vin>12345678901111141</vin>
        <dealer id="14">Название компании 103</dealer>
        <category id="1">Легковые</category>
        <type>used</type>
        <year>2015</year>
        <brand id="14">BmW</brand>
        <model id="4">320i F3x</model>
        <generation id="5">VI (F3x)</generation>
        <bodyConfiguration id="5">VI (F3x)</bodyConfiguration>
        <modification id="4">320i ED 1.6 AT (170 л.с.)</modification>
        <complectation id="20">cmp-1</complectation>
        <brandComplectationCode>EXTRA-PREMIUM#5</brandComplectationCode>
        <engineType>Бензиновый</engineType>
        <engineVolume>2000</engineVolume>
        <enginePower>123</enginePower>
        <bodyNumber>12345678901111252</bodyNumber>
        <bodyType>Седан</bodyType>
        <bodyDoorCount>4</bodyDoorCount>
        <bodyColor>Желтый</bodyColor>
        <bodyColorMetallic>1</bodyColorMetallic>
        <driveType>Передний</driveType>
        <gearboxType>Механическая</gearboxType>
        <gearboxGearCount>5</gearboxGearCount>
        <steeringWheel>Левый</steeringWheel>
        <mileage>120000</mileage>
        <mileageUnit>km</mileageUnit>
        <price>23000</price>
        <specialOffer>1</specialOffer>
        <specialOfferPreviousPrice>25000</specialOfferPreviousPrice>
        <photoCount>1</photoCount>
        <description><![CDATA[Описание из объявления]]></description>
        <address><![CDATA[Адрес осмотра автомобиля]]></address>
        <ownersCount>1</ownersCount>
        <vehicleCondition>Хорошее</vehicleCondition>
        <equipment>
            <group id="7" name="Мультимедиа и навигация">
              <element id="96">Навигационная система</element>
            </group>
        </equipment>
        <photos>
            <photo>http://www.maxposter.ru/photo/photo.jpg</photo>
        </photos>
        <video>http://www.youtube.com/watch?v=0u6tfN3E2dE</video>
        <phones>
            <phone number="74441110101" callFrom="10" callTo="12">+7 (444) 111-01-01</phone>
            <phone number="74441110102" callFrom="11" callTo="13">+7 (444) 111-01-02</phone>
        </phones>
        </brandColorCode>
        </brandInteriorCode>
        <certificationProgram id="1">Premium Selection</certificationProgram>
        <promoFeatures>
            <promoFeature>особенность</promoFeature>
            <promoFeature>особенность</promoFeature>
        </promoFeatures>
        <avitoId/>
        <autoruId/>1101805952-4851dfcb</autoruId>
        <dromId/>
        <avitoUrl/>
        <autoruUrl>https://auto.ru/cars/used/sale/bmw/600/1101805952-4851dfcb/</autoruUrl>
        <dromUrl/>
        <siteUrl>https://site.com/vehicles/12345678901111141</siteUrl>
    </vehicle>
</vehicles>
                

Пример xml-файла cо значениями для коммерческого транспорта:

<?xml version="1.0" encoding="UTF-8" ?>
<vehicles>
    <vehicle>
        <id>141</id>
        <vin>12345678901111141</vin>
        <dealer id="14">Название компании 103</dealer>
        <category id="3">Грузовики</category>
        <subcategory id="22">Эвакуатор</subcategory>
        <type>used</type>
        <year>2015</year>
        <brand id="38">Ford</brand>
        <model id="15613">Transit</model>
        <generation/>
        <bodyConfiguration/>
        <modification/>
        <complectation/>
        <brandComplectationCode/>
        <engineType>petrol</engineType>
        <engineVolume>2000</engineVolume>
        <enginePower>123</enginePower>
        <bodyNumber>12345678901111252</bodyNumber>
        <bodyType>sedan</bodyType>
        <bodyDoorCount>4</bodyDoorCount>
        <bodyColor>yellow</bodyColor>
        <bodyColorMetallic>1</bodyColorMetallic>
        <driveType>front</driveType>
        <gearboxType>manual</gearboxType>
        <gearboxGearCount>5</gearboxGearCount>
        <steeringWheel>left</steeringWheel>
        <mileage>120000</mileage>
        <mileageUnit>km</mileageUnit>
        <price>23000</price>
        <country id="4">Россия</country>
        <operatingTime>400</operatingTime>
        <ecoClass id="6">Евро-4</ecoClass>
        <driveWheel id="2">4x4</driveWheel>
        <axisCount>4</axisCount>
        <brakeType id="2">Дисковые</brakeType>
        <cabinType id="1">2-х местная без спального</cabinType>
        <maximumPermittedMass>3000</maximumPermittedMass>
        <saddleHeight id="2">150</saddleHeight>
        <cabinSuspension id="2">Пневматическая</cabinSuspension>
        <chassisSuspension id="1">Рессора-рессора</chassisSuspension>
        <length>4.5</length>
        <width>1.3</width>
        <bodyVolume>4.5</bodyVolume>
        <bucketVolume>4.5</bucketVolume>
        <tractionClass id="15">10</tractionClass>
        <refrigeratorClass id="5">E (-10°C и ниже)</refrigeratorClass>
        <craneArrowRadius>4.5</craneArrowRadius>
        <craneArrowLength>4.5</craneArrowLength>
        <craneArrowPayload>100</craneArrowPayload>
        <loadHeight>10.3</loadHeight>
        <photoCount>1</photoCount>
        <description><![CDATA[Описание из объявления]]></description>
        <address><![CDATA[Адрес осмотра автомобиля]]></address>
        <ownersCount>1</ownersCount>
        <vehicleCondition>good</vehicleCondition>
        <photos>
            <photo>http://www.maxposter.ru/photo/photo.jpg</photo>
        </photos>
        <video>http://www.youtube.com/watch?v=0u6tfN3E2dE</video>
        <phones>
            <phone number="74441110101" callFrom="10" callTo="12">+7 (444) 111-01-01</phone>
            <phone number="74441110102" callFrom="11" callTo="13">+7 (444) 111-01-02</phone>
        </phones>
        </brandColorCode>
        </brandInteriorCode>
        <certificationProgram id="1">Premium Selection</certificationProgram>
        <promoFeatures>
            <promoFeature>особенность</promoFeature>
            <promoFeature>особенность</promoFeature>
        </promoFeatures>
        <avitoId/>
        <autoruId/>
        <dromId/>
        <avitoUrl/>
        <autoruUrl/>
        <dromUrl/>
        <siteUrl>https://site.com/vehicles/12345678901111141</siteUrl>
    </vehicle>
</vehicles>
                

По всем вопросам работы с API необходимо обращаться в Службу Поддержки: