+7 (812) 565-58-88
+7 (495) 445-48-88

Описание XML формата данных CarCopy.ru

Разработчики: Константин Денисов, Павел Светлов, Роман Хоничев

Обновлено:

Содержание

  1. Комментарий
    1. Документация
    2. Изменения в документации
    3. Версия документации
  2. Передача данных
    1. Набор данных
      1. XML файл
      2. ZIP архив
    2. Импорт данных
      1. Через веб-интерфейс
    3. Экспорт данных
      1. Выгрузка файла на FTP сервер
      2. Через веб-интерфейс
  3. Общие сведения о формате CarCopy
    1. Обязательные и рекомендуемые данные
    2. Требование к кодировке
    3. Требование к изображениям
    4. Содержание главной секции
    5. Структура XML файла в формате CarCopy
  4. Описание данных
    1. Таблица: структура секции <seller>...</seller>
    2. Таблица: структура секции <offer>...</offer>
      1. Таблица: структура секции <offer><badges>...<badges></offer>
      2. Таблица: структура секции <offer><equipment-id>...<equipment-id></offer>
      3. Таблица: структура секции <offer><publications>...<publications></offer>
      4. Таблица: структура секции <offer><photos>...<photos></offer>
      5. Таблица: структура секции <offer><delivery_info>...<delivery_info></offer>
    3. Справочные данные
      1. Справочные данные category, color, body-type, engine-type, transmission, equipment
      2. Справочные данные make
      3. Справочные данные country, city
      4. Справочные данные equipment-code
      5. Справочные данные interior-code
  5. Пример данных
  6. История изменений

Комментарий

Документация

Настоящая документация описывает все принципы обмена данными с системой CarCopy.ru в формате CarCopy. Документация предназначена для разработчиков и включает в себя все необходимые наборы данных, а также необходимые ссылки на специальную справочную информацию. Все правила, описанные в настоящей документации, вступают в силу, начиная с 20 марта 2009 года.

Изменения в документации

Все изменения и дополнения содержатся в §6. История изменений настоящей документации.

Версия документации

ВАЖНО: Убедитесь, что работаете с последней версией документации.
Актуальная версия документации доступна по адресу: http://docs.carcopy.ru/format.html

Передача данных

Набор данных

Файл в формате XML со ссылками на изображения. Набор данных может быть в двух видах:

XML файл

Файл со ссылками на изображения на внешнем источнике. Например: file.xml (имя файла произвольное).

ZIP архив

Архив, состоящий из XML файла и набора изображений. Например, simple.zip, состоящий из: file.xml, image_1.jpg, image_2.jpg, image_3.jpg.
Имя ZIP архива, имя XML файла, имена изображений — произвольные.

Импорт данных

Вне зависимости от типа данных в файле содержатся данные по одному дилеру.

Через веб-интерфейс

Экспорт данных

Выгрузка файла на FTP сервер

Через веб-интерфейс

Общие сведения о формате CarCopy

Обязательные и рекомендуемые данные

В настоящей документации все ОБЯЗАТЕЛЬНЫЕ для передачи данные выделены красным жирным шрифтом.
Если для дальнейшей передачи на какой-либо сайт, подключенный к системе CarCopy, данных в объявлении будет недостаточно, такое объявление передаваться не будет.

Требование к кодировке

Файл simple.xml должен быть ОБЯЗАТЕЛЬНО в кодировке UTF-8.

Требование к изображениям

Изображения должны быть в формате jpg, gif или png.
Размер изображений должен быть не менее 920 пикселей по ширине и не менее 700 пикселей по высоте.

Содержание главной секции

Примечания:

  • Данные о разных продавцах могут содержаться в наборе данных <sellers> (в данный момент не используется)
  • Каждый из наборов данных <seller>...</seller> соответствует отдельному продавцу. Не является обязательным, если существует другой механизм идентификации продавца в системе CarCopy

Структура XML файла в формате CarCopy 


