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

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

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

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

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 используются другие причины:

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

Важно: Через REST API партнёр может отменить заказ целиком из статуса new или new to be confirmed. Отдельные товары можно отменить также из статусов confirmed и Awaiting shipment (если нет активной отгрузки). Для отмены заказов в других статусах обратитесь к менеджеру Lamoda.

Ограничения при активной отгрузке

Отмена заказа или позиции невозможна, если для заказа уже создана отгрузка (shipment) в одном из следующих статусов:

• new — отгрузка создана
• confirmed — отгрузка подтверждена
• sent — отгрузка отправлена
• cancelPending — отгрузка в процессе отмены

В этих случаях API вернёт ошибку. Дождитесь завершения обработки отгрузки или обратитесь к менеджеру.

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

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

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 и получена этикетка, но поставка ещё не создана?

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

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

Причина отмены доступна на уровне позиции (item), а не заказа. В ответе GET /api/v1/orders/{orderNr} смотрите поле items[].statusChangeReason.

Примечание: Поле statusChangeReason на уровне заказа (не в массиве items) всегда возвращает null.

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

Ошибки при отмене

См. также

• Статусы заказов
• Создание отгрузки
• Типы возвратов