Обновлено

20.03.2026

Содержание статьи

Типы возвратов и статусы

В Lamoda существует два типа возвратного потока: клиентский возврат (товар выкуплен и возвращён) и невыкуп (клиент отказался при получении). Работа с возвратами отличается в зависимости от модели фулфилмента — FBS или FBO.

API для работы с возвратами

API	Базовый URL	Модель	Назначение
REST API v2	`https://public-api-seller.lamoda.ru`	Только FBS	Мониторинг возвратных товаров и коробов (read-only)
Lamoda B2B Platform Partner API v1	`https://api-b2b.lamoda.ruGET /api/v1/`	FBS	Подтверждение возврата (`change_status_request`)

FBO: В модели FBO отдельного API для возвратов нет — Lamoda обрабатывает возвраты автоматически. Партнёр отслеживает статусы через GET /api/v1/orders и нотификации.

Различия FBS и FBO при возвратах

Аспект	FBS (Fulfillment by Seller)	FBO (Fulfillment by Operator)
Обработка возврата	На ПВЗ Lamoda или в магазине партнёра	На складе Lamoda
Проверка качества	На стороне партнёра	На стороне Lamoda
Возврат денег клиенту	Партнёр возвращает самостоятельно	Lamoda возвращает
Подтверждение возврата через API	`GET /api/v1/orders/{orderNr}/change_status_request`	Не требуется (Lamoda обрабатывает сама)
Мониторинг возвратов	REST API v2: `/api/v2/fbs/return-*`	Через статусы заказов: `GET /api/v1/orders`
Маркировка (DataMatrix)	Партнёр управляет кодами маркировки	Lamoda управляет кодами маркировки

Типы возвратов (REST API v2)

В новом REST API v2 возвраты классифицируются по полю returnType:

Тип	Описание
`CLAIM`	Клиентский возврат — товар был выкуплен и возвращён
`REJECT`	Невыкуп — клиент отказался от товара при получении
`CANCEL`	Отмена — заказ отменён до доставки
`NO_SHOW`	Неявка — клиент не явился за заказом

Статусы возвратов: Lamoda B2B Platform Partner API v1

Статусы проверки качества

Статус в API	Статус в интерфейсе	Описание
`Claimed`	На проверке	Товар получен, идёт проверка качества
`Claimed ok`	Принят к возврату	Проверка не выявила нарушений. Товар принят, требуется возврат денег
`Claimed defective`	Принят к возврату как брак	Обнаружен заводской брак. Товар не пригоден к продаже. Требуется возврат денег
`Claimed used`	Не подлежит возврату как использованный	Товар использован клиентом. В возврате денег отказано
`Not bought`	Невыкуп	Клиент отказался от товара при получении

Статусы возврата денежных средств

Статус в API	Статус в интерфейсе	Описание
`Refund necessary`	Требуется возврат денежных средств	Создаётся автоматически для товаров, принятых к возврату
`Refund investigation`	Сбор информации для возврата	Недостаточно данных для перевода (например, реквизиты клиента)
`Ready to refund`	В процессе возврата	Документы в работе у бухгалтерии
`Refunded`	Денежные средства возвращены	Деньги переведены покупателю (FBO)
`Refund by partner`	Возврат денежных средств партнёром	Партнёр сам возвращает деньги клиенту (FBS)
`Non-Refund`	Не возвращён	Товар принят к возврату, но деньги ещё не возвращены

Статусы возвратов: REST API v2 (только FBS)

Статусы возвратных товаров

Статус	Описание
`CREATED`	Возврат создан
`LEFT_TO_WH`	Едет на склад Lamoda
`ARRIVED_TO_WH`	На складе Lamoda
`READY_TO_RETURN`	Готов к возврату партнёру
`SHIPPED`	Отгружен партнёру

Статусы возвратных коробов

