Атрибуты авто на складе

Обязательные атрибуты для передачи авто с пробегом

Для корректной работы интеграции необходимо обязательно передавать из DMS в Авто.ру Бизнес следующие параметры:

Атрибут

Комментарий

Номер авто на складе (dmsCarId)

Номером авто на складе может быть любой идентификатор автомобиля на складе.

Требования к номеру авто на складе:

  1. Тип: строка длиной до 60 символов. Может содержать любые символы, включая цифры, латинский и русские буквы, знаки (тире, точка и проч.).
  2. Обязательно должен быть уникальным для всех автосалонов одного клиента Авто.ру Бизнес. Это означает, что не должно быть двух разных предложений, имеющих одинаковый номер на складе.
  3. Если один и тот же автомобиль повторно ставится на склад по причине, например, повторного выкупа — он должен иметь новый номер на складе.

Статус авто на складе (stockState)

Используется в бизнес-логике Авто.ру Бизнес. Обязательно для передачи.

Дата приема на склад (arrivedAt)

Используется в бизнес-логике Авто.ру Бизнес. Обязательно для передачи.

«Дата выбытия» и «Причина выбытия» обязательны для указания для выбывших со склада авто.

Дата выбытия со склада (outAt)

Причина выбытия (outReason)

Автосалон (dealerId)

Используется в основной бизнес-логике Авто.ру Бизнес. Требуется передавать обязательно. Список автосалонов в Авто.ру Бизнес и их id можно получить методом API GET /dealers/

VIN-номер (vin) или номер кузова (bodyNumber)

Требуется Авто.ру Бизнес для сопоставления объявлений и авто на складе. Для машин с левым рулем обязательным к передаче является VIN-номер, для машин с правым рулем – номер кузова.

Необходимо передавать эти атрибуты в Авто.ру Бизнес из DMS.

Год выпуска авто (year)

Пробег (mileage)

Контракт (contractType)

Указывает на тип взаимоотношений с владельцем автомобиля.

Для корректной работы отчетов Авто.ру Бизнес как минимум требуется отличать комиссионные автомобили, от авто, находящихся в собственности.

Цена продажи (sellingPrice)

Текущая цена продажи / фактическая цена продажи (для проданных авто).

Цена выкупа (buyoutPrice)

Используется в отчетах Авто.ру Бизнес. Необходимо передавать для собственных авто. Для комиссионных авто рассчитывается автоматически.

Затраты на ремонт и подготовку (repairCost)

Используется в отчетах Авто.ру Бизнес.

Маржа, руб (markup)

Используется в отчетах Авто.ру Бизнес. Необходимо передавать для комиссионных авто. Для собственных авто рассчитывается автоматически.

Примечание

Обратите внимание, что передавать марку, модель, поколение автомобиля для автомобилей из DMS необязательно, Авто.ру Бизнес в большинстве случаев расшифровывает эти значения из VIN-кода. В том случае, если значения не расшифрованы – их можно передать в соответствующих атрибутах.

Комплектация

Список опций рекомендуется передавать из DMS в том объеме, в котором они содержатся. Отсутствующие опции в значении false передавать не нужно.

Рынок, конкуренция, перспектива продажи

Большая часть атрибутов рассчитывается автоматически в Авто.ру Бизнес, поэтому передавать их не нужно. Полный список атрибутов, которые можно получить из Авто.ру Бизнес вvDMS, содержится в документации к API.

Публикация автомобилей

Для публикации объявления о продаже авто из интерфейса Авто.ру Бизнес желательно дополнительно к обязательным параметрам передавать следующие атрибуты (при их наличии в DMS):

Атрибут

Комментарий

Тип транспортного средства (vehicleType)

Может быть расшифровано из VIN, дополнено из оценки

Марка авто (searchingBrand)

Может быть расшифровано из VIN, дополнено из оценки

Модель (searchingModel)

Может быть расшифровано из VIN, дополнено из оценки

Поколение (searchingGeneration)

Может быть расшифровано из VIN, дополнено из оценки

Цвет (color)

Может быть расшифровано из VIN, дополнено из оценки

Количество владельцев (ownersAmount)

Может быть расшифровано из VIN, дополнено из оценки

Тип кузова (body)

Может быть расшифровано из VIN, дополнено из оценки

Количество дверей (doors)

Может быть расшифровано из VIN, дополнено из оценки. Для типов кузова «Хетчбэк» и «Внедорожник» обязательно к передаче.

Коробка передач (gear)

Может быть расшифровано из VIN, дополнено из оценки

Тип двигателя (engine)

Может быть расшифровано из VIN, дополнено из оценки

Объем двигателя (volume)

Может быть расшифровано из VIN, дополнено из оценки

Мощность двигателя (power)

Может быть расшифровано из VIN, дополнено из оценки

Привод (drive)

Может быть расшифровано из VIN, дополнено из оценки

Расположение руля (wheel)

Может быть расшифровано из VIN, дополнено из оценки

Описание (description)

Описание может быть сокращено при публикации со стороны сайта (например, на avito.ru действует ограничение на количество символов)

Фотографии (photosUrls)

Поддерживается загрузка по ссылкам. Файл должен быть не менее 920 px по ширине и 700 px по высоте