Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 13 Next »

Метод assignPerformersToVehicles

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

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


URL: /rest/2/distribution-api/objects/assignPerformersToVehicles 


Поддерживаемые атрибуты:

№Название поляОбязательностьОписание
1performerName ДаИмя водителя
2

vehicleName

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


Пример запроса:

<?xml version="1.0" encoding="UTF-8"?>
<apiRequest>
   <sessionID>545d1a3f6b2445019a369c9477c6dc36</sessionID>
   <allocationsDetails>
      <allocations>
         <allocation performerName="Виктор Иванов" vehicleName="А 609 КМ" date="24.02.2016" />
      </allocations>
   </allocationsDetails>
</apiRequest>


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

<?xml version="1.0" encoding="UTF-8"?>
<apiResponse version="1.0">
   <objects>
      <updatedObject>
         <name>Виктор Иванов - А 609 КМ</name>
      </updatedObject>
   </objects>
</apiResponse>

Возможные ошибки:

 

причина

ошибка

1

При указании некорректного sessionID

1009 - "Provided credentials are invalid"

2

При вводе некорректного имени водителя

1206 - "Performer is not found"

3

При вводе некорректного имени автомобиля

1304 - "Vehicle is not found"

4

При попытке назначить водителя на машинку из другого депо

1234 - "Performer and vehicle have different areas of control"

5

При попытке назначить водителя, который имеет не уникальное имя в системе

1302 - Found more then one performer with same name" 

6

При попытке привязать водителя/машинку, связанных с ДС, на который у пользователя нет прав

1019 - "User with provided credentials doesn't have AoC access or AoC doesn't exist"

7При попытке задать прошлую дату1214 - "Invalid value for parameter: date has already passed"
8При попытке назначить водителя с уже запланированным расписанием на другую машину.2028 - "The selected driver has allocated orders"



  • No labels