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

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

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

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

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

Загрузка в s3

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

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

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

Прочее

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

Формат JSON и XML

Название

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

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

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

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

Файл должен быть записан в кодировке UTF-8.

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

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

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 — комментарии осмотра.
  • INSPECTION_DETAILS_EXTENDED — подробный разбор осмотра. Содержит секции проверок. Каждая секция проверок должна содержать комментарий или хотя бы 1 проверку (COMMENT или CHECKS).
    • NAME — обязательный элемент, наименование секции проверок.
    • COMMENT — комментарий к секции проверок.
    • CHECKS — пункты проверок:

      • NAME — обязательный элемент, наименование проверки.

      • STATUS — обязательный элемент, статус проверки. Возможные значения: OK, PROBLEM.

      • VALUE — состояние, в процентах от 0 до 100. В отчете отобразим красным цветом значения 0-33, оранжевым — 34-66, зеленым — 67-100.

      • SIDE — сторона автомобиля.

        Возможные значения
        • UNKNOWN_SIDE
        • LEFT
        • RIGHT
        • FRONT
        • BACK
        • FRONT_LEFT
        • FRONT_RIGHT
        • BACK_LEFT
        • BACK_RIGHT

      • COMMENT — комментарий к проверке.

  • 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": [""],
          "INSPECTION_DETAILS_EXTENDED": [
            {
              "NAME": "Заключение эксперта",
              "CHECKS": [
                {
                  "NAME": "Плюсы",
                  "STATUS": "OK",
                  "COMMENT": "Чистый, ухоженный салон, Хорошая комплектация, Один собственник"
                },
                {
                  "NAME": "Минусы",
                  "STATUS": "PROBLEM",
                  "COMMENT": "Кузов поврежден коррозией, Внешние косметические дефекты"
                }
              ]
            },
            {
              "NAME": "Рулевое управление, подвеска и тормозная система",
              "COMMENT": "Люфты в пределах нормы, износ шин равномерный",
              "CHECKS": [
                {
                  "NAME": "Остаток передних тормозных колодок",
                  "STATUS": "PROBLEM",
                  "VALUE": "45",
                  "SIDE": "FRONT"
                },
                {
                  "NAME": "Передние тормозные диски, общее состояние",
                  "COMMENT": "Рекомендуется замена",
                  "STATUS": "PROBLEM",
                  "SIDE": "FRONT"
                }
              ]
            },
            {
              "NAME": "Осмотр на подъёмнике",
              "COMMENT": "Автомобиль не осматривался на подъемнике. В случае приобретения до сделки необходимо выполнить осмотр"
            }
          ],
          "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": [""],
              "INSPECTION_DETAILS_EXTENDED": [
                {
                  "NAME": "Заключение эксперта",
                  "CHECKS": [
                    {
                      "NAME": "Плюсы",
                      "STATUS": "OK",
                      "COMMENT": "Чистый, ухоженный салон, Хорошая комплектация, Один собственник"
                    },
                    {
                      "NAME": "Минусы",
                      "STATUS": "PROBLEM",
                      "COMMENT": "Кузов поврежден коррозией, Внешние косметические дефекты"
                    }
                  ]
                },
                {
                  "NAME": "Рулевое управление, подвеска и тормозная система",
                  "COMMENT": "Люфты в пределах нормы, износ шин равномерный",
                  "CHECKS": [
                    {
                      "NAME": "Остаток передних тормозных колодок",
                      "STATUS": "PROBLEM",
                      "VALUE": "45",
                      "SIDE": "FRONT"
                    },
                    {
                      "NAME": "Передние тормозные диски, общее состояние",
                      "COMMENT": "Рекомендуется замена",
                      "STATUS": "PROBLEM",
                      "SIDE": "FRONT"
                    }
                  ]
                },
                {
                  "NAME": "Осмотр на подъёмнике",
                  "COMMENT": "Автомобиль не осматривался на подъемнике. В случае приобретения до сделки необходимо выполнить осмотр"
                }
              ],
              "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>
              <INSPECTION_DETAILS_EXTENDED>
                <CHECK_GROUP>
                    <NAME>Заключение эксперта</NAME>
                    <CHECKS>
                        <CHECK>
                            <NAME>Плюсы</NAME>
                            <STATUS>OK</STATUS>
                            <COMMENT>Чистый, ухоженный салон, Хорошая комплектация, Один собственник</COMMENT>
                        </CHECK>
                        <CHECK>
                            <NAME>Минусы</NAME>
                            <STATUS>PROBLEM</STATUS>
                            <COMMENT>Кузов поврежден коррозией, Внешние косметические дефекты</COMMENT>
                        </CHECK>
                    </CHECKS>
                </CHECK_GROUP>
                <CHECK_GROUP>
                    <NAME>Рулевое управление, подвеска и тормозная система</NAME>
                    <COMMENT>Люфты в пределах нормы, износ шин равномерный</COMMENT>
                    <CHECKS>
                        <CHECK>
                            <NAME>Остаток передних тормозных колодок</NAME>
                            <STATUS>PROBLEM</STATUS>
                            <VALUE>45</VALUE>
                            <SIDE>FRONT</SIDE>
                        </CHECK>
                        <CHECK>
                            <NAME>Передние тормозные диски, общее состояние</NAME>
                            <COMMENT>Рекомендуется замена</COMMENT>
                            <STATUS>PROBLEM</STATUS>
                            <SIDE>FRONT</SIDE>
                        </CHECK>
                    </CHECKS>
                </CHECK_GROUP>
                <CHECK_GROUP>
                    <NAME>Осмотр на подъёмнике</NAME>
                    <COMMENT>Автомобиль не осматривался на подъемнике. В случае приобретения до сделки необходимо выполнить осмотр</COMMENT>
                </CHECK_GROUP>
              </INSPECTION_DETAILS_EXTENDED>
              <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

