Элементы фида и их значения

Примечание

Элементы со строго ограниченным набором значений могут содержать только перечисленные варианты. Использование других значений приведет к ошибке при обработке прайс-листа.

Информация об автомобиле

Здесь описаны основные элементы данных об автомобиле. Полный список всех элементов см. в примере XML-фида.

Элемент

Обязательный элемент

Описание

dmsCarId

Да

Уникальный идентификатор автомобиля в Авто.ру Бизнес.

dealerId

Да (если не задано dealerName)

Идентификатор автосалона в Авто.ру Бизнес.

dealerName

Да (если не задано dealerId)

Название автосалона, которое указано в Авто.ру Бизнес. Данный тег не меняет название автосалона. Если название автосалона изменится в Авто.ру Бизнес, его необходимо заменить в данном элементе фида.

vin

Да (для б/у при необходимости публикации)

VIN автомобиля.

bodyNumber

Да (при необходимости публикации и отсутствии vin)

Номер кузова.

stockState

Да (при необходимости публикации)

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

  • in – принят на склад;
  • out – выбыл со склада.

Если stockState: in и arrivedAt: null или эти параметры не заданы, то arrivedAt получит текущее значение времени на момент обработки.

vehicleType

Да (при необходимости публикации)

Тип транспортного средства:

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

searchingBrand

Строковый бренд автомобиля. Чтобы мы расшифровали значения, передайте все три тега: searchingBrand, searchingModel, year.

searchingModel

Строковая модель автомобиля. Чтобы мы расшифровали значения, передайте все три тега: searchingBrand, searchingModel, year.

searchingPseudoModel

Строковая псевдомодель автомобиля.

year

Да (для б/у при необходимости публикации)

Год производства. Чтобы мы расшифровали значения, передайте все три тега: searchingBrand, searchingModel, year.

mileage

Да (для б/у при необходимости публикации)

Пробег.

body

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

searchingGeneration

Строковое поколение автомобиля.

searchingEquipmentName

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

searchingModificationName

Строковая модификация автомобиля. Атрибут должен строго соответствовать каталогу Авто.ру.

doors

Да (при необходимости публикации)

Количество дверей.

volume

Да (при необходимости публикации)

Объем двигателя в литрах.

engine

Да (при необходимости публикации)

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

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

power

Да (при необходимости публикации)

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

color

Да (при необходимости публикации)

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

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

gear

Да (при необходимости публикации)

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

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

drive

Да (при необходимости публикации)

Тип привода:

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

wheel

Да (при необходимости публикации)

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

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

arrivedAt

Дата и время приема автомобиля на склад в формате RFC 3339.

outAt

Дата и время выбытия со склада в формате RFC 3339.

saleStatus

Да (при необходимости публикации)

Статус продажи автомобиля:

  • onsale – в продаже;
  • offsale – не в продаже.

description

Описание автомобиля для объявления о продаже.

photosUrls

Да (для б/у при необходимости публикации)

Ссылки на фотографии для стокового автомобиля. Ссылки должны быть общедоступны через интернет.

sellingPrice

Да (при необходимости публикации)

Цена продажи в рублях.

discountCredit

Скидка при покупке в кредит.

discountInsurance

Скидка при покупке страховки.

discountTradeIn

Скидка при покупке по программе Trade-in.

discountMax

Максимальная сумма скидки.

ownersAmount

Да (для б/у при необходимости публикации)

Количество владельцев.

videoUrl

Ссылка на видео (YouTube, RuTube, VK-видео).

avitoRuVideoFileUrl

Ссылка на короткое видео на Авито.

dealerSitePublicationUrl

Ссылка на сайт дилера.

isNew

Используется для определения автосалона. Если у клиента всего два автосалона с разными типами (новые автомобили и с пробегом), то можно использовать поле для указания автосалона вместо dealerId и dealerName.

Внимание

Автомобили, которые были загружены в предыдущем фиде и будут отсутствовать в текущем, получат статус «продан» с датой/временем прогрузки последнего фида.

Если вы хотите управлять статусом карточки автомобиля, можете отправлять тег <stockState>in</stockState> для автомобилей на складе или <stockState>out</stockState> для выбывших автомобилей.

Для осуществления такой настройки необходимо сообщить эту информацию вашему менеджеру проектов интеграции.

