Отчеты Авто.ру

Способы передачи данных

Для передачи данных в Авто.ру можно использовать несколько способов.

Передача файлов по почте

Вам нужно отправить файлы на почту вида ***@partner-main.autoru.tv. В теме письма укажите название дилера и дату отправки. А в теле письма ничего не заполняйте. Во вложении должны быть только передаваемые файлы (ограничение – до 40 мб). Если файл не помещается в письмо и загружается в облако — разбейте информацию на несколько писем.

Загрузка в s3

Мы создадим бакет в s3 и выдадим ключи доступа. Вам необходимо поддержать API s3 и передать файлы в соответствующий уникальный бакет.

Передача через Авто.ру Бизнес

Если вы клиент Авто.ру Бизнес, то можно настроить обмен данными по продаже и оценке автомобилей. Для этого необходимо принять условия обмена в системе Авто.ру Бизнес.

Прочее

Другие способы передачи данных вы можете обсудить с вашим менеджером.

Формат JSON и XML

Название

Название файлов должно соответствовать формату:

«(Название партнера)_(event_type)_(дата и время формирования файла «ГГГГММДД-ЧЧММСС»).xml»

Название партнера должно содержать только латинские буквы без нижних подчеркиваний, дефисов и прочих специальных символов.

Пример:DEALER_1_20191230-135025.xml

Структура и формат

Файлы должны начинаться с параметров:

RESULT – массив;

EVENT — данные о событии;

ID— уникальный идентификатор события (например, № заказ-наряда);

VIN — VIN-номер автомобиля;

EVENT_TYPE — код типа события;

INFO — информация о событии.

На каждый тип Event_type нужно создавать отдельный файл. Если по одному VIN-номеру несколько событий одного типа (например, вы делали оценку автомобиля несколько раз) , сделайте на каждое событие отдельную запись.

На месте отсутствующих значений ничего не передается, структуру можно менять (то есть пустые поля можно не передавать).

Для исправления информации отправьте запись с теми же VIN, ID, EVENT_TYPE и корректными данными в INFO. Для удаления — пришлите только VIN, ID, EVENT_TYPE.

Продажа – 1

Параметр

Обязательный элемент

Значение

ID

Уникальный идентификатор события из вашей базы. Например, № заказ-наряда.

VIN

VIN автомобиля.

EVENT_TYPE

Код типа события.

  • 1 – Продажа.

INFO

Информация о событии.

EVENT_DATE_START

Дата начала события в формате ГГГГ-ММ-ДД.

EVENT_DATE

Дата окончания события в формате ГГГГ-ММ-ДД.

EVENT_REGION

Регион события.

EVENT_CITY

Город события.

STO_ID

Уникальный идентификатор точки. Например, ДЦ, в котором было совершено событие.

STO_NAME

Название точки. Например, ДЦ.

MARK

Марка автомобиля.

MODEL

Модель автомобиля.

YEAR

Год выпуска автомобиля.

AMOUNT

Сумма сделки.

CURRENCY

Валюта сделки.

Возможнные значения:

  • rub;
  • usd;
  • eur.

Если поле передано пустым, мы укажим значние rub.

IS_CREDIT

В кредит.

Возможные значения:

  • 1 — да
  • 0 — нет.

MILEAGE

Пробег автомобиля. Только для авто с пробегом.

CLIENT_TYPE

Тип клиента.

Возможные значения:

  • 0 — частное лицо;
  • 1 — юридическое лицо, занимающиеся сдачей авто в аренду.

SELLER_TYPE

Тип продавца. Обязательно только для автомобилей с пробегом.

Возможные значения:

  • 0 — частное лицо;
  • 1 — юридическое лицо, занимающиеся сдачей авто в аренду.
Пример

{
        "ID": "2222221",
        "VIN": "MR0KB3CD100908181",
        "EVENT_TYPE": 1,
        "INFO": {
                "EVENT_DATE": "2023-05-14",
                "EVENT_REGION": "Белгородская обл.",
                "EVENT_CITY": "Белгород",
                "STO_ID": 2,
                "STO_NAME": "Авто.ру",
                "MARK": "Lada",
                "MODEL": "Lada Vesta",
                "YEAR": 2020,
                "AMOUNT": 15020,
                "CURRENCY": "rub",
                "IS_CREDIT": 0,
                "MILEAGE": null,
                "CLIENT_TYPE": 0,
                "SELLER_TYPE": 1
        }
}
                      


<root>
  <0>
  <ID>2222221</ID>
  <VIN>MR0KB3CD100908181</VIN>
  <EVENT_TYPE>1</EVENT_TYPE>
  <INFO>
    <EVENT_DATE>2023-05-14</EVENT_DATE>
    <EVENT_REGION>Белгородская обл.</EVENT_REGION>
    <EVENT_CITY>Белгород</EVENT_CITY>
    <STO_ID>2</STO_ID>
    <STO_NAME>Авто.ру</STO_NAME>
    <MARK>Lada</MARK>
    <MODEL>Lada Vesta</MODEL>
    <YEAR>2020</YEAR>
    <AMOUNT>15020</AMOUNT>
    <CURRENCY>rub</CURRENCY>
    <IS_CREDIT>0</IS_CREDIT>
    <MILEAGE/>
    <CLIENT_TYPE>0</CLIENT_TYPE>
    <SELLER_TYPE>1</SELLER_TYPE>
  </INFO>
</0>
</root>
Ремонт, обслуживание — 2

Параметр

Обязательный элемент

Значение

ID

Уникальный идентификатор события из вашей базы. Например, № заказ-наряда.

VIN

VIN автомобиля.

EVENT_TYPE

Код типа события.

  • 2 – Ремонт, обслуживание.

INFO

Информация о событии.

EVENT_DATE_START

Дата начала события в формате ГГГГ-ММ-ДД.

EVENT_DATE

Дата окончания события в формате ГГГГ-ММ-ДД.

EVENT_REGION

Регион события.

EVENT_CITY

Город события.

STO_ID

Уникальный идентификатор точки. Например, ДЦ, в которой было совершено событие.

STO_NAME

Название точки. Например, ДЦ.

