Интеграция с помощью URL-интерфейса
Вы можете создавать или открывать ранее созданную оценку в Авто.ру Бизнес при помощи специальной ссылки (URL) с набором параметров.
Вместе с параметрами автомобиля можно передать уникальный идентификатор оценки или автомобиля из дилерской информационной системы (DMS). Этот идентификатор будет использоваться для связывания оценок или автомобилей в разных системах.
Как работает интерфейс
При получении запроса Авто.ру Бизнес пытается открыть ранее созданную оценку. Сначала поиск осуществляется по номеру автомобиля в DMS (если он передан). Если Авто.ру Бизнес не находит ничего, поиск осуществляется по номеру оценки в DMS (если он передан), а затем по VIN.
В случае если Авто.ру Бизнес находит несколько оценок, соответствующих критерию поиска, то открывается последняя созданная оценка.
Если ни один способ поиска не дал результатов — создается новая оценка, в которую сохраняются номера оценки и автомобиля из DMS, если они были переданы.
Если на вход передан параметр «action=new», то Авто.ру Бизнес всегда создает новую оценку.
При передаче VIN-кода выполняется расшифровка параметров автомобиля. Если значение, переданное через URL, отличается от расшифрованного из VIN, применяется переданное через URL.
Изменения оценки в DMS
Если через URL-интерфейс открывается ранее созданная оценка и переданные параметры отличаются от сохраненных, то Авто.ру Бизнес применяет новые переданные значения.
Пример ссылки
https://lk.cm.expert/appraisals/create?vin=XWEHN812BE0011152&year=2014&mileage=25000&body=wag&gear=at&drive=fwd&engine=petrol&volume=1.6&power=129&color=black&wheel=left
Описание параметров
|
Параметр |
Обязательный |
Описание |
|
action=new |
Нет |
Если указан, то Авто.ру Бизнес всегда создает новую оценку |
|
contractType |
Да |
Тип взаимоотношений с владельцем автомобиля:
|
|
vin |
Нет |
VIN-код автомобиля. Строка из 17 символов, соответствующая стандарту ISO. |
|
dealerId |
Да |
Идентификатор дилера, в котором должна быть создана оценка. Если идентификатор дилера не передан, по умолчанию используется идентификатор дилера предыдущей оценки. |
|
appraisal (ранее evaluation) |
Нет |
Номер оценки в DMS. Должен быть уникальным в рамках клиента. Строка длиной не более 20 символов. |
|
car |
Нет |
Номер автомобиля на складе в DMS. Должен быть уникальным в рамках клиента. Строка длиной не более 60 символов. |
|
inStock |
Нет |
Флаг принятия автомобиля на склад, в случае если авто был принят – 1, 0 – в противном случае. Данный параметр [1] проставляется автоматически в случае передачи любого параметра из двух: car, arrivedAt |
|
stockArrivedDate |
Нет |
Дата принятия на склад. Формат YYYY-MM-DD. Например, 2017-06-23 или 2016-12-01 |
|
customerFirstName |
Нет |
Имя контактного лица |
|
customerLastName |
Нет |
Фамилия контактного лица |
|
customerPhone |
Нет |
Телефон контактного лица |
|
comments |
Нет |
Комментарии по машине или оценке |
|
customerWishes |
Нет |
Комментарии по пожеланиям контактного лица |
|
customerExpectedBuyoutPrice |
Нет |
Желаемая цена выкупа автомобиля |
|
year |
Нет |
Год выпуска автомобиля. Всегда расшифровывается из VIN автоматически. |
|
mileage |
Нет |
Пробег автомобиля в километрах. Не расшифровывается из VIN. Желательно указывать. |
|
vehicleType |
Нет |
Тип транспортного средства. Значение может быть расшифровано из VIN-кода. Список возможных значений:
По умолчанию используется значение расшифрованное из VIN или «Легковой». |
|
body |
Нет |
Тип кузова автомобиля. Список возможных значений:
Желательно указывать, так как не всегда расшифровывается из VIN. Другие типы кузовов следует приводить одному из наиболее близких среди указанных здесь. |
|
doors |
Нет |
Количество дверей указывается только для внедорожников и хетчбэков. Число – желательно указывать, так как не всегда расшифровывается из VIN. |
|
gear |
Нет |
Тип коробки передач:
Желательно указывать, так как не всегда расшифровывается из VIN. |
|
drive |
Нет |
Тип привода:
Желательно указывать, так как не всегда расшифровывается из VIN. |
|
engine |
Нет |
Тип двигателя:
Желательно указывать, так как не всегда расшифровывается из VIN. |
|
volume |
Нет |
Объем двигателя в литрах. Число в формате «9.9». Желательно указывать, так как не всегда расшифровывается из VIN. |
|
power |
Нет |
Мощность двигателя в лошадиных силах. Желательно указывать, так как не всегда расшифровывается из VIN. |
|
color |
Нет |
Цвет автомобиля:
|
|
wheel |
Нет |
Расположение руля:
Желательно указывать, если руль — правый. По умолчанию используется значение расшифрованное из VIN или «левый». |
|
inChannel |
Нет |
Канал поступления авто на оценку:
|
|
vehicleState |
Нет |
Состояние автомобиля:
|
|
diagnosticOrder |
Нет |
Номер заказ-наряда на проведение диагностике при оценке, строка до 30 символов |
|
isByPhone |
Нет |
Оценка выполнена по телефону
|
|
inspectedAt |
Нет |
Дата проведения осмотра Формат YYYY-MM-DD%20hh:mm:ss. Например: 2018-06-05 14:25:00 |
|
ownersAmount |
Нет |
Количество владельцев по ПТС Целое [1;20] |
|
originalPts |
Нет |
Статус ПТС. Словарные значения:
|
|
buyoutPrice |
Нет |
Цена выкупа (для выкупаемых авто) или сумма владельцу (для комиссионных) в рублях |
|
repairCost |
Нет |
Стоимость ремонта и подготовки в рублях |
|
markup |
Нет |
Маржа в рублях |