Запрос status
Данный метод используется для запроса статусов запущенных сессий автоматического планирования для определенного распределительного центра (или нескольких РЦ).
Ответ содержит информацию о текущей фазе автоматического планирования и ее прогрессе. После окончания планирования результат информирует об окончании процесса только один раз. Последующие запросы будут содержать неудачный статус. Если планирование не запущено, ответ вернет неудачный статус.
Входные данные запроса status
Для запроса статуса о запущенных сессиях автоматического планирования API использует стандартный HTTP-метод GET.
Входные данные должны отправляться как атрибуты и не должны находиться в теле запроса. Список всех поддерживаемых атрибутов представлен ниже.
# | Название атрибута | Тип | Обязательный | Описание |
1 | sessionID | Текст | Да | Идентификатор сессии, полученный от сервера после запроса авторизации. |
2 | aocID | Целое число | Нет | Список идентификаторов распределительных центров в Максоптре для составления расписания. Если он пуст, будут использоваться все РЦ, доступные текущему пользователю. |
Пример запроса status
Заголовки:
URL: /rest/2/distribution-api/schedules/status?sessionID=ff58060757da43a7b94f2b341fec172e&aocID=[190,91]
Метод: GET
Тело запроса: не должно содержать никакой информации
Ответ status
Структура application/xml используется в качестве структуры ответа.
Выходные данные ответа status
1 | scheduling | |
1.1 | requestStatus | Статус процесса планирования. Возможные значения: true/false. Если планирование идет без ошибок, в ответе приходит "true"; если планирование не удалось, в ответе приходит "false". |
1.2 | operationNumber | Шаг планирования. Существуют три шага планирования: 2 - расчет матрицы 1 - идёт планирование 0 - планирование завершено |
1.3 | progress | Текущий прогресс шага планирования. |
1.4 | message | Текст, информирующий о том, какое количество заказов запланировано/не запланировано, либо текст ошибки. |
# | Название поля | Описание |
---|
Примеры ответа status
<?xml version="1.0" encoding="UTF-8"?> <apiResponse version="1.0"> <scheduling> <requestStatus>true</requestStatus> <operationNumber>1</operationNumber> <progress>100</progress> <message /> </scheduling> </apiResponse>
<?xml version="1.0" encoding="UTF-8"?> <apiResponse version="1.0"> <scheduling> <requestStatus>true</requestStatus> <operationNumber>0</operationNumber> <progress>100</progress> <message>Planned successfully 5, not planned 3</message> </scheduling> </apiResponse>