MARK

Марка автомобиля.

MODEL

Модель автомобиля.

YEAR

Год выпуска автомобиля.

MILEAGE

Пробег автомобиля. Только для авто с пробегом.

AMOUNT

Сумма сделки.

CURRENCY

Валюта сделки.

Возможнные значения:

  • rub;
  • usd;
  • eur.

Если поле передано пустым, мы укажим значние rub.

IS_PLANNED

Тип обслуживания.

Возможные значения:

  • 1 — плановое;
  • 0 — внеплановое.

TYPE

Тип ремонта.

Возможные значения:

  • guaranty — ремонт по гарантии;
  • body_insurance — кузовной ремонт за счет страховой;
  • ordinary_insurance — текущий ремонт за счет страховой;
  • body_paid — кузовной ремонт за свой счет;
  • ordinary_paid — текущий ремонт за свой счет;
  • ordinary_dealer — текущий ремонт за счет дилерского центра или автосервиса;
  • regulation — регламентное ТО.

DESCRIPTION

Описание ремонта.

RECOMMENDATIONS

Список рекомендаций, выданный по заказ-наряду.

Каждую рекомендацию размещайте отдельно внутри массива.

Пример JSON
"RECOMMENDATIONS": [
         "Требуется заменить втулки переднего стабилизатора",
         "ТО через 5000 км",
         "Замена масла АКПП"       
      ],
Пример XML
<RECOMMENDATIONS>
   <RECOMMENDATION>Требуется заменить втулки переднего стабилизатора</RECOMMENDATION>   
   <RECOMMENDATION>ТО через 5000 км</RECOMMENDATION>   <RECOMMENDATION>Замена масла АКПП</RECOMMENDATION>
</RECOMMENDATIONS>

WORKS

Список работ по заказ-наряду.

Каждую работу размещайте отдельно внутри массива с дополнительными параметрами:

  • NAME — название работы;
  • HOUR — время, затраченное на работу;
  • COST — стоимость услуги;
  • CURRENCY — валюта сделки. Возможнные значения: rub; usd; eur. Если поле передано пустым, мы укажим значние rub.
Пример JSON
"WORKS": [
         {
                "NAME": "Замена передних тормозных дисков",           
                "HOUR": 2,           
                "COST": 4000,           
                "CURRENCY": "rub"         
              },         
              {           
                "NAME": "Замена задних тормозных колодок",           
                "HOUR": 1,           
                "COST": 4000,           
                "CURRENCY": "rub"         
              }       
            ],
Пример XML
<WORKS>
  <WORK>
    <NAME>Замена передних тормозных дисков</NAME>
    <HOUR>2</HOUR>
    <COST>4000</COST>
    <CURRENCY>rub</CURRENCY>
  </WORK>
  <WORK>
    <NAME>Замена задних тормозных колодок</NAME>
    <HOUR>1</HOUR>
    <COST>4000</COST>
    <CURRENCY>rub</CURRENCY>
  </WORK>
</WORKS>

PRODUCTS

Список товаров и запчастей по заказ-наряду, событию.

Каждую работу размещайте отдельно внутри массива с дополнительными параметрами:

  • NAME – название товара;
  • BRAND — бренд товара;
  • COUNT — количество товара;
  • COST — стоимость товара.
Пример JSON
"PRODUCTS": [
    {
        "NAME": "Тормозной диск F-серия",
        "BRAND": "MILES",
        "COUNT": 2,
        "COST": 4500
    },
    {
        "NAME": "Тормозной диск",
        "BRAND": "BMW",
        "COUNT": 2,
        "COST": 8500
    },
    {
        "NAME": "Датчик износа тормозных накладок F01,02,04",
        "COUNT": 1,
        "COST": 2500
    }
],
Пример XML
<PRODUCTS>
  <PRODUCT>
    <NAME>Тормозной диск F-серия</NAME>
    <BRAND>MILES</BRAND>
    <COUNT>2</COUNT>
    <COST>4500</COST>
  </PRODUCT>
  <PRODUCT>
    <NAME>Тормозной диск</NAME>
    <BRAND>BMW</BRAND>
    <COUNT>2</COUNT>
    <COST>8500</COST>
  </PRODUCT>
  <PRODUCT>
    <NAME>Датчик износа тормозных накладок F01,02,04</NAME>
    <COUNT>1</COUNT>
    <COST>2500</COST>
  </PRODUCT>
</PRODUCTS>

CLIENT_TYPE

Тип клиента.

Возможные значения:

  • 0 — частное лицо;
  • 1 — юридическое лицо, занимающиеся сдачей авто в аренду.
Пример

[
    {
        "ID": "222id",
        "VIN": "MR0KB3CD100908181",
        "EVENT_TYPE": 2,
        "INFO": {
            "EVENT_DATE": "2024-04-26",
            "EVENT_REGION": "Тюменская область",
            "EVENT_CITY": "Тюмень",
            "STO_ID": "1",
            "STO_NAME": "Авто.ру",
            "MARK": "ГАЗ",
            "MODEL": "ГАЗЕЛЬ",
            "YEAR": 2023,
            "AMOUNT": "",
            "CURRENCY": "rub",
            "IS_PLANNED": 0,
            "TYPE": "ordinary_paid",
            "MILEAGE": 139564,
            "DESCRIPTION": "Текущий ремонт",
            "CLIENT_TYPE": 0
        },
        "WORKS": [ 
            {
            "NAME": "Замена передних тормозных дисков",
            "HOUR": 2,
            "COST": 4000,
            "CURRENCY": "rub"
          },
          {
            "NAME": "Замена задних тормозных колодок",
            "HOUR": 1,
            "COST": 4000,
            "CURRENCY": "rub"
          }
        ],
        "PRODUCTS": [
            {
            "NAME": "Тормозной диск F-серия",
            "BRAND": "MILES",
            "COUNT": 2,
            "COST": 4500
          },
          {
            "NAME": "Тормозной диск",
            "BRAND": "BMW",
            "COUNT": 2,
            "COST": 8500
          },
          {
            "NAME": "Датчик износа тормозных накладок F01,02,04",
            "COUNT": 1,
            "COST": 2500
          } 
        ],
        "RECOMMENDATIONS": [ 
        "Требуется заменить втулки переднего стабилизатора",
        "ТО через 5000 км",
        "Замена масла АКПП"
]
}]
                      