Статус	Описание
`CREATED`	Короб создан
`IN_PROGRESS`	В процессе наполнения
`ACCEPTED`	Принят, готов к отгрузке
`SHIPPED`	Отгружен партнёру

Маппинг статусов: Lamoda B2B Platform Partner API v1 → REST API v2

При миграции на новый REST API v2 типы и статусы возвратов меняют формат. Ниже — соответствие старых статусов новым понятиям в v2.

Lamoda B2B Platform Partner API v1	REST API v2 (returnType)	Пояснение
`Claimed`, `Claimed ok`, `Claimed defective`	`CLAIM`	Клиентский возврат. В v1 — несколько этапов проверки. В v2 — единый тип `CLAIM`, этапы отражаются в `status` товара
`Not bought`	`REJECT`	Невыкуп. Клиент отказался при получении
`Canceled`	`CANCEL`	Заказ отменён до доставки
—	`NO_SHOW`	Неявка клиента. Новый тип, не имеет прямого аналога в v1

Важно: REST API v2 и Lamoda B2B Platform Partner API v1 — это разные системы статусов. В v2 тип возврата (returnType) и текущее состояние (status) разделены. В v1 статус товара содержит и тип, и состояние одновременно (например, Claimed ok = тип «возврат» + состояние «принят»).

Схема переходов статусов возврата (Lamoda B2B Platform Partner API v1)

Клиентский возврат

Невыкуп

Причины возврата и невыкупа

При обновлении статуса товара на not_delivered или canceled через Lamoda B2B Platform Partner API v1 необходимо указать причину.

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

Отсутствие удобного дня доставки
Отсутствие удобного промежутка времени для доставки
Отсутствие подходящего метода доставки
Нет нужной позиции/размера в наличии
Товар больше не нужен
Доставка в регион клиента не осуществляется
Техническое ограничение при подтверждении

Причины невыкупа (not_delivered)

Размер не подошёл
Не соответствует описанию/фото
Низкое качество изготовления, материала
Брак, некомплект, следы примерки
Не подошёл фасон, посадка, стиль
Доставлен не тот товар
Товар не был доставлен
Другое

Частичный возврат

Если клиент выкупил заказ и вернул только часть товаров:

Статус заказа: Delivered
Выкупленные товары: Delivered
Возвращённые товары: Claimed ok / Claimed defective

{
  "id": "CZ123456789",
  "status": "Delivered",
  "items": [
    {"id": 1, "sku": "SKU001", "status": "Delivered"},
    {"id": 2, "sku": "SKU002", "status": "Claimed ok"}
  ]
}

Нотификации о возвратах

При изменении статуса товара на возвратный Lamoda отправляет нотификацию itemStatusChanged:

{
  "type": "itemStatusChanged",
  "trackingId": "123456789",
  "data": {
    "id": "CZ123456789",
    "status": "Delivered",
    "items": [
      {
        "id": 7602,
        "status": "Claimed ok",
        "sku": "SELLERSK082",
        "finalERPStatus": null,
        "statusChangeReason": null
      }
    ]
  }
}

Важно: миграция нотификаций (FBS)
С 3 марта 2026 года возвратные статусы перестанут передаваться через нотификации itemStatusChanged и методы GET /api/v1/order/*. Для мониторинга возвратов FBS используйте новые методы /api/v2/fbs/return-*. Подробнее — в разделе Возвраты FBS.

Миграция: С 3 марта 2026 старые статусы возвратов перестанут передаваться через GET /api/v1/orders и нотификации itemStatusChanged. Подробный план миграции и список затронутых методов: Возвраты FBS → Миграция.

См. также

Возвраты FBS — полное описание API для FBS-возвратов (REST API v2 + подтверждение через v1)
Статусы заказов и товаров
Типы нотификаций

Помогла эта информация?

Да Нет

Спасибо за отзыв

0/1000 Отправить

Возвраты FBS в API

Способы доставки в API

Типы возвратов и статусы в API