Выбытие авто со склада

Выбытие — продажа, возврат автомобиля владельцу по комиссионному договору, либо другая причина выбытия авто со склада.

Выбывшие со склада авто не удаляются из Авто.ру Бизнес, а переводятся в статус выбывших. Это позволяет сохранить информацию об автомобиле и рынке на момент выбытия и формировать отчеты по продажам и прочим типам выбытия в Авто.ру Бизнес.

Для фиксации факта выбытия авто в Авто.ру Бизнес необходимо воспользоваться методом API PUT или PATCH /dealers/{dealerId}/dms/cars/{dmsCarId} (partSaveDmsCar), с указанием необходимых атрибутов, в том числе:

  • Статус склада (stockState) = Выбыл (out)
  • Даты выбытия (outAt) = <дата и время выбытия авто со склада>
  • Причина выбытия (outReason) = <причина выбытия>
  • Цена продажи (sellingPrice) = <фактическая цена продажи> (если авто был продан)
  • Цена продажи (sellingPrice) = <последняя установленная розничная цена> (если авто не был продан)

Метод PATCH позволяет изменять только те параметры автомобиля, которые указаны в запросе. Метод PUT, в отличие от PATCH перезаписывает все параметры автомобиля, что может привести к неверному заполнению данных об авто на складе при некорректном формировании запроса.

Предлагаем использовать следующую схему работы для передачи изменений авто:

  1. Выполнить запрос на получение авто на складе из Авто.ру Бизнес GET /dealers/{dealerId}/dms/cars/{dmsCarId} (getDmsCar) с dmsCarId.

  2. Если запрошенного автомобиля нет (получили код ответа 404), то значит его следует создать методом PUT.

  3. Если авто уже доступен в Авто.ру Бизнес (получили код ответа 200), то используем метод PATCH для отправки изменений.