Продажа со склада Lamoda (FBO)

При работе по схеме FBO (Fulfillment by Operator) ваш товар хранится и отгружается со склада Lamoda.

Вы формируете поставку на распределительный центр Lamoda. После успешной приёмки товар появляется в остатках и попадает в продажу, а сборку заказов, доставку покупателю и возвраты осуществляет Lamoda.

Эта статья описывает порядок работы с методами API; а сам бизнес-процесс подробно описан в статьях раздела «Продажа со склада Lamoda (FBO)» Академии.

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

Как устроен процесс

При работе по схеме FBO вы не собираете и не отгружаете заказы — это делает Lamoda со своего склада. Ваша зона ответственности заканчивается на поставке товара на склад Lamoda; дальше вы отслеживаете приёмку, остатки и заказы.

Жизненный цикл поставки:

1. Создание — вы формируете поставку: что, сколько, на какой склад, к какой плановой дате.
2. Отправка и приёмка — поставка едет на распределительный центр Lamoda; там проверяют документы, разгружают и принимают товар по количеству и качеству.
3. Завершение — после приёмки поставка закрывается, а остаток проставляется автоматически: принятый товар становится доступен к продаже.

Как физически устроены поставка и приёмка (что подготовить, требования к упаковке/маркировке, бронирование слота на воротах склада) — см. «Поставки FBO» и «Бронирование поставок и возвратов FBO (Gate Management)».

Порядок работы

1. Создание поставки

Определите состав поставки, склад-получатель и плановую дату, когда поставка будет отгружена на склад.

В теле указываются ваш идентификатор поставки (externalShipmentId — для сопоставления на своей стороне), код склада, дата и позиции (externalSku = ваш supplierSku из карточки товара — см. «Каталог: карточки товаров и цены»; количество; цена; при необходимости — коды маркировки).

• POST /v2/fbo/shipments — создать поставку. В ответе — id поставки на стороне Lamoda; он подставляется в пути методов ниже. Статус в ответе не приходит — читайте его отдельно (шаг 2).

Код склада (warehouseCode) задаётся строкой. В настоящее время доступные значения для кода склада: BYKOVO (Быково) или SOFINO (Софьино).

Для категорий с обязательной маркировкой («Честный знак») поставка не пройдёт без items[].markingCodes.

Как подготовить поставку — см. «Подготовка к поставке».

2. Отслеживание поставки и приёмки

После отправки следите за статусом и прогрессом приёмки — сколько из запланированного реально принято, недосчитано или забраковано.

• GET /v2/fbo/shipments — список поставок (фильтры по плановой дате from/to, status).
• GET /v2/fbo/shipments/{shipmentId} — детали поставки.
• GET /v2/fbo/shipments/{shipmentId}/items — товары поставки с фактом приёмки по каждому.
• GET /v2/fbo/shipments/{shipmentId}/status-history — хронология переходов статуса.

Прогресс приёмки поставок можно отслеживать в агрегате statistics по поставке и по каждому товару в items.

Ключевые маркеры в statistics:

• acceptedItems означает количество принятого товара, которое отразится на остатках.
• receivedItems означает, что товар физически получено (включая, поврежденные товары и излишки).

Полный состав полей агрегата statistics смотрите в справочнике метода.

Как выстроить процесс синхронизации поставок и заказов см. в статье «Синхронизация и события».

3. Отмена поставки

Для отмены поставки используйте метод:

POST /v2/fbo/shipments/{shipmentId}/cancel — отменить поставку (в теле — sellerId и cancelReason). Список причин и их значения смотрите в справочнике метода.

4. Получение остатков

Используйте следующие методы для получения количества остатков, доступное к продаже, по каждому складу.

• GET /v2/fbo/stocks — остатки (фильтры по warehouseCode, sku/externalSku, withZeroQuantity).
• GET /v2/stocks-summary — сводка по остаткам.
• GET /v2/stocks/illiquid — сводка по заблокированным остаткам, методв помогает выявить товары, которые не продаются на маркетплейсе.

5. Справочник категорий

• GET /v2/fbo/categories — дерево категорий товаров, доступных на FBO-складах.

6. Отслеживание заказов

При работе по схеме FBO вы можете отслеживать заказы, но сборку и доставку заказов осуществляет Lamoda.

• GET /v2/orders возвращает статусы ваших заказов (общий метод; фильтры по времени изменения и группе статусов). Действий по сборке/отгрузке в FBO на стороне продавца нет; подробнее об отслеживании заказов читайте в статье «Синхронизация и события».

7. Возвраты

При работе по схеме FBO Lamoda сама возвращает непроданный или возвращённый покупателем товар на свой склад — отдельных методов возвратов для FBO не предусмотрено.

Как устроены возвраты со склада — см. «Возвраты FBO».

См. также

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