Запрос start
Данный метод используется для запуска автоматического планирования на определенном распределительном центре (или нескольких РЦ).
Автоматическое планирование – это процесс создания расписания для набора доступных ресурсов и запланированных заказов. Каждый новый запуск планирования на тот же самый период времени и для одного и того же распределительного центра (области контроля) уничтожит все уже запланированные рейсы кроме тех, которые не были до этого зафиксированы ("locked") в UI.
Входные данные запроса start
Для запуска автоматического планирования API использует application/x-www-form-urlencoded в качестве допустимого представления запроса (Media Type) и стандартный HTTP-метод POST.
Входные данные должны отправляться как атрибуты и не должны находиться в теле запроса. Список всех поддерживаемых атрибутов представлен ниже.
| # | Название атрибута | Тип | Обязательный | Описание |
| 1 | sessionID | Текст | Да | Идентификатор сессии, полученный от сервера после запроса авторизации. |
| 2 | aocID | Целое число | Нет | Список идентификаторов распределительных центров в Максоптре для составления расписания. Если он пуст, будут использоваться все РЦ, доступные текущему пользователю. |
| 3 | startDate | Дата | Нет | Дата начала планирования. Используется формат ISO 8601. Эта дата должна быть равна или быть позже текущей даты. Если дата отсутствует, будет использоваться текущая дата. |
| 4 | isSchedulingCollections | Логический | Нет | Отметка для разрешения планирования заказов типа «Сбор» |
Пример запроса start
Заголовки:
URL: /rest/2/distribution-api/schedules/start?sessionID=ff58060757da43a7b94f2b341fec172e&aocID=[190,91]&startDate=2018-08-26&isSchedulingCollections=false
Метод: POST
Структура: application/x-www-form-urlencoded
Тело запроса: не должно содержать никакой информации
Ответ start
Структура application/xml используется в качестве структуры ответа.
Данные содержатся внутри объекта Scheduling
requestStatus: логический * - если планирование начато успешно, то присылается true, если планирование уже запущено, то false
operationNumber: целое число – шаг планирования(2 – расчет матрицы, 1 – идет планирование, 0 – планирование завершено). Для метода start не важен
progress: целое число – текущий прогресс шага. Для метода start будет 0
message: текст – текст ошибки, в случае если запустить планирование не удалось
Выходные данные ответа start
| # | Название поля | Описание |
|---|---|---|
| 1 | ||