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