Subtask 2-4: Business Models Documentation (FBL, FBS, etc.)

Date: 2025-02-10

Overview

Lamoda supports multiple business models for seller partnership, each with different operational workflows, API requirements, and responsibility distribution between the seller and Lamoda.

Business Models

1. FBS - Fulfillment by Seller (Выполнение заказов продавцом)

Description

FBS (Fulfillment by Seller) — модель работы, при которой продавец самостоятельно хранит товары на своем складе, комплектует и отправляет заказы покупателям.

Key Characteristics

• Хранение товаров: На складе продавца
• Комплектация: Выполняется продавцом
• Доставка: Отправка продавцом через службу доставки Lamoda
• Возвраты: Обрабатываются через FBS Return Boxes API
• Сток: Управляется через API (обновление остатков)

API Requirements

Seller JSON-RPC API:

• v1.stock.update — обновление остатков на складе продавца
• v1.nomenclatures.store — управление номенклатурой товаров
• v1.nomenclature.set-price — управление ценами (FBS/FBO)
• v1.stock.list — получение информации об остатках

B2B Platform API:

• GET /api/v1/orders — получение заказов
• PUT /api/v1/orders/{orderNr}/items/{itemId} — обновление статусов товаров
• POST /api/v1/label/packs — печать этикеток для заказов
• POST /api/v1/shipments/out — создание поставки на доставку

Seller REST API:

• GET /api/v2/fbs/return-boxes — получение информации о возвратах
• GET /api/v2/fbs/return-items — получение деталей товаров в возврате
• GET /api/v2/fbs/return-boxes-anomalies — выявление несоответствий в возвратах

Workflow

1. Загрузка каталога через Seller API
2. Установка цен через Seller API
3. Обновление стока через Seller API
4. Получение заказов через B2B Platform API
5. Комплектация заказа на складе продавца
6. Печать этикеток через B2B Platform API
7. Передача поставки в службу доставки через B2B Platform API
8. Обработка возвратов через Seller REST API (если необходимо)

Order Statuses (FBS)

Для FBS доступны только 2 статуса:

• canceled — отменен
• returned — возвращен

Responsibility Matrix

Операция	Кто выполняет
Хранение товаров	Продавец
Комплектация заказа	Продавец
Упаковка	Продавец
Передача в доставку	Продавец
Доставка клиенту	Lamoda (курьерская служба)
Возвраты	Lamoda → Продавец (через FBS Return Boxes)

Pros and Cons

Преимущества:

• Полный контроль над хранением и комплектацией
• Возможность быстрого обновления стока
• Отсутствие затрат на хранение на складе Lamoda

Недостатки:

• Необходимость собственного склада
• Обязательность комплектации и упаковки
• Сложнее масштабирование

---

2. FBO - Fulfillment by Operator/Lamoda (Выполнение заказов Lamoda)

Description

FBO (Fulfillment by Operator) — модель работы, при которой товары хранятся на складе Lamoda, а весь процесс комплектации, упаковки и доставки выполняется Lamoda.

Key Characteristics

• Хранение товаров: На складе Lamoda
• Комплектация: Выполняется Lamoda
• Упаковка: Выполняется Lamoda
• Доставка: Выполняется Lamoda
• Сток: Управляется через API (склад Lamoda)

API Requirements

Seller JSON-RPC API:

• v1.nomenclatures.store — управление номенклатурой товаров
• v1.nomenclature.set-price — управление ценами (FBS/FBO)
• v1.fbo.warehouse.list — получение списка складов Lamoda

B2B Platform API:

• POST /api/v1/shipments/fulfilment — создание поставки на склад Lamoda
• GET /api/v1/stock/goods — получение информации о стоке на складе Lamoda
• GET /api/v1/orders — получение заказов (автоматически комплектуются Lamoda)

Workflow

1. Загрузка каталога через Seller API
2. Установка цен через Seller API
3. Создание поставки на склад Lamoda через B2B Platform API
4. Передача товаров на склад Lamoda
5. Автоматическая комплектация заказов Lamoda
6. Автоматическая отправка заказов Lamoda

Fulfillment Flow

1. Продавец создает поставку через POST /api/v1/shipments/fulfilment
2. Товары передаются на склад Lamoda
3. Lamoda принимает товары и обновляет сток
4. При поступлении заказа Lamoda комплектует и отправляет
5. Продавец может отслеживать сток через GET /api/v1/stock/goods