Пример XML-фида


<?xml version="1.0" encoding="UTF-8"?>
<feed>
  <version>1</version> 
  <creationDate>2023-01-01T13:30:30+03:00</creationDate>
  <email>example@ya.ru</email>
  <dmsCars>
    <dmsCar>
      <dmsCarId>S-2017-01-24-0020A</dmsCarId>
      <dealerId>14</dealerId>
      <dealerName>Автосалон</dealerName>
      <vin>JF1GDGLD36G062165</vin>
      <bodyNumber>SV30-0169266</bodyNumber>
      <deleted>false</deleted>
      <stockState>in</stockState>
      <dmsCreatedAt>2017-03-10T05:40:00+03:00</dmsCreatedAt>
      <dmsUpdatedAt>2017-03-10T05:40:00+03:00</dmsUpdatedAt>
      <dmsDeletedAt>2017-03-10T05:40:00+03:00</dmsDeletedAt>
      <vehicleType>pc</vehicleType>
      <searchingBrand>string</searchingBrand>
      <searchingModel>string</searchingModel>
      <searchingPseudoModel>string</searchingPseudoModel>
      <year>2006</year>
      <mileage>120500</mileage>
      <body>sed</body>
      <searchingGeneration>string</searchingGeneration>
      <searchingEquipmentName>string</searchingEquipmentName>
      <searchingModificationName>string</searchingModificationName>
      <doors>4</doors>
      <gear>mt</gear>
      <drive>awd</drive>
      <engine>petrol</engine>
      <volume>2.5</volume>
      <power>230</power>
      <color>silver</color>
      <wheel>left</wheel>
      <tradeInCarVin>JF1GDGLD36G062166</tradeInCarVin>
      <ptsNumber>77 ТК 123456</ptsNumber>
      <arrivedAt>2017-03-10T05:40:00+03:00</arrivedAt>
      <outAt>2017-03-10T05:40:00+03:00</outAt>
      <acceptedByCustomerAt>2017-03-10</acceptedByCustomerAt>
      <saleStatus>offsale</saleStatus>
      <returnToSaleAt>2018-03-10T05:40:00+03:00</returnToSaleAt>
      <description>Автомобиль в хорошем состоянии, боком не ездили, покрышки не жгли</description>
      <photosUrls>https://media.cm.expert/images/401e387f80aeb3dae3d1016d9480d7f3/cars/big.jpg\</photosUrls>
      <exposition>retail</exposition>
      <inChannel>new</inChannel>
      <contractType>tradeinnew</contractType>
      <certificated>true</certificated>
      <certificatedAt>2019-04-05</certificatedAt>
      <certificateNumber>458983-FRF-002</certificateNumber>
      <outReason>return</outReason>
      <saleChannel>auto.ru</saleChannel>
      <customerFirstName>Иван</customerFirstName>
      <customerLastName>Иванов</customerLastName>
      <customerMiddleName>Иванович</customerMiddleName>
      <customerPhoneNumber>79112223344</customerPhoneNumber>
      <buyoutPrice>600000</buyoutPrice>
      <repairCost>5000</repairCost>
      <markup>50000</markup>
      <sellingPrice>700000</sellingPrice>
      <discountCredit>10000</discountCredit>
      <discountInsurance>20000</discountInsurance>
      <discountTradeIn>20000</discountTradeIn>
      <discountMax>30000</discountMax>
      <recommendedRetailPrice>670000</recommendedRetailPrice>
      <pendingPrice>650000</pendingPrice>
      <pendingPriceSetById>1</pendingPriceSetById>
      <responsibleForSellingUserId>1</responsibleForSellingUserId>
      <appraisalCarId>23</appraisalCarId>
      <acceptanceDealerId>14</acceptanceDealerId>
      <salesTacticId>5</salesTacticId>
      <ownersAmount>3</ownersAmount>
      <originalPts>original</originalPts>
      <hasWarranty>false</hasWarranty>
      <extendedWarranty>string</extendedWarranty>
      <vehicleState>average</vehicleState>
      <vehicleAvailability>exists</vehicleAvailability>
      <hasNoCustoms>false</hasNoCustoms>
      <sts>99АА999999</sts>
      <videoUrl>https://www.youtube.com/watch?v=ZqxfvuCR8v5\</videoUrl>
      <spinCarUrl>https://spins.spincar.com/autopragayug/01012277\</spinCarUrl>
      <autoRuPanoramaUrl>http://autoru-panorama.s3.yandex.net/artifacts/105/422/1054220494-1589531230673-RXrwo/video_webm/n3/v1/320.webm\</autoRuPanoramaUrl>
      <autoRuExteriorPanoramaUrl>http://autoru-panorama.s3.yandex.net/artifacts/105/422/1054220494-1589531230673-RXrwo/video_webm/n3/v1/320.webm\</autoRuExteriorPanoramaUrl>
      <avitoRuVideoFileUrl> https://disk.yandex.ru/i/s0ciOIMZ-oHsqQ\ </avitoRuVideoFileUrl>
      <autoRuInteriorPanoramaUrl>http://autoru-panorama.s3.yandex.net/artifacts/105/422/1054220494-1589531230673-RXrwo/video_webm/n3/v1/320.webm\</autoRuInteriorPanoramaUrl>
      <dealerSitePublicationUrl>http://dealer-site.ru/car/offer/w03jd92spsm02kd02kdo21vm\</dealerSitePublicationUrl>
      <outReasonDescription>Клиент решил продавать самостоятельно</outReasonDescription>
      <anyCommentDescription>Комментарий</anyCommentDescription>
      <appraisedById>1</appraisedById>
      <appraisalInitializedById>1</appraisalInitializedById>
      <soldById>102</soldById>
      <customerLegalType>string</customerLegalType>
      <customerLegalName>ООО Зеленоглазое такси</customerLegalName>
      <multimedia>cddvdbluray</multimedia>
      <hasMultimediaForRearPassengers>false</hasMultimediaForRearPassengers>
      <hasVoiceControl>false</hasVoiceControl>
      <hasOnBoardComputer>false</hasOnBoardComputer>
      <climate>cc1zone</climate>
      <wheelAdjusting>height</wheelAdjusting>
      <seatsHeat>all</seatsHeat>
      <electricWindows>all</electricWindows>
      <hasCruiseControl>false</hasCruiseControl>
      <hasAdaptiveCruiseControls>false</hasAdaptiveCruiseControls>
      <hasActivePowerSteering>false</hasActivePowerSteering>
      <hasTirePressureSensor>false</hasTirePressureSensor>
      <hasRemoteStartEngine>false</hasRemoteStartEngine>
      <hasStartEngineButton>false</hasStartEngineButton>
      <hasCamera360>false</hasCamera360>
      <hasCameraRear>false</hasCameraRear>
      <hasCoolingGloveBox>false</hasCoolingGloveBox>
      <hasParkSensorRear>false</hasParkSensorRear>
      <hasParkSensorFront>false</hasParkSensorFront>
      <hasProgrammablePrestartHeater>false</hasProgrammablePrestartHeater>
      <driverSeatAdjusting>manual</driverSeatAdjusting>
      <passengerSeatAdjusting>manual</passengerSeatAdjusting>
      <rearSeatAdjusting>electro</rearSeatAdjusting>
      <hasAdjustablePedals>false</hasAdjustablePedals>
      <hasAutoParkingSystem>false</hasAutoParkingSystem>
      <hasKeylessAccess>false</hasKeylessAccess>
      <hasStartStopSystem>false</hasStartStopSystem>
      <hasSunshadeCurtainRearWindow>false</hasSunshadeCurtainRearWindow>
      <hasSunshadeCurtainRearDoors>false</hasSunshadeCurtainRearDoors>
      <hasTintedWindows>false</hasTintedWindows>
      <hasPowerSteering>false</hasPowerSteering>
      <hasWheelElectricSteering>false</hasWheelElectricSteering>
      <hasElectricTrunk>false</hasElectricTrunk>
      <hasAbs>false</hasAbs>
      <hasEsp>false</hasEsp>
      <hasIsofix>false</hasIsofix>
      <hasTcs>false</hasTcs>
      <hasRearDoorsLocking>false</hasRearDoorsLocking>
      <hasDriverFatigueSensor>false</hasDriverFatigueSensor>
      <hasLaminatedSideWindows>false</hasLaminatedSideWindows>
      <hasAirbagFront>false</hasAirbagFront>
      <hasAirbagKnee>false</hasAirbagKnee>
      <hasAirbagPassengerFront>false</hasAirbagPassengerFront>
      <hasAirbagSide>false</hasAirbagSide>
      <hasAirbagRearSide>false</hasAirbagRearSide>
      <hasAirbagWindow>false</hasAirbagWindow>
      <hasLaneControlSystem>false</hasLaneControlSystem>
      <hasBlindAreaControlSystem>false</hasBlindAreaControlSystem>
      <hasNightVisionSystem>false</hasNightVisionSystem>
      <hasHillStartAssist>false</hasHillStartAssist>
      <hasCollisionAvoidanceSystem>false</hasCollisionAvoidanceSystem>
      <hasTrafficSignRecognition>false</hasTrafficSignRecognition>
      <headLightType>xenon</headLightType>
      <hasLightAutoCorrection>false</hasLightAutoCorrection>
      <hasRainSensor>false</hasRainSensor>
      <hasLightSensor>false</hasLightSensor>
      <hasHeatesMirrors>false</hasHeatesMirrors>
      <hasHeadLightWasher>false</hasHeadLightWasher>
      <hasFogLights>false</hasFogLights>
      <hasAdvancedFrontLightingInTurnSystem>false</hasAdvancedFrontLightingInTurnSystem>
      <hasAdvancedFrontLightingSystem>false</hasAdvancedFrontLightingSystem>
      <hasWiperHeatingZone>false</hasWiperHeatingZone>
      <hasHeatedWindscreen>false</hasHeatedWindscreen>
      <hasHeatedWiperSprayers>false</hasHeatedWiperSprayers>
      <hasElectricMirrors>false</hasElectricMirrors>
      <hasAutoMirrorsFold>false</hasAutoMirrorsFold>
      <wheelRimType>steel</wheelRimType>
      <wheelRimDiameter>20</wheelRimDiameter>
      <hasAerography>false</hasAerography>
      <hasDecorativeMoldings>false</hasDecorativeMoldings>
      <hasCrankcaseProtection>false</hasCrankcaseProtection>
      <hasPneumaticSuspension>false</hasPneumaticSuspension>
      <hasRoofRails>false</hasRoofRails>
      <hasTrailerHook>false</hasTrailerHook>
      <hasCentralLock>false</hasCentralLock>
      <hasOemImmobiliser>false</hasOemImmobiliser>
      <hasAftermarketImmobiliser>false</hasAftermarketImmobiliser>
      <alarm>common</alarm>
      <hasAlarmWithRollingCode>false</hasAlarmWithRollingCode>
      <hasIntrusionSensor>false</hasIntrusionSensor>
      <salon>velor</salon>
      <hasAluminumPedalPads>false</hasAluminumPedalPads>
      <hasFrontSeatsVentilation>false</hasFrontSeatsVentilation>
      <sunroof>common</sunroof>
      <hasPanoramicRoof>false</hasPanoramicRoof>
      <hasDoorSillPlates>false</hasDoorSillPlates>
      <hasSteeringWheelHeater>false</hasSteeringWheelHeater>
      <hasLeatherSteeringWheel>false</hasLeatherSteeringWheel>
      <hasLeatherGearShift>false</hasLeatherGearShift>
      <hasFrontCenterArmrest>false</hasFrontCenterArmrest>
      <hasGearShiftPaddles>false</hasGearShiftPaddles>
      <salonTone>lightstyle</salonTone>
      <hasFoldingTableOnFrontSeats>false</hasFoldingTableOnFrontSeats>
      <hasFoldingTableOnRearSeats>false</hasFoldingTableOnRearSeats>
      <hasFrontSportSeats>false</hasFrontSportSeats>
      <hasThirdRearHeadrest>false</hasThirdRearHeadrest>
      <hasThirdRowSeats>false</hasThirdRowSeats>
      <hasFoldingRearSeats>false</hasFoldingRearSeats>
      <armored>false</armored>
      <hasAutoGasEquipment>false</hasAutoGasEquipment>
      <hasAudioSystem>false</hasAudioSystem>
      <hasAudioSystemHiFi>false</hasAudioSystemHiFi>
      <hasWirelessCharging>false</hasWirelessCharging>
      <hasNavigation>false</hasNavigation>
      <hasSocket12V>false</hasSocket12V>
      <hasSocket220V>false</hasSocket220V>
      <hasYandexAuto>false</hasYandexAuto>
      <hasAndroidAuto>false</hasAndroidAuto>
      <hasAux>false</hasAux>
      <hasBluetooth>false</hasBluetooth>
      <hasAppleCarPlay>false</hasAppleCarPlay>
      <hasTvOrVideo>false</hasTvOrVideo>
      <hasUSB>false</hasUSB>
      <hasAudioPreparation>false</hasAudioPreparation>
      <hasFrontSeatUpdown>false</hasFrontSeatUpdown>
      <hasDriverSeatUpdown>false</hasDriverSeatUpdown>
      <hasRearSeatElectro>false</hasRearSeatElectro>
      <hasWheelMemory>false</hasWheelMemory>
      <hasMultiWheel>false</hasMultiWheel>
      <hasElectronicDashboard>false</hasElectronicDashboard>
      <hasCameraFront>false</hasCameraFront>
      <hasEasyTrunkOpening>false</hasEasyTrunkOpening>
      <hasAshtrayAndCigaretteLighter>false</hasAshtrayAndCigaretteLighter>
      <hasProjectionDisplay>false</hasProjectionDisplay>
      <hasDoorCloser>false</hasDoorCloser>
      <hasIsofixFront>false</hasIsofixFront>
      <hasGlonass>false</hasGlonass>
      <hasBAS>false</hasBAS>
      <hasHighBeamAssist>false</hasHighBeamAssist>
      <hasAlarm>false</hasAlarm>
      <hasBlackRoof>false</hasBlackRoof>
      <hasRearSeatVent>false</hasRearSeatVent>
      <hasSunroof>false</hasSunroof>
      <hasDecorativeInteriorLighting>false</hasDecorativeInteriorLighting>
      <hasMassageSeats>false</hasMassageSeats>
      <hasSuspensionActive>false</hasSuspensionActive>
      <hasSuspensionSport>false</hasSuspensionSport>
      <hasSpareMini>false</hasSpareMini>
      <hasSpareFullSize>false</hasSpareFullSize>
      <registrationPlateNumber>А0345УЕ98</registrationPlateNumber>
      <revenueCredit>5000</revenueCredit>
      <revenueInsurance>5000</revenueInsurance>
      <revenueOtherFinanceInsurance>5000</revenueOtherFinanceInsurance>
      <revenueUpsale>5000</revenueUpsale>
      <revenueServices>5000</revenueServices>
      <costUpsale>5000</costUpsale>
      <costServices>5000</costServices>
      <costGift>5000</costGift>
      <costCalltracking>5000</costCalltracking>
      <costMarketing>5000</costMarketing>
      <costLoan>5000</costLoan>
      <costStorage>5000</costStorage>
      <factDiscountCredit>5000</factDiscountCredit>
      <factDiscountTradein>5000</factDiscountTradein>
      <factDiscountInsurance>5000</factDiscountInsurance>
      <factDiscountUpsale>5000</factDiscountUpsale>
      <factDiscountServices>5000</factDiscountServices>
      <factDiscountBargain>5000</factDiscountBargain>
      <factDiscountOther>5000</factDiscountOther>
      <factDiscountComment>Комментарий о причине фактической скидки</factDiscountComment>
      <isAbleToSellWithVat>true</isAbleToSellWithVat>
      <isForCustomerFromUka>true</isForCustomerFromUka>
      <withoutMileageInRu>false</withoutMileageInRu>
      <soldByTradein>false</soldByTradein>
      <saleWithDiscount>false</saleWithDiscount>
      <tradeinDiscount>100000</tradeinDiscount>
      <discountAmount>100000</discountAmount>
      <isLoan>false</isLoan>
      <distributorRefusedAward>false</distributorRefusedAward>
      <registeredInRu>false</registeredInRu>
      <certificationProgram>hpromise</certificationProgram>
      <keyNumber>С317ЕЕ98</keyNumber>
      <parkingSpot>3 эт, 25/17</parkingSpot>
      <isNew>true</isNew>
      <skipLocks>sellingPrice</skipLocks>
    </dmsCar>
  </dmsCars>
</feed>
Предыдущая
Требования к передаче данных
Следующая
IP-адреса серверов Авто.ру Бизнес