XML импорт для Автосалонов

Сервис автоматической загрузки объявлений о продаже легковых автомобилей в формате XML предоставляется на GVANGA.COM бесплатно* для Автосалонов и Автомобильных дилеров.
Для подключения к сервису выгрузки объявлений XML достаточно просто зарегистрироваться на GVANGA и отправить нам ссылку на Ваш XML файл.

Как это работает?

Вы регистрируетесь на портале GVANGA.COM и в Личном кабинете в разделе "XML фиды" - настройки XML загрузки отправляете ссылку на XML фид. 
Добавленная ссылка на Ваш XML файл пройдет проверку на корректность, и все объявления в течение 24 часов будут импортированы на наш портал. Последующее обновление данных файла будет проходить один раз в сутки. Просмотр и редактирование всех загруженных объявлений будет доступно из Вашего Личного кабинета.
Публикация всех объявлений осуществляется после проверки службой модерации.

Технические требования к фиду

  • URL фида должен быть постоянным и доступным по протоколу HTTP.
  • Импорт данных Вашего XML фида будет производиться 1 раз в сутки.
  • Фид должен быть создан в кодировке UTF-8.
  • Не допускается наличие в фиде HTML-кода.
  • В текстовых полях не должны использоваться первые 32 символа с ASCII-кодами (за исключением значений 9, 10 и 13).
  • Кроме того, ряд символов для файла необходимо заменять кодами:

 

Символ  Код
"             "
&            &
>             >
<             &lt;
'              &apos;

 

Описание формата XML файла для авто

Заголовок фида должен начинаться со стандартного XML-заголовка:
<?xml version="1.0" encoding="utf-8"?>

В файле должен быть корневой элемент auto-catalog - <auto-catalog>  …</auto-catalog> с датой создания фида:
<generation-date>YYYY-MM-DD HH:mm:ss+04:00</generation-date>

Каждое объявление в фиде формируется элементом offer, для которого необходимо указывать уникальный идентификатор internal-id:
<offer internal-id="Номер id"> ... </offer>

 

Описание обязательных параметров элемента offer:

ЭлементОписание
<url>Ссылка на страницу с объявлением
<mark>Марка автомобиля
<model>Модель автомобиля
<date>Дата создания объявления – формат даты: YYYY-MM-DDTHH:mm:ss+04:00
<year>Год выпуска (четырехзначное число)
<displacement>Объем двигателя (в литрах, через запятую)
<horse-power>Мощность двигателя (лошадиные силы)
<price>
</price>
Элементы показателя «Цена»
<value>
Цена (без пробелов)
<currency>
Валюта: «RUR» или «RUB», «USD», «EUR», «UAH»
<steering-wheel>Расположение руля («правый» или «RHD», «левый» или «LHD»)
<transmission>Тип коробки передач («механика» или «MT», «автомат» или «AT», «вариатор» или «CVT»)
<additional-info>Описание

 

Дополнительные параметры.

Рекомендуется включать в фид все элементы предложений, чтобы Ваши объявления лучше попадали в результаты поиска пользователей сайта – Ваших потенциальных клиентов.

 