<root>
  <0>
  <ID>222id</ID>
  <VIN>MR0KB3CD100908181</VIN>
  <EVENT_TYPE>2</EVENT_TYPE>
  <INFO>
    <EVENT_DATE>2024-04-26</EVENT_DATE>
    <EVENT_REGION>Тюменская область</EVENT_REGION>
    <EVENT_CITY>Тюмень</EVENT_CITY>
    <STO_ID>1</STO_ID>
    <STO_NAME>Авто.ру</STO_NAME>
    <MARK>ГАЗ</MARK>
    <MODEL>ГАЗЕЛЬ</MODEL>
    <YEAR>2023</YEAR>
    <AMOUNT>
    </AMOUNT>
    <CURRENCY>rub</CURRENCY>
    <IS_PLANNED>0</IS_PLANNED>
    <TYPE>ordinary_paid</TYPE>
    <MILEAGE>139564</MILEAGE>
    <DESCRIPTION>Текущий ремонт</DESCRIPTION>
    <CLIENT_TYPE>0</CLIENT_TYPE>
  </INFO>
  <WORKS>
    <NAME>Замена передних тормозных дисков</NAME>
    <HOUR>2</HOUR>
    <COST>4000</COST>
    <CURRENCY>rub</CURRENCY>
  </WORKS>
  <WORKS>
    <NAME>Замена задних тормозных колодок</NAME>
    <HOUR>1</HOUR>
    <COST>4000</COST>
    <CURRENCY>rub</CURRENCY>
  </WORKS>
  <PRODUCTS>
    <NAME>Тормозной диск F-серия</NAME>
    <BRAND>MILES</BRAND>
    <COUNT>2</COUNT>
    <COST>4500</COST>
  </PRODUCTS>
  <PRODUCTS>
    <NAME>Тормозной диск</NAME>
    <BRAND>BMW</BRAND>
    <COUNT>2</COUNT>
    <COST>8500</COST>
  </PRODUCTS>
  <PRODUCTS>
    <NAME>Датчик износа тормозных накладок F01,02,04</NAME>
    <COUNT>1</COUNT>
    <COST>2500</COST>
  </PRODUCTS>
  <RECOMMENDATIONS>Требуется заменить втулки переднего стабилизатора</RECOMMENDATIONS>
  <RECOMMENDATIONS>ТО через 5000 км</RECOMMENDATIONS>
  <RECOMMENDATIONS>Замена масла АКПП</RECOMMENDATIONS>
</0>
</root>
Страховка — 5

Параметр

Обязательный элемент

Значение

ID

Уникальный идентификатор события из вашей базы. Например, № заказ-наряда.

VIN

VIN автомобиля

EVENT_TYPE

Код типа события.

  • 5 – Страховка.

INFO

Информация о событии.

EVENT_DATE_START

Дата начала события в формате ГГГГ-ММ-ДД.

EVENT_DATE

Дата окончания события в формате ГГГГ-ММ-ДД.

EVENT_REGION

Регион события.

EVENT_CITY

Город события.

STO_ID

Уникальный идентификатор точки. Например, ДЦ, в котором было совершено событие.

STO_NAME

Название точки. Например, ДЦ.

MARK

Марка автомобиля.

MODEL

Модель автомобиля.

YEAR

Год выпуска автомобиля.

MILEAGE

Пробег автомобиля. Только для авто с пробегом.

INSURANCE_START

Дата начала действия страховки в формате ГГГГ-ММ-ДД.

INSURANCE_END

Дата окончания действия страховки в формате ГГГГ-ММ-ДД.

INSURANCE_TYPE

Тип страховки.

Возможные значения:

  • 0 — КАСКО;
  • 1 — ОСАГО;
  • 2 — другое.

INSURANCE_NAME

Только если указано INSURANCE_TYPE  — 2 (другое).

CLIENT_TYPE

Тип клиента.

Возможные значения:

  • 0 — частное лицо;
  • 1 — юридическое лицо, занимающиеся сдачей авто в аренду.
Пример

[
    {
        "ID": "PE0006940",
        "VIN": "Z8NTBNT31CS047525",
        "EVENT_TYPE": 5,
        "INFO": {
            "EVENT_DATE": "2024-04-26",
            "EVENT_REGION": "Тюменская область",
            "EVENT_CITY": "Тюмень",
            "STO_ID": "32000077",
            "STO_NAME": "Автору",
            "MARK": "Suzuki",
            "MODEL": "Vitara",
            "YEAR": 2019,
            "MILEAGE": 60237,
            "CLIENT_TYPE": 0,
            "INSURANCE_START": "2024-05-12",
            "INSURANCE_END": "2025-05-11",
            "INSURANCE_TYPE": 1
        }
    }
]
                    


<root>
  <0>
  <ID>PE0006940</ID>
  <VIN>Z8NTBNT31CS047525</VIN>
  <EVENT_TYPE>5</EVENT_TYPE>
  <INFO>
    <EVENT_DATE>2024-04-26</EVENT_DATE>
    <EVENT_REGION>Тюменская область</EVENT_REGION>
    <EVENT_CITY>Тюмень</EVENT_CITY>
    <STO_ID>32000077</STO_ID>
    <STO_NAME>Автору</STO_NAME>
    <MARK>Suzuki</MARK>
    <MODEL>Vitara</MODEL>
    <YEAR>2019</YEAR>
    <MILEAGE>60237</MILEAGE>
    <CLIENT_TYPE>0</CLIENT_TYPE>
    <INSURANCE_START>2024-05-12</INSURANCE_START>
    <INSURANCE_END>2025-05-11</INSURANCE_END>
    <INSURANCE_TYPE>1</INSURANCE_TYPE>
  </INFO>
</0>
</root>
Оценка — 6

Параметр

Обязательный элемент

Значение

ID

Уникальный идентификатор события из вашей базы. Например, № заказ-наряда.

VIN

