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

Новость на модерации

Обновлено

18.12.2025

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

В Lamoda существует несколько типов возвратов товаров, каждый с разным сценарием обработки и возврата денежных средств. 
 
<h2>Основные типы возвратов</h2> 
 
<h4>1. Невыкуп (Not bought)</h4> 
Клиент отказался от товара при доставке или на пункте выдачи. 
Статус товара: <code>Not bought</code> 
Возврат денег: Не требуется (товар не был оплачен) 
Конечный статус: <code>Returned</code> — товар возвращён на склад 
<h4>2. Клиентский возврат (Claimed)</h4> 
Клиент выкупил товар, но вернул его по гарантии или по другой причине. 
Статус товара: <code>Claimed</code> → проверка качества → результат 
Возврат денег: Требуется (если товар прошёл проверку) 
Конечные статусы: <code>Claimed ok</code>, <code>Claimed defective</code>, <code>Claimed used</code> 
<h4>3. Не доставлен (Not delivered)</h4> 
Товар не был доставлен по различным причинам (клиент недоступен, ошибка адреса и т.д.) 
Статус товара: <code>Not delivered</code> 
Возврат денег: Требуется для предоплаченных заказов 
<h2>Статусы возвратов</h2> 
 
<table style="border-collapse: collapse; width: 100%;"> 
<tbody> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Статус в API</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Статус в интерфейсе</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Описание</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>Not bought</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Не выкуплен</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Клиент отказался от товара при доставке</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>Returned</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Возвращён на склад</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Невыкупленные товары возвращены на склад</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>Claimed</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Поступил на склад для проверки</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Выкупленный товар возвращён клиентом. Идёт проверка качества</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>Claimed ok</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Принят к возврату</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Проверка не выявила нарушений. Товар принят, требуется возврат денег</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>Claimed defective</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Принят к возврату как брак</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Обнаружен заводской брак. Товар не пригоден к продаже. Требуется возврат денег</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>Claimed used</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Не подлежит возврату как использованный</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Товар использован клиентом. В возврате денег отказано</td> 
</tr> 
</tbody> 
</table> 
 
<h2>Статусы возврата денежных средств</h2> 
 
<table style="border-collapse: collapse; width: 100%;"> 
<tbody> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Статус в API</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Статус в интерфейсе</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Описание</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>Refund necessary</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Требуется возврат денежных средств</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Создаётся автоматически для товаров, принятых к возврату</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>Refund investigation</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Сбор информации для возврата</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Недостаточно данных для перевода (например, реквизиты клиента)</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>Ready to refund</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">В процессе возврата</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Документы в работе у бухгалтерии</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>Refunded</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Денежные средства возвращены</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Деньги переведены покупателю</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>Refund by partner</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Возврат денежных средств партнёром</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Партнёр сам возвращает деньги клиенту (для FBS)</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>Non-Refund</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Не возвращён</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Товар принят к возврату, но деньги ещё не возвращены</td> 
</tr> 
</tbody> 
</table> 
 
<h2>Схема переходов статусов возврата</h2> 
 
Delivered (Доставлен) 
↓ 
[Клиент возвращает товар] 
↓ 
Claimed (На проверке) 
↓ 
 
↓ ↓ ↓ 
Claimed ok Claimed defective Claimed used 
↓ ↓ ↓ 
Refund necessary Refund necessary [Конец] 
↓ 
Refund by partner / Refunded 
<h2>Невыкуп: схема переходов</h2> 
 
In Delivery (В доставке) 
↓ 
[Клиент отказывается] 
↓ 
Not bought 
↓ 
Returned (Возвращён на склад) 
<h2>Причины возврата/невыкупа</h2> 
 
При обновлении статуса товара на <code>not_delivered</code> или <code>canceled</code> необходимо указать причину: 
 
<h3>Причины отмены (canceled)</h3> 
 
<ul> 
<li>Отсутствие удобного дня доставки</li> 
<li>Отсутствие удобного промежутка времени для доставки</li> 
<li>Отсутствие подходящего метода доставки</li> 
<li>Нет нужной позиции/размера в наличии</li> 
<li>Товар больше не нужен</li> 
<li>Доставка в регион клиента не осуществляется</li> 
<li>Техническое ограничение при подтверждении</li> 
</ul> 
 
<h3>Причины невыкупа (not_delivered)</h3> 
 
<ul> 
<li>Размер не подошёл</li> 
<li>Не соответствует описанию/фото</li> 
<li>Низкое качество изготовления, материала</li> 
<li>Брак, некомплект, следы примерки</li> 
<li>Не подошёл фасон, посадка, стиль</li> 
<li>Доставлен не тот товар</li> 
<li>Товар не был доставлен</li> 
<li>Другое</li> 
</ul> 
 
