Как понять, подходит ли ваш XML-фид для импорта автомобилей

Эта инструкция помогает быстро проверить ваш фид на соответствие нашим требованиям — без глубоких технических знаний.

Коротко: фид должен быть доступен по HTTPS-ссылке, иметь валидный XML и соответствовать одному из наших готовых драйверов. Если формат иной — вы можете передать данные по “минимальному набору полей”.

Шаг 1. Базовая проверка ссылки

✅ Ссылка начинается с https:// (не http://, не ftp://).
✅ Ссылка открывается в браузере без пароля и вы видите текст XML (угловые скобки, теги).
✅ Содержимое — именно XML (а не JSON, HTML-страница с ошибкой, PDF и т.п.).

Если на странице отображается ошибка, редирект или требуется авторизация — такой фид импортироваться не будет.

Шаг 2. Определите формат (драйвер)

Мы поддерживаем 4 готовых формата. Сверьте корневые теги и ключевые элементы:

Драйвер 1 CM.Expert Maxposter «Автору»

Обычно корневые теги вида: <data><cars><car>…
Поля часто в “человеческом” виде (цвет, металл, тип кузова и т.д.).

Показать пример Драйвер 1

<data>
	<cars>
		<car>
			<unique_id>99999</unique_id>
			<mark_id>Solaris</mark_id>
			<folder_id>HS</folder_id>
			<modification_id>1.6 AT [123 л.с.]</modification_id>
			<complectation_name>Active Plus</complectation_name>
			<body_type>Седан 4 дв.</body_type>
			<wheel>Левый</wheel>
			<color>Черный</color>
			<metallic>да</metallic>
			<availability>В наличии</availability>
			<custom>Растаможен</custom>
			<owners_number>Не было владельцев</owners_number>
			<year>2024</year>
			<registry_year>2024</registry_year>
			<doors_count>4</doors_count>
			<currency>RUR</currency>
			<vin>Z94K241CBSR999999</vin>
			<price>2019000</price>
			<engine_volume>1591</engine_volume>
			<engine_power>123</engine_power>
			<engine_type>Бензин</engine_type>
			<gearbox>Автоматическая</gearbox>
			<drive>Передний</drive>
			<credit_discount>150000</credit_discount>
			<tradein_discount>150000</tradein_discount>
			<max_discount>300000</max_discount>
			<description>Распродажа склада новых автомобилей до конца месяца! Ограничeннoe количecтво aвтoмoбилей на эксклюзивныx уcлoвияx с выгодой дo 650 000 pублeй! Сделаем лучшее предложение среди дилеров! Новые автомобили в наличии с ПТС. Отдаем автомобиль в день покупки. Выгодный кредит и рассрочка. Звоните! Новый Solaris 2024 года выпуска от официального дилера ! Официальная гарантия 3 года или 100 000 км. Автомобили с полным НДС 20% Ваши преимущества при покупке автомобиля: ⭐ Индивидуальный подход к каждому клиенту ⭐ Trade-in на ваших условиях ⭐ Кредит без первоначального взноса и рассрочка ⭐ Выдача авто в кредит за 1 день ⭐ Автомобили в наличии с ПТС ⭐ Спец. предложения на обслуживание автомобилей ⭐ Спец. тарифы и скидки на автомобиль при оформлении КАСКО и ОСАГО ⭐ Охранный комплекс и зимняя резина в подарок Улучшим предложение другого дилера! Звоните прямо сейчас и получите уникальное предложение на покупку вашего автомобиля уже сегодня!</description>
			<extras>обогрев зеркал,стальные диски,Диски 15,сигнализация,центральный замок,штатный иммобилайзер,штатная аудиосистема [без CD],Bluetooth,USB,розетка 12V,подогрев передних сидений,обогрев сидений,регулировка сидений водителя по высоте,сиденье водителя: ручная регулировка,сиденье водителя: электро регулировка,тканевый салон,темный салон,электроподъемники передние,электроподъемники задние,кондиционер,усилитель руля,регулировка руля по высоте,бортовой компьютер,мультифункциональное рулевое колесо,электропривод зеркал,подушка безопасности водителя,подушка безопасности пассажира,ABS,антипробуксовочная система,система помощи при торможении,система помощи при старте в гору,датчик давления в шинах,Isofix / LATCH,ESP</extras>
			<images>
				<image>https://s1.maxposter.ru/photo/1302/5770926/orig/7b23dfc6bf8c2d9d8d694efd8e03080d.jpg?sid=205</image>
				<image>https://s1.maxposter.ru/photo/1302/5770926/orig/7ac050971a44dfd286850bcaa85844d4.jpg?sid=205</image>
			</images>
			<poi_id>
				<![CDATA[ Санкт-Петербург, ул. Пушкина 1 ]]>
			</poi_id>
			<pts>Оригинал</pts>
			<exchange>Рассмотрю варианты</exchange>
			<tech_param_id>23891135</tech_param_id>
		</car>
	</cars>
