1.3 Lamoda Seller Partner API vs Lamoda B2B Platform API

<h1>1.3 Lamoda Seller Partner API vs Lamoda B2B Platform API</h1><br />
<br />
<p>У Lamoda два API, и их функционал частично пересекается. Эта статья объясняет, какой API использовать для каких задач.</p><br />
<br />
<b>TL;DR — Краткая рекомендация</b><br />
<table style="border-collapse: collapse; width: 100%;"><br />
<tbody><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;">Lamoda Seller Partner API</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">Товары, цены, остатки, изображения</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;">Lamoda B2B Platform API</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">Заказы, отгрузки, этикетки, нотификации</td><br />
</tr><br />
</tbody><br />
</table><br />
<br />
<h2>Сравнение API</h2><br />
<br />
<table style="border-collapse: collapse; width: 100%;"><br />
<tbody><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Параметр</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Seller API</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>B2B Platform API</b></td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Протокол</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;">JSON-RPC 2.0</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">REST</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Base Endpoint</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><code><a class="txttohtmllink" href="https://public-api-seller.lamoda.ru/jsonrpc">https://public-api-seller.lamoda.ru/jsonrpc</a></code></td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><code><a class="txttohtmllink" href="https://api-b2b.lamoda.ru">https://api-b2b.lamoda.ru</a></code></td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Формат URL запроса</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><code>/jsonrpc/v1/{method}</code><br>Пример: <code>/jsonrpc/v1/nomenclatures.list</code></td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><code>/api/v1/{resource}</code> или <code>/api/v2/{resource}</code><br>Пример: <code>/api/v1/orders</code></td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Token Endpoint</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><code>POST /jsonrpc/v1/tokens.create</code></td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><code>POST /auth/token</code></td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>TTL токена</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;">15 минут</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">15 минут</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Credentials</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;" colspan="2">Одни и те же <code>client_id</code> / <code>client_secret</code> для обоих API</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>API Versions</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;">v1</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">v1 + v2 (в развитии)</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Scopes</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;">Общий scope <code>partner_client</code></td><br />
<td style="border: 1px solid #ddd; padding: 8px;">Детальные: <code>r_orders</code>, <code>c_order</code>, <code>u_order</code>, <code>c_shipments</code>, <code>r_nomenclatures</code> и др.</td><br />
</tr><br />
</tbody><br />
</table><br />
<br />
<h2>Распределение функционала</h2><br />
<br />
<table style="border-collapse: collapse; width: 100%;"><br />
<tbody><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Функция</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Seller API</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>B2B Platform</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Рекомендация</b></td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Создание товаров</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;">✔</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">✘</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">Seller — единственный вариант</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Обновление цен РФ</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;">✔</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">✔</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">Seller — batch-операции</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Цены BY/KZ</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;">✔</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">✔</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">Оба варианта равнозначны</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Управление остатками</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;">✔</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">✔</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">Seller — для FBS</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Атрибуты товаров</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;">✔</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">✘</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">Seller — единственный вариант</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Справочники (бренды, категории)</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;">✔</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">✔</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">Оба варианта равнозначны</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Получение заказов</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;">✘</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">✔</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">B2B — единственный вариант</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Управление заказами</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;">✘</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">✔</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">B2B — единственный вариант</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Создание отгрузок</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;">✘</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">✔</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">B2B — единственный вариант</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Этикетки</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;">✘</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">✔</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">B2B — единственный вариант</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Нотификации (webhooks)</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;">✘</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">✔</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">B2B — единственный вариант</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>FBO-поставки</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;">✘</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">✔</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">B2B — единственный вариант</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Адреса, ПВЗ, доставка</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;">✘</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">✔</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">B2B — единственный вариант</td><br />
</tr><br />
</tbody><br />
</table><br />
<br />
<h2>Пересекающийся функционал</h2><br />
<br />
<p>Некоторые операции можно выполнить через оба API. Правило: используйте тот API, который лучше подходит для вашего основного сценария.</p><br />
<br />
<p><b>Обновление цен:</b></p><br />
<table style="border-collapse: collapse; width: 100%;"><br />
<tbody><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Модель</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Seller API (JSON-RPC)</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Примечание</b></td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;">FBS</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><code>v1.nomenclature.set-price</code></td><br />
<td style="border: 1px solid #ddd; padding: 8px;">Для единичных обновлений</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;">FBO</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><code>v1.nomenclature.update-price</code></td><br />
<td style="border: 1px solid #ddd; padding: 8px;">Поддерживает <code>price_status</code> (карантин)</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;">Batch</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><code>v1.nomenclatures.set-prices</code></td><br />
<td style="border: 1px solid #ddd; padding: 8px;">Массовое обновление цен</td><br />
</tr><br />
</tbody><br />
</table><br />
<br />
<p><b>Важно: ценовой карантин.</b> При снижении цены более чем на 70% система может перевести цену в статус <code>QUARANTINE</code>. В ответе метода <code>v1.nomenclature.update-price</code> появится объект <code>price_status</code> с информацией о карантине. Подробнее — в <a href="3_4_1_price_quarantine.html">Ценовой карантин</a>.</p><br />
<br />
<h2>Почему два API?</h2><br />
<br />
<p>Исторически Seller API (JSON-RPC) появился первым для управления товарами, а B2B Platform API (REST) — для операционных задач (заказы, отгрузки). Lamoda <b>запустила</b> новый единый REST API v2 (<code>/api/v2/</code>), который объединяет функционал обоих API в единый интерфейс.</p><br />
<br />
<p><b>Уже доступно в REST API v2:</b></p><br />
<ul><br />
<li><b>Возвраты FBS</b> — 8 методов <code>/api/v2/fbs/return-*</code> (коробы, товары, статусы, аномалии, статистика)</li><br />
<li><b>Вопросы покупателей</b> — <code>GET /v2/feedback/questions</code>, <code>POST /v2/feedback/questions/{questionId}/answer</code></li><br />
</ul><br />
<br />
<p><b>⚠ Важно:</b> С 24 февраля 2026 года возвратные статусы перестанут передаваться через методы v1. Для работы с возвратами необходимо перейти на методы <code>/api/v2/fbs/return-*</code>.</p><br />
<br />
<p>OpenAPI-спецификация REST v2: <a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/api-specification-lamoda-seller-rest/lamoda-seller-partner-api-rest/">https://academy.lamoda.ru/articles/api/api-specification-lamoda-seller-rest/lamoda-seller-partner-api-rest/</a>">Lamoda Seller Partner API REST</a></p><br />
<br />
<p>Подробнее о всех эндпоинтах — в <a href="2_1_endpoints.html">Точки входа (endpoints)</a>. История изменений — в <a href="changelog.html">Changelog</a>.</p><br />
<br />
<h2>Минимальный FBS-сценарий</h2><br />
<br />
<table style="border-collapse: collapse; width: 100%;"><br />
<tbody><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Шаг</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Действие</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>API</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Метод</b></td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;">1</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">Загрузите каталог</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">Seller</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><code>v1.nomenclatures.store</code></td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;">2</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">Установите цены</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">Seller</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><code>v1.nomenclature.set-price</code> (FBS)<br><code>v1.nomenclature.update-price</code> (FBO)</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;">3</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">Обновите остатки</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">Seller</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><code>v1.nomenclatures.update-stock</code></td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;">4</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">Получите заказы</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">B2B</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><code>GET /api/v1/orders</code></td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;">5</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">Создайте отгрузку</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">B2B</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><code>POST /api/v1/shipments</code></td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;">6</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">Напечатайте этикетки</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">B2B</td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><code>GET /api/v1/label/*</code></td><br />
</tr><br />
</tbody><br />
</table><br />
<br />
<h2>Чек-лист: какой API выбрать</h2><br />
<br />
<table style="border-collapse: collapse; width: 100%;"><br />
<tbody><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Вопрос</b></td><br />
<td style="border: 1px solid #ddd; padding: 8px;"><b>Ответ</b></td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;">Нужно загружать изображения?</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">Seller API</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;">Нужно работать с атрибутами?</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">Seller API</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;">Нужно получать/обрабатывать заказы?</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">B2B Platform API</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;">Нужно создавать отгрузки?</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">B2B Platform API</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;">Нужно печатать этикетки?</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">B2B Platform API</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;">Нужны webhooks/нотификации?</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">B2B Platform API</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;">Только товары и цены?</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">Seller API</td><br />
</tr><br />
<tr><br />
<td style="border: 1px solid #ddd; padding: 8px;">Полная FBS/FBO интеграция?</td><br />
<td style="border: 1px solid #ddd; padding: 8px;">Оба API вместе</td><br />
</tr><br />
</tbody><br />
</table><br />
<br />
<h2>См. также</h2><br />
<br />
<ul><br />
<li><a href="2_1_endpoints.html">Точки входа (endpoints)</a> — полный список URL и версий</li><br />
<li><a href="2_2_oauth.html">OAuth 2.0 авторизация</a> — scopes и токены</li><br />
<li><a href="1_2_quickstart.html">Быстрый старт</a></li><br />
<li><a href="6_1_fbs_vs_fbo.html">FBS vs FBO: в чём разница</a></li><br />
<li><a href="17_1_api_versions.html">Версии API</a></li><br />
</ul>