<h2>Различия FBS и FBO</h2> 
 
 FBS: Возврат денег делает партнёр! 
В модели FBS партнёр самостоятельно возвращает деньги клиенту. После подтверждения возврата товар переходит в статус <code>Claimed ok</code>, затем автоматически в <code>Refund by partner</code>. 
<h3>FBO (Fulfillment by Operator)</h3> 
<ul> 
<li>Возврат обрабатывается на складе Lamoda</li> 
<li>Проверка качества — на стороне Lamoda</li> 
<li>Возврат денег — через Lamoda (если не настроено иначе)</li> 
</ul> 
 
<h3>FBS (Fulfillment by Seller)</h3> 
<ul> 
<li>Возврат может быть обработан на ПВЗ Lamoda или напрямую партнёром</li> 
<li>При возврате в магазин партнёра — проверка на стороне партнёра</li> 
<li>Возврат денег — всегда на стороне партнёра</li> 
</ul> 
 
<h2>Получение информации о возвратах</h2> 
 
Информация о возвратах доступна через статусы заказов и товаров: 
 
<pre><code># Получить заказы со статусами возврата 
<a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%97%D0%B0%D0%BA%D0%B0%D0%B7%D1%8B/get_api_1_get_orders">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%97%D0%B0%D0%BA%D0%B0%D0%B7%D1%8B/get_api_1_get_orders</a>" target="_blank">GET /api/v1/orders</a>?status=claimed 
 
# Получить детали заказа 
<a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%97%D0%B0%D0%BA%D0%B0%D0%B7%D1%8B/get_api_1_get_order_by_order_nr">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%97%D0%B0%D0%BA%D0%B0%D0%B7%D1%8B/get_api_1_get_order_by_order_nr</a>" target="_blank">GET /api/v1/orders/{id}</a> 
 
# Подсчёт заказов по группам статусов 
<a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%97%D0%B0%D0%BA%D0%B0%D0%B7%D1%8B/get_api_1_get_orders_count_by_statuses">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%97%D0%B0%D0%BA%D0%B0%D0%B7%D1%8B/get_api_1_get_orders_count_by_statuses</a>" target="_blank">GET /api/v1/orders/count-by-statuses</a></code></pre> 
 
Пример ответа count-by-statuses: 
 
<pre><code>{ 
 "count": [ 
 {"statusGroup": "group_delivered", "quantity": 592}, 
 {"statusGroup": "group_failed", "quantity": 1614}, 
 {"statusGroup": "group_claimed", "quantity": 6} 
 ] 
}</code></pre> 
 
 Группа group_claimed 
Включает все заказы со статусами возврата: Claimed, Claimed ok, Claimed defective, Claimed used. 
<h2>Частичный возврат</h2> 
 
Если клиент выкупил заказ и вернул только часть товаров: 
 
<ul> 
<li>Статус заказа: <code>Delivered</code></li> 
<li>Выкупленные товары: <code>Delivered</code></li> 
<li>Возвращённые товары: <code>Claimed ok</code> / <code>Claimed defective</code></li> 
</ul> 
 
<pre><code>{ 
 "id": "CZ123456789", 
 "status": "Delivered", 
 "items": [ 
 {"id": 1, "sku": "SKU001", "status": "Delivered"}, 
 {"id": 2, "sku": "SKU002", "status": "Claimed ok"} 
 ] 
}</code></pre> 
 
<h2>Нотификации о возвратах</h2> 
 
При изменении статуса товара на возвратный Lamoda отправляет нотификацию <code>itemStatusChanged</code>: 
 
<pre><code>{ 
 "type": "itemStatusChanged", 
 "trackingId": "123456789", 
 "data": { 
 "id": "CZ123456789", 
 "status": "Delivered", 
 "items": [ 
 { 
 "id": 7602, 
 "status": "Claimed ok", 
 "sku": "SELLERSK082", 
 "finalERPStatus": null, 
 "statusChangeReason": null 
 } 
 ] 
 } 
}</code></pre> 
 
<h2>См. также</h2> 
 
<ul> 
<li><a href="12_3_process_return.html">Обработка возврата</a></li> 
<li><a href="6_4_order_statuses.html">Статусы заказов</a></li> 
<li><a href="10_2_notification_types.html">Типы нотификаций</a></li> 
</ul>

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

Да Нет

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

Отправить

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

Пункты выдачи в API