</data>

Драйвер 2 Maxposter «Авито»

Корневой тег: <Ads target="Avito.ru" formatVersion="3">
Объявления обёрнуты в <Ad>…</Ad>.

Показать пример Драйвер 2

<Ads target="Avito.ru" formatVersion="3">
	<Ad>
		<Id>9999999</Id>
		<AdStatus>Free</AdStatus>
		<ListingFee>Package</ListingFee>
		<ContactMethod>По телефону и в сообщениях</ContactMethod>
		<ManagerName>Менеджер</ManagerName>
		<ContactPhone>799999999</ContactPhone>
		<Address>Россия, Санкт-Петербург</Address>
		<Latitude>59.91199306</Latitude>
		<Longitude>30.39967550</Longitude>
		<Category>Автомобили</Category>
		<CarType>Новые</CarType>
		<Price>3299000</Price>
		<Make>Jetour</Make>
		<Model>X70 Plus</Model>
		<Year>2023</Year>
		<VIN>HJRPBGGB2PF19999999</VIN>
		<BodyType>Внедорожник</BodyType>
		<Doors>5</Doors>
		<GenerationId>18773888</GenerationId>
		<ModificationId>18773889</ModificationId>
		<ComplectationId>18773891</ComplectationId>
		<Color>Белый</Color>
		<FuelType>Бензин</FuelType>
		<Transmission>Робот</Transmission>
		<DriveType>Передний</DriveType>
		<WheelType>Левый</WheelType>
		<TradeinDiscount>200000</TradeinDiscount>
		<CreditDiscount>300000</CreditDiscount>
		<InsuranceDiscount>50000</InsuranceDiscount>
		<MaxDiscount>550000</MaxDiscount>
		<Availability>В наличии</Availability>
		<Description>
			<![CDATA[ <p>Все специальные предложения и выгоды действуют до 31 августа 2024 года, забронируйте свой автомобиль на выгодных условиях! Специальная кредитная ставка, бонус по трейд-ин, выгодное КАСКО и индивидуальные условия покупки.</p><p>ФЕСТИВАЛЬ ПРОДАЖ JETOUR!<br><br>С 1 по 31 декабря 2023 года приобретайте ВСЕ автомобили JETOUR: DASHING, X70 PLUS, X90 PLUS и на максимально выгодных финансовых условиях. Специально для Вас АВТОРАССРОЧКА и самые выгодные кредитные предложения от наших банков-партнеров. И только в декабре 2023 года приобретайте любой автомобиль JETOUR DASHING с выгодой 150 000 рублей в АВТОБИОГРАФИИ ЦЕНТР. Предложение суммируется со всеми кредитными программами банков-партнеров. <br><br>🔥В наличии у официального дилера JETOUR<br><br>✅Более 40 автомобилей в наличии и пути!<br><br>✅Сервисная поддержка до 5 лет или до 150 000 км<br><br>✅С полным НДС</p><p>. Информация носит информационно-справочный характер, точную комплектацию по автомобилю уточняйте у менеджера отдела продаж. Предложение ограничено и не является публичной офертой. Более подробную информацию об условия авторассрочки и кредитования уточняйте в подразделениях банков-партнеров. Предложение действительно 31.08.2024. Выгода на автомобиль JETOUR Dashing предоставляется путем прямого снижения РРЦ на автомобиль выбранной комплектации. Предложение действительно до 31.08.2024 года,]]>
		</Description>
		<Images>
			<Image url="https://s1.maxposter.ru/photo/7778/5150220/orig/9ae0c375d0b0e94b855a1ec266ddcbc9.jpg?sid=14"/>
			<Image url="https://s1.maxposter.ru/photo/7778/5150220/orig/2dbe2951babff38874f65db171615d79.jpg?sid=14"/>
			<VideoURL>http://www.youtube.com/watch?v=yNi1XfXgRkw</VideoURL>
		</Ad>
	</Ads>

