ChangeOrderIssue. Изменение типа выдачи посылки
Сервис для изменения типа выдачи посылки.
Внимание! Режим редактирования посылок возможен на разных статусах движения заказа.
Список всех статусов приведен в "Таблица статусов доступности изменения свойств отправления" – графа «Изменение типа выдачи».
Входящие параметры:
Параметр | Обяз. | Тип | Описание | Пример |
|---|---|---|---|---|
| token | ● | string | Токен для доступа к api-сервисам | d6f33e419c16131e5325cbd84d5d6000 |
| method | ● | string | Название метода | ChangeOrderIssue |
| track | ● | string | Трек-номер посылки | AAP114630687 |
| orderid | string | Номер заказа ИМ | test-001923 | |
| issue | ● | integer | Новый вид выдачи заказа. 0 - без вскрытия 1 - со вскрытием 2 - частичная выдача | 1 |
Данные ответа:
Параметр | Тип | Описание |
|---|---|---|
| err | bool | false - запрос успешно выполнен (в ЛК ИМ изменены данные посылки) |
string | Сообщение об ошибке, в случае err != false |
Справочник ошибок:
Текст ошибки | Описание ошибки | |
|---|---|---|
| 1 | "Некорректный статус для изменения опций заказа или на отделении недоступна частичная выдача" | В изменении отказано. Данный вид выдачи недоступен для отправления. |
| 2 | "Посылке уже присвоен тип выдачи = (вид выдачи)" | Отравление уже с данным видом выдачи, изменений не требуется. |
| 3 | "Не найдена посылка" | Отправление не найдено. |
| 4 | "Не указан вид выдачи" | Не указан вид выдачи посылки. |
| 5 | "Значение «Issue» должно быть целым числом." | Переданное значение является строковым. |
| 6 | Невозможно изменение вида выдачи. Отсутствуют товары. | Для отправлений без товарных позиций вид выдачи "2" недоступен. |
| 7 | Стоимость всех товаров (<сумма>) + стоимость доставки (<сумма>) должна быть равна сумме к оплате (<сумма>). | Сумма к оплате не соответствует требованиям для вида выдачи "2". |
| 8 | Оказание услуги "Примерка" невозможно при типе выдачи "Без вскрытия" | Совокупность типа выдачи 0 (Без вскрытия) и выбранной услуги Примерка (fitting: true) невозможно. |
| Параметр | Условие проверки | Текст ошибки при невыполнении |
|---|---|---|
| issue (Вид выдачи) | Обязателен для передачи | Не указан вид выдачи |
| Возможные значения 0, 1, 2 | Неверно указан вид выдачи | |
| issue = 2 (частичная выдача) | у посылки должны быть товары в БД ЛК ИМ | Невозможно изменение вида выдачи. Отсутствуют товары. |
| Сумма к оплате = Стоимость всех товаров + стоимость доставки, либо Сумма к оплате = 0 (предоплаченный заказ) | Невозможно изменение вида выдачи. Стоимость всех товаров (<сумма>) + стоимость доставки (<сумма>) должна быть равна сумме к оплате (<сумма>). | |
| Совокупность issue и fitting | Проверяем значение полей "Тип выдачи" (issue) и "Примерка (fitting) в совокупности: ЕСЛИ при создании отправления "Тип выдачи"* = "Без вскрытия" И флаг "Примерка"* установлен * данное значение поля указано по умолчанию в профиле ИМ или явно в запросе | Оказание услуги "Примерка" невозможно при типе выдачи "Без вскрытия". |