Содержание статьи
| Это документация по API v1. Поддержка v1 прекращается 30.11.2026 — переходите на API v2. |
О 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. - Управление акциями — 5 методов в
/api/v2/promotions*и/api/v2/promotion-variants/*: список акций и их вариантов, товары в акции, подбор товаров для добавления в конкретный вариант, добавление и удаление товаров. Поддерживаются onsite-акции (с фиксированной и плавающей скидкой) и купонные акции.
Как будет развиваться:
- Весь новый функционал будет появляться в 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 |
promotionId
|
Идентификатор акции. Одна акция может иметь несколько вариантов с разной скидкой | Lamoda B2B Platform Partner API v2 |
promotionVariantId
|
Идентификатор варианта акции — конкретный набор условий внутри акции (процент скидки, категории, пол, минимальная цена) | Lamoda B2B Platform Partner API v2 |
DataMatrix
|
Код маркировки товара (для маркируемых категорий). Формат CIS-кода, содержащий GTIN, серийный номер и криптохвост | Оба API |
Структура документации
Документация организована в 21 раздел:
- Введение — начните здесь
- Подключение к API — как получить доступ к API и токены авторизации
- Справочники и контент — создание товаров, размерные сетки, изображения товаров
- Товары и цены — управление ценами на товары, ценовой карантин
- Остатки — управление остатками FBS и FBO
- Этикетки — генерация этикеток для упаковки FBS
- Заказы — получение и обработка заказов
- FBS — создание и подтверждение отгрузок FBS
- Отмены — отмена заказов
- FBO — поставки, статусы, рекомендации
- Нотификации — настройка webhook'ов
- Возвраты — обработка возвратов FBS
- Вопросы о товарах — работа с вопросами и ответами от клиентов по товарам
- Решение проблем — известные проблемы, FAQ
- Версии и совместимость — версии API, политика совместимости
- Поддержка — как получить помощь
- Акции — управление участием товаров в акциях: onsite-акции с фиксированной и плавающей скидкой, купоны, валидация акционных цен
API-спецификации:
- Lamoda B2B Platform Partner API
- Lamoda Seller Partner API v1 (JSON-RPC)
- Lamoda Seller Partner API v2 (REST API)
С чего начать
Рекомендуем следующий порядок:
- Прочитайте Быстрый старт — пошаговый чек-лист
- Настройте авторизацию
- Изучите раздел, соответствующий вашей задаче (заказы, товары, отгрузки)
- При проблемах — см. FAQ
Помогла эта информация?
Спасибо за отзыв
0/1000
Отправить