<?xml version="1.0" encoding="utf-8"?>
<carcopy version="2">
  <!-- Дата создания файла -->
  <creation-date>25 Mar 2011 06:03:58 GMT+0</creation-date>

  <!-- Список объявлений -->
  <offers>
    <offer>
      <id>4454645</id>
      <seller-id>116</seller-id>
      <seller-key>250</seller-key>
      <date/>
      <valid-thru-date/>
      <type>Легковой</type>
      <category>подержанный</category>
      <body-type>Седан</body-type>
      <engine-type>Турбодизель</engine-type>
      <make-id>66</make-id>
      <make>Toyota</make>
      <model>Corolla</model>
      <version>1.4 D-4D (90 Hp)</version>
      <year>2008</year>
      <price>1500000</price>
      <currency-type>RUR</currency-type>
      <haggle>no</haggle>
      <run>123456</run>
      <run-metric>km</run-metric>
      <vin>XWF0AHL48A0003925</vin>
      <body-number>TD62WYMZR-G2</body-number>
      <color>черный</color>
      <color-metallic>yes</color-metallic>
      <doors>4</doors>
      <power>90</power>
      <power-metric>hp</power-metric>
      <transmission>Автомат вариатор</transmission>
      <transmission-steps/>
      <cubic-capacity>1364</cubic-capacity>
      <drive>Передний</drive>
      <custom-clean>yes</custom-clean>
      <steering-wheel>L</steering-wheel>
      <seller-phone/>
      <seller-contact/>
      <accident>no</accident>
      <condition/>
      <presence>На заказ</presence>
      <comment>Автомобиль в наличии в Томске!</comment>

      <equipment>Антиблокировочная система (ABS)</equipment>
      <equipment-id>
        <item>1</item>
      </equipment-id>

      <photos root="http://carcopy.ru/">
        <photo>image.php?seller_id=116&vehicle_id=4454645&orig=1&image=1</photo>
        <photo>image.php?seller_id=116&vehicle_id=4454645&orig=1&image=2</photo>
        <photo>image.php?seller_id=116&vehicle_id=4454645&orig=1&image=3</photo>
        <photo>image.php?seller_id=116&vehicle_id=4454645&orig=1&image=4</photo>
        <photo>image.php?seller_id=116&vehicle_id=4454645&orig=1&image=5</photo>
        <photo>image.php?seller_id=116&vehicle_id=4454645&orig=1&image=65</photo>
      </photos>

      <delivery_info>
          <address>Санкт-Петербург, Невский проспект 1</address>
          <address>Москва, Льва Толстого 16</address>
      </delivery_info>

      <publications>
        <publication for="auto.ru" name="special"/>
        <publication for="auto.ru" name="export"/>
        <publication for="auto.ru" name="premium"/>
        <publication for="auto.ru" name="premium_offer"/>
        <publication for="auto.ru" name="disable_upload"/>
      </publications>

      <badges>
        <badge>Камера заднего вида</badge>
      </badges>

      <warranty-expire>12-2020</warranty-expire>
      <max-sale-date>2022-04-30</max-sale-date>
    </offer>
  </offers>

  <!-- Список продавцов -->
  <sellers>
    <seller>
      <id>116</id>
      <login/>
      <password/>
      <name>"Digiboo Ltd."</name>
      <country-id>335</country-id>
      <country>Албания</country>
      <city-id>no city</city-id>
      <city/>
      <address>Babkin st.</address>
      <phone>+7 (911) 5555555</phone>
      <phone>+7 (921) 6666666</phone>
      <fax>+7 (000) 000</fax>
      <contact>Digiboo</contact>
      <email>info@carcopy.ru</email>
      <url/>
    </seller>
  </sellers>
</carcopy>

Описание данных

Таблица: структура секции <seller>...</seller>

Тег Тип Пример Описание
<login> Текст vasiliypoupkine Логин. Может использоваться для разных систем
<password> Текст Qwerty123 Пароль. Может использоваться для разных систем
<id> Целое число 12345 Идентификатор продавца
<name> Текст WorldWideCars Ltd. Название компании продавца
<country> Текст Россия Страна местонахождения продавца (если не указан <country-id>)
<city> Текст Санкт-Петербург Город местонахождения продавца (если не указан <city-id>)
<address> Текст ул. Ленина 21 Улица, номер дома и т.д., местонахождения продавца
<info> Текст Продажа авто с пробегом Дополнительное описание (информация) о продавце
<phone> Текст +7 (812) 111-0000 Основной номер телефона.
Допустимые символы: цифры 0–9, + - ( ). Может быть 2 основных номера
<fax> Текст +7 (812) 111-0001 Номер факса.
Допустимые символы: цифры 0–9, + - ( )
<contact> Текст Василий Пупкин Имя контактного лица компании
<email> Текст info@site.ru Адрес электронной почты компании в системе
<url> Текст site.ru Адрес сайта продавца в интернете

Таблица: структура секции <offer>...</offer>

Общие теги для всех категорий ТС