Драйвер 3 Maxposter dealer-export

Корневые теги: <vehicles><vehicle>…
Поля, как правило, на английском (например, engineType, bodyType), переводы мы делаем сами.
Есть complectation (комплектация).

Показать пример Драйвер 3

<vehicles>
	<vehicle>
		<id>9999999</id>
		<vin>SALEA7BW9P2199999</vin>
		<uin/>
		<dealer id="9999">ЛЕГЕНДА 999</dealer>
		<category id="1">Легковые</category>
		<subcategory/>
		<type>used</type>
		<year>2022</year>
		<brand id="58">Land Rover</brand>
		<model id="1046">Defender</model>
		<generation id="10430">II</generation>
		<bodyConfiguration id="9140">Внедорожник 5 дв. 110</bodyConfiguration>
		<modification id="74554">110 3.0d AT [249 л.с.] 4WD</modification>
		<complectation id="15167">SE</complectation>
		<brandComplectationCode/>
		<engineType>diesel</engineType>
		<engineVolume>2996</engineVolume>
		<enginePower>249</enginePower>
		<bodyNumber/>
		<bodyType>suv</bodyType>
		<bodyDoorCount>5</bodyDoorCount>
		<seatCount/>
		<bodyColor>white</bodyColor>
		<bodyColorMetallic>0</bodyColorMetallic>
		<driveType>full_4wd</driveType>
		<gearboxType>automatic</gearboxType>
		<gearboxGearCount/>
		<steeringWheel>left</steeringWheel>
		<mileage>4843</mileage>
		<mileageUnit>km</mileageUnit>
		<price>12990000</price>
		<previousPrice>13500000</previousPrice>
		<specialOffer>0</specialOffer>
		<specialOfferPreviousPrice/>
		<tradeinDiscount/>
		<creditDiscount/>
		<insuranceDiscount/>
		<maxDiscount/>
		<bargain>0</bargain>
		<availability>available</availability>
		<ptsType>electronic</ptsType>
		<photoCount>1</photoCount>
		<description>
			<![CDATA[ Данный автомобиль возможно приобрести в кредит, по ставке от 15,3% годовых В наличии большое количество автомобилей различных премиальных марок. Выкупаем автомобили любых марок и годов выпуска. Возможна полная выплата стоимости автомобиля в день обращения. При срочном выкупе – до 90% от реальной стоимости автомобиля. Возможен как наличный, так и безналичный расчет. Возможна продажа/покупка авто с НДС [уточняйте у менеджера про конкретный автомобиль]. • Гарантия юридической чистоты сделки • Проверенная история автомобиля • Заключение авторизованной станции технического обслуживания о техническом состоянии предлагаемого автомобиля • Проведена полная предпродажная подготовка • Работает система Trade- in, принимаем Ваш автомобиль в зачет • Срочный выкуп автомобилей на выгодных условиях • Принимаем авто на комиссию • Продажа автомобилей с пробегом • Перечень дополнительных услуг по страхованию Вашего автомобиля; техническому обслуживанию, приобретению и установке дополнительного оборудования и аксессуаров ]]>
		</description>
		<address>
			<![CDATA[ Иркутск ]]>
		</address>
		<ownersCount>0</ownersCount>
		<vehicleCondition>good</vehicleCondition>
		<equipment>
			<group id="1" name="Активная безопасность">
				<element id="1">Антиблокировочная система</element>
				<element id="2">Антипробуксовочная система</element>
				<element id="3">Система курсовой устойчивости</element>
				<element id="4">Система контроля слепых зон</element>
				<element id="5">Система помощи при экстренном торможении</element>
				<element id="6">Система предотвращения столкновения</element>
				<element id="7">Датчик усталости водителя</element>
				<element id="8">Датчик давления в шинах</element>
			</group>
			<group id="2" name="Пассивная безопасность">
				<element id="10">Подушки безопасности водителя</element>
				<element id="12">Подушки безопасности пассажира</element>
				<element id="14">Боковые передние подушки безопасности</element>
				<element id="16">Оконные шторки безопасности</element>
				<element id="18">Блокировка замков задних дверей</element>
				<element id="19">Система крепления детских автокресел</element>
			</group>
		</equipment>
		<photos>
			<photo>https://s1.maxposter.ru/photo/2387/5037604/orig/e0ab1b30a24cb1fb021c6f8dede4a90a.jpg?sid=86</photo>
			<photo>https://s1.maxposter.ru/photo/2387/5037604/orig/1cfa69532d638325bd0ea51d8df68d5b.jpg?sid=86</photo>
		</photos>
	</vehicle>
