| ℹ️ Это документация по актуальной версии — API v2. Вся документация по предыдущей версии, API v1, переехала в отдельный раздел «Статьи для версии v1». Новые интеграции стройте на v2; если вы переходите с v1 — см. статью «Миграция v1→v2». |
Lamoda Seller REST API — единый REST-интерфейс для продавцов-партнёров. Он работает для обеих логистических моделей — FBS (продажа со своего склада) и FBO (продажа со склада Lamoda).
Базовый URL — https://public-api-seller.lamoda.ru/api.
Эта статья — точка входа: помогает выбрать модель, увидеть карту сущностей и найти нужную статью.
| Следующий шаг - Впервые подключаетесь → статья «Начало работы и авторизация» (токен, sellerId, первый вызов).- Уже на API v1, мигрируете → статья «Миграция v1→v2» (переименования полей, отличия контракта). - Нужна конкретная ручка → Справочник методов (детали параметров, полей, примеры). |
Модель сотрудничества: FBO и FBS
Модель сотрудничества определяет, кто хранит товар, кто собирает и отгружает заказы и кто ведёт возвраты. Товары и цены при этом заводятся одинаково для обеих моделей. Особенности модели проявляются дальше на уровне логистики.
| FBS — свой склад | FBO — склад Lamoda | |
|---|---|---|
| Хранение товара | у вас | на складе Lamoda |
| Сборка и отгрузка заказа | вы сами | Lamoda |
| Остатки | загружаете вы; дальше остаток ведёте совместно с Lamoda: при продаже его уменьшает Lamoda, а при возврате обновить остаток должны вы. | ведёт Lamoda (вы читаете) |
| Поставка на склад | — | вы формируете поставку |
| Возвраты через API | есть | нет (Lamoda возвращает товар сама) |
| Ваша статья по логистике | «Продажа со своего склада (FBS)» | «Продажа со склада Lamoda (FBO)» |
Бизнес-описание моделей — в разделах Академии «Продажа со своего склада (FBS)» и «Продажа со склада Lamoda (FBO)».
Путь товара от карточки до заказа
Товар проходит путь от карточки до заказа и (при работе по модели FBS) до возврата. Каталог и цены заводятся одинаково для обеих моделей. Дальше, на уровне управления остатками и логистики, начинаются отличия между FBS и FBO.
При работе по FBS остаток заводите вы, заказы собираете и отгружаете сами, возвраты тоже принимаете сами:
Карточка → Цена → Остаток → Заказ → Сборка → Отгрузка → Возврат
При работе по FBO селлер привозит товар на склад Lamoda, а остатки и логистику ведёт Lamoda:
Карточка → Цена → Поставка на склад Lamoda → Остаток → Заказ
С чего начать
Рекомендуемый маршрут по статьям:
- «Начало работы и авторизация» — авторизация,
sellerId, первый вызов, сквозные соглашения и ошибки. - «Каталог: карточки товаров и цены» — завести товары и цены (общий шаг для FBS и FBO).
- «Синхронизация и события» — как вовремя узнавать о новых заказах и сменах статусов (поллинг + вебхуки).
- Ваша ветка по модели сотрудничества: «Продажа со своего склада (FBS)» или «Продажа со склада Lamoda (FBO)».
Точечный поиск метода — в Справочнике методов; переход с v1 — в статье «Миграция v1→v2».
См. также
Помогла эта информация?
Спасибо за отзыв