Изменение статусов нескольких заказов
Метод доступен для моделей: 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/campaigns/{campaignId}/orders/status-update
Path parameters
Name |
Description |
campaignId* |
Type: integer<int64> Идентификатор магазина в кабинете. Чтобы узнать идентификаторы своих магазинов, воспользуйтесь запросом GET campaigns. ℹ️ Что такое кабинет и магазин на Маркете
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
— заказ переносили слишком много раз. -
DELIVERY_DATE_CHANGED_TOO_MUCH
— заказ перенесен на слишком много дней.
-
-
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 |
result |
Type: UpdateOrderStatusesDTO Список заказов, статус которых обновился. |
status |
Type: ApiResponseStatusType Тип ответа. Возможные значения:
Enum: |
UpdateOrderStatusesDTO
Список заказов, статус которых обновился.
Name |
Description |
orders* |
Type: UpdateOrderStatusDTO[] Список с обновленными заказами. |
ApiResponseStatusType
Тип ответа. Возможные значения:
OK
— ошибок нет.ERROR
— при обработке запроса произошла ошибка.
Type |
Description |
Enum: |
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.