Отказ от отмены заказа
В случае, если запрос на отмену (см. Отмена заказа по инициативе курьерской службы) был отправлен курьерской службой по ошибке или курьерская служба готова возобновить доставку клиенту по любой другой причине в течение 48 часов после того как заказ был помечен на отмену - ИС курьерской службы может отправить отказ от отмены в ИС Золотого Яблока. При выполнении этого запроса пометка на удаление автоматически снимется с заказа , и курьерская служба сможет возобновить доставку и присылать статусы заказа в штатном режиме.
Также Курьерская служба может отправить запрос на отказ от отмены для заказа, по которому ранее была инициирована отмена по инициативе Золотого яблока (см. Отмена заказа по инициативе Золотого Яблока) в течение 48 часов после получения запроса. При выполнении этого запроса пометка на удаление автоматически снимется с заказа и курьерская служба сможет возобновить доставку и присылать статусы заказа в штатном режиме.
При использовании данного метода необходимо исключить ранее переданный статус отмены из истории статусов по заказу, чтобы избежать логических разрывов в истории статусов.
Обратите внимание, что указанный период времени (48 часов), зависит от условий договора на оказание услуг, заключенного между Золотым Яблоком и Курьерской Службой.
Основная информация
| Тип метода запроса | POST |
|---|---|
| Путь/URL | /api/v1/orders/{orderNumber}/reopen |
| Описание | Метод для возврата заказа в обработку после отмены |
| Направление | Запрос выполняется курьерской службой. Ответ предоставляется ИС Золотого Яблока. |
Запрос
Параметры заголовка
| Параметр | Тип данных | Обязательность | Описание | Комментарий |
|---|---|---|---|---|
| Authorization | string | 1 | Access-token, выданнный сервисом | см. метод Авторизация в сервисе |
| content-type | string | 1 | Тип содержимого запроса | Заполняется "application/json" |
Параметры пути запроса
| Параметр | Тип данных | Обязательность | Описание | Комментарий |
|---|---|---|---|---|
| orderNumber | string | 1 | Номер заказа в ИС Золотого Яблока | Внутренний номер заказа в ИС Золотого Яблока. Трек-номер |
Параметры запроса
| Параметр | Тип данных | Обязательность | Описание | Комментарий |
|---|---|---|---|---|
| сomment | string | 1 | Комментарий к отказу от отмены | Человекочитаемый комментарий в свободной строковой форме |
Пример запроса
{
"comment": "Курьер закрыл по ошибке"
}
Ответ
Коды ответов и сообщений
| Код | Статус | Сообщение | Причина |
|---|---|---|---|
| 200 | ОК | Order has been reopened | Все прошло успешно. Заказ помечен на отмену в ИС Золотого Яблока |
| 400 | Bad Request | Missing or inappropriate required parameters | Не переданы или некорретно заполнены обязательные поля |
| 401 | Unauthorized | Token is invalid | Ошибка аутентификации в КС |
| 403 | Forbidden | Has no permission | Запрещено в текущем контексте |
| 500 | Internal Server Error | Server unavailable | Сервер недоступен |
Параметры успешного ответа
200 ОК
Параметры неуспешного ответа
| Параметр | Тип данных | Обязательность | Описание | Комментарий |
|---|---|---|---|---|
| error | string | 1 | Человекочитаемое описание ошибки | см. п. "Коды ответов и сообщений" |
Пример неуспешного ответа
Неуспешный ответ
{
"error": "Invalid request format"
}