Тег Тип Пример Описание
<id> Целое число 12345 Идентификатор объявления в системе
<date> Дата Дата объявления
<seller-id> Целое число 12345 Идентификатор продавца в системе CarCopy
<seller-key> Текст 123RRT Идентификатор объявления в системе продавца.
Идентификатор должен быть уникальным для каждого объявления внутри файла!
<seller-phone> Текст +7 (812) 222-0000 Номер телефона для конкретного объявления (если отличается от основного).
Допустимые символы: цифры 0–9, + - ( )
<seller-contact> Текст Иван Иванов Контактное лицо для конкретного объявления (если отличается от основного).
<type> Текст Легковой Тип транспортного средства (легковой, грузовой...)
<version> Текст Highline 1,6 Версия транспортного средства (Модификация)
<category> Текст Подержанный Категория транспортного средства
<make>** Текст VW Общепринятое написание марки транспортного средства
** Поле не редактируется
<model>** Текст Golf IV Общепринятое название модели транспортного средства
** Поле не редактируется
<year> Целое число 2003 Год выпуска транспортного средства
<price> Целое число 1000000 Цена транспортного средства
<currency-type> Одно из:
RUR
EUR
USD		 RUR Валюта.
RUR — рубль РФ
EUR — Евро
USD — доллар США
<location-address> Текст Санкт-Петербург, Екатерининский пр., 3 Место осмотра транспортного средства
<location-latitude> Текст 55.755241 Географические координаты места осмотра (широта)
<location-longitude> Текст 37.617779 Географические координаты места осмотра (долгота)
<haggle> yes или no yes Возможен торг:
yes — да
no — нет (по умолчанию)
<exchange> Текст Обмен не интересует Варианты обмена:
Обмен не интересует
Обмен с вашей доплатой
Обмен с моей доплатой
Рассмотрю варианты обмена
<custom-clean> yes или no yes Растаможен:
yes — да
no — нет
Указывается, только если автомобиль ввезён
<accident> yes или no no Аварийный:
yes — да
no — нет (по умолчанию)
<comment> Текст Любой текст Дополнительное описание
<equipment> Текст центральный замок, гидроусилитель руля, ABS Опции транспортного средства через запятую
(если не указана секция <equipment-id>)
<condition> Одно из:
Отличное
Хорошее
Среднее
Требует ремонта		 Отличное Состояние транспортного средства
<presence> Одно из:
В наличии
В пути
На заказ		 В наличии Наличие транспортного средства
<external_video_url> URL https://www.youtube.com/watch?v=QH2-TGUlwu4 Ссылка на видео с YouTube
<vat-invoice> yes или no yes Счет-фактура для вычета НДС:
yes — да
no — нет (по умолчанию)
<autoru-panorama-url> URL <Ссылка на файл> Ссылка на видеофайл с панорамным изображением ТС для auto.ru
<autoru-panorama-interior-url> URL <Ссылка на файл> Ссылка на файл с панорамным изображением интерьера ТС для auto.ru
URL <Ссылка на сайт> Ссылка на карточку ТС на сайте автосалона
Текст ООО КАРКОПИ Юридическое лицо
<admission-status> Одно из:
  • Выкуп
  • Trade-in (с пробегом)
  • Trade-in (новый)
  • Комиссия
  • Аукцион
  • Собственный парк
 Собственный парк Поступление ТС
<crm-status> Одно из:
  • Уточнить информацию по авто
  • Возврат владельцу
  • Внесен задатком
  • Зарезервирован
  • Продан
 Продан Статус ТС в CRM
<max-sale-date> Текст в формате ГГГГ-ММ-ДД 2022-04-30 Максимальный срок продажи ТС

Теги для категории Легковые

Тег Тип Пример Описание
<vin>* ** Текст XWF0AHL48A0003925 Идентификационный номер транспортного средства. Значение из 17 символов

В VIN-номере могут быть только символы латинского алфавита и арабские цифры:
0 1 2 3 4 5 6 7 8 9 A B C D E F G H J K L M N P R S T U V W X Y Z
Там не должно быть букв I, O, Q, потому что они похожи на единицу и ноль
* Обязательно, если статус В наличии и если не указан номер кузова
** Поле не редактируется
<body-number>* ** Текст TD62WYMZR-G2 Номер кузова транспортного средства
* Обязательно, если статус В наличии и если не указан VIN
** Поле не редактируется
<engine-type> Текст Бензин Тип двигателя
<power> Целое число 101 Мощность двигателя
<power-metric> hp или kw hp Единицы измерения мощности:
hp — лошадиные силы (по умолчанию)
kw — киловатт (1.359 * hp)
<cubic-capacity> Целое число 1599 Объем двигателя в см3
<transmission> Текст Автомат Коробка передач
<body-type> Текст Внедорожник Тип кузова
<doors> Целое число 5 Количество дверей
<drive> Текст задний Тип привода
<color> Текст Синий Цвет кузова
<run> Целое число 120000 Пробег
<run-metric>* km или mile km km — километр
mile — миля (1609 km)
* Обязательно для автомобилей с пробегом
<owners> Целое число 1 Количество владельцев
<registration_year> Целое число 2015 Год регистрации транспортного средства
<complectation> Текст Active Название комплектации ТС
<color-metallic> yes или no no Цвет металлик:
yes — да
no — нет (по умолчанию)
<modification-code> Текст ACC16K5RB Код модификации от производителя
<color-code> Текст Белый лед (369) Код цвета автомобиля по каталогу производителя
<interior-code> Текст ACCESS Код интерьера автомобиля по каталогу производителя
<equipment-code> Текст PRUPTE Код опций автомобиля по каталогу производителя
<pts> Текст Оригинал Данные о паспорте транспортного средства:
Оригинал
Дубликат
Не указано
<steering-wheel> L или R L Рулевое колесо:
L — слева (по умолчанию)
R — справа
<credit-discount> Целое число > 1500 50000 Сумма скидки при покупке в кредит
<insurance-discount> Целое число > 1500 30000 Сумма скидки при покупке страховки
<tradein-discount> Целое число > 1500 70000 Сумма скидки при покупке по программе trade-in
<discount-price> Целое число 999000 Цена транспортного средства с учетом всех акций, одновременно действующих на данный момент.
<discount-price-reason> Текст Цена при покупке в кредит Причина скидки:
Цена при продаже старого автомобиля по системе Trade-in
Цена при покупке в кредит
Цена по специальной акции импортера (скидка от представительства бренда)
Скидка за лояльность (повторная покупка у дилера)
Скидка по программе утилизации
<max-discount> Целое число > 1500 200000 Максимальная сумма скидки
<sts> Текст 00 АА 123456 Серия и номер свидетельства транспортного средства
(только кириллические символы!)
<certified_used_car> yes или no
1 или 0		 yes Сертифицированное производителем транспортное средство
<warranty-expire> мм-гггг 12-2020 Гарантия на транспортное средство
<video-file-url> URL <Ссылка на файл> Прямая ссылка на видео, расположенное на файлообменнике Яндекс.Диск (для avito.ru)
Инструкция по созданию ссылки
<not-registered-in-russia> yes или no yes Автомобиль не стоит на учёте в РФ

