Метод для изменения статуса обработчика сделки, что влечёт за собой изменение статуса самой сделки. Статус обработчика можно получить в ответе при вызове Получение данных по сделки, в поле - data.handler.status. Изменять статус обработчика сделки можно только тогда, когда в сделке используется ручной тип обработчика (например data.handler.type=”Custom”) и статус обработчика сделки - ‘CREATED', 'SENT' или 'DELIVERED' (это возможно только после Подтверждение сделки). А изменить статус можно только на 'SENT', 'DELIVERED', 'FINISHED', 'CANCELED', 'REJECTED' или 'EXPIRED'.
Статусы обработчика 'FINISHED', 'CANCELED', 'REJECTED' и 'EXPIRED' являются конечными, изменению не подлежат и влекут за собой зачисления/возвраты денег за товар и доставку.
Запрос
Method | PATCH |
URL | /handlers/{{handlerType}}/status |
Параметры запроса
Поле | Обязательное | Тип | Описание | Пример |
---|---|---|---|---|
{{handlerType}} | Да | String | Тип обработчика | "Custom" |
dealId | Да | String | ID сделки | "L8M95ER" |
status | Да | String | Статус обработчика. Может быть:
| “SENT“ |
statusCode | Нет | String | Статус код обработчика в системе клиента | “123“ |
statusText | Нет | String | Текстовый статус обработчика в системе клиента | “Посылка находится в сортировочном центре“ |
PATCH /handlers/Custom/status |
{ "dealId": "L8M95ER", "status": “SENT“, "statusCode": “123“, "statusText": “Посылка находится в сортировочном центре“ } |
Параметры ответа
Поле | Описание |
---|---|
data | Объект с ответом |
ID сделки | |
data.externalId | Внешний ID сделки |
Пример:
{ "data": { "id": "L8M95ER", "externalId": "myExternalId537916" } } |