Изменение статусов нескольких заказов
Метод доступен для моделей: FBS, Экспресс и DBS.
Если вы используете API-Key-токен, для вызова метода необходим один из доступов в списке
- inventory-and-order-processing — Обработка заказов и учёт товаров
- all-methods — Полное управление кабинетом
Изменяет статусы нескольких заказов.
Возможные изменения статусов:
- Если магазин подтвердил и подготовил заказ к отправке, то заказ из статуса "status": "PROCESSING"и этапа обработки"substatus": "STARTED"нужно перевести в статус"status": "PROCESSING"и этап обработки"substatus": "READY_TO_SHIP".
- Если магазин подтвердил заказ, но не может его выполнить (например, товар числится в базе, но отсутствует на складе или нет нужного цвета), то заказ из статуса "status": "PROCESSING"и этапа обработки"substatus": "STARTED"нужно перевести в статус"status": "CANCELLED"с причиной отмены заказа"substatus": "SHOP_FAILED".
- Если магазин подготовил заказ к отгрузке, но не может его выполнить (например, последний товар был поврежден или оказался с браком), то заказ из статуса "status": "PROCESSING"и этапа обработки"substatus": "READY_TO_SHIP"нужно перевести в статус"status": "CANCELLED"с причиной отмены заказа"substatus": "SHOP_FAILED".
| ⚙️ Лимит: 100 000 заказов в час | 
|---|
Request
POST
https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/orders/status-update
Path parameters
| Name | Description | 
| campaignId* | Type: integer<int64> Идентификатор кампании. Его можно узнать с помощью запроса GET v2/campaigns или найти в кабинете продавца на Маркете — нажмите на иконку вашего аккаунта → Настройки и в меню слева выберите API и модули: 
 ⚠️ Не передавайте вместо него идентификатор магазина, который указан в кабинете продавца на Маркете рядом с названием магазина и в некоторых отчетах.
 Min value:  | 
Body
application/json
{
    "orders": [
        {
            "id": 0,
            "status": "PLACING",
            "substatus": "RESERVATION_EXPIRED"
        }
    ]
}
| Name | Description | 
| orders* | Type: OrderStateDTO[] Список заказов. Min items:  Max items:  | 
OrderStateDTO
Информация по заказу.
| Name | Description | 
| id* | Type: integer<int64> Идентификатор заказа. | 
| status* | Type: OrderStatusType Статус заказа: 
 Также могут возвращаться другие значения. Обрабатывать их не нужно. Enum:  | 