Теги для категории Лёгкие коммерческие

Тег Тип Пример Описание
<vin>* ** Текст XWF0AHL48A0003925 Идентификационный номер
* Обязательно, если не указан номер кузова
** Поле не редактируется
<body-number>* ** Текст TD62WYMZR-G2 Номер кузова
* Обязательно, если не указан VIN
** Поле не редактируется
<engine-type> Текст Бензин Тип двигателя
<power> Целое число 101 Мощность двигателя
<power-metric> hp или kw hp Единицы измерения мощности:
hp — лошадиные силы (по умолчанию)
kw — киловатт (1.359 * hp)
<cubic-capacity> Целое число 1599 Объем двигателя в см3
<transmission> Текст Автомат Коробка передач
<body-type> Текст Микроавтобус Тип кузова
<doors> Целое число 5 Количество дверей
<drive> Текст задний Тип привода
<color> Текст Синий Цвет
<run> Целое число 120000 Пробег
<owners> Целое число 1 Количество владельцев
<complectation> Текст Active Название комплектации ТС
<steering-wheel> L или R L Рулевое колесо:
L — слева (по умолчанию)
R — справа
<seats> Целое число 10 Число мест
<payload> Целое число 3000 Грузоподъёмность (килограммы)

Теги для категории Грузовые

Тег Тип Пример Описание
<power> Целое число 101 Мощность двигателя
<power-metric> hp или kw hp Единицы измерения мощности:
hp — лошадиные силы (по умолчанию)
kw — киловатт (1.359 * hp)
<cubic-capacity> Целое число 1599 Объем двигателя в см3
<transmission> Текст Механическая Коробка передач
<body-type> Текст Автовоз Тип кузова
<color> Текст Синий Цвет
<run> Целое число 120000 Пробег
<kmu_make> Текст Fiskars Марка КМУ
<kmu_model>* Текст 65S Модель КМУ
* Обязательно если указана марка КМУ
<engine-type> Текст Бензин Тип двигателя
<drive> Текст 8x8 Колёсная формула
<steering-wheel> L или R L Рулевое колесо:
L — слева (по умолчанию)
R — справа
<vin>** Текст XWF0AHL48A0003925 Идентификационный номер
** Поле не редактируется
<body-number>** Текст TD62WYMZR-G2 Номер кузова
** Поле не редактируется
<cabin> Текст 2-х местная без спального Тип кабины
<cabin-suspension> Текст Механическая Подвеска кабины
<euro_class> Текст 5 Класс загрязнения
<seats> Целое число 5 Число мест
<payload> Целое число 5000 Грузоподъёмность (килограммы)
<container-volume> Целое число 500 Объём кузова
<tanks_volume> Целое число 7000 Общий объём баков
<tanks_number> Целое число 2 Количество топливных баков
<tanks_material> Текст Алюминий Материал баков

Теги для категории Автобусы

Тег Тип Пример Описание
<power> Целое число 101 Мощность двигателя
<power-metric> hp или kw hp Единицы измерения мощности:
hp — лошадиные силы (по умолчанию)
kw — киловатт (1.359 * hp)
<cubic-capacity> Целое число 1599 Объем двигателя в см3
<transmission> Текст Механическая Коробка передач
<body-type> Текст Городской Тип кузова
<color> Текст Синий Цвет кузова
<run> Целое число 120000 Пробег
<engine-type> Текст Дизель Тип двигателя
<drive> Текст 6x6 Тип привода
<steering-wheel> L или R L Рулевое колесо:
L — слева (по умолчанию)
R — справа
<vin>** Текст XWF0AHL48A0003925 Идентификационный номер
** Поле не редактируется
<body-number>** Текст TD62WYMZR-G2 Номер кузова
** Поле не редактируется
<seats> Целое число 17 Число мест

Теги для категории Седельные тягачи

Тег Тип Пример Описание
<power> Целое число 101 Мощность двигателя
<power-metric> hp или kw hp Единицы измерения мощности:
hp — лошадиные силы (по умолчанию)
kw — киловатт (1.359 * hp)
<cubic-capacity> Целое число 1599 Объем двигателя в см3
<transmission> Текст Механическая Коробка передач
<color> Текст Синий Цвет
<run> Целое число 120000 Пробег
<engine-type> Текст Дизель Тип двигателя
<drive> Текст 8x8 Колесная формула
<steering-wheel> L или R L Рулевое колесо:
L — слева (по умолчанию)
R — справа
<vin>** Текст XWF0AHL48A0003925 Идентификационный номер
** Поле не редактируется
<body-number>** Текст TD62WYMZR-G2 Номер кузова
** Поле не редактируется
<cabin> Текст 2-х местная без спального Тип кабины
<cabin-suspension> Текст Механическая Подвеска кабины
<suspension-txt> Текст Подвеска шасси
<drawbar-load> Целое число 500 Нагрузка на сцепное (килограммы)
<bolster_height> Целое число 250 Высота седельного устройства

