exportVehicles


запрос exportVehicles

Запрос используется для экспорта автомобилей из системы.

Метод: POST

URL: [account-name].maxoptra.com/rest/2/distribution-api/objects/exportVehicles


Список поддерживаемых атрибутов:

Наименование поляОбязательностьОписание
1vehicle
Блок информации об автомобиле
1.1idДаИдентификатор машины в аккаунте, который может быть использован в дальнейших вопросах
1.2nameДаИмя автомобиля
1.3externalIDНетВнешний идентификатор автомобиля. Поле выгружается только в том случае, если оно было заполнено при создании автомобиля
1.3activeДаВключен или нет
1.4suspended ДаЗаблокирован или нет
1.5costByDistance ДаЦена за милю
1.6vehicleActivationCostДаФиксированная стоимость использования определенной машины. Эта стоимость используется, чтобы отразить стоимость выхода машины в работу или зарплату водителя за день.
1.7costPerOrderДаДанный параметр отражает стоимость выполнения одного заказа определенной машиной.
1.8maxWeight ДаМаксимальная вместимость машины для используемой в аккаунте первой единицы измерения заказа (вес)
1.9maxVolumeДаМаксимальная вместимость машины для используемой в аккаунте второй единицы измерения заказа (объём)
1.10averageSpeed ДаМаксимальная скорость
1.11deviceCodeНетКод устройства
1.12deviceTypeНетТип устройства. Значения: TomTom, Wialon, Autotracker
1.13colorНетЦвет
1.14manufacturerInfoНетИнформация о производителе
1.15vinНетЗаводской номер автомобиля
1.16comments НетКомментарии
1.17allowSpeedCorrectionFactorНетКорректирующий коэффициент: включен, выключен. Значения: true / false.
1.18speedCorrectionFactorНетЗначение корректирующего коэффициента
1.19runDistanceLimitНетМаксимальная протяженность рейса. Значение указывается в единицах расстояния аккаунта (для России - километры). Незаполненное поле означает отсутствие ограничений.
1.20areaOfControlДаРаспределительный центр
2vehicleRequirementsНетБлок информации о поддерживаемых требованиях к транспортному средству
2.1nameДаНаименование поддерживаемых требований к транспортному средству
2.2abbreviationНетАббревиатура поддерживаемых требований к транспортному средству
3units
Блок со значениями единиц измерений
3.1timeZoneНетТаймзона
3.2timeZoneOffsetДаЧасовой пояс
3.3currencyДаВалюта
3.4distanceUnitsДаЕдиницы измерения расстояния
3.5speedUnitsДаЕдиницы измерения скорости. Значения: METERS_PER_SEC   KILOMETERS_PER_HOUR   MILES_PER_HOUR.
3.6durationUnitsДаЕдиницы измерения погрузки
3.7weightUnitsДаЕдиницы измерения веса
3.8volumeUnitsДаЕдиницы измерения объема (если настроено)
4zone
Блок, в котором указывается территория, на которой может работать автомобиль
4.1nameДаНазвание территории
5homeLocation
Блок информации об адресе возврата в конце дня
5.1nameДаИмя
5.2addressДаАдрес
5.3latitudeНетШирота
5.4longitudeНетДолгота

Передает параметр sessionID

URL: /rest/2/distribution-api/objects/exportVehicles?sessionID=c7aea2918df94ec78e86bb0f86098ec8


Пример ответа

<?xml version="1.0" encoding="UTF-8"?>
<apiResponse version="1.0">
   <vehiclesDetails>
      <units timeZone="Greenwich Mean Time" timeZoneOffset="GMT+0:00" currency="ROUBLE" distanceUnits="KILOMETER" speedUnits="KILOMETERS_PER_HOUR" durationUnits="MINUTE" weightUnits="Kg" />
      <vehicles>
         <vehicle name="demosupport" externalId="7cc3098028614de3bcc6fb3c468fc986" active="true" suspended="false" costByDistance="1" maxWeight="55" maxVolume="0" averageSpeed="90" color="#937128" allowSpeedCorrectionFactor="false" runDistanceLimit="50,3" areaOfControl="ChippenhamZone">
            <homeLocation />
         </vehicle>
      </vehicles>
   </vehiclesDetails>
</apiResponse>