Экспорт объявлений в стандартном формате Автохаба
Генерируется 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 | Количество дверей | |
seatCount | Количество мест | |
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 | Цена | |
previousPrice | Предыдущая цена | |
specialOffer | Отмечено как специальное предложение | |
specialOfferPreviousPrice | Цена без специального предложения | |
priceWithDiscount | Цена со скидкой * только для новых ТС |
|
tradeinDiscount | Скидка за обмен | |
creditDiscount | Скидка за кредит | |
insuranceDiscount | Скидка за страховку | |
maxDiscount | Максимальная скидка * только для подержанных ТС |
|
bargain | Возможен торг | |
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 | |
siteUrl | Ссылка на объявление на сайте автосалона | |
avitoUrl | Ссылка на объявление на avito.ru | |
autoruUrl | Ссылка на объявление на auto.ru | |
dromUrl | Ссылка на объявление на drom.ru | |
siteUrls |
Ссылки на объявления на сайтах автосалона
<siteUrls> <url sourceId="0" source="Ссылка по шаблону">ссылка</url> <url sourceId="86" source="Выгрузка для сайта">ссылка</url> </siteUrls> |
|
acquisitionSource | Тип контракта. Одно из значений: "auction", "buyout", "buyout_on_visit", "commission", "fleet", "own", "trade_in_new", "trade_in_used", "trade_in_return", "parallel_import" | |
acquisitionDate | Дата поступления в формате Y-m-d | |
manufactureDate | Дата производства в формате Y-m-d | |
warrantyDate | Гарантия производителя Y-m | |
status |
Статус. Список вида
<status> <inPresalePreparation>0</inPresalePreparation> <inRepair>0</inRepair> <inLogistics>0</inLogistics> <inLegal>0</inLegal> <inProblems>1</inProblems> <inContent>1</inContent> <reserved>1</reserved> </status> |
* Вывод значений всех этих полей возможен на русском
** Поля для коммерческого транспорта
Пример 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> <previousPrice>24500</previousPrice> <specialOffer>1</specialOffer> <specialOfferPreviousPrice>25000</specialOfferPreviousPrice> <bargain>0</bargain> <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/> <siteUrl>https://site.com/vehicles/12345678901111141</siteUrl> <avitoUrl/> <autoruUrl/> <dromUrl/> <siteUrls> <url sourceId="1" source="Выгрузка для сайта">https://site.com/vehicles/12345678901111141</url> </siteUrls> <acquisitionSource>trade_in_used</acquisitionSource> <acquisitionDate>2020-05-01</acquisitionDate> <manufactureDate>2020-01-01</manufactureDate> <warrantyDate>2022-02</warrantyDate> </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> <previousPrice/> <bargain>0</bargain> <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/> <siteUrl/> <avitoUrl/> <autoruUrl/> <dromUrl/> <siteUrls/> <acquisitionSource/> <acquisitionDate/> <manufactureDate/> <warrantyDate/> </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> <previousPrice/> <specialOffer>1</specialOffer> <specialOfferPreviousPrice>25000</specialOfferPreviousPrice> <bargain>1</bargain> <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/> <siteUrl>https://site.com/vehicles/12345678901111141</siteUrl> <avitoUrl/> <autoruUrl>https://auto.ru/cars/used/sale/bmw/600/1101805952-4851dfcb/</autoruUrl> <dromUrl/> <siteUrls/> <acquisitionSource/> <acquisitionDate>2020-05-01</acquisitionDate> <manufactureDate>2020-01-01</manufactureDate> <warrantyDate/> </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> <previousPrice/> <bargain/> <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/> <siteUrl>https://site.com/vehicles/12345678901111141</siteUrl> <avitoUrl/> <autoruUrl/> <dromUrl/> <siteUrls/> <acquisitionSource/> <acquisitionDate>2020-05-01</acquisitionDate> <manufactureDate>2020-01-01</manufactureDate> <warrantyDate/> </vehicle> </vehicles>
По всем вопросам работы с API необходимо обращаться в Службу Поддержки:
- email: support.autohub@avito.ru