VIN автомобиля

EVENT_TYPE

Код типа события.

  • 6 – Оценка.

INFO

Информация о событии.

EVENT_DATE_START

Дата начала события в формате ГГГГ-ММ-ДД.

EVENT_DATE

Дата окончания события в формате ГГГГ-ММ-ДД.

EVENT_REGION

Регион события.

EVENT_CITY

Город события.

STO_ID

Уникальный идентификатор точки. Например, ДЦ, в котором было совершено событие.

STO_NAME

Название точки. Например ДЦ.

MARK

Марка автомобиля.

MODEL

Модель автомобиля.

YEAR

Год выпуска автомобиля.

IS_NEW

Тип автомбиля.

Возможные значения:

  • 1 – новый;
  • 0 — с пробегом.

MILEAGE

Пробег автомобиля. Только для авто с пробегом.

IMAGES

Фотографии осмотра.

Каждый снимок передатся двумя параметрами:

  • ORIG_URL —url оригинала фотографии;
  • IMAGE_TYPE — тип фотографии. Если на фото повержения укажите DAMAGE, если что-то другое — оставьте пустым.
Пример JSON
"IMAGES": [
  {
    "ORIG_URL": "https://...",
    "IMAGE_TYPE": "DAMAGE"
  }
]

VIDEOS

Видео осмотра.

  • URL — ссылка на оригинал видео;
  • VIDEO_TYPE — тип видео. Если на видео есть повреждения укажите DAMAGE, если нет — оставьте пустым.
Пример JSON
"VIDEOS": [
  {
    "URL": "https://..",
    "VIDEO_TYPE": "DAMAGE"
  }
]

DAMAGES

Комлексное описание поверждения.

DESCRIPTION — общее описание.

Массив DAMAGES_LIST внутри которого:

  • PART – код повреждения авто.

    Варианты кодов
    • неизвестная деталь автомобиля = 0
    • передний бампер = 2
    • задний бампер = 3
    • переднее левое крыло = 4
    • переднее правое крыло = 5
    • заднее левое крыло = 6
    • заднее правое крыло = 7
    • крыша = 8
    • капот = 9
    • стекло = 10
    • дверь багажника = 11
    • передняя левая дверь = 12
    • передняя правая дверь = 13
    • задняя левая дверь = 14
    • задняя правая дверь = 15
    • переднее левое зеркало = 16
    • переднее правое зеркало = 17

  • DESCRIPTION — описание повреждения;

  • IMAGE — фото повреждения;

  • ORIG_URL — url оригинала фотографии;

  • IMAGE_TYPE — тип фотографии. Если на фото повержения укажите DAMAGE, если что-то другое — оставьте пустым.

    Пример JSON
    "DAMAGES": {
    "DESCRIPTION": "",
    "DAMAGES_LIST": [
        {
            "PART": "",
            "DESCRIPTION": "",
            "IMAGE": {
                "ORIG_URL": "",
                "IMAGE_TYPE": ""
            }
        }
    ]
},

RESULTS

Результат осмотра.

  • REPORT_URL — url отчета (если есть).

  • PRICE_FROM — цена автомобиля минимальная, в рублях.

  • PRICE_TO — цена автомобиля максимальная, в рублях. Если сумма одна, указать в этом поле.

  • REPAIR_ESTIMATE_RESULTS — результат оценки ремонта.

    • PRICE_FROM — цена ремонта минимальная, в рублях;
    • PRICE_TO — цена ремонта максимальная, в рублях. Если сумма одна, указать в этом поле.

  • INSPECTION_DETAILS — комментарии осмотра.

  • SUMMARY — итоговое описание осмотра.

Пример JSON
"RESULTS": {
  "REPORT_URL": "https://www.report.ru/report/document/id.pdf",
  "PRICE_FROM": 600000,
  "PRICE_TO": 800000,
  "REPAIR_ESTIMATE_RESULTS": {
    "PRICE_FROM": 30000,
    "PRICE_TO": 50000
  },
  "INSPECTION_DETAILS": [""],
  "SUMMARY": ""
}
Пример

[
{
"ID": "PE0006940",
"VIN": "Z8NTBNT31CS047525",
"EVENT_TYPE": 6,
"INFO": {
"EVENT_DATE_START": "",
"EVENT_DATE": "2024-04-26",
"EVENT_REGION": "Краснодарский край",
"EVENT_CITY": "Краснодар",
"STO_ID": "1",
"STO_NAME": "Авто.ру",
"MARK": "LADA",
"MODEL": "LADA Vesta SW Cross",
"YEAR": 2021,
"IS_NEW": "",
"MILEAGE": 30000,
"RESULTS":  {
    "REPORT_URL": "https://www.report.ru/report/document/id.pdf",
    "PRICE_FROM": 600000,
    "PRICE_TO": 800000,
    "REPAIR_ESTIMATE_RESULTS": {
        "PRICE_FROM": 30000,
        "PRICE_TO": 50000
    },
    "INSPECTION_DETAILS": [""],
    "SUMMARY": ""
  },
"DAMAGES": 
{
    "DESCRIPTION": "",
    "DAMAGES_LIST": [
      {
        "PART": "",
        "DESCRIPTION": "",
        "IMAGE": {
          "ORIG_URL": "",
          "IMAGE_TYPE": ""
        }
      }
    ] 
  },
"DESCRIPTION": " Александр оценил в 1 250 000р"

}
}
]
                    