Файл должен быть записан в кодировке UTF-8.

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

Каждая запись должна обязательно начинаться тремя параметрами: 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 — комментарии осмотра.
  • INSPECTION_DETAILS_EXTENDED — подробный разбор осмотра. Содержит секции проверок. Каждая секция проверок должна содержать комментарий или хотя бы 1 проверку (COMMENT или CHECKS).
    • NAME — обязательный элемент, наименование секции проверок.
    • COMMENT — комментарий к секции проверок.
    • CHECKS — пункты проверок:

      • NAME — обязательный элемент, наименование проверки.

      • STATUS — обязательный элемент, статус проверки. Возможные значения: OK, PROBLEM.

      • VALUE — состояние, в процентах от 0 до 100. В отчете отобразим красным цветом значения 0-33, оранжевым — 34-66, зеленым — 67-100.

      • SIDE — сторона автомобиля.

        Возможные значения
        • UNKNOWN_SIDE
        • LEFT
        • RIGHT
        • FRONT
        • BACK
        • FRONT_LEFT
        • FRONT_RIGHT
        • BACK_LEFT
        • BACK_RIGHT

      • COMMENT — комментарий к проверке.

  • 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": [""],
          "INSPECTION_DETAILS_EXTENDED": [
            {
              "NAME": "Заключение эксперта",
              "CHECKS": [
                {
                  "NAME": "Плюсы",
                  "STATUS": "OK",
                  "COMMENT": "Чистый, ухоженный салон, Хорошая комплектация, Один собственник"
                },
                {
                  "NAME": "Минусы",
                  "STATUS": "PROBLEM",
                  "COMMENT": "Кузов поврежден коррозией, Внешние косметические дефекты"
                }
              ]
            },
            {
              "NAME": "Рулевое управление, подвеска и тормозная система",
              "COMMENT": "Люфты в пределах нормы, износ шин равномерный",
              "CHECKS": [
                {
                  "NAME": "Остаток передних тормозных колодок",
                  "STATUS": "PROBLEM",
                  "VALUE": "45",
                  "SIDE": "FRONT"
                },
                {
                  "NAME": "Передние тормозные диски, общее состояние",
                  "COMMENT": "Рекомендуется замена",
                  "STATUS": "PROBLEM",
                  "SIDE": "FRONT"
                }
              ]
            },
            {
              "NAME": "Осмотр на подъёмнике",
              "COMMENT": "Автомобиль не осматривался на подъемнике. В случае приобретения до сделки необходимо выполнить осмотр"
            }
          ],
          "SUMMARY": ""
        }

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

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

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