</vehicles>

Драйвер 4 Maxposter без комплектаций

Также <vehicles><vehicle>…, очень похож на Драйвер 3.
Переводы делает Maxposter, нет complectation.

Показать пример Драйвер 4

<vehicles>
	<vehicle>
		<id>999999</id>
		<vin>LB37852D9PS99999</vin>
		<uin>
			<![CDATA[ f17990f8-7197-199e-ad72-a499995ae8c3 ]]>
		</uin>
		<dealer id="5322">Сургут</dealer>
		<category id="1">Легковые</category>
		<subcategory/>
		<type>used</type>
		<year>2023</year>
		<brand id="177">Geely</brand>
		<model id="84343">Monjaro</model>
		<generation/>
		<bodyConfiguration id="11963">Внедорожник 5 дв.</bodyConfiguration>
		<modification id="88965">2.0 AT [238 л.с.] 4WD</modification>
		<complectation/>
		<brandComplectationCode/>
		<engineType>Бензиновый</engineType>
		<engineVolume>1969</engineVolume>
		<engineVolumeLiters>2.0</engineVolumeLiters>
		<enginePower>238</enginePower>
		<bodyNumber/>
		<bodyType>Внедорожник</bodyType>
		<bodyDoorCount>5</bodyDoorCount>
		<bodyColor>Черный</bodyColor>
		<bodyColorMetallic>0</bodyColorMetallic>
		<driveType>Полный</driveType>
		<gearboxType>Автоматическая</gearboxType>
		<gearboxGearCount/>
		<steeringWheel>Левый</steeringWheel>
		<mileage>16</mileage>
		<mileageUnit>km</mileageUnit>
		<price>4100000</price>
		<specialOffer>0</specialOffer>
		<specialOfferPreviousPrice/>
		<tradeinDiscount/>
		<creditDiscount/>
		<insuranceDiscount/>
		<maxDiscount/>
		<availability>В наличии</availability>
		<ptsType>Электронный</ptsType>
		<photoCount>1</photoCount>
		<description>
			<![CDATA[ АБСОЛЮТНО НОВЫЙ Geely Monjaro, вы можете приобрести именно сегодня, у официального дилера! ЦЕНА СФОРМИРОВАНА С УЧЕТОМ ВСЕХ ВЫГОД ПРИ ОФОРМЛЕНИИ АВТОМОБИЛЯ В КРЕДИТ И ОБМЕНЕ ПО СИСТЕМЕ ТРЕЙД-ИН! ✅ 2.0 ДВС; ✅ 4WD; ✅ Русифицированный интерфейс; ✅ Максимальная комплектация; ✅ БЕСПЛАТНАЯ ОЦЕНКА вашего авто в день обращения; ✅ Возможность оформления кредита без первоначального взноса; ]]>
		</description>
		<ownersCount>1</ownersCount>
		<photos>
			<photo>https://s1.maxposter.ru/photo/5322/5081651/orig/8e12abe81466b403c40d77faf1a9239e.jpg?sid=137</photo>
			<photo>https://s1.maxposter.ru/photo/5322/5081651/orig/5a2e1ab18eaa4fbcf26f31a3b8c04c3c.jpg?sid=137</photo>
		</photos>
	</vehicle>
</vehicles>

Если ваш фид совпадает по структуре с одним из драйверов — отлично, импорт пройдёт сразу. Если нет — переходите к “минимальному набору полей”.

Шаг 3. Если формат иной — минимальный набор полей

Мы можем принять “свободный” XML, если он содержит поля из таблицы ниже. Обязательные поля отмечены (*обяз.).

