Интеграция с помощью URL-интерфейса

  1. Как работает интерфейс
  2. Изменения оценки в DMS
  3. Пример ссылки
  4. Описание параметров

Вы можете создавать или открывать ранее созданную оценку в Авто.ру Бизнес при помощи специальной ссылки (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 Нет Маржа в рублях