Теги для категории Прицепы

Тег Тип Пример Описание
<body-type> Текст Полуприцеп изотермический Тип прицепа
<color> Текст Синий Цвет
<run> Целое число 120000 Пробег
<vin>** Текст XWF0AHL48A0003925 Идентификационный номер
** Поле не редактируется
<body-number>** Текст TD62WYMZR-G2 Номер кузова
** Поле не редактируется
<suspension> Текст Рессорная Тип подвески
<brake> Текст Барабанные Тип тормозов
<container-volume> Целое число 500 Объём кузова
<payload> Целое число 8000 Грузоподъёмность (килограммы)
<axles> Целое число 3 Количество осей

Теги для категории Сельскохозяйственная техника

Тег Тип Пример Описание
<cubic-capacity> Целое число 1599 Объем двигателя в см3
<body-type> Текст Комбайн Тип кузова
<color> Текст Синий Цвет
<run> Целое число 120000 Пробег
<power> Целое число 101 Мощность двигателя
<power-metric> hp или kw hp Единицы измерения мощности:
hp — лошадиные силы (по умолчанию)
kw — киловатт (1.359 * hp)
<steering-wheel> L или R L Рулевое колесо:
L — слева (по умолчанию)
R — справа
<sts> Текст 00 АА 123456 Серия и номер СТС
(только кириллические символы!)
<vin>** Текст XWF0AHL48A0003925 Идентификационный номер
** Поле не редактируется
<body-number>** Текст TD62WYMZR-G2 Номер кузова
** Поле не редактируется
<run-hours> Целое число 5000 Моточасы

Теги для категории Бульдозеры

Тег Тип Пример Описание
<cubic-capacity> Целое число 1599 Объем двигателя в см3
<body-type> Текст Гусеничный Тип кузова
<color> Текст Синий Цвет
<run> Целое число 120000 Пробег
<power> Целое число 101 Мощность двигателя
<power-metric> hp или kw hp Единицы измерения мощности:
hp — лошадиные силы (по умолчанию)
kw — киловатт (1.359 * hp)
<vin>** Текст XWF0AHL48A0003925 Идентификационный номер
** Поле не редактируется
<body-number>** Текст TD62WYMZR-G2 Номер кузова
** Поле не редактируется
<run-hours> Целое число 5000 Моточасы
<traction-class> Целое число 50 Тяговый класс (тонны)

Теги для категории Экскаваторы

Тег Тип Пример Описание
<body-type> Текст Каток Тип кузова
<run> Целое число 120000 Пробег
<power> Целое число 101 Мощность двигателя
<power-metric> hp или kw hp Единицы измерения мощности:
hp — лошадиные силы (по умолчанию)
kw — киловатт (1.359 * hp)
<cubic-capacity> Целое число 1599 Объем двигателя в см3
<vin>** Текст XWF0AHL48A0003925 Идентификационный номер
** Поле не редактируется
<body-number>** Текст TD62WYMZR-G2 Номер кузова
** Поле не редактируется
<run-hours> Целое число 5000 Моточасы
<bucket-volume> Целое число 30 Объём ковша в м3

Теги для категории Автокраны

Тег Тип Пример Описание
<cubic-capacity> Целое число 1599 Объем двигателя в см3
<color> Текст Синий Цвет
<run> Целое число 120000 Пробег
<vin>** Текст XWF0AHL48A0003925 Идентификационный номер
** Поле не редактируется
<body-number>** Текст TD62WYMZR-G2 Номер кузова
** Поле не редактируется
<run-hours> Целое число 5000 Моточасы
<payload> Целое число 8000 Грузоподъёмность (килограммы)
<lift> Целое число 10 Высота подъёма (метры)
<radius> Целое число 10 Вылет стрелы (метры)

Теги для категории Самопогрузчики

Тег Тип Пример Описание
<run> Целое число 120000 Пробег
<cubic-capacity> Целое число 1599 Объем двигателя в см3
<vin>** Текст XWF0AHL48A0003925 Идентификационный номер
** Поле не редактируется
<body-number>** Текст TD62WYMZR-G2 Номер кузова
** Поле не редактируется
<run-hours> Целое число 5000 Моточасы
<payload> Целое число 8000 Грузоподъёмность (килограммы)

Теги для категории Строительная техника

Тег Тип Пример Описание
<body-type> Текст Каток Тип кузова
<run> Целое число 120000 Пробег
<vin>** Текст XWF0AHL48A0003925 Идентификационный номер
** Поле не редактируется
<body-number>** Текст TD62WYMZR-G2 Номер кузова
** Поле не редактируется
<run-hours> Целое число 5000 Моточасы

Теги для категории Автопогрузчики

Тег Тип Пример Описание
<body-type> Текст Фронтальный погрузчик Тип кузова
<run> Целое число 120000 Пробег
<vin>** Текст XWF0AHL48A0003925 Идентификационный номер
** Поле не редактируется
<body-number>** Текст TD62WYMZR-G2 Номер кузова
** Поле не редактируется
<run-hours> Целое число 5000 Моточасы
<lift> Целое число 10 Высота подъёма (метры)

Теги для категории Коммунальная техника