<root>
  <0>
  <ID>PE0006940</ID>
  <VIN>Z8NTBNT31CS047525</VIN>
  <EVENT_TYPE>6</EVENT_TYPE>
  <INFO>
    <EVENT_DATE_START>
    </EVENT_DATE_START>
    <EVENT_DATE>2024-04-26</EVENT_DATE>
    <EVENT_REGION>Краснодарский край</EVENT_REGION>
    <EVENT_CITY>Краснодар</EVENT_CITY>
    <STO_ID>1</STO_ID>
    <STO_NAME>Авто.ру</STO_NAME>
    <MARK>LADA</MARK>
    <MODEL>LADA Vesta SW Cross</MODEL>
    <YEAR>2021</YEAR>
    <IS_NEW>
    </IS_NEW>
    <MILEAGE>30000</MILEAGE>
    <RESULTS>
      <REPORT_URL>https://www.report.ru/report/document/id.pdf</REPORT_URL>
      <PRICE_FROM>600000</PRICE_FROM>
      <PRICE_TO>800000</PRICE_TO>
      <REPAIR_ESTIMATE_RESULTS>
        <PRICE_FROM>30000</PRICE_FROM>
        <PRICE_TO>50000</PRICE_TO>
      </REPAIR_ESTIMATE_RESULTS>
      <INSPECTION_DETAILS>
      </INSPECTION_DETAILS>
      <SUMMARY>
      </SUMMARY>
    </RESULTS>
    <DAMAGES>
      <DESCRIPTION>
      </DESCRIPTION>
      <DAMAGES_LIST>
        <PART>
        </PART>
        <DESCRIPTION>
        </DESCRIPTION>
        <IMAGE>
          <ORIG_URL>
          </ORIG_URL>
          <IMAGE_TYPE>
          </IMAGE_TYPE>
        </IMAGE>
      </DAMAGES_LIST>
    </DAMAGES>
    <DESCRIPTION> Александр оценил в 1 250 000р</DESCRIPTION>
  </INFO>
</0>
</root>
Программа сертификации — 102

Параметр

Обязательный элемент

Значение

ID

Уникальный идентификатор события из вашей базы. Например, № заказ-наряда.

VIN

VIN автомобиля.

EVENT_TYPE

Код типа события.

  • 102 – Сертификация.

INFO

Информация о событии.

PROGRAM_ACTIVE

Статус программы:

Возможные значения:

  • Активна.
  • Неактивна.

PROGRAM_ID

Уникальный id программы.

EVENT_DATE

Дата возникновения события.
Пример

[
  {
    "ID": "1",
    "VIN": "Z8NTBNT31CS047525",
    "EVENT_TYPE": 102,
    "INFO": {
      "PROGRAM_ACTIVE": true,
      "PROGRAM_ID": "auto_ru",
      "EVENT_DATE": "2023-04-26"
    }
  }
]
                    


<root>
  <0>
  <ID>1</ID>
  <VIN>Z8NTBNT31CS047525</VIN>
  <EVENT_TYPE>102</EVENT_TYPE>
  <INFO>
    <PROGRAM_ACTIVE>true</PROGRAM_ACTIVE>
    <PROGRAM_ID>auto_ru</PROGRAM_ID>
    <EVENT_DATE>2023-04-26</EVENT_DATE>
  </INFO>
</0>
</root>

Формат CSV

Примечание

CSV — менее приоритетный способ.

Название

Название файла должно соответствовать формату:

«(Название партнера)_(event_type)_(дата и время формирования файла ГГГГММДД-ЧЧММСС).csv»

Пример:DEALER_1_20191230-135025.csv

Структура и формат

Каждая запись должна обязательно начинаться тремя параметрами: VIN, ID и Event_type.

На каждый тип Event_type нужно создавать отдельный файл. Если по одному VIN-номеру несколько событий одного типа (например, вы делали оценку автомобиля несколько раз) , сделайте на каждое событие отдельную запись.

Для исправления информации отправьте запись с тем же VIN, ID, EVENT_TYPE и корректными данными в остальных полях. Для удаления — остальные поля оставьте пустыми.

Пример

ID

VIN

EVENT_TYPE

EVENT_DATE

EVENT_REGION

EVENT_CITY

STO_ID

STO_NAME

MARK

MODEL

YEAR

MILEAGE

AMOUNT

CURRENCY

IS_PLANNED

TYPE

DESCRIPTION

RECOMMENDATIONS

WORK

PRODUCTS

CLIENT_TYPE

AMV0378172

X4XYB81160D247134

2

Правила формата csv:

  • парметры передаются в первой строчке и выделяются кавычками;
  • значения параметров передаются под первой строкой и выделяются кавычками;
  • точка с запятой ; разделяет значения параметров;
  • символ переноса строки разделяет строки;
  • на месте отсутствующих значений ничего не передается (пропускать через разделитель). Структуру можно менять, т.е. не передавать пустые поля;
  • для списков (запчастей, услуг) используйте двоеточие и восклицательный знак :!. В строке не может быть такого символа кроме как для разделения элементов.

Список параметров для каждого типа события:

Продажа – 1

Параметр

Значение

VIN

VIN-номер автомобиля

ID

Уникальный идентификатор события из вашей базы. Например, № заказ-наряда.

EVENT_TYPE

Код типа события.

  • 1 – Продажа.

EVENT_DATE_START

Дата начала события в формате ГГГГ-ММ-ДД.

EVENT_DATE

Дата окончания события в формате ГГГГ-ММ-ДД.

EVENT_REGION

Регион события.

EVENT_CITY

Город события.

STO_ID

Уникальный идентификатор точки. Например, ДЦ, в котором было совершено событие.

STO_NAME

Название точки. Например ДЦ.

MARK

Марка автомобиля.

MODEL

Модель автомобиля.

YEAR

Год выпуска автомобиля.

IS_NEW

Тип автомбиля.

Возможные значения:

  • 1 – новый;
  • 0 — с пробегом.

MILEAGE

Пробег автомобиля. Только для авто с пробегом.

AMOUNT

Сумма сделки.

CURRENCY

Валюта сделки.

Возможнные значения:

  • rub;
  • usd;
  • eur.

Если поле передано пустым, мы укажим значние rub.

IS_CREDIT

В кредит.

Возможные значения:

  • 1 — да
  • 0 — нет.

CLIENT_TYPE

Тип клиента.

Возможные значения:

  • 0 — частное лицо;
  • 1 — юридическое лицо, занимающиеся сдачей авто в аренду.

SELLER_TYPE

Тип продавца. Обязательно только для втомобилей с пробегом.

Возможные значения:

  • 0 — частное лицо;
  • 1 — юридическое лицо, занимающиеся сдачей авто в аренду.
Ремонт, обслуживание — 2

Параметр

Значение

VIN

VIN-номер автомобиля.

