...
# | Название атрибута | Тип | Обязательность | Описание | ||
| 1 | sessionID | Текст | Да | Идентификатор сессии, полученный от сервера после запроса авторизации. | ||
2 | date | Дата | Да | Дата, на которую назначен(ы) рейс(ы). | ||
| 3 | vehicleExternalID | Текст | Нет | Если указан, то отошлются только рейсы, назначенные на данную машину. | ||
| 4 | driverExternalID | Текст | Нет | Если указан, то отошлются только рейсы, назначенные на данного водителя. | ||
| 5 | dcName | Текст | Нет | Если указан, то отошлются только рейсы для данного РЦ. | ||
| 6 | runNumber | Число | Нет | Если указан, то отошлется только выбранный рейс. | ||
...
В запросе возможны следующие комбинации атрибутов:
Отправка рейсов для всех РЦ данного аккаунта: sessionID + date;
Sending runs of a certain DC: sessionID + date + dcName;
Sending runs of a certain vehicle: sessionID + date + vehicleExternalID;
Sending runs of a certain driver: sessionID + date + driverExternalID;
Sending a certain run of a certain vehicle: sessionID + date + vehicleExternalID + runNumber;
Sending a certain run of a certain driver: sessionID + date + driverExternalID + runNumber.
Примечание Указание сразу нескольких атрибутов приводит к избыточности (кроме случая vehicleExternalI/driverExternalID + runNumber), и система отреагирует на это ошибкой (1020 "Redundant parameters" - Избыточные параметры). См. перечень возможных ошибок ниже.
...
Ошибка | Описание | Описание |
|---|---|---|
| 1009 | Invalid or unknown session ID | Недействительный или неизвестный идентификатор сессии |
| 1013 | Date in incorrect format | Некорректный формат даты |
| 1014 | Expected parameter not provided | Ожидаемый параметр не представлен |
| 1015 | Internal service error | Внутренняя ошибка |
| 1020 | Redundant parameters | Избыточные параметры |
| 1202 | Area of control is not found | Не найдены распределительные центры |
| 1206 | Performer is not found | Водитель не найден |
| 1304 | Vehicle is not found | Машина не найдена |
Пример ошибки
|