Тег Тип Пример Описание
<body-type> Текст Мусоровоз Тип кузова
<engine-type> Текст Дизель Тип двигателя
<power> Целое число 101 Мощность двигателя
<power-metric> hp или kw hp Единицы измерения мощности:
hp — лошадиные силы (по умолчанию)
kw — киловатт (1.359 * hp)
<vin>** Текст XWF0AHL48A0003925 Идентификационный номер
** Поле не редактируется
<body-number>** Текст TD62WYMZR-G2 Номер кузова
** Поле не редактируется

Теги для категории Мотоциклы

Тег Тип Пример Описание
<engine-type> Текст Бензин Тип двигателя
<power> Целое число 101 Мощность двигателя
<power-metric> hp или kw hp Единицы измерения мощности:
hp — лошадиные силы (по умолчанию)
kw — киловатт (1.359 * hp)
<cubic-capacity> Целое число 1599 Объем двигателя в см3
<transmission> Текст Ручная КПП Коробка передач
<body-type> Текст Чоппер Тип
<color> Текст Синий Цвет
<run> Целое число 120000 Пробег
<owners> Целое число 1 Количество владельцев
<vin>* ** Текст XWF0AHL48A0003925 Идентификационный номер
* Обязателен если статус В наличии и если не указан Номер кузова
** Поле не редактируется
<body-number>* ** Текст TD62WYMZR-G2 Номер кузова
* Обязателен если статус В наличии и если не указан VIN
** Поле не редактируется
<pts> Текст Оригинал Данные о паспорте транспортного средства:
Оригинал
Дубликат
Не указано
<cylinders> Целое число 10 Число цилиндров
<cycles> Целое число 4 Число тактов

Теги для категории Скутеры

Тег Тип Пример Описание
<engine-type> Текст Дизель Тип двигателя
<power> Целое число 101 Мощность двигателя
<power-metric> hp или kw hp Единицы измерения мощности:
hp — лошадиные силы (по умолчанию)
kw — киловатт (1.359 * hp)
<cubic-capacity> Целое число 1599 Объем двигателя в см3
<transmission> Текст Вариатор Коробка передач
<color> Текст Синий Цвет
<run> Целое число 120000 Пробег
<run-metric> km или mile km km — километр
mile — миля (1609 km)
<owners> Целое число 2 Количество владельцев
<pts> Текст Оригинал Данные о паспорте транспортного средства:
Оригинал
Дубликат
Не указано
<body-number> Текст TD62WYMZR-G2 Номер кузова
<cycles> Целое число 2 Число тактов

Таблица: структура секции <offer><badges>...<badges></offer>

Секция предназначена для передачи стикеров на сайт auto.ru. Максимум 3 стикера по 25 символов

Тег Тип Пример Описание
<badge> Текст Камера заднего вида Стикер для площадки auto.ru; до 25 символов

Таблица: структура секции <offer><equipment-id>...<equipment-id></offer>

Тег Тип Пример Описание
<item> Целое число 2 Опция транспортного средства.
Повторяется для каждой опции

Таблица: структура секции <offer><publications>...<publications></offer>

Секция предназначена для автоматического выделения конкретного объявления в общем списке.

Тег Атрибут for Атрибут name Описание
<publication> Тип площадки
(например: auto.ru)		 Значение для площадки
(см. Описание)
  • export — для обязательной выгрузки на сайт
  • disable_upload — отключить отгрузку ТС на площадку
  • premium — премиум-объявление
  • special — спецпредложение
  • exchange — обмен
  • fresh — поднятие в поиске (для auto.ru)
  • hide — снять объявление с продажи (для auto.ru)
  • expert — опубликовать объявление в разделе Авто.ру Эксперт (для auto.ru)
  • booking_online — услуга Бронирование онлайн (для auto.ru)
  • online_view — значок Онлайн-показ по видеосвязи (для auto.ru)
  • turbo_sale — турбо-продажа (желательно передавать Турбо один раз, и на протяжении 7 дней после активации, не применять другие флаги) (для auto.ru и avito.ru)
  • vip — VIP-объявление (для avito.ru)
  • push_up — Поднятие объявления в поиске (для avito.ru)
  • highlight — Выделение объявления (для avito.ru)
  • quick_sale — Пакет "Быстрая продажа" (для avito.ru)
  • quick_sale — Пакет "Быстрая продажа" (для avito.ru)
  • x2_1 — Пакет "До 2 раз больше просмотров на 1 день" (для avito.ru)
  • x2_7 — Пакет "До 2 раз больше просмотров на 7 день" (для avito.ru)
  • x5_1 — Пакет "До 5 раз больше просмотров на 1 день" (для avito.ru)
  • x5_7 — Пакет "До 5 раз больше просмотров на 7 день" (для avito.ru)
  • x10_1 — Пакет "До 10 раз больше просмотров на 1 день" (для avito.ru)
  • x10_7 — Пакет "До 10 раз больше просмотров на 7 день" (для avito.ru)
  • xl — Пакет "XL-объявление" (для avito.ru)

Примечания:

Например, ваш автосалон загружает в CarCopy 100 объявлений, а для выгрузки на auto.ru у вашего салона имеется аккаунт на 50 объявлений. Таким образом, если при передаче в CarCopy будут отмечены необходимые 50 объявлений из 100 для сайта auto.ru, то они и только они будут выгружены на площадку.
По умолчанию, будут переданы первые 50 объявлений из списка.

