Интеграция с помощью 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

Да

Тип взаимоотношений с владельцем автомобиля:

  • tradein – trade-in, (обмен на новый или б/у авто);
  • tradeinnew – trade-in на новый (обмен на новый авто);
  • tradeinused – trade-in на б/у (обмен на авто с пробегом);
  • commission – комиссия;
  • buyout – выкуп;
  • internalpark – внутренний парк (продажа авто из внутреннего парка).

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-кода.

Список возможных значений:

  • pc — Легковой;
  • lcv — Легкий коммерческий.

По умолчанию используется значение расшифрованное из VIN или «Легковой».

body

Нет

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

Список возможных значений:

  • sed — седан;
  • hatch — хетчбеэк;
  • wag — универсал;
  • off — внедорожник / кроссовер;
  • pick — пикап;
  • coupe — купе;
  • conv — кабриолет;
  • miniwan — минивэн;
  • minibus — микроавтобус;
  • limousine — лимузин;
  • cargovan — фургон;
  • chassis — шасси;
  • fbtruck — борт.

Желательно указывать, так как не всегда расшифровывается из VIN.

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

doors

Нет

Количество дверей указывается только для внедорожников и хетчбэков. Число – желательно указывать, так как не всегда расшифровывается из VIN.

gear

Нет

Тип коробки передач:

  • mt — механическая;
  • at — автоматическая;
  • cvt — вариатор;
  • amt — робот.

Желательно указывать, так как не всегда расшифровывается из VIN.

drive

Нет

Тип привода:

  • rwd — задний привод;
  • fwd — передний привод;
  • awd — полный привод.

Желательно указывать, так как не всегда расшифровывается из VIN.

engine

Нет

Тип двигателя:

  • petrol — бензин;
  • diesel — дизель;
  • electric — электро;
  • gas — газ;
  • hybrid — гибрид.

Желательно указывать, так как не всегда расшифровывается из VIN.

volume

Нет

Объем двигателя в литрах. Число в формате «9.9».

Желательно указывать, так как не всегда расшифровывается из VIN.

power

Нет

Мощность двигателя в лошадиных силах.

Желательно указывать, так как не всегда расшифровывается из VIN.

color

Нет

Цвет автомобиля:

  • черный — black;
  • серый — gray;
  • серебряный — silver;
  • белый — white;
  • бежевый — beige;
  • желтый — yellow;
  • золотой — gold;
  • оранжевый — orange;
  • коричневый — brown;
  • красный — red;
  • розовый — pink;
  • фиолетовый — violet;
  • пурпурный — purple;
  • синий — blue;
  • голубой — skyblue;
  • зеленый — green.

wheel

Нет

Расположение руля:

  • left — левый руль;
  • right — правый руль.

Желательно указывать, если руль — правый. По умолчанию используется значение расшифрованное из VIN или «левый».

inChannel

Нет

Канал поступления авто на оценку:

  • new — продажа новых;
  • used — продажа б/у;
  • incalls — входящие звонки;
  • pedestrian — пешеходы;
  • outcalls — исходящие звонки;
  • offers — объявления;
  • nternetrequest — интернет-запрос;
  • internalpark — внутренний парк;
  • corppark – корпоративный парк;
  • service — сервис;
  • fi — FI;
  • painter — МКЦ;
  • commission — комиссия;
  • directbuyback — прямой выкуп;
  • urgentbuyback — срочный выкуп;
  • distributorspark – парк дистрибьютора;
  • auction – аукцион;
  • buyoutoutdoors – выкуп выезд;
  • buyoutindoors – выкуп в салоне;
  • buyoutfromsecondhanddealer – выкуп у перекупа.

vehicleState

Нет

Состояние автомобиля:

  • excellent — отличное;
  • good — хорошее;
  • average — среднее;
  • bad — плохое;
  • broken — битый.

diagnosticOrder

Нет

Номер заказ-наряда на проведение диагностике при оценке, строка до 30 символов

isByPhone

Нет

Оценка выполнена по телефону

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

inspectedAt

Нет

Дата проведения осмотра

Формат YYYY-MM-DD%20hh:mm:ss. Например: 2018-06-05 14:25:00

ownersAmount

Нет

Количество владельцев по ПТС

Целое [1;20]

originalPts

Нет

Статус ПТС. Словарные значения:

  • original — оригинал ПТС;
  • duplicate — дубликат ПТС;
  • electron – электронный ПТС.

buyoutPrice

Нет

Цена выкупа (для выкупаемых авто) или сумма владельцу (для комиссионных) в рублях

repairCost

Нет

Стоимость ремонта и подготовки в рублях

markup

Нет

Маржа в рублях