ID

Уникальный идентификатор события из вашей базы. Например, № заказ-наряда.

EVENT_TYPE

Код типа события.

  • 2 – Ремонт, обслуживание.

EVENT_DATE_START

Дата начала события в формате ГГГГ-ММ-ДД.

EVENT_DATE

Дата окончания события в формате ГГГГ-ММ-ДД.

EVENT_REGION

Регион события.

EVENT_CITY

Город события.

STO_ID

Уникальный идентификатор точки. Например, ДЦ, в котором было совершено событие.

STO_NAME

Название точки. Например ДЦ.

MARK

Марка автомобиля.

MODEL

Модель автомобиля.

YEAR

Год выпуска автомобиля.

MILEAGE

Пробег автомобиля. Только для авто с пробегом.

AMOUNT

Сумма сделки.

CURRENCY

Валюта сделки.

Возможнные значения:

  • rub;
  • usd;
  • eur.

Если поле передано пустым, мы укажим значние rub.

IS_PLANNED

Тип обслуживания.

Возможные значения:

  • 1 — плановое;
  • 0 — внеплановое.

TYPE

Тип ремонта.

Возможные значения:

  • guaranty — ремонт по гарантии;
  • body_insurance — кузовной ремонт за счет страховой;
  • ordinary_insurance — текущий ремонт за счет страховой;
  • body_paid — кузовной ремонт за свой счет;
  • ordinary_paid — текущий ремонт за свой счет;
  • ordinary_dealer — текущий ремонт за счет дилерского центра или автосервиса;
  • regulation — регламентное ТО.

RECOMMENDATION

Список рекомендаций, выданный по заказ-наряду.

WORKS

Список услуг заказ-наряда / события.

PRODUCTS

Список товаров, запчастей заказ-наряда / события.

CLIENT_TYPE

Тип клиента.

Возможные значения:

  • 0 — частное лицо;
  • 1 — юридическое лицо, занимающиеся сдачей авто в аренду.
Страховка — 5

Параметр

Значение

VIN

VIN-номер автомобиля

ID

Уникальный идентификатор события из вашей базы. Например, № заказ-наряда.

EVENT_TYPE

Код типа события.

  • 5 – Страховка.

EVENT_DATE_START

Дата начала события в формате ГГГГ-ММ-ДД.

EVENT_DATE

Дата окончания события в формате ГГГГ-ММ-ДД.

EVENT_REGION

Регион события.

EVENT_CITY

Город события.

STO_ID

Уникальный идентификатор точки. Например, ДЦ, в котором было совершено событие.

STO_NAME

Название точки. Например ДЦ.

MARK

Марка автомобиля.

MODEL

Модель автомобиля.

YEAR

Год выпуска автомобиля.

MILEAGE

Пробег автомобиля. Только для авто с пробегом.

AMOUNT

Сумма сделки.

CURRENCY

Валюта сделки.

Возможнные значения:

  • rub;
  • usd;
  • eur.

Если поле передано пустым, мы укажим значние rub.

INSURANCE_START

Дата начала действия страховки в формате ГГГГ-ММ-ДД.

INSURANCE_END

Дата окончания действия страховки в формате ГГГГ-ММ-ДД.

INSURANCE_TYPE

Тип страховки.

Возможные значения:

  • 0 — КАСКО;
  • 1 — ОСАГО;
  • 2 — другое.

CLIENT_TYPE

Тип клиента.

Возможные значения:

  • 0 — частное лицо;
  • 1 — юридическое лицо, занимающиеся сдачей авто в аренду.
Оценка — 6

Параметр

Значение

VIN

VIN-номер автомобиля

ID

Уникальный идентификатор события из вашей базы. Например, № заказ-наряда.

EVENT_TYPE

Код типа события.

Оценка — 6.

EVENT_DATE_START

Дата начала события в формате ГГГГ-ММ-ДД.

EVENT_DATE

Дата окончания события в формате ГГГГ-ММ-ДД.

EVENT_REGION

Регион события.

EVENT_CITY

Город события.

STO_ID

Уникальный идентификатор точки. Например, ДЦ, в котором было совершено событие.

STO_NAME

Название точки. Например ДЦ.

MARK

Марка автомобиля.

MODEL

Модель автомобиля.

YEAR

Год выпуска автомобиля.

MILEAGE

Пробег автомобиля. Только для авто с пробегом.

IMAGES_ORIG_URL

Url оригинала фотографии.

VIDEOS_URL

Url оригинала видео.

PRICE_FROM

Цена автомобиля минимальная в рублях.

PRICE_TO

Цена автомобиля максимальная в рублях.

DAMAGES_DESCRIPTION

Описание повреждений.

REPAIR_PRICE_FROM

Цена ремонта минимальная в рублях.

REPAIR_PRICE_TO

Цена ремонта максимальная в рублях. Если цена одна, указать в этом поле.

REPORT_URL

Url отчета (при наличии).

SUMMARY

Итоговое описание осмотра.

Интеграция по API

Примечание

Интеграция по API — менее приоритетный способ.

Правила передачи данных

  • Способ передачи данных: HTTP API.
  • Формат передачи данных: JSON / XML.
  • Отказоустойчивость сервиса партнера: 95%.
  • Скорость обработки запроса: не более 1 секунды.

Входящие данные

  • username - логин
  • password— пароль
  • VIN — VIN или FRAME автомобиля
  • dealer_id — id личного кабинета дилер.

Исходящие параметры

Ответ API

Параметр

Значение

VIN

VIN-номер автомобиля, по которому был запрос.

SUCCESS

Успешность запроса.

ERROR_DESCRIPTIONE

Описание ошибки, в случае неуспешного запроса.

SALE — продажа

Параметр

Обязательный элемент

Значение

ID

Уникальный идентификатор события из вашей базы. Например, № заказ-наряда.

VIN

VIN автомобиля.

EVENT_TYPE

Код типа события.

  • 1 – Продажа.

INFO

Информация о событии.

EVENT_DATE_START

Дата начала события в формате ГГГГ-ММ-ДД.

EVENT_DATE

Дата окончания события в формате ГГГГ-ММ-ДД.