Ключ	Тип	Описание	Пример	Обяз.
VIN	строка(17)	Идентификатор автомобиля. Уникален в пределах фида.	`WBANU51070C999999`	*
BRAND	строка	Марка	`Geely`	*
MODEL	строка	Модель	`Atlas`	*
Цена	число	Цена без скидок	`1999000`	—
Спеццена	число	Если нет — продублируйте “Цена”. Иначе все модификаторы вычитаются от спеццены.	`1899000`	—
Модификаторы скидок	число	Кредит / Trade-in / КАСКО / Максимальная скидка	`50000`	—
dealer	строка	Дилерский центр (привязка)	`Дилер 1`	—
run	число	Пробег, км	`500`	—
drive	строка	Тип привода	`Передний`	—
year	число	Год выпуска	`2023`	—
color	строка	Цвет	`Белый`	—
engine_power	число	Мощность (л.с.), только цифры	`123`	—
body_type	строка	Тип кузова	`Седан`	—
equipment	строка	Комплектация (название)	`Luxe`	—
engine_type	строка	Тип топлива	`Бензиновый`	—
door_count	число	Количество дверей	`5`	—
description	строка	Описание авто (текст, допускается CDATA)	—	—
gearbox	строка	Коробка передач	`Автомат`	—
engine_volume	число	Литры через точку (а не куб.см)	`1.6`	—
images	список ссылок	Фото в HTTPS, один общий домен, прямая ссылка на файл	`<images> <image>https://site.ru/a.jpg</image> <image>https://site.ru/b.jpg</image> </images>`	—

Важно про VIN: длина строго 17 символов и без дублей. Если во фиде встречаются два одинаковых VIN — импорт не пройдёт.

Шаг 4. Быстрая самопроверка перед отправкой

✅ Ссылка на фид — HTTPS, открывается без авторизации.
✅ XML валиден: есть корневой тег, теги корректно закрыты.
✅ Фид соответствует одному из Драйверов или содержит минимальный набор полей.
✅ VIN у каждого авто уникальный без повторов и есть у каждого автомобиля.
✅ Фото:
- — в HTTPS, один домен-источник для всех изображений
- — При открытии видно фотографию, без ошибок что недоступен сертификат
- — ведут на сам файл (а не на HTML-страницу/просмотрщик),
- — обёрнуты в общий тег <images>...</images>.

Правильно vs. Неправильно (изображения)

✅ Правильно (есть общий контейнер <images>, ссылки прямые и HTTPS):

<images>
  <image>https://s1.maxposter.ru/photo/1302/5770926/orig/7b23dfc6bf8c2d9d8d694efd8e03080d.jpg?sid=205</image>
  <image>https://s1.maxposter.ru/photo/1302/5770926/orig/7ac050971a44dfd286850bcaa85844d4.jpg?sid=205</image>
</images>

❌ Неправильно (нет общего контейнера <images>):

<image>https://s1.maxposter.ru/photo/1302/5770926/orig/7b23dfc6bf8c2d9d8d694efd8e03080d.jpg?sid=205</image>
<image>https://s1.maxposter.ru/photo/1302/5770926/orig/7ac050971a44dfd286850bcaa85844d4.jpg?sid=205</image>

Также не подходят ссылки на FTP, облачные превью (например, Яндекс.Диск/Google Photos) и любые HTTP-ссылки без шифрования.

Типичные ошибки и как их избежать

Дублирующийся или неверный VIN — проверьте уникальность и длину (17 символов).
HTTP вместо HTTPS — включите HTTPS на стороне хостинга фида и фотографий.
Нет контейнера <images> — обязательно оборачивайте список фото в общий тег.
Скидки вычитаются от “Цены”, а не от “Спеццены” — если указываете “Спеццену”, модификаторы применяются к ней; если “Спеццены” нет — продублируйте “Цену”.
Литры/куб.см перепутаны — в “свободном” формате поле engine_volume указывайте в литрах через точку (напр., 1.6).
Фото ведут на HTML-страницы — нужны прямые ссылки на файлы изображений (оканчиваются на .jpg, .png и т.п.).

FAQ (коротко)

Можно ли защищённую ссылку с логином/паролем? Нет, фид должен открываться без авторизации по HTTPS.

Можно ли смешивать поля из разных драйверов? Рекомендуем придерживаться одного формата. Иначе используйте “минимальный набор полей”.

Описание и длинные тексты? Допускаются длинные описания (лучше заворачивать в <![CDATA[ ... ]]>).

Итог

Если вы прошли самопроверку и ваш фид соответствует одному из драйверов (или содержит минимальный набор полей) — он подходит для импорта. Пришлите нам HTTPS-ссылку на XML, и мы подключим импорт.