Сравнение Lamoda Seller Partner API и Lamoda B2B Platform Partner API
У Lamoda два API, и их функционал частично пересекается. Эта статья объясняет, какой API использовать для каких задач.
Краткая рекомендация
| Lamoda Seller Partner API | Товары, цены, остатки, изображения |
| Lamoda B2B Platform Partner API | Заказы, отгрузки, этикетки, нотификации |
Сравнение API
| Параметр | Lamoda Seller Partner API | Lamoda B2B Platform Partner API |
| Протокол | JSON-RPC 2.0 | REST |
| Base Endpoint |
https://public-api-seller.lamoda.ru/jsonrpc
|
https://api-b2b.lamoda.ru
|
| Формат URL запроса |
POST /jsonrpc/v1/{method}Пример: POST /jsonrpc/v1/nomenclatures.list
|
GET /api/v1/{resource} или /api/v2/{resource}Пример: GET /api/v1/orders
|
| Token Endpoint |
POST /jsonrpc/v1/tokens.create
|
POST /auth/token
|
| TTL токена | 15 минут | 15 минут |
| Credentials |
Одни и те же client_id / client_secret для обоих API
|
|
| API Versions | v1 | v1 + v2 (в развитии) |
| Scopes |
Общий scope partner_client
|
Детальные: r_orders, c_order, u_order, c_shipments, r_nomenclatures и др.
|
Распределение функционала
| Функция | Lamoda Seller Partner API | Lamoda B2B Platform Partner API | Рекомендация |
| Создание товаров | ✔ | ✘ | Seller — единственный вариант |
| Обновление цен РФ | ✔ | ✔ | Seller — batch-операции |
| Цены BY/KZ | ✔ | ✔ | Оба варианта равнозначны |
| Управление остатками | ✔ | ✔ | Seller — для FBS |
| Атрибуты товаров | ✔ | ✘ | Seller — единственный вариант |
| Справочники (бренды, категории) | ✔ | ✔ | Оба варианта равнозначны |
| Получение заказов | ✘ | ✔ | B2B — единственный вариант |
| Управление заказами | ✘ | ✔ | B2B — единственный вариант |
| Создание отгрузок | ✘ | ✔ | B2B — единственный вариант |
| Этикетки | ✘ | ✔ | B2B — единственный вариант |
| Нотификации (webhooks) | ✘ | ✔ | B2B — единственный вариант |
| FBO-поставки | ✘ | ✔ | B2B — единственный вариант |
| Адреса, ПВЗ, доставка | ✘ | ✔ | B2B — единственный вариант |
Пересекающийся функционал
Некоторые операции можно выполнить через оба API. Правило: используйте тот API, который лучше подходит для вашего основного сценария.
Обновление цен:
| Модель | Lamoda Lamoda Seller Partner API | Примечание |
| FBS |
POST /jsonrpc/v1/nomenclature.set-price
|
Для единичных обновлений |
| FBO |
POST /jsonrpc/v1/nomenclature.update-price
|
Поддерживает price_status (карантин)
|
| Batch |
POST /jsonrpc/v1/nomenclatures.set-prices
|
Массовое обновление цен |
Важно: ценовой карантин. При снижении цены более чем на 70% система может перевести цену в статус QUARANTINE. В ответе метода POST /jsonrpc/v1/nomenclature.update-price появится объект price_status с информацией о карантине. Подробнее — в Ценовой карантин.
Почему два API?
Исторически Lamoda Lamoda Seller Partner API появился первым для управления товарами, а Lamoda B2B Platform Partner API (REST) — для операционных задач (заказы, отгрузки). Lamoda запустила новый единый REST API v2 (/api/v2/), который объединяет функционал обоих API в единый интерфейс.
Уже доступно в REST API v2:
- Возвраты FBS — 8 методов
/api/v2/fbs/return-*(коробы, товары, статусы, аномалии, статистика) - Вопросы покупателей —
GET /v2/feedback/questions,POST /v2/feedback/questions/{questionId}/answer
OpenAPI-спецификация Lamoda B2B Platform Partner API v2: Lamoda Seller Partner API REST
Подробнее о всех эндпоинтах — в Точки входа (endpoints). История изменений — в Changelog.
Минимальный FBS-сценарий
| Шаг | Действие | API | Метод |
| 1 | Загрузите каталог | Seller |
POST /jsonrpc/v1/nomenclatures.store
|
| 2 | Установите цены | Seller |
POST /jsonrpc/v1/nomenclature.set-price (FBS)POST /jsonrpc/v1/nomenclature.update-price (FBO)
|
| 3 | Обновите остатки | Seller |
POST /jsonrpc/v1/nomenclatures.update-stock
|
| 4 | Получите заказы | B2B |
GET /api/v1/orders
|
| 5 | Создайте отгрузку | B2B |
GET /api/v1/shipments
|
| 6 | Напечатайте этикетки | B2B |
GET /api/v1/label/*
|
Чек-лист: какой API выбрать
| Вопрос | Ответ |
| Нужно загружать изображения? | Lamoda Seller Partner API |
| Нужно работать с атрибутами? | Lamoda Seller Partner API |
| Нужно получать/обрабатывать заказы? | Lamoda B2B Platform Partner API |
| Нужно создавать отгрузки? | Lamoda B2B Platform Partner API |
| Нужно печатать этикетки? | Lamoda B2B Platform Partner API |
| Нужны webhooks/нотификации? | Lamoda B2B Platform Partner API |
| Только товары и цены? | Lamoda Seller Partner API |
| Полная FBS/FBO интеграция? | Оба API вместе |
См. также
- Точки входа (endpoints) — полный список URL и версий
- OAuth 2.0 авторизация — scopes и токены
- Быстрый старт
- FBS vs FBO: в чём разница
- Версии API
Помогла эта информация?
Спасибо за отзыв