ЭлементОписание
<title>Заголовок объявления
<engine-type>Тип двигателя («бензин» или «gasoline», «дизель» или «diesel», «гибрид» или «hybrid», «электро» или «electro», «газ» или «gas»)
<generation>Поколение автомобиля (II, E70, J1, ...)
<wheel-drive>Наличие полного привода 4WD (да - «да»,  «true», «1», «+»; нет - «нет», «false», «0», «-»)
<body-type>Тип кузова (седан, хэтчбэк, универсал...)
<doors-count>Количество дверей (целое число)
<state>Состояние автомобиля («новый» или «new», «с пробегом» или «used», «аварийное» или «crashed»)
<run>Пробег автомобиля (в километрах)
<custom-house-state>Таможенное оформление (растаможен - «растаможен», «да»,  «true», «1», «+»; нет – «не растаможен», «нет», «false», «0», «-»)
<color>Цвет кузова (белый, черный, желтый, зеленый, …)
<update-date>Дата обновления объявления
<valid-thru-date>Дата, до которой действительно объявление.
<vin>Идентификационный номер автомобиля.
<modification>Модификация автомобиля (GTI, ST, Alltrack ...).
<equipment>Комплектация автомобиля - для каждого параметра нужно создавать отдельный тег
<image>Фотография - для каждой фотографии нужно создавать отдельный тег с url адресом (может быть загружено до 4 изображений).
<dealer>
</dealer>
Набор элементов контактных данных дилера - Вы можете заполнить контактные данные для объявлений в личном кабинете пользователя GVANGA, чтобы они фигурировали во всех загружаемых объявлениях без дополнительного заполнения данных элементов в фиде. Если же контакты дилера отличаются от указанных ранее на нашем сайте, добавьте этот элемент в Ваш XML файл.
<country>
Страна
<region>
Область
<city>
Город
<address>
Улица (или улица и дом)
<name>
Имя представителя дилера
<company-name>
Название организации
<phone>
Номер телефона
<email>
Электронный адрес

Пример корректного XML фида:

<?xml version="1.0" encoding="UTF-8"?>
<auto-catalog>
    <creation-date>2016-02-21 22:22:22 GMT+4</creation-date>
    <host>gvanga.com</host>
    <offers>
        <offer internal-id="1">
            <url>https://gvanga.com/ad/citroen-jumpy-20d-mt-109-ls.html</url>
            <date>2016-02-21 22:22:22 GMT+4</date>
            <update-date>2016-03-16 11:11:11 GMT+4</update-date>
            <valid-thru-date>20.04.2016</valid-thru-date>
            <mark>Citroen</mark>
            <model>Jumpy</model>
            <year>2001</year>
            <run>175000</run>
            <additional-info>
                Автомобиль в хорошем состоянии, родная краска, есть небольшие сколы на бамперах.
            </additional-info>
            <doors-count>5</doors-count>
            <generation>IV</generation>
            <modification>GTI</modification>
            <state>Отличное</state>
            <color>Черный</color>
            <body-type>Хэтчбек</body-type>
            <engine-type>Дизель</engine-type>
            <displacement>2.0</displacement>
            <transmission>MT</transmission>
            <steering-wheel>Левый</steering-wheel>
            <custom-house-state>Растаможен</custom-house-state>
            <equipment>Магнитола (CD)</equipment>
            <equipment>Электрозеркала</equipment>
            <equipment>Электростеклоподъемники (все)</equipment>
            <image>https://gvanga.com/images/682cd2cc.jpg</image>
            <vin>WAUJC68E82A012</vin>
            <horse-power>109</horse-power>
            <price>
                <value>140000</value>
                <currency>USD</currency>
            </price>
            <dealer>
                <name>Иван Иванович</name>
                <country>Россия</currency>
                <region>Московская</region>
                <city>Москва</city>
                <phone>(495) 000-00-00</phone>
                <email>gvanga@gvanga.com</email>
            </dealer>
        </offer>
    </offers>
</auto-catalog>

Скачать: https://gvanga.com/examples/xml/car.xml

 

Для загрузки объявлений на наш портал Вы можете использовать XML файл формата Яндекс.Авто.

При возникновении дополнительных вопросов и предложений по XML загрузке объявлений на портале GVANGA.COM, пожалуйста, обращайтесь к нам через форму «Обратная связь» ниже и мы свяжемся с Вами в ближайшее время.

 

* Для Автосалонов и Автомобильных дилеров бесплатной является загрузка объявлений только из одного XML фида до 250 объявлений. При подключении импорта каждого дополнительного фида действует платная услуга, стоимость которой включает тариф за подключение и ежемесячный платеж в период действия услуги.

** Для агрегаторов и информационных систем действуют специальные платные условия подключения. Стоимость ежемесячного платежа зависит от общего количества активных для публикации объявлений.

 

Обратная связь

Поля, отмеченные * - обязательные для заполнения