EVENT_REGION

Регион события.

EVENT_CITY

Город события.

STO_ID

Уникальный идентификатор точки. Например, ДЦ, в котором было совершено событие.

STO_NAME

Название точки. Например, ДЦ.

MARK

Марка автомобиля.

MODEL

Модель автомобиля.

YEAR

Год выпуска автомобиля.

AMOUNT

Сумма сделки.

CURRENCY

Валюта сделки.

Возможнные значения:

  • rub;
  • usd;
  • eur.

Если поле передано пустым, мы укажим значние rub.

IS_CREDIT

В кредит.

Возможные значения:

  • 1 — да
  • 0 — нет.

MILEAGE

Пробег автомобиля. Только для авто с пробегом.

CLIENT_TYPE

Тип клиента.

Возможные значения:

  • 0 — частное лицо;
  • 1 — юридическое лицо, занимающиеся сдачей авто в аренду.

SELLER_TYPE

Тип продавца. Обязательно только для автомобилей с пробегом.

Возможные значения:

  • 0 — частное лицо;
  • 1 — юридическое лицо, занимающиеся сдачей авто в аренду.

REPAIR — ремонт

Параметр

Обязательный элемент

Значение

ID

Уникальный идентификатор события из вашей базы. Например, № заказ-наряда.

VIN

VIN автомобиля.

EVENT_TYPE

Код типа события.

  • 2 – Ремонт, обслуживание.

INFO

Информация о событии.

EVENT_DATE_START

Дата начала события в формате ГГГГ-ММ-ДД.

EVENT_DATE

Дата окончания события в формате ГГГГ-ММ-ДД.

EVENT_REGION

Регион события.

EVENT_CITY

Город события.

STO_ID

Уникальный идентификатор точки. Например, ДЦ, в которой было совершено событие.

STO_NAME

Название точки. Например, ДЦ.

MARK

Марка автомобиля.

MODEL

Модель автомобиля.

YEAR

Год выпуска автомобиля.

MILEAGE

Пробег автомобиля. Только для авто с пробегом.

AMOUNT

Сумма сделки.

CURRENCY

Валюта сделки.

Возможнные значения:

  • rub;
  • usd;
  • eur.

Если поле передано пустым, мы укажим значние rub.

IS_PLANNED

Тип обслуживания.

Возможные значения:

  • 1 — плановое;
  • 0 — внеплановое.

TYPE

Тип ремонта.

Возможные значения:

  • guaranty — ремонт по гарантии;
  • body_insurance — кузовной ремонт за счет страховой;
  • ordinary_insurance — текущий ремонт за счет страховой;
  • body_paid — кузовной ремонт за свой счет;
  • ordinary_paid — текущий ремонт за свой счет;
  • ordinary_dealer — текущий ремонт за счет дилерского центра или автосервиса;
  • regulation — регламентное ТО.

DESCRIPTION

Описание ремонта.

RECOMMENDATIONS

Список рекомендаций, выданный по заказ-наряду.

Каждую рекомендацию размещайте отдельно внутри массива.

Пример JSON
"RECOMMENDATIONS": [
    "Требуется заменить втулки переднего стабилизатора",
    "ТО через 5000 км",
    "Замена масла АКПП"
],
Пример XML
<RECOMMENDATIONS>
  <RECOMMENDATION>Требуется заменить втулки переднего стабилизатора</RECOMMENDATION>
  <RECOMMENDATION>ТО через 5000 км</RECOMMENDATION>
  <RECOMMENDATION>Замена масла АКПП</RECOMMENDATION>
</RECOMMENDATIONS>

WORKS

Список работ по заказ-наряду.

Каждую работу размещайте отдельно внутри массива с дополнительными параметрами:

  • NAME — название работы;
  • HOUR — время, затраченное на работу;
  • COST — стоимость услуги;
  • CURRENCY — валюта сделки. Возможнные значения: rub; usd; eur. Если поле передано пустым, мы укажим значние rub.
Пример JSON
"WORKS": [
    {
        "NAME": "Замена передних тормозных дисков",
        "HOUR": 2,
        "COST": 4000,
        "CURRENCY": "rub"
    },
    {
        "NAME": "Замена задних тормозных колодок",
        "HOUR": 1,
        "COST": 4000,
        "CURRENCY": "rub"
    }
]
Пример XML
<WORKS>
  <WORK>
    <NAME>Замена передних тормозных дисков</NAME>
    <HOUR>2</HOUR>
    <COST>4000</COST>
    <CURRENCY>rub</CURRENCY>
  </WORK>
  <WORK>
    <NAME>Замена задних тормозных колодок</NAME>
    <HOUR>1</HOUR>
    <COST>4000</COST>
    <CURRENCY>rub</CURRENCY>
  </WORK>
</WORKS>

PRODUCTS

Список товаров и запчастей по заказ-наряду, событию.

Каждую работу размещайте отдельно внутри массива с дополнительными параметрами:

  • NAME – название товара;
  • BRAND — бренд товара;
  • COUNT — количество товара;
  • COST — стоимость товара.
Пример JSON
"PRODUCTS": [
    {
        "NAME": "Тормозной диск F-серия",
        "BRAND": "MILES",
        "COUNT": 2,
        "COST": 4500
    },
    {
        "NAME": "Тормозной диск",
        "BRAND": "BMW",
        "COUNT": 2,
        "COST": 8500
    },
    {
        "NAME": "Датчик износа тормозных накладок F01,02,04",
        "COUNT": 1,
        "COST": 2500
    }
]
Пример XML
<PRODUCTS>
  <PRODUCT>
    <NAME>Тормозной диск F-серия</NAME>
    <BRAND>MILES</BRAND>
    <COUNT>2</COUNT>
    <COST>4500</COST>
  </PRODUCT>
  <PRODUCT>
    <NAME>Тормозной диск</NAME>
    <BRAND>BMW</BRAND>
    <COUNT>2</COUNT>
    <COST>8500</COST>
  </PRODUCT>
  <PRODUCT>
    <NAME>Датчик износа тормозных накладок F01,02,04</NAME>
    <COUNT>1</COUNT>
    <COST>2500</COST>
  </PRODUCT>
