Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Метод assignPerformersToVehicles

Метод для назначения водителей на автомобили. Если автомобиль уже занят, предыдущий водитель снимается и назначается новый, указанный в запросе. В случае, если на определенную дату хотя бы на один из ресурсов (автомобиль/водитель) назначено расписание, то указанные водитель и машина на этот день не меняются.

Для назначения водителей на автомобили по API используется структура application/xml и HTTP-метод POST.


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

...

Название поляОбязательностьОписание
1performerName

Да,

если не указан performerExternalID

Имя водителя
2performerExternalId

Да,

если не указан performerName

Идентификатор водителя во внешней системе
3

vehicleName

Да,

если не указан vehicleExternalID

Имя автомобиля
4vehicleExternalIDvehicleExternalId

Да,

если не указан vehicleName

Идентификатор машины во внешней системе
5dateНет

Дата, на которую водитель назначается на автомобиль. Дата не может быть указана в прошлом.

Примечание Дату обязательно указывать в том случае, если назначение водителя на машину должно быть отражено на Экране планирования (назначение на конкретный день). Если не указать дату в запросе, назначение водителя на машину произойдет только в дефолтных настройках (Водители, /wiki/spaces/MAX/pages/3608188).

Примечания

Если поле performerExternalId заполнено, оно будет использовано для идентификации водителя, если нет - водитель будет идентифицирован по имени (performerName). Если заполнены оба поля, то водитель будет идентифицирован по связке имени и внешнего идентификатора.

...