Таблица: структура секции <offer><photos>...<photos></offer>

Секция предназначена для указания фотографий объявления.

Тег Атрибут root Пример Описание
<photos> URL https://site.ru/item_001/ Ссылка на папку с изображениями.
Если изображения прикладываются в ZIP архиве, то root=""

Тег Тип Пример Описание
<photo> Текст img1.jpg Имя изображения

Таблица: структура секции <offer><delivery_info>...<delivery_info></offer>

Секция предназначена для указания адресов филиалов дилера, куда возможна доставка ТС.

Тег Тип Пример Описание
<address> Текст Санкт-Петербург, Невский проспект 1 Адрес филиала, в который возможна доставка ТС

https://carcopy.ru/docs/carcopy_refs_doc.xml

Теги <category-id>, <make-id>, <color-id>, <body-type-id>, <engine-type-id>, <transmission-id>, <equipment-id>, <drive-id> используются для чтения при экспорте файла.

https://carcopy.ru/xml/catalog_cars_v2.xml — легковые
https://carcopy.ru/xml/catalog_motos_v2.xml — мото
https://carcopy.ru/xml/catalog_scooters_v2.xml — скутеры
https://carcopy.ru/xml/catalog_trucks_v2.xml — грузовые

Описание формата файлов каталога на примере catalog_cars_v2.xml:

Пример файла для одной модификации приведён ниже. В настоящем файле может быть много марок, моделей и модификаций.


<?xml version="1.0" encoding="UTF-8"?>
<makes>
    <make id="1941" name="AC">
        <models>
            <model id="model20344361" id_old="model2" name="Ace" common_name="Ace" common_id="2142">
                <modification id="20465647" name="2.9 AT (195 л.с.)"/>
            </model>
        </models>
    </make>
</makes>

Описание элементов. В данный момент поколения и модификации фактически есть только в легковом типе ТС:

  • /makes — тег содержит в себе все марки, доступные для данного типа (типов) транспортных средств (ТС)
  • /makes/make — тег содержит каталог этой марки для данного типа (типов) ТС
  • /makes/make@id — атрибут содержит числовой идентификатор марки
  • /makes/make@name — атрибут содержит наименование марки
  • /makes/make/models — тег содержит все доступные поколения каждой модели этой марки для данного типа (типов) ТС.
    В модели может быть много поколений, поэтому нормальна ситуация, когда будут встречаться теги по одной модели, но с разными поколениями
  • /makes/make/models/model — тег содержит одно конкретное поколение модели.
    В этом теге содержатся все доступные модификации для этого конкретного поколения модели
  • /makes/make/models/model@id — атрибут содержит строку с идентификатором поколения.
    В данный момент поколения фактически есть только в легковом типе ТС, из-за этого в атрибуте могут содержаться два варианта значений:
    • Строка имеет префикс model и числовой идентификатор поколения
    • Строка имеет префикс emptymodel и некоторый числовой код, который постоянен для модели
  • /makes/make/models/model@id_old — атрибут содержит строку со старым идентификатором поколения.
    Это поле приведено для справки и оно будет полностью удалено в будущем.
    В этом атрибуте могут содержаться два варианта значений:
    • Строка имеет префикс model и числовой идентификатор поколения
    • Строка имеет префикс emptymodel и некоторый числовой код, который постоянен для модели
  • /makes/make/models/model@name — атрибут содержит наименование поколения
  • /makes/make/models/model@common_name — атрибут содержит наименование модели
  • /makes/make/models/model@common_id — атрибут содержит числовой идентификатор модели
  • /makes/make/models/model@type — атрибут содержит текстовое написание типа транспортного средства в котором есть эта модель.
    Этот атрибут есть только в каталоге для грузовых типов транспортных средств catalog_trucks_v2.xml.
    В легковом, мото и скутерах этого атрибута нет, т.к. в них ровно по одному типу ТС на каталог
  • /makes/make/models/model/modification — тег содержит одну конкретную модификацию
  • /makes/make/models/model/modification@id — атрибут содержит числовой идентификатор модификации
  • /makes/make/models/model/modification@name — атрибут содержит наименование модификации

https://carcopy.ru/docs/country_ru.xml

https://carcopy.ru/xml/equipement_codes.xml

https://carcopy.ru/xml/interior_codes.xml

Пример данных

При необходимости запрашивайте по адресу: info@carcopy.ru

История изменений

[11.04.2023] Добавлен тег <not-registered-in-russia> - Автомобиль не стоит на учёте в РФ

[09.02.2023] Добавлен тег <video-file-url> - Ссылка на видео на файлообменнике для avito.ru

[10.10.2022] Запрещено редактирование полей <vin>, <body-number>, <make> <model>

[30.05.2022] Добавлено описание тегов для каждой категории ТС

[28.03.2022] Добавлен тег <max-sale-date> - Максимальный срок продажи ТС

[24.01.2022] Добавлен тег <vat-invoice> - Счет-фактура для вычета НДС

[01.11.2021] Добавлено описание флагов публикаций спец.услуг Авито