</PRODUCTS>

CLIENT_TYPE

Тип клиента.

Возможные значения:

  • 0 — частное лицо;
  • 1 — юридическое лицо, занимающиеся сдачей авто в аренду.

INSURANCE — страховка

Параметр

Обязательный элемент

Значение

ID

Уникальный идентификатор события из вашей базы. Например, № заказ-наряда.

VIN

VIN автомобиля

EVENT_TYPE

Код типа события.

  • 5 – Страховка.

INFO

Информация о событии.

EVENT_DATE_START

Дата начала события в формате ГГГГ-ММ-ДД.

EVENT_DATE

Дата окончания события в формате ГГГГ-ММ-ДД.

EVENT_REGION

Регион события.

EVENT_CITY

Город события.

STO_ID

Уникальный идентификатор точки. Например, ДЦ, в котором было совершено событие.

STO_NAME

Название точки. Например, ДЦ.

MARK

Марка автомобиля.

MODEL

Модель автомобиля.

YEAR

Год выпуска автомобиля.

MILEAGE

Пробег автомобиля. Только для авто с пробегом.

INSURANCE_START

Дата начала действия страховки в формате ГГГГ-ММ-ДД.

INSURANCE_END

Дата окончания действия страховки в формате ГГГГ-ММ-ДД.

INSURANCE_TYPE

Тип страховки.

Возможные значения:

  • 0 — КАСКО;
  • 1 — ОСАГО;
  • 2 — другое.

INSURANCE_NAME

Только если указано INSURANCE_TYPE  — 2 (другое).

CLIENT_TYPE

Тип клиента.

Возможные значения:

  • 0 — частное лицо;
  • 1 — юридическое лицо, занимающиеся сдачей авто в аренду.

COST — оценка

Параметр

Обязательный элемент

Значение

ID

Уникальный идентификатор события из вашей базы. Например, № заказ-наряда.

VIN

VIN автомобиля

EVENT_TYPE

Код типа события.

  • 6 – Оценка.

INFO

Информация о событии.

EVENT_DATE_START

Дата начала события в формате ГГГГ-ММ-ДД.

EVENT_DATE

Дата окончания события в формате ГГГГ-ММ-ДД.

EVENT_REGION

Регион события.

EVENT_CITY

Город события.

STO_ID

Уникальный идентификатор точки. Например, ДЦ, в котором было совершено событие.

STO_NAME

Название точки. Например ДЦ.

MARK

Марка автомобиля.

MODEL

Модель автомобиля.

YEAR

Год выпуска автомобиля.

IS_NEW

Тип автомбиля.

Возможные значения:

  • 1 – новый;
  • 0 — с пробегом.

MILEAGE

Пробег автомобиля. Только для авто с пробегом.

IMAGES

Фотографии осмотра.

Каждый снимок передатся двумя параметрами:

  • ORIG_URL —url оригинала фотографии;
  • IMAGE_TYPE — тип фотографии. Если на фото повержения укажите DAMAGE, если что-то другое — оставьте пустым.
Пример JSON
"IMAGES": [
  {
    "ORIG_URL": "https://...",
    "IMAGE_TYPE": "DAMAGE"
  }
]

VIDEOS

Видео осмотра.

  • URL — ссылка на оригинал видео;
  • VIDEO_TYPE — тип видео. Если на видео есть повреждения укажите DAMAGE, если нет — оставьте пустым.
Пример JSON
"VIDEOS": [
  {
    "URL": "https://..",
    "VIDEO_TYPE": "DAMAGE"
  }
]

DAMAGES

Комлексное описание поверждения.

DESCRIPTION — общее описание.

Массив DAMAGES_LIST внутри которого:

  • PART – код повреждения авто.

    Варианты кодов
    • неизвестная деталь автомобиля = 0
    • передний бампер = 2
    • задний бампер = 3
    • переднее левое крыло = 4
    • переднее правое крыло = 5
    • заднее левое крыло = 6
    • заднее правое крыло = 7
    • крыша = 8
    • капот = 9
    • стекло = 10
    • дверь багажника = 11
    • передняя левая дверь = 12
    • передняя правая дверь = 13
    • задняя левая дверь = 14
    • задняя правая дверь = 15
    • переднее левое зеркало = 16
    • переднее правое зеркало = 17

  • DESCRIPTION — описание повреждения;

  • IMAGE — фото повреждения;

  • ORIG_URL — url оригинала фотографии;

  • IMAGE_TYPE — тип фотографии. Если на фото повержения укажите DAMAGE, если что-то другое — оставьте пустым.

    Пример JSON
    "DAMAGES": {
    "DESCRIPTION": "",
    "DAMAGES_LIST": [
        {
            "PART": "",
            "DESCRIPTION": "",
            "IMAGE": {
                "ORIG_URL": "",
                "IMAGE_TYPE": ""
            }
        }
    ]
},

RESULTS

Результат осмотра.

  • REPORT_URL — url отчета (если есть).

  • PRICE_FROM — цена автомобиля минимальная, в рублях.

  • PRICE_TO — цена автомобиля максимальная, в рублях. Если сумма одна, указать в этом поле.

  • REPAIR_ESTIMATE_RESULTS — результат оценки ремонта.

    • PRICE_FROM — цена ремонта минимальная, в рублях;
    • PRICE_TO — цена ремонта максимальная, в рублях. Если сумма одна, указать в этом поле.

  • INSPECTION_DETAILS — комментарии осмотра.

  • SUMMARY — итоговое описание осмотра.

Пример JSON
"RESULTS": {
  "REPORT_URL": "https://www.report.ru/report/document/id.pdf",
  "PRICE_FROM": 600000,
  "PRICE_TO": 800000,
  "REPAIR_ESTIMATE_RESULTS": {
    "PRICE_FROM": 30000,
    "PRICE_TO": 50000
  },
  "INSPECTION_DETAILS": [""],
  "SUMMARY": ""
}

Правовые документы

Полезные ссылки

Социальные сети
Предыдущая
Условия программы лояльности Проверенный дилер
Следующая
Расчет стоимости ремонта