Продажа со своего склада (FBS)

Схема FBS (Fulfillment by Seller) — товар хранится у вас на складе. По поступившему заказу вы сами комплектуете и маркируете товар, формируете отгрузку на сортировочный центр Lamoda и самостоятельно принимаете возвраты.

Эта статья описывает порядок работы с методами API на каждом шаге; бизнес-процесс, термины и работа в личном кабинете подробно разобраны в разделе «Продажа со своего склада (FBS)» Академии (в частности — «Схема работы FBS»).

Детали каждого метода (параметры, поля, значения, примеры) смотрите в справочнике по ссылке на метод.

Процесс работы по FBS состоит из нескольких действий: обновить остатки, собрать заказ, сформировать отгрузку. При этом важно помнить, что статус заказов не меняется вручную, а является результатом выполнения одного из перечисленных выше действий.

Важно различать сборку и отгрузку заказов:

• Сборка всегда относится к одному заказу: вы комплектуете конкретный заказ, раскладываете его товары по упаковкам, сохраняете коды маркировки. В результате этого шага заказ переходит в статус «Ждёт отгрузки».
• Отгрузка относится к партии заказов: вы берёте несколько уже собранных заказов, раскладываете их упаковки по грузовым местам (в API грузовые места называются pallets: короб или паллета) и создаёте одну физическую отгрузку на сортировочный центр. Одно грузовое место может содержать упаковки из разных заказов.

То есть сначала вы собираете каждый заказ по отдельности, затем одной отгрузкой отправляете сразу несколько собранных заказов. Правила формирования отгрузки в ЛК — в статье «Правила работы с отгрузками в FBS».

Порядок работы с FBS-заказами состоит из следующих этапов:

1. Поддержка товарных остатков в актуальном состоянии, чтобы приходили заказы.
2. Получение новых заказов.
3. Сборка заказа (по завершению этапа заказ переходит в статус «Ждёт отгрузки»).
4. Печать этикеток на упаковки, товары и грузовые места.
5. Формирование отгрузки из собранных заказов и отправка отгрузок на сортцентр Lamoda.
6. Дальше статус ведёт Lamoda (приёмка, доставка) — вы только отслеживаете его статус. Ручная смена статуса возможна только для исключеных ситуаций.
7. Прием возвратов.

Как своевременно узнавать о новых заказах и сменах статусов (поллинг + webhooks) — в статье «Синхронизация и события».

Далее, в разделах ниже, каждый из этапов работы с заказами описан более подробно.

1. Поддержка товарных остатков в актуальном состоянии

Продавец сообщает Lamoda доступное к продаже количество товарных остатков. Количество указывается без учёта резервов. За один запрос можно обновить остатки максимум для 100 SKU.

• POST /v2/fbs/stocks — обновить остатки.
• GET /v2/fbs/stocks — проверить текущие остатки. Важно помнить, что при создании заказа, Ламода сама вычитает кол-во проданных единиц товара в заказе из остатков по данному товару.

2. Получение новых заказов

GET /v2/orders — возвращает список заказов (фильтры по дате изменения и statusGroup). В списке у каждого заказа есть и orderId (групповой номер заказа), и id (внутренний номер заказа) — именно id используется во всех методах ниже.

Для регулярной синхронизации фильтруйте заказы по дате изменения и группе статусов. Заказы, готовые к сборке, относятся к группе статусов AWAITING_SHIPMENT («Ждут отгрузки»).

Группа статусов шире одноимённого статуса: в неё попадают и заказы, которые ещё предстоит собрать.

Русскоязычные названия статусов здесь являются ориентирами, взятыми из интерфейса ЛК Lamoda Seller. Точные API-значения смотрите в справочнике соответствующего метода.

• GET /v2/orders/{orderId} — детали заказа, включая позиции items[]. Из items[] берутся items[].id (нужны для сборки, статусов позиций и как unitload при отгрузке) и срок deliveryMethod.cutOff, к которому заказ необходимо собрать и отгрузить на сортировочный центр Lamoda.
• GET /v2/orders/{orderId}/item-statuses, GET /v2/orders/{orderId}/status-history — вовзвращают статусы позиций заказа и историю смены. статусов заказа.
• GET /v2/orders/{orderId}/invoice — ссылка на накладную по заказу.

3. Сборка заказа

Сборка заказа — основной шаг подготовки заказа к отгрузке: вы раскладываете товары заказа по упаковкам и сохраняете распределение, после чего заказ переходит в статус «Ждёт отгрузки».

• POST /v2/orders/{orderId}/assembly — распределить позиции (items[].id из шага 2) по упаковкам. Каждый элемент — одна упаковка со своим списком позиций.
• POST /v2/orders/{orderId}/packs — сгенерировать паковые штрихкоды для наклейки на упаковки. Полученные packNumber понадобятся для этикеток (шаг 4) и в качестве packId при создании отгрузки (шаг 5).

4. Печать этикеток

После сборки заказа печатаются этикетки. Этикетки обязательно клеятся на каждое грузовое место: без них склад Lamoda не примет отгрузку.

