Интеграция с помощью 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 |
Нет |
Маржа в рублях |