| substatus | Type: OrderSubstatusType Этап обработки заказа (если он имеет статус  
 Также могут возвращаться другие значения. Обрабатывать их не нужно. Enum:  | 
OrderStatusType
Статус заказа:
- 
PLACING— оформляется, подготовка к резервированию.
- 
RESERVED— зарезервирован, но недооформлен.
- 
UNPAID— оформлен, но еще не оплачен (если выбрана оплата при оформлении).
- 
PROCESSING— находится в обработке.
- 
DELIVERY— передан в службу доставки.
- 
PICKUP— доставлен в пункт самовывоза.
- 
DELIVERED— получен покупателем.
- 
CANCELLED— отменен.
- 
PENDING— ожидает обработки со стороны продавца.
- 
PARTIALLY_RETURNED— возвращен частично.
- 
RETURNED— возвращен полностью.
- 
UNKNOWN— неизвестный статус.
Также могут возвращаться другие значения. Обрабатывать их не нужно.
| Type | Description | 
| Enum:  | 
OrderSubstatusType
Этап обработки заказа (если он имеет статус PROCESSING) или причина отмены заказа (если он имеет статус CANCELLED).
- 
Значения для заказа в статусе PROCESSING:- 
STARTED— заказ подтвержден, его можно начать обрабатывать.
- 
READY_TO_SHIP— заказ собран и готов к отправке.
 
- 
- 
Значения для заказа в статусе CANCELLED:- 
RESERVATION_EXPIRED— покупатель не завершил оформление зарезервированного заказа в течение 10 минут.
- 
USER_NOT_PAID— покупатель не оплатил заказ (для типа оплатыPREPAID) в течение 30 минут.
- 
USER_UNREACHABLE— не удалось связаться с покупателем. Для отмены с этой причиной необходимо выполнить условия:- не менее 3 звонков с 8 до 21 в часовом поясе покупателя;
- перерыв между первым и третьим звонком не менее 90 минут;
- соединение не короче 5 секунд.
 Если хотя бы одно из этих условий не выполнено (кроме случая, когда номер недоступен), отменить заказ не получится. Вернется ответ с кодом ошибки 400. 
- 
USER_CHANGED_MIND— покупатель отменил заказ по личным причинам.
- 
USER_REFUSED_DELIVERY— покупателя не устроили условия доставки.
- 
USER_REFUSED_PRODUCT— покупателю не подошел товар.
- 
SHOP_FAILED— магазин не может выполнить заказ.
- 
USER_REFUSED_QUALITY— покупателя не устроило качество товара.
- 
REPLACING_ORDER— покупатель решил заменить товар другим по собственной инициативе.
- 
PROCESSING_EXPIRED— значение более не используется.
- 
PICKUP_EXPIRED— закончился срок хранения заказа в ПВЗ.
- 
TOO_MANY_DELIVERY_DATE_CHANGES— заказ переносили слишком много раз.
- 
TOO_LONG_DELIVERY— заказ доставляется слишком долго.
- 
INCORRECT_PERSONAL_DATA— для заказа из-за рубежа указаны неправильные данные получателя, заказ не пройдет проверку на таможне.
 
- 
- 
TECHNICAL_ERROR— техническая ошибка на стороне Маркета. Обратитесь в поддержку.
Также могут возвращаться другие значения. Обрабатывать их не нужно.
| Type | Description | 
| Enum:  | 
Responses
200 OK
Возвращается информация об обновленных статусах заказов.
Body
application/json
{
    "status": "OK",
    "result": {
        "orders": [
            {
                "id": 0,
                "status": "PLACING",
                "substatus": "RESERVATION_EXPIRED",
                "updateStatus": "OK",
                "errorDetails": "string"
            }
        ]
    }
}
| Name | Description | 
| status* | Type: ApiResponseStatusType Тип ответа. Возможные значения: 
 Enum:  | 
| result | Type: UpdateOrderStatusesDTO Список заказов, статус которых обновился. | 
ApiResponseStatusType
Тип ответа. Возможные значения:
- OK— ошибок нет.
- ERROR— при обработке запроса произошла ошибка.
| Type | Description | 
| Enum:  | 
UpdateOrderStatusesDTO
Список заказов, статус которых обновился.
| Name | Description | 
| orders* | Type: UpdateOrderStatusDTO[] Список с обновленными заказами. | 
UpdateOrderStatusDTO
Список заказов.
| Name | Description | 
| errorDetails | Type: string Ошибка при изменении статуса заказа. Содержит описание ошибки и идентификатор заказа. Возвращается, если параметр  | 
| id | Type: integer<int64> Идентификатор заказа. | 
| status | Type: OrderStatusType Статус заказа: 
 Также могут возвращаться другие значения. Обрабатывать их не нужно. Enum:  | 
| substatus | Type: OrderSubstatusType Этап обработки заказа (если он имеет статус  
 Также могут возвращаться другие значения. Обрабатывать их не нужно. Enum:  | 
| updateStatus | Type: OrderUpdateStatusType Статус обновления. Enum:  | 
OrderUpdateStatusType
Изменился ли статус заказа:
- 
OK— статус изменен.
- 
ERROR— статус не изменен. В этом случае появится сообщение об ошибке в параметреerrorDetails.
| Type | Description | 
| Enum:  | 
400 Bad Request
Запрос содержит неправильные данные. Подробнее об ошибке
Body
application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}
| Name | Description | 
| errors | Type: ApiErrorDTO[] Список ошибок. Min items:  | 
| status | Type: ApiResponseStatusType Тип ответа. Возможные значения: 
 Enum:  | 
ApiErrorDTO
Общий формат ошибки.
| Name | Description | 
| code* | Type: string Код ошибки. | 
| message | Type: string Описание ошибки. | 
401 Unauthorized
В запросе не указаны данные для авторизации. Подробнее об ошибке
Body
application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}
| Name | Description | 
| errors | Type: ApiErrorDTO[] Список ошибок. Min items:  | 
| status | Type: ApiResponseStatusType Тип ответа. Возможные значения: 
 Enum:  | 
403 Forbidden
Данные для авторизации неверны или доступ к ресурсу запрещен. Подробнее об ошибке
Body
application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}
| Name | Description | 
| errors | Type: ApiErrorDTO[] Список ошибок. Min items:  | 
| status | Type: ApiResponseStatusType Тип ответа. Возможные значения: 
 Enum:  | 
404 Not Found
Запрашиваемый ресурс не найден. Подробнее об ошибке
Body
application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}
| Name | Description | 
| errors | Type: ApiErrorDTO[] Список ошибок. Min items:  | 
| status | Type: ApiResponseStatusType Тип ответа. Возможные значения: 
 Enum:  | 
420 Method Failure
Превышено ограничение на доступ к ресурсу. Подробнее об ошибке
Body
application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}
| Name | Description | 
| errors | Type: ApiErrorDTO[] Список ошибок. Min items:  | 
| status | Type: ApiResponseStatusType Тип ответа. Возможные значения: 
 Enum:  | 
500 Internal Server Error
Внутренняя ошибка Маркета. Подробнее об ошибке
Body
application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}
| Name | Description | 
| errors | Type: ApiErrorDTO[] Список ошибок. Min items:  | 
| status | Type: ApiResponseStatusType Тип ответа. Возможные значения: 
 Enum:  | 
No longer supported, please use an alternative and newer version.