FBS: обзор процесса в API

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

Обновлено

18.12.2025

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

FBS (Fulfillment by Seller) — модель работы, при которой товары хранятся на складе партнёра. Lamoda размещает товары на сайте, обрабатывает заказы и доставляет их клиентам. 
 
 
<h2>Принцип работы</h2> 
 
Схема FBS (также называется MP Crossdocking): 
 
<ol> 
<li>Клиент оформляет заказ на сайте Lamoda</li> 
<li>Lamoda передаёт заказ партнёру через API/нотификации</li> 
<li>Партнёр собирает заказ на своём складе</li> 
<li>Партнёр формирует поставку и передаёт посылки на склад Lamoda (Быково)</li> 
<li>Lamoda доставляет заказ клиенту через LM Express, xDC, ПВЗ или Почту России</li> 
<li>Невыкупленные товары возвращаются партнёру</li> 
</ol> 
 
<h2>Структура поставки FBS</h2> 
 
Поставка приходит на склад в иерархии: 
 
<pre> 
Поставка (shipment) 
Паллета (pallet) — грузовое место 
 Посылка (pack) — упакованный заказ для одного клиента 
 Товар (item) — единица товара 
</pre> 
 
<ul> 
<li>Паллета — контейнер для посылок (физически может быть коробом)</li> 
<li>Посылка — упаковка с товарами одного заказа</li> 
<li>Товар — конкретная единица товара</li> 
</ul> 
 
 Важно: Один заказ может состоять из нескольких посылок, но все посылки заказа должны быть в одной поставке. 
<h2>Жизненный цикл заказа FBS</h2> 
 
<table style="border-collapse: collapse; width: 100%;"> 
<tbody> 
<tr> 
<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>New to be confirmed</code></td><td style="border: 1px solid #ddd; padding: 8px;">Заказ создан, ожидает подтверждения</td></tr> 
<tr><td style="border: 1px solid #ddd; padding: 8px;"><code>Confirmed</code></td><td style="border: 1px solid #ddd; padding: 8px;">Заказ подтверждён, адрес валидирован</td></tr> 
<tr><td style="border: 1px solid #ddd; padding: 8px;"><code>Ready for shipment</code></td><td style="border: 1px solid #ddd; padding: 8px;">Заказ упакован, готов к отгрузке</td></tr> 
<tr><td style="border: 1px solid #ddd; padding: 8px;"><code>Shipped</code></td><td style="border: 1px solid #ddd; padding: 8px;">Отгружен с основного склада</td></tr> 
<tr><td style="border: 1px solid #ddd; padding: 8px;"><code>Arrived to LME</code></td><td style="border: 1px solid #ddd; padding: 8px;">Прибыл на транзитный склад</td></tr> 
<tr><td style="border: 1px solid #ddd; padding: 8px;"><code>Left LME</code></td><td style="border: 1px solid #ddd; padding: 8px;">Отправлен с транзитного склада</td></tr> 
<tr><td style="border: 1px solid #ddd; padding: 8px;"><code>In delivery</code></td><td style="border: 1px solid #ddd; padding: 8px;">Передан в доставку</td></tr> 
<tr><td style="border: 1px solid #ddd; padding: 8px;"><code>Delivered</code></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></tr> 
<tr><td style="border: 1px solid #ddd; padding: 8px;"><code>Sent back to partner</code></td><td style="border: 1px solid #ddd; padding: 8px;">Отправлен обратно партнёру</td></tr> 
</tbody> 
</table> 
 
<h2>Основные API-методы FBS</h2> 
 
<h3>Получение заказов</h3> 
 
<pre> 
<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=Confirmed 
</pre> 
 
<h3>Создание поставки</h3> 
 
<pre> 
<a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%A3%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5%20%D0%BE%D1%82%D0%B3%D1%80%D1%83%D0%B7%D0%BA%D0%B0%D0%BC%D0%B8%20FBS/post_api_1_post_shipment_out">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%A3%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5%20%D0%BE%D1%82%D0%B3%D1%80%D1%83%D0%B7%D0%BA%D0%B0%D0%BC%D0%B8%20FBS/post_api_1_post_shipment_out</a>" target="_blank">POST /api/v1/shipments/out</a> 
 
