Главное
- API Lamoda — единый интерфейс для обеих моделей, FBO и FBS: товары, цены, остатки, заказы, поставки, возвраты, акции.
- Ключ создают сами в кабинете: «Настройки аккаунта» → «API ключи» → «Сгенерировать». С 7 октября 2026 года менеджеры ключи не выдают.
- Ключей можно создать сколько угодно — например, отдельный для каждой программы, чтобы отключать их по одному.
- Актуальная версия — v2. Старые версии API Lamoda отключает 30.11.2026.
- Финансовых документов, рекламы и воронки в справочнике методов API v2 нет — они остаются в кабинете.
- Всё, что сделано по вашим ключам, по оферте считается сделанным вашей компанией. Утечку нужно сразу сообщить Lamoda.
Что такое API Ламоды и кому он нужен
Lamoda Seller Partner API (в поиске пишут и «ламода апи») — это способ обмениваться данными с Lamoda напрямую из своей программы. Вместо того чтобы вручную менять цены в кабинете или выгружать заказы в Excel, учётная система делает это сама по расписанию. Адрес API — public-api-seller.lamoda.ru, документация лежит в академии Lamoda.
Кому он нужен:
- Продавцам на FBS. Среди требований к продавцу FBS Lamoda прямо называет готовность настроить интеграцию по API — или регулярно обновлять остатки вручную. Остаток со своего склада Lamoda сама не узнает.
- Тем, кто ведёт товар в учётной системе. 1С или МойСклад сами передают карточки, цены и остатки — не нужно вести одно и то же в двух местах.
- Тем, кто подключает сервисы аналитики. Сервис забирает заказы, остатки и акции и собирает из них отчёты, которых нет в кабинете.
При небольшом ассортименте на FBO можно работать и без API: остатки ведёт Lamoda по факту поставок. Чем различаются модели — в статье «FBO или FBS на Ламоде».
Интеграция Ламоды с 1С и МойСклад
- Встроенная интеграция с 1С. С 14 ноября 2025 года в типовых конфигурациях 1С, например «Управление торговлей» и «Комплексная автоматизация», есть обмен с Lamoda без внешних интеграторов. Он сопоставляет товары Lamoda с номенклатурой 1С, обновляет остатки и цены по расписанию, умеет выбирать склады, держать страховой запас и передавать цены до и после скидки. Инструкция — на портале 1С:ИТС.
- Партнёры-интеграторы. Для 1С и МойСклад Lamoda публикует в академии список компаний с готовыми решениями. Для МойСклад в этом списке решение только под FBS.
- Своя разработка. Программист пишет обмен по документации API, технические вопросы задаёт на api-integration@lamoda.ru.
В перечне возможностей интеграции Ламоды с 1С, который даёт Lamoda, — остатки и цены; отчётов о марже и выкупе там нет. Для них нужны сервисы аналитики. Что есть в кабинете и чего не хватает — в статье «Аналитика продаж на Ламоде».
Где взять ключ API Ламоды
С октября 2026 года ключ создают сами, за пару минут. С 7 октября менеджеры ключи больше не выдают.
- Наведите курсор на название магазина справа вверху → «Настройки аккаунта».
- В меню слева — «API ключи».
- Нажмите «Сгенерировать» и скопируйте Client ID и Client Secret.
Ключ начинает работать сразу. Полностью он показывается только один раз — при создании. Закрыли окно и не сохранили — создайте новый, а старый деактивируйте.
| Что | Как устроено |
|---|---|
| Сколько ключей | сколько угодно активных одновременно |
| Права | одинаковые у всех ключей: заказы, товары, цены, остатки, отгрузки, акции |
| Старые ключи от менеджера | продолжают работать, видны в той же таблице |
| Деактивация | «…» → «Деактивировать»; отменить нельзя |
Третье значение, sellerId, видно там же, в «Настройках аккаунта» → «Общая информация», строка Seller Shop ID.
По client_id и client_secret программа получает временный пропуск — токен. Сколько он живёт, Lamoda сообщает при выдаче токена, и программа обновляет его сама. Вручную с токеном ничего делать не нужно.
Если кабинетов два. FBO и FBS у Lamoda — разные кабинеты, у каждого свой sellerId. Токен выдаётся под конкретного продавца: с чужим sellerId запрос вернёт ошибку. Ключ создавайте в том кабинете, данные которого нужны программе.
Где искать кабинет и поддержку — в статье «Ламода Селлер: личный кабинет продавца». Если договора ещё нет — начните с «Как стать продавцом Ламоды».
Что можно делать через Lamoda API
| Задача | FBO | FBS |
|---|---|---|
| Карточки и фото | да | да |
| Цены и скидки | да | да |
| Остатки | только читать | загружать и читать |
| Заказы | только следить | сборка, этикетки, отгрузка |
| Поставка на склад | создать, отменить, следить | — |
| Возвраты | методов нет | да |
| Заявки на машину Lamoda | — | смотреть и отменять |
| Акции | да | да |
| Вопросы покупателей | да | да |
| Разрешительные документы | да | да |
| Финансовые отчёты и документы | нет | нет |
| Реклама и воронка | нет | нет |
Подводные камни:
- Тестовых товаров нет. Создать пробную карточку через API нельзя — проверять обмен приходится на настоящем ассортименте.
- Карантин цен. Если новая цена без скидки ниже прежней больше чем на 70%, она не публикуется. Подтвердить её можно только в кабинете — через API это не сделать. Пока цена на карантине, товар продаётся по старой.
- Акции — только для России. Товар может стоять только в одном варианте акции: чтобы сменить скидку, его убирают из одного варианта и добавляют в другой.
- Остатки FBS — до 100 артикулов-размеров за запрос. При продаже Lamoda сама уменьшает остаток, а после возврата обновить его должны вы.
- Заявку на приезд машины Lamoda (забор посылок и возвратов) через API не создать — только посмотреть или отменить. По Регламенту FBS отказаться бесплатно можно до 14:00 рабочего дня перед забором посылок и за 2 рабочих дня до привоза возвратов.
- Уведомления о событиях (вебхуки) подключает менеджер или поддержка по вашему адресу. По нашему опыту, часть событий можно включить и самим: «Настройки» → событие → «Настройка по API». Доставка не гарантирована, поэтому заказы всё равно нужно регулярно запрашивать.
Как заводить карточки — в статье «Карточка товара на Ламоде», как собирать и сдавать заказы — в «Отгрузке FBS на Ламоду». Отчёт агента, УПД и акт сверки приходят в ЭДО, копии — в кабинете. Подробно в статье «Закрывающие документы Ламоды».
Безопасность ключа
Ключ API — такой же доступ к компании, как логин и пароль от кабинета. По Общим условиям Lamoda:
- любые действия с вашими данными доступа считаются совершёнными вашей компанией или её уполномоченными лицами;
- единственное доказательство действий — журналы событий в системах Lamoda;
- при подозрительной активности или повышенной нагрузке Lamoda вправе отозвать доступ и API-ключ;
- об утечке данных доступа нужно сразу сообщить Lamoda.
Что из этого следует на практике:
- Не пересылайте client_secret в почте, мессенджерах и общих таблицах.
- В обращении в поддержку вместо токена пишите звёздочки — так просит сама Lamoda в шаблоне письма на api-integration@lamoda.ru.
- Для каждой программы или интегратора создайте отдельный ключ — так советует сама Lamoda. Его можно деактивировать, не затрагивая остальные.
- Вписывайте ключ только в систему, которой доверяете и где он хранится в зашифрованном виде.
- Ушёл сотрудник с доступом к ключу или ключ попал к посторонним — создайте новый, переключите на него программу и деактивируйте старый.
- Помните: если программа массово снизит цены или отменит заказы, отвечать перед Lamoda будет ваша компания.
Частые ошибки подключения
| Ошибка | Причина | Что сделать |
|---|---|---|
| 401 со свежим токеном | токен передан в адресе запроса | передавать только в заголовке Authorization: Bearer |
| 401 через время | токен истёк | обновлять по сроку из ответа, а не по постоянному числу |
| 403 | sellerId не от этого ключа | указать свой sellerId |
| 400 по списку товаров | нет страны или больше 25 строк на странице | добавить страну RU, BY или KZ, уменьшить страницу |
| 429 | слишком много запросов | паузы и повтор с растущей задержкой |
| Дубль карточки | создание повторили после сбоя | повторять как обновление, а не создание |
Если ошибка не уходит, напишите на api-integration@lamoda.ru и сразу приложите текст запроса и ответ — так обращение разберут быстрее. О новых методах и технических работах Lamoda сообщает в Telegram-канале @apilamoda.
Старые версии API Lamoda отключает 30.11.2026. На странице «Версии API» ещё стоит 01.01.2027, но в истории изменений и в канале @apilamoda — 30.11.2026; ориентируйтесь на раннюю дату. Ключи одни и те же для всех версий — новые просить не нужно. Если интеграцию делали давно, уточните у подрядчика, переведена ли она на v2.
DropScale: подключение по ключу API Ламоды
DropScale подключается по ключу API: создайте для него отдельный ключ в «API ключах» — это пара минут — и впишите в форму подключения. В форме три поля: Client ID, Client Secret и Seller Shop ID. Сервис сразу проверяет подключение и показывает, какой шаг не прошёл, если ключ не подошёл.
Дальше вручную ничего делать не нужно: история продаж подтягивается сама, данные приходят по расписанию. Ключ хранится в зашифрованном виде, серверы — в России. Несколько кабинетов, например FBO и FBS, подключаются каждый отдельно и смотрятся по отдельности и сводно.
Финансовых документов в API нет, поэтому для сверки с отчётами Lamoda DropScale просит загрузить файлы из кабинета. Из чего складывается маржа артикула — в статье «Юнит-экономика на Ламоде».
Частые вопросы
Где взять ключ API Ламоды? Создать самому в кабинете Lamoda Seller: «Настройки аккаунта» → «API ключи» → «Сгенерировать». Client ID и Client Secret показываются один раз — сразу сохраните их. С 7 октября 2026 года менеджеры ключи не выдают.
Что такое ламода апи и зачем он продавцу? Это способ передавать товары, цены, остатки и заказы между Lamoda и вашей программой без ручной работы в кабинете. На FBS без API остатки придётся обновлять вручную.
Есть ли интеграция Ламоды с 1С? Да. С 14 ноября 2025 года в типовых конфигурациях 1С есть встроенный обмен с Lamoda: остатки и цены по расписанию. Есть и партнёры-интеграторы, их список — в академии Lamoda.
Можно ли подключить Ламоду к МойСклад? Да, через партнёра-интегратора из списка Lamoda. Для МойСклад там указано решение под FBS.
Можно ли получить отчёт агента и выплаты через Lamoda API? Нет. Закрывающие документы и финансовые отчёты берут в кабинете Lamoda Seller и в ЭДО.
Почему API Ламоды возвращает ошибку 401? Токен истёк или передан не в заголовке Authorization: Bearer, а в адресе запроса. Получите новый токен и передайте его в заголовке.