Содержание статьи
Значимые обновления API Lamoda: новые методы, изменения контрактов, депрекации. Оперативные анонсы выходят в Telegram-канале @apilamoda — рекомендуем не отключать уведомления, чтобы узнавать об изменениях, влияющих на ваши интеграции.
Всегда актуальный список методов — в спецификации Lamoda Seller Partner API v2.
Хронология изменений
| Дата | API | Изменение | Действие |
|---|---|---|---|
| 06.10.2026 | REST v2 | Заявки на транспорт и склады продавца. Добавлены методы: GET /v2/fbs/transport-requests — список заявок на вывоз и самостоятельную доставку; GET /v2/fbs/transport-requests/{requestId} — заявка с данными транспортного пропуска; POST /v2/fbs/dropoff-requests и POST /v2/fbs/dropoff-requests/{requestId} — создание и изменение заявки на самостоятельную доставку (dropoff); GET /v2/fbs/warehouses — склады продавца, warehouseId из ответа передаётся при создании заявки. Подробнее — «Заявки на транспорт (FBS)». | ● Новое |
| 06.10.2026 | Все | API-ключи в личном кабинете. Ключи client_id и client_secret теперь создаются и деактивируются самостоятельно в Lamoda Seller: «Настройки аккаунта» → «API ключи». Активных ключей может быть несколько — например, отдельный для интегратора. С 07.10.2026 менеджеры ключи не выдают; ранее выданные ключи продолжают работать. Подробнее — «API-ключи в личном кабинете». | ● Новое |
| 01.10.2026 | REST v2 | Ювелирные изделия по FBS: спецификация ГИИС ДМДК и УИН. В сборку заказа POST /v2/orders/{orderId}/assembly добавлены giisSpecId и giisUins[] (itemId + giisUin из 16 цифр) — для ювелирных позиций их нужно передавать вместе с составом паков. В ответ GET /v2/orders и GET /v2/orders/{orderId} добавлен объект jewellerySpecification с результатом проверки спецификации и статусами по каждому УИН; отгружать заказ можно, когда проверка перешла в FINISHED, а все УИН — в SUCCESS. В GET /v2/fbs/return-items у ювелирной позиции появился объект jewellery (uin, uinStatus); у обычного товара он равен null. Подробнее — «Ювелирные изделия по FBS». | ● Рекомендуется: передавать для ювелирных позиций |
| 27.08.2026 | REST v2 | Категории сайта — признак конечной категории. В ответ GET /v2/nomenclature-categories/{categoryId}/attributes-mappings добавлено поле isLeaf (признак конечной категории сайта). При создании товара в site_category указывайте только конечные категории (isLeaf: true) — родительские (промежуточные) отклоняются. Подробнее — «Каталог: карточки товаров и цены». | ● Рекомендуется: фильтровать isLeaf: true |
| 24.08.2026 | REST v2 | Разрешительные документы — раздельные счётчики товаров. В ответы POST /v2/product-certificates и POST /v2/product-certificates/document добавлено поле parentSkuCount — количество моделей (родительских SKU). Поле skuCount теперь в обеих ручках означает количество размерных SKU (Lamoda SKU); ранее на ручке-списке оно возвращало число моделей. Подробнее — «Работа с разрешительными документами». | ● Рекомендуется: проверить обработку skuCount на ручке списка |
| 10.08.2026 | REST v2 | Разрешительные документы — проверка статусов и карточка документа. Добавлены два метода. POST /v2/product-certificates — список документов продавца со статусами проверки в реестрах контролирующих органов (IN_PROGRESS — на проверке, PASSED — пройдена, FAILED — не пройдена; при FAILED расширенный статус в statusText), с фильтрами по статусу, типу, товару и номеру. POST /v2/product-certificates/document — карточка одного документа со статусом и постраничным списком привязанных товаров. Подробнее — «Работа с разрешительными документами». | ● Новое |
| 30.07.2026 | REST v2 | Запуск API разрешительных документов (РД). Программная передача сертификатов, деклараций о соответствии, СГР и отметок «документ не требуется» и привязка к товарам — без ручной загрузки в Lamoda Seller. Три метода: создание задачи добавления (ADD) или отвязки (REMOVE) — POST /v2/product-certificates/jobs, получение статуса обработки — GET /v2/product-certificates/jobs/{jobId}, список задач — GET /v2/product-certificates/jobs. С 01.09.2026 информация о разрешительном документе обязательна для товаров FBO и FBS (ФЗ № 546-ФЗ). Подробнее — «Работа с разрешительными документами». | ● Новое |
| 22.07.2026 | Все | Релиз Lamoda Seller Partner API v2. Единый REST API для моделей FBS и FBO — актуальная версия для всех интеграций. Документация опубликована в Lamoda Academy, материалы по API v1 переведены в архивный раздел «Статьи для версии v1». Поддержка v1 прекращается 30.11.2026 — переходите на v2. | ● Обязательно: перейти на API v2 (v1 отключается 30.11.2026) |
| 03.07.2026 | REST v2 | Управление акциями — обновление контракта. Метод удаления товаров из варианта акции переименован: вместо DELETE /v2/promotion-variants/{promotionVariantId}/products теперь POST /v2/promotion-variants/{promotionVariantId}/remove-products (тело и ответы не изменились). В ответ GET /v2/promotions/{promotionId}/products добавлено поле promotionVariantId — видно, в какой вариант акции добавлен товар. Подробнее — «Акции». | ● Обязательно: заменить DELETE → POST |
| 11.06.2026 | REST v2 | Запуск управления акциями. Пять методов для участия в акциях без личного кабинета: список акций и их вариантов, товары в акции, подбор товаров, добавление и удаление товаров в вариантах. Поддержаны onsite-акции с фиксированной и плавающей скидкой и купонные акции. Подробнее — «Акции». | ● Новое |
| 03.03.2026 | REST v1 | Возвратные статусы FBS больше не передаются через v1. По заказам и товарам перестают приходить статусы возвратного товародвижения (FBS). Для работы с возвратами перейдите на REST API v2 (/v2/fbs/return-*). Затронуты методы /api/v1/orders, /api/v1/shipments и связанные. | ● Обязательно: перейти на v2 |
| Февраль 2026 | Все | Полное обновление документации в Lamoda Academy. Старые ссылки на статьи перестают работать, новая документация — в разделе «API-интеграция»: единая структура по FBS и FBO, актуальные примеры, чек-листы. Функционал API не изменился, спецификации доступны по прежним адресам. | ● Информация: обновить закладки |
| 05.02.2026 | REST v2 | Вопросы покупателей — приведение к REST-стандарту. POST /v2/feedback/questions/list → GET /v2/feedback/questions (метод сменён на GET, параметры в query); POST /v2/feedback/questions/answer → POST /v2/feedback/questions/{questionId}/answer (questionId в пути). Enum-значения в ответе — в UPPER_CASE, поле dateCreate → createdAt, убрано поле с изображениями товаров. Подробнее — «Вопросы покупателей». | ● Обязательно: обновить контракты |
| 01.01.2026 | JSON-RPC v1 | Ставка НДС: vat20 → vat22. По ФЗ № 425-ФЗ ставка повышена с 20 % до 22 %. Значение vat20 считается устаревшим и будет отключено без предупреждения, переходного периода нет. Затронуты nomenclatures.store, attributes.sku.list, attribute-dictionaries.list. | ● Обязательно: заменить vat20 → vat22 |
| 26.12.2025 | REST v2 | Запуск возвратов FBS. Первый функционал единого REST API v2: восемь методов /v2/fbs/return-* — возвратные короба и товары, статусы, история, аномалии, статистика. Подробнее — «Продажа со своего склада (FBS)». | ● Новое |
| 24.12.2025 | JSON-RPC v1 | Вопросы покупателей — новые методы. Управление вопросами и ответами через API: выгрузка вопросов с фильтрацией (questions.list), запись ответов (questions.answer), редактирование ответов на модерации. Доступны и в REST v2: GET /v2/feedback/questions, POST /v2/feedback/questions/{questionId}/answer. | ● Новое |
| 16.12.2025 | JSON-RPC v1 | Карантин цен. При снижении цены более чем на 70 % товар попадает в карантин — цена не публикуется до подтверждения в личном кабинете. В ответах появился объект price_status с полями code (QUARANTINE / OK) и details; в nomenclatures.list добавлен фильтр priceQuarantineByCountry. Числовые поля (drop_pct, threshold_pct, цены) — тип float64. | ● Рекомендуется: обрабатывать QUARANTINE |
| 01.11.2025 | REST v1 | Этикетки через API. Три метода для товарных, паковых и паллетных этикеток (GET /api/v1/label/items, /label/packs, /label/pallets). Возвращают ссылку на PDF, лимит 100 элементов в запросе, размеры s / m / l. | ● Новое |
| 30.10.2025 | REST v1 | Статусы поставки FBO. Уточнены промежуточные значения атрибута status у GET /api/v1/shipments/fulfilment[...]. Терминальные статусы без изменений. Новые значения: draft, validation, ready_for_shipment, unloading_needed, unloading, unloaded, processing, closed, validation_error, rejected. | ● Рекомендуется: проверить обработку |
Условные обозначения
| Метка | Что значит |
|---|---|
| ● Обязательно | Нужны изменения в интеграции, иначе функционал перестанет работать |
| ● Рекомендуется | Стоит обновить интеграцию для корректной работы |
| ● Новое | Добавлен новый функционал, интеграция по необходимости |
| ● Информация | Информационное изменение, действий не требуется |
См. также
Помогла эта информация?
Спасибо за отзыв
0/1000
Отправить