{ 
 "id": "SHIP-2025-001", 
 "type": "Sale", 
 "shippedAt": "2025-01-20", 
 "destination": "PPBykovo", 
 "containers": [ 
 { 
 "barcode": "PAL001", 
 "type": "pallet", 
 "containers": [ 
 { 
 "barcode": "FBS123456789", 
 "type": "pack", 
 "items": [ 
 { 
 "orderNr": "CZ117391950", 
 "sku": "XD001XW03JMM", 
 "unitload": "CZ117391950-001", 
 "datamatrix": "..." 
 } 
 ] 
 } 
 ] 
 } 
 ] 
} 
</pre> 
 
<h3>Генерация этикеток</h3> 
 
<ul> 
<li><code><a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%AD%D1%82%D0%B8%D0%BA%D0%B5%D1%82%D0%BA%D0%B8%20FBS/post_api_1_items_get_label">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%AD%D1%82%D0%B8%D0%BA%D0%B5%D1%82%D0%BA%D0%B8%20FBS/post_api_1_items_get_label</a>" target="_blank">POST /api/v1/label/items</a></code> — товарные этикетки</li> 
<li><code><a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%AD%D1%82%D0%B8%D0%BA%D0%B5%D1%82%D0%BA%D0%B8%20FBS/post_api_1_packs_get_label">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%AD%D1%82%D0%B8%D0%BA%D0%B5%D1%82%D0%BA%D0%B8%20FBS/post_api_1_packs_get_label</a>" target="_blank">POST /api/v1/label/packs</a></code> — паковые этикетки</li> 
<li><code><a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%AD%D1%82%D0%B8%D0%BA%D0%B5%D1%82%D0%BA%D0%B8%20FBS/post_api_1_pallets_get_label">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%AD%D1%82%D0%B8%D0%BA%D0%B5%D1%82%D0%BA%D0%B8%20FBS/post_api_1_pallets_get_label</a>" target="_blank">POST /api/v1/label/pallets</a></code> — паллетные этикетки</li> 
</ul> 
 
<h2>Параметр CutOff</h2> 
 
<code>CutOff</code> — время, до которого заказ должен быть отправлен со склада партнёра. 
 
 Правило: Отгружайте заказы максимально близко к CutOff. При <code>CutOff = null</code> — в ближайшую поставку. 
<h2>Обратное товародвижение</h2> 
 
Невыкупленные товары и возвраты: 
 
<ol> 
<li>Возвращаются на склад Lamoda</li> 
<li>Проходят приёмку и проверку</li> 
<li>Отправляются партнёру (минимум раз в неделю)</li> 
</ol> 
 
Забор происходит с того же склада, куда поставлялись заказы (Быково). 
 
<h2>Ограничения</h2> 
 
<ul> 
<li>Разница между датой создания заказа и поставки — не более 6 дней</li> 
<li>Barcode посылок в API должен совпадать со штрих-кодом физической посылки</li> 
<li>После отправки поставки нельзя дослать заказы</li> 
<li>Отмена поставки возможна только до сверки документов в ЭДО</li> 
</ul> 
 
<h2>Методы обновления цен FBS</h2> 
 
 Частая ошибка: Для FBS используйте <code>v1.nomenclature.set-price</code>, а не <code>update-price</code> (который для FBO). 
<h2>См. также</h2> 
 
<ul> 
<li><a href="6_1_fbs_vs_fbo.html">FBS vs FBO</a></li> 
<li><a href="7_2_create_shipment.html">Создание отгрузки FBS</a></li> 
<li><a href="6_4_order_statuses.html">Статусы заказов</a></li> 
</ul>

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

Да Нет

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

Отправить

Создание отгрузки FBS через API

Товары в заказе