Отмена заказов в API

В процессе работы с заказами может потребоваться отменить весь заказ или отдельные позиции. В этом разделе описаны методы и правила отмены.

Методы отмены

Отмена всего заказа

POST /api/v1/orders/{orderNr}/change_status_request — изменение статуса всего заказа.

Отмена отдельного товара

POST /api/v1/orders/{orderNr}/items/{itemNr}/change_status_request — изменение статуса конкретной позиции.

Отмена заказа

POST /api/v1/orders/RU251201-123456/change_status_request
Authorization: Bearer {access_token}
Content-Type: application/json

{
    "status": "canceled",
    "reason": "Нет нужной позиции/размера в наличии"
}

Отмена отдельного товара

POST /api/v1/orders/RU251201-123456/items/RU251201-123456-001/change_status_request
Authorization: Bearer {access_token}
Content-Type: application/json

{
    "status": "canceled",
    "reason": "Нет нужной позиции/размера в наличии"
}

Причины отмены (canceled)

При установке статуса canceled параметр reason обязателен.

Причины недоставки (not_delivered)

Для статуса not_delivered используются другие причины:

Когда можно отменить заказ

Важно: нельзя отменить заказ после того, как он включён в подтверждённую поставку и отправлен на склад.

Частичная отмена

Если в заказе несколько позиций и одну нельзя собрать:

1. Отмените только недоступную позицию (не весь заказ)
2. Остальные позиции продолжат обработку

Пример: в заказе 2 товара, один отсутствует:

// Отменяем только отсутствующий товар
POST /api/v1/orders/RU251201-123456/items/RU251201-123456-002/change_status_request
{
    "status": "canceled",
    "reason": "Нет нужной позиции/размера в наличии"
}

// Первый товар продолжаем обрабатывать
POST /api/v1/orders/RU251201-123456/items/RU251201-123456-001/change_status_request
{
    "status": "ready_for_shipment"
}

Полная отмена при невозможности сборки

При невозможности собрать полный заказ необходимо передать статус canceled для всех товаров в заказе.

// Отменяем все позиции
POST /api/v1/orders/RU251201-123456/change_status_request
{
    "status": "canceled",
    "reason": "Нет нужной позиции/размера в наличии"
}

Отмена с этикеткой и track numbers

Вопрос: можно ли отменить заказ, для которого уже запрошены track numbers и получена этикетка, но поставка ещё не создана?

Ответ: Да, можно. Заказ ещё не создан на складе, отмена доступна.

Получение причины отмены

Ограничение: технически получить причину отмены заказа через API невозможно. Поле statusChangeReason в ответе GET /api/v1/orders/{orderNr} всегда возвращает null.

Статусы после отмены