Обработка возвратов в API

В модели FBS обработка возвратов и возврат денежных средств полностью лежат на стороне партнёра. Рассмотрим API-методы для работы с возвратами.

Метод подтверждения возврата

POST /api/v1/orders/{orderNr}/change_status_request

Изменение статуса всех товаров в заказе на Claimed_ok (принят возврат) или полная отмена заказа.

curl -X POST "https://api-b2b.lamoda.ru/api/v1/orders/CZ123456789/change_status_request" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "returned"
}'

Параметры запроса

Возврат отдельного товара

POST /api/v1/orders/{orderNr}/items/{itemNr}/change_status_request

Изменение статуса отдельного товара в заказе (для частичного возврата).

curl -X POST "https://api-b2b.lamoda.ru/api/v1/orders/CZ123456789/items/7602/change_status_request" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "returned"
}'

Параметры запроса

Допустимые статусы для обновления

Процесс обработки возврата FBS

1 Получить нотификацию о возврате

Lamoda отправляет нотификацию itemStatusChanged при возврате товара на ПВЗ.

2 Проверить товар

Проверка качества на стороне партнёра или на ПВЗ Lamoda (для маркетплейс-доставки).

3 Подтвердить возврат через API

POST /api/v1/orders/{orderNr}/items/{itemNr}/change_status_request
{"status": "returned"}

4 Вернуть деньги клиенту

После статуса Refund by partner — вернуть деньги клиенту самостоятельно.

Возврат в магазин партнёра

• Проверка качества — полностью на стороне партнёра
• Конечный статус товара: Delivered to store
• Возвращённые товары можно отправить на склад Lamoda как новую поставку

DataMatrix при возврате

Если товар маркирован — при продаже DataMatrix выводится из оборота на стороне партнёра (FBS). При возврате необходимо:

• Вернуть DataMatrix в оборот (если товар пригоден к продаже)
• Или списать код (если товар признан браком)

Мониторинг возвратов

Для отслеживания возвратов используйте:

1. Подсчёт заказов по группам

GET /api/v1/orders/count-by-statuses

{
  "count": [
    {"statusGroup": "group_claimed", "quantity": 6}
  ]
}

2. Получение заказов со статусом возврата

GET /api/v1/orders

Фильтруйте по статусам товаров на своей стороне — в API нет прямого фильтра по статусу Claimed.

3. Нотификации

Настройте вебхук для получения itemStatusChanged — так вы узнаете о возвратах в реальном времени.

Пример полного сценария

# 1. Получаем нотификацию о возврате
{
  "type": "itemStatusChanged",
  "data": {
    "id": "CZ123456789",
    "items": [
      {"id": 7602, "status": "Claimed", "sku": "SKU001"}
    ]
  }
}

# 2. Проверяем товар (на своей стороне)
# Товар в хорошем состоянии

# 3. Подтверждаем возврат
POST /api/v1/orders/CZ123456789/items/7602/change_status_request
{"status": "returned"}

# 4. Товар переходит в Claimed ok → Refund by partner

# 5. Возвращаем деньги клиенту (на своей стороне)

Отказ в возврате

Если товар использован и не подлежит возврату — Lamoda ставит статус Claimed used. В этом случае:

• Деньги клиенту не возвращаются
• Товар остаётся у клиента
• Партнёру не нужно предпринимать действий

Сроки обработки возвратов

• Проверка товара: до 3 рабочих дней
• Возврат денежных средств: до 10 рабочих дней после подтверждения
• Общий срок возврата по закону: до 14 дней

Частые проблемы

См. также

• Типы возвратов
• Статусы заказов
• Отмена заказов
• Работа с DataMatrix