Содержание статьи
О Lamoda API
Lamoda API — это набор интерфейсов для продавцов-партнёров маркетплейса Lamoda. API позволяет автоматизировать управление товарами, ценами, остатками, заказами и отгрузками.
У Lamoda два API, которые работают совместно:
| API | Протокол | Основные задачи |
| Lamoda Seller Partner API | JSON-RPC 2.0 | Товары, цены, остатки, изображения, атрибуты |
| Lamoda B2B Platform Partner API | REST | Заказы, отгрузки, этикетки, нотификации |
Подробное сравнение — в Lamoda Seller Partner API vs Lamoda B2B Platform Partner API.
Lamoda Seller Partner API v2 (REST) — единый API
Lamoda запустила новую версию — Lamoda Seller Partner API v2 (REST), который объединяет возможности Seller Partner API и Lamoda B2B Platform Partner API. Переработанная архитектура, консистентные контракты, camelCase-параметры.
Уже доступно в v2:
- Возвраты FBS — 8 методов в
/api/v2/fbs/return-*: списки возвратных коробов, товаров, статусы, история, аномалии, статистика. Важно: с 3 марта 2026 возвратные статусы перестанут передаваться через старые методы v1 — необходим переход на v2. - Вопросы покупателей —
GET /v2/feedback/questions(список вопросов),POST /v2/feedback/questions/{questionId}/answer(ответ на вопрос). Параметры в camelCase:sellerId,dateCreateFrom.
Как будет развиваться:
- Весь новый функционал будет появляться в Lamoda Seller Partner API v2 (REST)
- Существующие методы из текущих API постепенно добавляются в v2
- Текущие Seller Partner API и Lamoda B2B Platform Partner API продолжают работать — срочно менять ничего не нужно
Подробнее — в Точки входа (endpoints).
Ключевые термины
| Термин | Описание | В каком API |
seller_sku
|
Ваш артикул товара (присваиваете вы) | Lamoda Seller Partner API |
supplierSku
|
Тот же артикул продавца | Lamoda B2B Platform Partner API v1 (path-параметр) |
lamoda_sku
|
Артикул товара в системе Lamoda | Оба API |
lamoda_parent_sku
|
Родительский артикул модели (объединяет размеры/цвета) | Оба API |
orderNr
|
Номер заказа (используется в API v1) | Lamoda B2B Platform Partner API v1 |
orderId
|
Публичный номер заказа (используется в API v2) | B2B Lamoda B2B Platform Partner API v2 |
sellerId
|
Идентификатор продавца, обязателен во всех запросах v2 | Lamoda B2B Platform Partner API v2 |
shipment
|
Отгрузка — набор заказов, передаваемых в доставку | Lamoda Seller Partner API |
pack_number
|
Код упаковки для этикетки | Lamoda Seller Partner API |
price_status
|
Статус цены: ACTIVE, QUARANTINE (карантин при снижении >70%)
|
Lamoda Seller Partner API |
DataMatrix
|
Код маркировки товара (для маркируемых категорий). Формат CIS-кода, содержащий GTIN, серийный номер и криптохвост | Оба API |
Структура документации
Документация организована в 20 разделов:
- Введение — начните здесь
- Подключение к API — как получить доступ к API и токены авторизации
- Справочники и контент — создание товаров, размерные сетки, изображения товаров
- Товары и цены — управление ценами на товары, ценовой карантин
- Остатки — управление остатками FBS и FBO
- Этикетки — генерация этикеток для упаковки FBS
- Заказы — получение и обработка заказов
- FBS — создание и подтверждение отгрузок FBS
- Отмены — отмена заказов
- FBO — поставки, статусы, рекомендации
- Нотификации — настройка webhook'ов
- Доставка — адреса, ПВЗ, способы доставки
- Возвраты — обработка возвратов FBS
- Вопросы о товарах — работа с вопросаии и ответами по торвам от клиентов
- Маркировка — CIS-коды, DataMatrix
- Решение проблем — известные проблемы, FAQ
- Построение надежной интеграции — рекомендации по интеграции
- Обработка ошибок — коды типовых ошибок API
- Версии и совместимость — версии API, политика совместимости
- Поддержка — как получить помощь
API-спецификации:
- Lamoda B2B Platform Partner API
- Lamoda Seller Partner API v1 (JSON-RPC)
- Lamoda Seller Partner API v2 (REST API)
С чего начать
Рекомендуем следующий порядок:
- Прочитайте Быстрый старт — пошаговый чек-лист
- Настройте авторизацию
- Изучите раздел, соответствующий вашей задаче (заказы, товары, отгрузки)
- При проблемах — см. FAQ
Помогла эта информация?
Спасибо за отзыв
0/1000
Отправить