Responsibility Matrix

Операция	Кто выполняет
Хранение товаров	Lamoda
Приемка товаров	Lamoda
Комплектация заказа	Lamoda
Упаковка	Lamoda
Доставка клиенту	Lamoda
Возвраты	Lamoda

Pros and Cons

Преимущества:

• Полное автоматическое выполнение заказов
• Нет необходимости в собственном складе
• Быстрая доставка (товары уже на складе Lamoda)
• Легкое масштабирование

Недостатки:

• Затраты на хранение на складе Lamoda
• Меньший контроль над процессом
• Необходимость создания поставок на склад

---

3. DBS - Delivery by Seller (Доставка продавцом)

Description

DBS (Delivery by Seller) — модель работы, при которой продавец осуществляет доставку заказов покупателям самостоятельно.

Key Characteristics

• Хранение товаров: На складе продавца
• Комплектация: Выполняется продавцом
• Доставка: Выполняется продавцом (курьеры продавца)
• Информация о доставке: Передается через API

API Requirements

B2B Platform API:

• GET /api/v1/delivery_info — получение доступных способов доставки
• GET /api/v1/delivery_methods — получение методов доставки
• Обновление статусов DBS заказов

Workflow

1. Продавец получает информацию о доступных методах доставки
2. Продавец комплектует заказ на своем складе
3. Продавец доставляет заказ своим курьером
4. Обновление статуса доставки через API

Use Cases

• Собственная курьерская служба продавца
• Экспресс-доставка в определенных регионах
• Специфические требования к доставке

---

4. B2B FF - B2B Fulfillment (Корпоративные заказы с выполнением Lamoda)

Description

B2B FF — модель работы для корпоративных клиентов (B2B), где fulfillment выполняется Lamoda.

Key Characteristics

• Хранение: На складе Lamoda
• Комплектация: Выполняется Lamoda
• Клиенты: Корпоративные (B2B)
• API Tags: "Номенклатуры", "Входящие поставки", "Уведомления о поставках"

API Requirements

B2B Platform API:

• Управление номенклатурой
• Работа с входящими поставками
• Уведомления о поставках

Use Cases

• Корпоративные продажи
• Оптовые заказы
• B2B интеграции

---

5. B2B FBS - B2B Fulfillment by Seller (Корпоративные заказы FBS)

Description

B2B FBS — модель работы для корпоративных клиентов (B2B), где fulfillment выполняется продавцом.

Key Characteristics

• Хранение: На складе продавца
• Комплектация: Выполняется продавцом
• Клиенты: Корпоративные (B2B)
• CutOff время: Указывается для B2B FBS заказов

API Requirements

B2B Platform API:

• Работа с заказами B2B
• Учет cutOff времени для отгрузки

Use Cases

• Корпоративные продажи с собственной доставкой
• Специфические требования B2B клиентов
• Особые условия комплектации

---

Comparison Table

Характеристика	FBS	FBO	DBS	B2B FF	B2B FBS
Хранение	Продавец	Lamoda	Продавец	Lamoda	Продавец
Комплектация	Продавец	Lamoda	Продавец	Lamoda	Продавец
Доставка	Lamoda	Lamoda	Продавец	Lamoda	Продавец
Тип клиентов	B2C	B2C	B2C	B2B	B2B
Управление стоком	Seller API	B2B API	Seller API	B2B API	Seller API
Печать этикеток	B2B API	—	—	—	—
Возвраты	FBS Return Boxes API	Lamoda	Продавец	Lamoda	Продавец
Поставки	На доставку (shipments/out)	На склад (shipments/fulfilment)	—	Входящие поставки	На доставку

API System Usage by Business Model

Seller JSON-RPC API

Используется для всех моделей:

• Управление номенклатурой товаров
• Управление ценами (FBS/FBO)
• Управление стоком
• Загрузка изображений
• Управление атрибутами товаров

B2B Platform API

Используется для:

• FBS: Получение заказов, печать этикеток, создание поставок на доставку, обновление статусов
• FBO: Создание поставок на склад, получение стока на складе Lamoda
• DBS: Получение информации о доставке, обновление статусов доставки
• B2B FF/B2B FBS: Специфические B2B операции

Seller REST API

Используется для:

• FBS: Управление возвратами (return boxes, return items, anomalies)
• Обработка обратной логистики

Business Model Detection in API Responses

Order Response Fields

API ответы могут содержать поля, указывающие на бизнес-модель:

{
  "orderNr": "RU220426-12345",
  "items": [...],
  "cutOff": "2025-02-11 18:00:00",  // Только для FBS и B2B FBS
  "shippingMethodTypeCode": "delivery_service", // Тип доставки
  "fulfillmentType": "FBS" // Модель выполнения (если указана)
}

Business Model Flags

Seller JSON-RPC API может возвращать информацию о доступных бизнес-моделях:

{
  "business_models": ["FBS", "FBO"],
  "shipments_fbs_enabled": true,
  "shipments_fbo_enabled": true,
  "returns_fbs_enabled": true
}

Choosing the Right Business Model

Use FBS when:

• У вас есть собственный склад
• Вы хотите контролировать комплектацию
• Ваши товары требуют специальной упаковки
• Вы можете быстро обрабатывать заказы

Use FBO when:

• Вы хотите делегировать логистику Lamoda
• У вас нет собственного склада
• Вы хотите масштабироваться без инвестиций в склад
• Быстрая доставка важна для ваших клиентов

Use DBS when:

• У вас есть собственная курьерская служба
• Вам нужен полный контроль над доставкой
• Вы работаете в локальном регионе

Use B2B models when:

• Вы продаете корпоративным клиентам
• У вас оптовые заказы
• Нужны специфические условия B2B

Integration Examples by Business Model

Example 1: FBS Integration

# 1. Update stock (Seller API)
seller_api.call('v1.stock.update', {
    'seller_id': 123,
    'stock': [
        {'seller_sku': 'SKU1', 'quantity': 10, 'warehouse_code': 'WH1'}
    ]
})

# 2. Get orders (B2B API)
orders = b2b_api.get('/api/v1/orders', params={'status': 'new'})

# 3. Mark as collected
b2b_api.put(f'/api/v1/orders/{order_nr}/collected')

# 4. Print labels
labels = b2b_api.post('/api/v1/label/packs', json={'order_nrs': [order_nr]})

# 5. Create shipment
b2b_api.post('/api/v1/shipments/out', json={
    'orders': [{'order_nr': order_nr, 'items': [...]}]
})

Example 2: FBO Integration

# 1. Create shipment to warehouse (B2B API)
shipment = b2b_api.post('/api/v1/shipments/fulfilment', json={
    'warehouse_code': 'LAMODA_WH1',
    'items': [{'sku': 'SKU1', 'quantity': 100}]
})

# 2. Get warehouse stock (B2B API)
stock = b2b_api.get('/api/v1/stock/goods')

# 3. Orders are automatically fulfilled by Lamoda
orders = b2b_api.get('/api/v1/orders')

Key Differences Summary

Aspect	FBS	FBO
Склад	Свой продавца	Склад Lamoda
Комплектация	Продавец	Lamoda
API для стока	v1.stock.update	GET /api/v1/stock/goods
API для поставок	POST /api/v1/shipments/out	POST /api/v1/shipments/fulfilment
Этикетки	Нужно печатать	Не нужно
Возвраты	Через FBS Return Boxes API	Через Lamoda
Статусы заказа	Ограничены (canceled, returned)	Полный цикл статусов

Additional Resources

• FBS vs FBO Selection Guide: Check Lamoda Seller Academy
• Integration Scenarios: Documented in subtask-1-1-findings.md
• Return Handling: FBS Return Boxes API documentation
• Stock Management: Detailed in Stock API sections

Verification

✅ Information Sources:

• OpenAPI specifications (lamoda_b2b_openapi.yaml)
• Seller JSON-RPC API spec (lamoda_seller_jsonrpc_api.yaml)
• Seller REST API spec (lamoda_seller_rest_api.yaml)
• Initial research findings (subtask-1-1-findings.md)

✅ Business Models Documented:

1. FBS (Fulfillment by Seller)
2. FBO (Fulfillment by Operator/Lamoda)
3. DBS (Delivery by Seller)
4. B2B FF (B2B Fulfillment)
5. B2B FBS (B2B Fulfillment by Seller)

✅ Coverage:

• Description and key characteristics for each model
• API requirements for each model
• Workflow examples
• Responsibility matrix
• Pros and cons
• Comparison table
• Integration examples
• Choosing guidance

---

Documentation Status: ✅ COMPLETE Lines: 524+ Business Models Covered: 5 models API Systems Covered: Seller JSON-RPC, B2B Platform, Seller REST