[06.10.2021] Добавлены теги: <admission-status> - Поступление ТС, <crm-status> - Статус ТС в CRM

[20.09.2021] Добавлен тег <legal-entity> : Юридическое лицо

[29.03.2021] Удалён тег <spincar_url> : Ссылка на панорамное изображение ТС

[16.03.2021] Добавлен тег <autoru-panorama-interior-url> : Ссылка на файл с панорамным изображением интерьера ТС для auto.ru

[04.02.2021] Возвращён <discount-price-reason> : Причина скидки

[10.06.2020] Добавлено значение атрибута name тега <publication> : online_view

[10.06.2020] Добавлено значение атрибута name тега <publication> : booking_online

[21.04.2020] Добавлено значение атрибута name тега <publication> : expert

[17.02.2020] Добавлен тег <url_link> : Ссылка на карточку ТС на сайте автосалона

[05.02.2020] Добавлен тег <autoru-panorama-url> : Ссылка на видеофайл с панорамным изображением ТС для auto.ru

[14.01.2020] Обновлено описание тега <owners>, добавлены теги: <location-latitude>, <location-longitude> : Географические координаты

[06.11.2019] Теги <modification-code>, <color-code>, <equipment-code>, <interior-code>, <complectation> стали необязательными

[09.08.2019] Добавлен тег <delivery_info> : Дополнительные адреса доставки

[23.05.2019] Добавлен тег <extra_options> : Дополнительные опции

[07.05.2019] Добавлено значение атрибута name тега <publication> : Турбо-продажа

[19.03.2019] Добавлен тег <seats> : Количество мест для коммерческих ТС

[06.03.2019] Добавлен тег <spincar_url> : Ссылка на панорамное изображение ТС

[22.02.2019] Обновлены описания тегов: <owners>, <run>, <vin>, <external_video_url>

[16.01.2019] Удален тег <discount-price-reason> : Причина скидки

[10.08.2018] Обновлен тег <complectation>, <max-discount> : Название комплектации, сумма скидки

[26.06.2018] Обновлены ссылки на каталоги, добавлен тег <interior> : Описание обшивки салона

[31.05.2018] Добавлен справочник по коду интерьера. §4.3.5

[18.04.2018] Добавлен справочник по коду комплектации. §4.3.4

[18.04.2018] Добавлен тег <warranty-expire> : Срок гарантии ТС

[19.03.2018] Добавлен тег <badges> : Стикеры для auto.ru

[19.03.2018] Добавлены теги <credit-discount>, <insurance-discount>, <tradein-discount> : Скидка при покупке

[07.02.2018] Добавлен тег <pts> : Данные о ПТС

[24.01.2018] Добавлен тег <body-number> : Номер кузова ТС

[30.11.2017] Добавлен тег <disable_upload> : Убрать ТС из выгрузки

[15.11.2017] Добавлены теги <modification-code>, <color-code>, <equipment-code>, <interior-code> : Коды по каталогу производителя для новых ТС

[07.09.2017] Удалены неиспользуемые теги <premium_offer>, <hcolor> : Дополнительные услуги

[17.02.2017] Добавлены теги <discount-price>, <discount-price-reason> : Цена по акции

[02.02.2017] Добавлен тег <exchange> : Вариант обмена

[17.10.2016] Добавлены теги <premium>, <premium_offer> : Дополнительные услуги для auto.ru

[25.08.2016] Добавлены теги <fresh>, <top> : Дополнительные услуги для auto.ru

[12.02.2016] Добавлены теги <external_video_url/>, <certified_used_car/>, <sts/>. Обновлены ссылки на справочники : Удалены дублирующие теги

[14.07.2015] Изменен пункт §4.3.4 : Удалены лишние справочники

[14.07.2015] Изменен пункт §4.3.2 : Справочники марок и моделей

[21.01.2013] Обязательные поля: <power> : Мощность

[12.04.2011] Добавлены возможности выделения цветом и спецпредложений на сайте cars.ru : Таблица SITE: допустимые значения

[06.04.2011] Добавлен тег <location-address> : Место осмотра ТС

[29.03.2011] Добавлен тег <owners> : Количество владельцев

[25.03.2011] Добавлена секция <offer> / <publications>

[25.03.2011] Удалена секция <offer> / <export> : Вместо нее сделана секция <offer> / <publications>

[25.03.2011] Добавлен тег <presence> в секции <offer>...</offer> : Наличие ТС

[25.03.2011] Добавлен тег <condition> в секции <offer>...</offer> : Состояние ТС

[25.03.2011] Добавлен тег <type> и <type-id> в секции <offer>...</offer> : Тип ТС (Легковой, грузовой...)

[25.03.2011] Изменено значение тега <category> и <category-id> : Категория транспортного средства

[25.03.2011] Дополнен тег <seller-id> в секции <offer>...</offer>

[10.05.2010] Добавлена секция <offer> / <export> и справочная таблица SITE

[10.05.2010] Установлен новый набор рекомендуемых наборов данных. §3.1

[07.05.2010] Добавлены обязательные теги, описывающие привод автомобиля: <drive-id> либо <drive> : Обязательные теги

[12.03.2009] Добавлены справочники: carcopy_ref.xml, make.xml, country.xml

[12.03.2009] Исправлена нумерация в оглавлении