...
| № | Название поля | Обязательность | Описание |
| 1 | performerName | Да Да, если не указан performerExternalID | Имя водителя |
| 2 | performerExternalId | Нет Да, если не указан performerName | Идентификатор водителя во внешней системе |
| 3 | vehicleName | Да, если не указан vehicleExternalID | Имя автомобиля |
| 4 | vehicleExternalID | Да, если не указан vehicleName | Идентификатор машины во внешней системе |
| 5 | date | Нет | Дата, на которую водитель назначается на автомобиль. Дата не может быть указана в прошлом |
...
Если поле performerExternalId заполнено, оно будет использовано для идентификации водителя, если нет - водитель будет идентифицирован по имени (performerName). Если заполнены оба поля, то водитель будет идентифицирован по связке имени и внешнего идентификатора.
Та же логика работает для полей vehicleName и vehicleExternalID.
Пример запроса:
| Code Block | ||
|---|---|---|
| ||
<?xml version="1.0" encoding="UTF-8"?>
<apiRequest>
<sessionID>545d1a3f6b2445019a369c9477c6dc36</sessionID>
<allocationsDetails>
<allocations>
<allocation performerName="Виктор Иванов" vehicleName="А 609 КМ" performerExternalId ="Водитель 4" vehicleExternalId="Машина 4" date="24.02.2016" />
</allocations>
</allocationsDetails>
</apiRequest> |
...
Возможные ошибки:
| причина | ошибка |
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 | При попытке назначить водителя, имя которого не соответствует значению driverExternalID | 2022 - "The driver is not found by same name and external id: performerExternalID<=>Performer" |
| 9 | При попытке назначить машину, имя которой не соответствует значению vehicleExternalID | 2023 - "При попытке назначить машину, имя которой не соответствует значению vehicleExternalID" |
| 10 | При попытке назначить водителя с уже запланированным расписанием на другую машину. | 2028 - "The selected driver has allocated orders" |
...