• POST /v2/labels/order-packs — получить этикетки на упаковки (по packNumber из шага 3).
• POST /v2/labels/order-items — получить этикетки на отдельные товары (по id позиций).
• POST /v2/labels/pallets — получить этикетки на грузовые места (паллеты). Баркоды грузовых мест (palletBarcodes) появляются далее при формировании отгрузки (шаг 5).
• GET /v2/orders/{orderId}/packs/{packNumber}/label — PDF-этикетка одной упаковки напрямую.

5. Формирование отгрузок

Собранные упаковки раскладываются по грузовым местам (в API pallets — это короб или паллета), грузовые места собираются в одну отгрузку на сортировочный центр. В качестве packId передаются паковые номера из шага 3, в качестве unitload — id позиций (items) из деталей заказа.

• POST /v2/fbs/shipments — создает отгрузку из собранных упаковок.
• POST /v2/fbs/prepared-shipments — отгрузка «вручную»: когда вы декларируете уже подготовленную отгрузку со своими данными документа, а не собираете её из системных упаковок.
• GET /v2/fbs/shipments, GET /v2/fbs/shipments/{shipmentId}, GET /v2/fbs/shipments/{shipmentId}/items — для отслеживания отгрузки и её состава.
• GET /v2/fbs/order-containers/{containerBarcode} — контейнер по штрихкоду (штрихкод определяется как упаковка или паллета автоматически).

6. Смена статусов

В обычном потоке статус меняется сам (действиями и на стороне Lamoda). Ручная смена статуса нужна лишь для исключений — отмена и возврат.

• POST /v2/orders/{orderId}/status — статус всего заказа.
• POST /v2/orders/{orderId}/items/{itemId}/status — статус отдельной позиции.

7. Обработка заявок на вывоз

Заявку на приезд курьера формирует логистика Lamoda — это запланированный визит для забора возвратов или доставки. Продавцу через API доступны только чтение списка заявок и их отмена; создавать и переносить заявки через API нельзя.

Тип заявки (type): DELIVERY — доставка, RETURN — возврат (забор возвратных коробов).

• GET /v2/fbs/pickup-requests — список заявок. Фильтры: по дате (dateFrom/dateTo/date), типу (type), статусам (statuses), с пагинацией и сортировкой. По каждой заявке доступны идентификатор (requestId), дата, тип, статус, планируемое время прибытия и отбытия курьера (arrivalAt/departureAt — могут отсутствовать, пока заявка не запланирована на исполнение), интервал прибытия и список курьеров.
• POST /v2/fbs/pickup-requests/{requestId}/status — сменить статус заявки. Единственное доступное продавцу значение — CANCELLED (отмена).

Статусы заявки (PickupRequestStatus):

Как физически забрать возврат (зависит от базового склада и метода доставки) — см. инструкцию «Как забрать возврат» в разделе «Возвраты FBS» личного кабинета.

8. Работа с возвратами

Когда покупатель возвращает, не выкупает или не забирает товар FBS, товар едет обратно на склад Lamoda, комплектуется в возвратный короб и становится доступен продавцу для вывоза со склада.

Подробно бизнес-процесс — в статьях «Основная информация по возвратам FBS» и «Расхождения при приеме возврата».

В API возврат представлен двумя сущностями: возвратные товары (позиции) и возвратные короба (физические коробки, в которые Lamoda складывает возвраты для отгрузки продавцу).

Жизненный цикл возвратного товара (ReturnItemStatus), в правой колонке — название статуса в личном кабинете:

На некоторых базовых складах часть статусов может отсутствовать.

Получить список товаров к возврату:

• GET /v2/fbs/return-items — список возвратных товаров. Фильтры: статус (status), период даты возврата (returnDateFrom/returnDateTo), короб (boxId), пагинация, сортировка. По каждому товару: наименование, sku/externalSku (Seller SKU), orderId, дата возврата, цена (согласованная с продавцом, без скидок лояльности, в копейках), изображение, идентификатор короба.
• GET /v2/fbs/return-items/{itemId}/status-history — история статусов товара.
• GET /v2/fbs/return-items-summary — количество товаров по статусам (быстрая сводка без выгрузки всего списка).

Получить список возвратных коробов:

• GET /v2/fbs/return-boxes — список коробов с фильтрами по периоду создания (createdFrom/createdTo).
• GET /v2/fbs/return-boxes/{id} — состав и данные короба (размер, габариты, статус, товары внутри).
• GET /v2/fbs/return-boxes/{id}/status-history — история статусов короба.
• GET /v2/fbs/return-boxes-summary — сводка по коробам (сколько готово к забору, суммарный объём).
• GET /v2/fbs/return-boxes-anomalies — короба с аномалиями (расхождениями).

Типичный сценарий: периодически опрашивайте GET /v2/fbs/return-items?status=READY_TO_RETURN (что готово к вывозу) и GET /v2/fbs/return-boxes, сверяйте с заявками на вывоз (раздел 7) и забирайте короба со склада. Быструю сводку без полной выгрузки дают *-summary-методы.

См. также

• Каталог: карточки товаров и цены
• Синхронизация и события
• Продажа со склада Lamoda (FBO)
• Начало работы и авторизация
• Частые вопросы (FAQ)