Содержание статьи
<h1>13.1 Типы возвратов и статусы</h1><br />
<p><br />
На Lamoda существует два типа возвратного потока: <b>клиентский возврат</b> (товар выкуплен и возвращён) и <b>невыкуп</b> (клиент отказался при получении). Работа с возвратами отличается в зависимости от модели фулфилмента — FBS или FBO.<br />
</p><br />
<div style="background-color: #e7f3fe; border: 1px solid #b6d4fe; padding: 15px; border-radius: 4px; margin: 15px 0;"><br />
<b>API для работы с возвратами</b><br><br />
<br><br />
<table style="border-collapse: collapse; width: 100%;"><br />
<tbody><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>API</b><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Базовый URL</b><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Модель</b><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Назначение</b><br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
REST API v2<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code><a class="txttohtmllink" href="https://public-api-seller.lamoda.ru">https://public-api-seller.lamoda.ru</a></code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Только FBS<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Мониторинг возвратных товаров и коробов (read-only)<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
B2B Platform API v1<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code><a class="txttohtmllink" href="https://api-b2b.lamoda.ru/api/v1/">https://api-b2b.lamoda.ru/api/v1/</a></code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
FBS<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Подтверждение возврата (<code>change_status_request</code>)<br />
</td><br />
</tr><br />
</tbody><br />
</table><br />
<p style="margin-top: 10px; margin-bottom: 0;"><br />
<b>FBO:</b> В модели FBO отдельного API для возвратов нет — Lamoda обрабатывает возвраты автоматически. Партнёр отслеживает статусы через <code>GET /api/v1/orders</code> и нотификации.<br />
</p><br />
</div><br />
<h2>Различия FBS и FBO при возвратах</h2><br />
<table style="border-collapse: collapse; width: 100%;"><br />
<tbody><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Аспект</b><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>FBS (Fulfillment by Seller)</b><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>FBO (Fulfillment by Operator)</b><br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Обработка возврата<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
На ПВЗ Lamoda или в магазине партнёра<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
На складе Lamoda<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Проверка качества<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
На стороне партнёра<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
На стороне Lamoda<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Возврат денег клиенту<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Партнёр</b> возвращает самостоятельно<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Lamoda</b> возвращает<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Подтверждение возврата через API<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>POST /api/v1/orders/{orderNr}/change_status_request</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Не требуется (Lamoda обрабатывает сама)<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Мониторинг возвратов<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
REST API v2: <code>/api/v2/fbs/return-*</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Через статусы заказов: <code>GET /api/v1/orders</code><br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Маркировка (DataMatrix)<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Партнёр управляет кодами маркировки<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Lamoda управляет кодами маркировки<br />
</td><br />
</tr><br />
</tbody><br />
</table><br />
<h2>Типы возвратов (REST API v2)</h2><br />
<p><br />
В новом REST API v2 возвраты классифицируются по полю <code>returnType</code>:<br />
</p><br />
<table style="border-collapse: collapse; width: 100%;"><br />
<tbody><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Тип</b><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Описание</b><br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>CLAIM</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Клиентский возврат — товар был выкуплен и возвращён<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>REJECT</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Невыкуп — клиент отказался от товара при получении<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>CANCEL</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Отмена — заказ отменён до доставки<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>NO_SHOW</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Неявка — клиент не явился за заказом<br />
</td><br />
</tr><br />
</tbody><br />
</table><br />
<h2>Статусы возвратов: B2B Platform API v1</h2><br />
<h3>Статусы проверки качества</h3><br />
<table style="border-collapse: collapse; width: 100%;"><br />
<tbody><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Статус в API</b><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Статус в интерфейсе</b><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Описание</b><br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>Claimed</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
На проверке<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Товар получен, идёт проверка качества<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>Claimed ok</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Принят к возврату<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Проверка не выявила нарушений. Товар принят, требуется возврат денег<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>Claimed defective</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Принят к возврату как брак<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Обнаружен заводской брак. Товар не пригоден к продаже. Требуется возврат денег<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>Claimed used</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Не подлежит возврату как использованный<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Товар использован клиентом. В возврате денег отказано<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>Not bought</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Невыкуп<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Клиент отказался от товара при получении<br />
</td><br />
</tr><br />
</tbody><br />
</table><br />
<h3>Статусы возврата денежных средств</h3><br />
<table style="border-collapse: collapse; width: 100%;"><br />
<tbody><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Статус в API</b><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Статус в интерфейсе</b><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Описание</b><br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>Refund necessary</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Требуется возврат денежных средств<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Создаётся автоматически для товаров, принятых к возврату<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>Refund investigation</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Сбор информации для возврата<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Недостаточно данных для перевода (например, реквизиты клиента)<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>Ready to refund</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
В процессе возврата<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Документы в работе у бухгалтерии<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>Refunded</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Денежные средства возвращены<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Деньги переведены покупателю (FBO)<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>Refund by partner</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Возврат денежных средств партнёром<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Партнёр сам возвращает деньги клиенту (FBS)<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>Non-Refund</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Не возвращён<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Товар принят к возврату, но деньги ещё не возвращены<br />
</td><br />
</tr><br />
</tbody><br />
</table><br />
<h2>Статусы возвратов: REST API v2 (только FBS)</h2><br />
<h3>Статусы возвратных товаров</h3><br />
<table style="border-collapse: collapse; width: 100%;"><br />
<tbody><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Статус</b><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Описание</b><br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>CREATED</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Возврат создан<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>LEFT_TO_WH</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Едет на склад Lamoda<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>ARRIVED_TO_WH</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
На складе Lamoda<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>READY_TO_RETURN</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Готов к возврату партнёру<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>SHIPPED</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Отгружен партнёру<br />
</td><br />
</tr><br />
</tbody><br />
</table><br />
<h3>Статусы возвратных коробов</h3><br />
<table style="border-collapse: collapse; width: 100%;"><br />
<tbody><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Статус</b><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Описание</b><br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>CREATED</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Короб создан<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>IN_PROGRESS</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
В процессе наполнения<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>ACCEPTED</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Принят, готов к отгрузке<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>SHIPPED</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Отгружен партнёру<br />
</td><br />
</tr><br />
</tbody><br />
</table><br />
<h2>Маппинг статусов: B2B Platform v1 → REST API v2</h2><br />
<p><br />
При миграции на новый REST API v2 типы и статусы возвратов меняют формат. Ниже — соответствие старых статусов новым понятиям в v2.<br />
</p><br />
<table style="border-collapse: collapse; width: 100%;"><br />
<tbody><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>B2B Platform API v1</b><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>REST API v2 (returnType)</b><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Пояснение</b><br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>Claimed</code>, <code>Claimed ok</code>, <code>Claimed defective</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>CLAIM</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Клиентский возврат. В v1 — несколько этапов проверки. В v2 — единый тип <code>CLAIM</code>, этапы отражаются в <code>status</code> товара<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>Not bought</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>REJECT</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Невыкуп. Клиент отказался при получении<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>Canceled</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>CANCEL</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Заказ отменён до доставки<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
—<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>NO_SHOW</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Неявка клиента. Новый тип, не имеет прямого аналога в v1<br />
</td><br />
</tr><br />
</tbody><br />
</table><br />
<div style="background-color: #fff3cd; border: 1px solid #ffc107; padding: 15px; border-radius: 4px; margin: 15px 0;"><br />
<b>Важно:</b> REST API v2 и B2B Platform API v1 — это разные системы статусов. В v2 тип возврата (<code>returnType</code>) и текущее состояние (<code>status</code>) разделены. В v1 статус товара содержит и тип, и состояние одновременно (например, <code>Claimed ok</code> = тип «возврат» + состояние «принят»).<br />
</div><br />
<h2>Схема переходов статусов возврата (B2B Platform API v1)</h2><br />
<h3>Клиентский возврат</h3><br />
<img width="688" alt="13_1_client_return.png" src="/upload/medialibrary/fdb/pp2llkixpom3fu15wuuun7wijr4y45qg.png" height="800" title="13_1_client_return.png"><br><br />
<h3>Невыкуп</h3><br />
<img width="284" alt="13_1_client_not_bought.png" src="/upload/medialibrary/4b4/vmr9hee6j1kz3ryh10rv71fub2ru1p5s.png" height="600" title="13_1_client_not_bought.png"><br><br />
<h2>Причины возврата и невыкупа</h2><br />
<p><br />
При обновлении статуса товара на <code>not_delivered</code> или <code>canceled</code> через B2B Platform API v1 необходимо указать причину.<br />
</p><br />
<h3>Причины отмены (canceled)</h3><br />
<ul><br />
<li>Отсутствие удобного дня доставки</li><br />
<li>Отсутствие удобного промежутка времени для доставки</li><br />
<li>Отсутствие подходящего метода доставки</li><br />
<li>Нет нужной позиции/размера в наличии</li><br />
<li>Товар больше не нужен</li><br />
<li>Доставка в регион клиента не осуществляется</li><br />
<li>Техническое ограничение при подтверждении</li><br />
</ul><br />
<h3>Причины невыкупа (not_delivered)</h3><br />
<ul><br />
<li>Размер не подошёл</li><br />
<li>Не соответствует описанию/фото</li><br />
<li>Низкое качество изготовления, материала</li><br />
<li>Брак, некомплект, следы примерки</li><br />
<li>Не подошёл фасон, посадка, стиль</li><br />
<li>Доставлен не тот товар</li><br />
<li>Товар не был доставлен</li><br />
<li>Другое</li><br />
</ul><br />
<h2>Частичный возврат</h2><br />
<p><br />
Если клиент выкупил заказ и вернул только часть товаров:<br />
</p><br />
<ul><br />
<li>Статус заказа: <code>Delivered</code></li><br />
<li>Выкупленные товары: <code>Delivered</code></li><br />
<li>Возвращённые товары: <code>Claimed ok</code> / <code>Claimed defective</code></li><br />
</ul><br />
<pre><code>{<br />
"id": "CZ123456789",<br />
"status": "Delivered",<br />
"items": [<br />
{"id": 1, "sku": "SKU001", "status": "Delivered"},<br />
{"id": 2, "sku": "SKU002", "status": "Claimed ok"}<br />
]<br />
}</code></pre><br />
<h2>Нотификации о возвратах</h2><br />
<p><br />
При изменении статуса товара на возвратный Lamoda отправляет нотификацию <code>itemStatusChanged</code>:<br />
</p><br />
<pre><code>{<br />
"type": "itemStatusChanged",<br />
"trackingId": "123456789",<br />
"data": {<br />
"id": "CZ123456789",<br />
"status": "Delivered",<br />
"items": [<br />
{<br />
"id": 7602,<br />
"status": "Claimed ok",<br />
"sku": "SELLERSK082",<br />
"finalERPStatus": null,<br />
"statusChangeReason": null<br />
}<br />
]<br />
}<br />
}</code></pre><br />
<div style="background-color: #f8d7da; border: 1px solid #f5c6cb; padding: 15px; border-radius: 4px; margin: 15px 0;"><br />
<b>Важно: миграция нотификаций (FBS)</b><br><br />
<br />
С <b>24 февраля 2026 года</b> возвратные статусы перестанут передаваться через нотификации <code>itemStatusChanged</code> и методы <code>GET /api/v1/orders</code>. Для мониторинга возвратов FBS используйте новые методы <code>/api/v2/fbs/return-*</code>. Подробнее — в разделе <a href="12_2_fbs_returns.html">Возвраты FBS</a>.<br />
</div><br />
<div style="background-color: #fff3cd; border: 1px solid #ffc107; padding: 15px; border-radius: 4px; margin: 15px 0;"><br />
<b>⚠️ Миграция:</b> С 24 февраля 2026 старые статусы возвратов перестанут передаваться через <code>GET /api/v1/orders</code> и нотификации <code>itemStatusChanged</code>. Подробный план миграции и список затронутых методов: <a href="12_2_fbs_returns.html#миграция">Возвраты FBS → Миграция</a>.<br />
</div><br />
<h2>См. также</h2><br />
<ul><br />
<li><a href="12_2_fbs_returns.html">Возвраты FBS</a> — полное описание API для FBS-возвратов (REST API v2 + подтверждение через v1)</li><br />
<li><a href="6_4_order_statuses.html">Статусы заказов и товаров</a></li><br />
<li><a href="10_2_notification_types.html">Типы нотификаций</a></li><br />
</ul>
<p><br />
На Lamoda существует два типа возвратного потока: <b>клиентский возврат</b> (товар выкуплен и возвращён) и <b>невыкуп</b> (клиент отказался при получении). Работа с возвратами отличается в зависимости от модели фулфилмента — FBS или FBO.<br />
</p><br />
<div style="background-color: #e7f3fe; border: 1px solid #b6d4fe; padding: 15px; border-radius: 4px; margin: 15px 0;"><br />
<b>API для работы с возвратами</b><br><br />
<br><br />
<table style="border-collapse: collapse; width: 100%;"><br />
<tbody><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>API</b><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Базовый URL</b><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Модель</b><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Назначение</b><br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
REST API v2<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code><a class="txttohtmllink" href="https://public-api-seller.lamoda.ru">https://public-api-seller.lamoda.ru</a></code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Только FBS<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Мониторинг возвратных товаров и коробов (read-only)<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
B2B Platform API v1<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code><a class="txttohtmllink" href="https://api-b2b.lamoda.ru/api/v1/">https://api-b2b.lamoda.ru/api/v1/</a></code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
FBS<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Подтверждение возврата (<code>change_status_request</code>)<br />
</td><br />
</tr><br />
</tbody><br />
</table><br />
<p style="margin-top: 10px; margin-bottom: 0;"><br />
<b>FBO:</b> В модели FBO отдельного API для возвратов нет — Lamoda обрабатывает возвраты автоматически. Партнёр отслеживает статусы через <code>GET /api/v1/orders</code> и нотификации.<br />
</p><br />
</div><br />
<h2>Различия FBS и FBO при возвратах</h2><br />
<table style="border-collapse: collapse; width: 100%;"><br />
<tbody><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Аспект</b><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>FBS (Fulfillment by Seller)</b><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>FBO (Fulfillment by Operator)</b><br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Обработка возврата<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
На ПВЗ Lamoda или в магазине партнёра<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
На складе Lamoda<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Проверка качества<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
На стороне партнёра<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
На стороне Lamoda<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Возврат денег клиенту<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Партнёр</b> возвращает самостоятельно<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Lamoda</b> возвращает<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Подтверждение возврата через API<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>POST /api/v1/orders/{orderNr}/change_status_request</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Не требуется (Lamoda обрабатывает сама)<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Мониторинг возвратов<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
REST API v2: <code>/api/v2/fbs/return-*</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Через статусы заказов: <code>GET /api/v1/orders</code><br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Маркировка (DataMatrix)<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Партнёр управляет кодами маркировки<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Lamoda управляет кодами маркировки<br />
</td><br />
</tr><br />
</tbody><br />
</table><br />
<h2>Типы возвратов (REST API v2)</h2><br />
<p><br />
В новом REST API v2 возвраты классифицируются по полю <code>returnType</code>:<br />
</p><br />
<table style="border-collapse: collapse; width: 100%;"><br />
<tbody><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Тип</b><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Описание</b><br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>CLAIM</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Клиентский возврат — товар был выкуплен и возвращён<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>REJECT</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Невыкуп — клиент отказался от товара при получении<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>CANCEL</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Отмена — заказ отменён до доставки<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>NO_SHOW</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Неявка — клиент не явился за заказом<br />
</td><br />
</tr><br />
</tbody><br />
</table><br />
<h2>Статусы возвратов: B2B Platform API v1</h2><br />
<h3>Статусы проверки качества</h3><br />
<table style="border-collapse: collapse; width: 100%;"><br />
<tbody><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Статус в API</b><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Статус в интерфейсе</b><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Описание</b><br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>Claimed</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
На проверке<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Товар получен, идёт проверка качества<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>Claimed ok</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Принят к возврату<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Проверка не выявила нарушений. Товар принят, требуется возврат денег<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>Claimed defective</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Принят к возврату как брак<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Обнаружен заводской брак. Товар не пригоден к продаже. Требуется возврат денег<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>Claimed used</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Не подлежит возврату как использованный<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Товар использован клиентом. В возврате денег отказано<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>Not bought</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Невыкуп<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Клиент отказался от товара при получении<br />
</td><br />
</tr><br />
</tbody><br />
</table><br />
<h3>Статусы возврата денежных средств</h3><br />
<table style="border-collapse: collapse; width: 100%;"><br />
<tbody><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Статус в API</b><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Статус в интерфейсе</b><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Описание</b><br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>Refund necessary</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Требуется возврат денежных средств<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Создаётся автоматически для товаров, принятых к возврату<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>Refund investigation</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Сбор информации для возврата<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Недостаточно данных для перевода (например, реквизиты клиента)<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>Ready to refund</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
В процессе возврата<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Документы в работе у бухгалтерии<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>Refunded</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Денежные средства возвращены<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Деньги переведены покупателю (FBO)<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>Refund by partner</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Возврат денежных средств партнёром<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Партнёр сам возвращает деньги клиенту (FBS)<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>Non-Refund</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Не возвращён<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Товар принят к возврату, но деньги ещё не возвращены<br />
</td><br />
</tr><br />
</tbody><br />
</table><br />
<h2>Статусы возвратов: REST API v2 (только FBS)</h2><br />
<h3>Статусы возвратных товаров</h3><br />
<table style="border-collapse: collapse; width: 100%;"><br />
<tbody><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Статус</b><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Описание</b><br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>CREATED</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Возврат создан<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>LEFT_TO_WH</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Едет на склад Lamoda<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>ARRIVED_TO_WH</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
На складе Lamoda<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>READY_TO_RETURN</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Готов к возврату партнёру<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>SHIPPED</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Отгружен партнёру<br />
</td><br />
</tr><br />
</tbody><br />
</table><br />
<h3>Статусы возвратных коробов</h3><br />
<table style="border-collapse: collapse; width: 100%;"><br />
<tbody><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Статус</b><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Описание</b><br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>CREATED</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Короб создан<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>IN_PROGRESS</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
В процессе наполнения<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>ACCEPTED</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Принят, готов к отгрузке<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>SHIPPED</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Отгружен партнёру<br />
</td><br />
</tr><br />
</tbody><br />
</table><br />
<h2>Маппинг статусов: B2B Platform v1 → REST API v2</h2><br />
<p><br />
При миграции на новый REST API v2 типы и статусы возвратов меняют формат. Ниже — соответствие старых статусов новым понятиям в v2.<br />
</p><br />
<table style="border-collapse: collapse; width: 100%;"><br />
<tbody><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>B2B Platform API v1</b><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>REST API v2 (returnType)</b><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<b>Пояснение</b><br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>Claimed</code>, <code>Claimed ok</code>, <code>Claimed defective</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>CLAIM</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Клиентский возврат. В v1 — несколько этапов проверки. В v2 — единый тип <code>CLAIM</code>, этапы отражаются в <code>status</code> товара<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>Not bought</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>REJECT</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Невыкуп. Клиент отказался при получении<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>Canceled</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>CANCEL</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Заказ отменён до доставки<br />
</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
—<br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
<code>NO_SHOW</code><br />
</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><br />
Неявка клиента. Новый тип, не имеет прямого аналога в v1<br />
</td><br />
</tr><br />
</tbody><br />
</table><br />
<div style="background-color: #fff3cd; border: 1px solid #ffc107; padding: 15px; border-radius: 4px; margin: 15px 0;"><br />
<b>Важно:</b> REST API v2 и B2B Platform API v1 — это разные системы статусов. В v2 тип возврата (<code>returnType</code>) и текущее состояние (<code>status</code>) разделены. В v1 статус товара содержит и тип, и состояние одновременно (например, <code>Claimed ok</code> = тип «возврат» + состояние «принят»).<br />
</div><br />
<h2>Схема переходов статусов возврата (B2B Platform API v1)</h2><br />
<h3>Клиентский возврат</h3><br />
<img width="688" alt="13_1_client_return.png" src="/upload/medialibrary/fdb/pp2llkixpom3fu15wuuun7wijr4y45qg.png" height="800" title="13_1_client_return.png"><br><br />
<h3>Невыкуп</h3><br />
<img width="284" alt="13_1_client_not_bought.png" src="/upload/medialibrary/4b4/vmr9hee6j1kz3ryh10rv71fub2ru1p5s.png" height="600" title="13_1_client_not_bought.png"><br><br />
<h2>Причины возврата и невыкупа</h2><br />
<p><br />
При обновлении статуса товара на <code>not_delivered</code> или <code>canceled</code> через B2B Platform API v1 необходимо указать причину.<br />
</p><br />
<h3>Причины отмены (canceled)</h3><br />
<ul><br />
<li>Отсутствие удобного дня доставки</li><br />
<li>Отсутствие удобного промежутка времени для доставки</li><br />
<li>Отсутствие подходящего метода доставки</li><br />
<li>Нет нужной позиции/размера в наличии</li><br />
<li>Товар больше не нужен</li><br />
<li>Доставка в регион клиента не осуществляется</li><br />
<li>Техническое ограничение при подтверждении</li><br />
</ul><br />
<h3>Причины невыкупа (not_delivered)</h3><br />
<ul><br />
<li>Размер не подошёл</li><br />
<li>Не соответствует описанию/фото</li><br />
<li>Низкое качество изготовления, материала</li><br />
<li>Брак, некомплект, следы примерки</li><br />
<li>Не подошёл фасон, посадка, стиль</li><br />
<li>Доставлен не тот товар</li><br />
<li>Товар не был доставлен</li><br />
<li>Другое</li><br />
</ul><br />
<h2>Частичный возврат</h2><br />
<p><br />
Если клиент выкупил заказ и вернул только часть товаров:<br />
</p><br />
<ul><br />
<li>Статус заказа: <code>Delivered</code></li><br />
<li>Выкупленные товары: <code>Delivered</code></li><br />
<li>Возвращённые товары: <code>Claimed ok</code> / <code>Claimed defective</code></li><br />
</ul><br />
<pre><code>{<br />
"id": "CZ123456789",<br />
"status": "Delivered",<br />
"items": [<br />
{"id": 1, "sku": "SKU001", "status": "Delivered"},<br />
{"id": 2, "sku": "SKU002", "status": "Claimed ok"}<br />
]<br />
}</code></pre><br />
<h2>Нотификации о возвратах</h2><br />
<p><br />
При изменении статуса товара на возвратный Lamoda отправляет нотификацию <code>itemStatusChanged</code>:<br />
</p><br />
<pre><code>{<br />
"type": "itemStatusChanged",<br />
"trackingId": "123456789",<br />
"data": {<br />
"id": "CZ123456789",<br />
"status": "Delivered",<br />
"items": [<br />
{<br />
"id": 7602,<br />
"status": "Claimed ok",<br />
"sku": "SELLERSK082",<br />
"finalERPStatus": null,<br />
"statusChangeReason": null<br />
}<br />
]<br />
}<br />
}</code></pre><br />
<div style="background-color: #f8d7da; border: 1px solid #f5c6cb; padding: 15px; border-radius: 4px; margin: 15px 0;"><br />
<b>Важно: миграция нотификаций (FBS)</b><br><br />
<br />
С <b>24 февраля 2026 года</b> возвратные статусы перестанут передаваться через нотификации <code>itemStatusChanged</code> и методы <code>GET /api/v1/orders</code>. Для мониторинга возвратов FBS используйте новые методы <code>/api/v2/fbs/return-*</code>. Подробнее — в разделе <a href="12_2_fbs_returns.html">Возвраты FBS</a>.<br />
</div><br />
<div style="background-color: #fff3cd; border: 1px solid #ffc107; padding: 15px; border-radius: 4px; margin: 15px 0;"><br />
<b>⚠️ Миграция:</b> С 24 февраля 2026 старые статусы возвратов перестанут передаваться через <code>GET /api/v1/orders</code> и нотификации <code>itemStatusChanged</code>. Подробный план миграции и список затронутых методов: <a href="12_2_fbs_returns.html#миграция">Возвраты FBS → Миграция</a>.<br />
</div><br />
<h2>См. также</h2><br />
<ul><br />
<li><a href="12_2_fbs_returns.html">Возвраты FBS</a> — полное описание API для FBS-возвратов (REST API v2 + подтверждение через v1)</li><br />
<li><a href="6_4_order_statuses.html">Статусы заказов и товаров</a></li><br />
<li><a href="10_2_notification_types.html">Типы нотификаций</a></li><br />
</ul>
Помогла эта информация?
Спасибо за отзыв