Seller Partner API vs B2B Platform API

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

Обновлено

10.12.2025

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

У Lamoda два API, и их функционал частично пересекается. Эта статья объясняет, какой API использовать для каких задач.

TL;DR — Краткая рекомендация

Seller API	Товары, цены, остатки, изображения
B2B Platform API	Заказы, отгрузки, этикетки, нотификации

Сравнение API

Параметр	Seller API	B2B Platform API
Протокол	JSON-RPC 2.0	REST
Endpoint	`public-api-seller.lamoda.ru/jsonrpc`	`api-b2b.lamoda.ru`
TTL токена	15 минут	15 минут
Credentials	Одни и те же `client_id` / `client_secret`
Формат запроса	`{ "jsonrpc": "2.0", "method": "v1.nomenclatures.list", "params": {...}, "id": "uuid" }`	`GET /api/v1/orders Authorization: Bearer {token}`

Распределение функционала

Функция	Seller	B2B	Рекомендация
Создание товаров			Seller — более полный функционал
Загрузка изображений			Seller — единственный вариант
Управление ценами			Seller — batch-операции
Цены BY/KZ			Оба варианта равнозначны
Управление остатками			Seller — для FBS
Атрибуты товаров			Seller — единственный вариант
Справочники (бренды, категории)			Оба варианта равнозначны
Получение заказов			B2B — единственный вариант
Управление заказами			B2B — единственный вариант
Создание отгрузок			B2B — единственный вариант
Этикетки			B2B — единственный вариант
Нотификации (webhooks)			B2B — единственный вариант
FBO-поставки			B2B — единственный вариант
Адреса, ПВЗ, доставка			B2B — единственный вариант

Пересекающийся функционал

Некоторые операции можно выполнить через оба API. Вот сравнение методов:

Номенклатура (товары)

Операция	Seller API	B2B Platform API
Список товаров	`v1.nomenclatures.list`	`GET /api/v1/nomenclatures`
Создание товара	`v1.nomenclatures.store`	`POST /api/v1/nomenclatures`
Товар по SKU	`v1.nomenclatures.list` + фильтр	`GET /api/v1/nomenclatures/{sku}`

Рекомендация: Используйте Seller API для работы с номенклатурой — там есть загрузка изображений и атрибуты, которых нет в B2B API.

Цены

Операция	Seller API	B2B Platform API
Установить цену (FBS)	`v1.nomenclature.set-price`	`PUT /api/v1/nomenclature/{sku}/country/{country}/price`
Обновить цену (FBO)	`v1.nomenclature.update-price`	—
Массовое обновление	`v1.nomenclatures.set-prices`	`POST /api/v1/nomenclature/country/{country}/prices`
Получить цены	через `v1.nomenclatures.list`	`GET /api/v1/nomenclature/sell-values`

Рекомендация: Используйте Seller API для управления ценами — там есть batch-метод set-prices и поддержка карантина цен.

Остатки (стоки)

Операция	Seller API	B2B Platform API
Получить остатки	`v1.stock.list`	`GET /api/v1/stock/goods`
Обновить остатки	`v1.stock.update`	`POST /api/v1/stock/goods`

Оба API равнозначны для работы с остатками. Выбирайте тот, который уже используете для других операций.

Типичные сценарии интеграции

Сценарий 1: Полная FBS-интеграция

Этап	API	Методы
1. Загрузка каталога	Seller	`v1.nomenclatures.store` `v1.nomenclature-images.update`
2. Установка цен	Seller	`v1.nomenclature.set-price`
3. Обновление остатков	Seller	`v1.stock.update`
4. Получение заказов	B2B	`GET /api/v1/orders`
5. Сборка и этикетки	B2B	`PUT /orders/{id}/collected` `POST /api/v1/label/packs`
6. Отгрузка	B2B	`POST /api/v1/shipments/out`

Сценарий 2: Только управление каталогом

Если вам нужно только управлять товарами и ценами (без обработки заказов):

Используйте только Seller API

Сценарий 3: FBO-интеграция

Этап	API	Методы
1. Загрузка каталога	Seller	`v1.nomenclatures.store`
2. Создание поставки на склад	B2B	`POST /api/v1/shipments/fulfilment`
3. Остатки на складе Lamoda	B2B	`GET /api/v1/stock/goods`

Почему два API?

Историческая справка

Seller API (JSON-RPC) изначально создавался как прокси-слой к внутренним микросервисам Lamoda для работы с контентом (товары, изображения, атрибуты).

B2B Platform API (REST) развивался параллельно для операционных задач (заказы, отгрузки, логистика).

Со временем часть функционала стала дублироваться. Lamoda планирует унификацию API в будущем.

Чек-лист: какой API выбрать

Вопрос	Ответ
Нужно загружать изображения?	Seller API
Нужно работать с атрибутами?	Seller API
Нужно получать/обрабатывать заказы?	B2B Platform API
Нужно создавать отгрузки?	B2B Platform API
Нужно печатать этикетки?	B2B Platform API
Нужны webhooks/нотификации?	B2B Platform API
Только товары и цены?	Seller API
Полная FBS/FBO интеграция?	Оба API вместе

См. также

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

Да Нет

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

Отправить

Точки входа API

Быстрый старт