15
Стать партнером
15
Отменить
–
Отменить
{{ formatMonthYear(startMonth) }}
{{ d }}
{{ day.day }}
{{ formatMonthYear(endMonth) }}
{{ d }}
{{ day.day }}
/
…
/
Инструкция по интеграции с API Lamoda Seller
Главная

Инструкция по интеграции с API Lamoda Seller

API Интеграция
Обновлено
02.03.2026
Содержание статьи

Работа с товаром

  • Получение информации о справочниках и маппингах для создания товара
  • Отправка информации о товаре для создания
  • Создание нового размера товара
  • Обновление информации о товаре
  • Обновление статуса активности товара

    • Получение информации о справочниках и маппингах для создания товара

    Выгрузите инфомодель Lamoda Seller и сопоставьте с вашими категориями и опциями атрибутов

    1. Список основных категорий товара: /v1/erp-categories.list

    Возвращает список основных категорий доступных для выбора товару.
    Для каждой категории возвращается информация:

    Название поля Описание Тип Пример
    rec_id ID категории, используется в интеграциях и API string "5637156453"
    name Название категории string "SPORT SHOES"
    path Путь категории (список ее родителей,
    включая саму категорию последним элементом).
    По количеству элементов в массиве можно определить
    уровень категории.
    Например, у категории 3-его уровня
    будет 4 элемента в массиве,
    включая ее саму.     		array of string ["5637153542", "5637156364", "5637156453"]
    allowed_for_nomenclature_template_generation Флаг доступности для генерации шаблона bool true
    translation_ru Перевод названия категории на русский язык string "Кроссовки и кеды"

    2. Список доступных атрибутов для товара: /v1/attributes.list

    Возвращает список атрибутов для товара по основной категории.
    Чтобы получить список в запросе нужно указать поля:
    Название поля Описание Тип Пример
    rec_id ID основной категории string "5637156453"

    Возвращается список атрибутов, для каждого атрибута возвращается информация:

    Название поля Описание Тип Пример
    code Уникальный идентификатор атрибута string "age_type"
    label Описание атрибута string "Возраст"
    type Тип атрибута enum: 'number', 'string',
    'boolean', 'dictionary_entry', 'array_of_dictionary_entry',
    'localized_string'     		"dictionary_entry"
    dictionary Справочник атрибута (если применимо) string "age_type"
    required_for_shipment_types Обязательность для
    разных типов доставки     		array of enum:['1', '2', '3'] ["1"]
    required_for_genders Обязательность для
    разных гендеров/полов     		array of enum:[ 'boys', 'girls',
    'kids', 'men', 'women', 'unisex' ]     		["kids", "boys"]
    required_for_templates Обязательность для
    "шаблонов"/типов запросов (создание/обновление)     		array of enum:[ 'full',
    'reduced', 'full_update' ]     		["full"]
    allowed_for_templates Разрешен для заполнения
    для "шаблонов"/типов запросов (создание/обновление)     		array of enum:[ 'full',
    'reduced', 'full_update' ]     		["full",
    "full_update"]
    comment Комментарий в помощь заполнению (для Excel) string "Укажите возраст, для которого
    предназначен товар.
    Если ограничений по возрасту нет,
    укажите значение "любой"
    allow_edit_for_seller Разрешен для редактирования bool true

    3. Список доступных опций для атрибутов с опциями: /v1/attribute-dictionaries.list

    Для атрибутов типов dictionary_entry и array_of_dictionary_entry для выбора доступен только конкретный список опций. Чтобы получить список опций, нужно передать:
    Название поля Описание Описание Пример
    seller_id Ваш ID продавца integer 2334
    dictionaries Список словарей для получения array of string ["age_type", "gender"]

    Где в список словарей нужно передавать нужные справочники атрибутов из ручки /v1/attributes.list

    Возвращается список словарей с опциями:

    Легенда
    Словарь Опция Свойство опции content
    age_type 33819
    name для любого возраста
    38108
    name 15+
    38107
    name 25+
    gender
    Легенда
    boys
    name boys
    unisex
    name unisex
    girls
    name girls
    kids
    name kids
    men
    name men
    women
    name women

    4. Список маппингов опций атрибутов друг на друга: /v1/attributes-dictionaries-mappings.get

       Некоторые опции атрибутов зависят друг от друга. Чтобы узнать маппинги опций атрибутов друг на друга и успешно пройти валидацию продукта при создании, нужно сделать запрос, передав ID основной категории будущего продукта.

    Название поля Описание Тип Пример
    rec_id ID основной категории string "5637156836"

    В ответе вернется такая структура данных, отфильтрованная по основной категории:

    мачм.png

    dvdfv.png

    Из этой таблицы можно сделать выводы, что:

    1. Для переданной основной категории доступны
      a. категории сайта с ID 35 и 39
      b. ТН ВЭДы с ID 35776 и 35765
      c. наименования с ID 278
      d. шкалы размеров с ID ACC_W_BELTS_INT и CL_M_IT
    2. Для ТН ВЭДов
      a. с ID 35776 доступны любые гендеры
      b. с ID 35765 доступны гендеры с ID women, girls, kids, unisex
    3. Для наименований
      a. с ID 278 доступна комната с ID 35139
    4. Для шкал размеров
    • a. с ID ACC_W_BELTS_INT доступны
      i. значения размеров с ID XXS, XS, S, M, L, XL, XXL
      ii. гендер с ID women
      iii. запрещено создание продукта с единственным размером
    • b. с ID CL_M_IT доступны
      i. значения размеров с ID 42, 44, 46, 48, 50, 52, 54, 56, 58, 60, 62, 64, 40, 66, 49
      ii. гендер с ID men
      iii. запрещено создание продукта с единственным размером

      • Отправка информации о товаре для создания

      Отправьте информацию о товаре через API /v1/nomenclatures.store

      Укажите:

      1. Ваш ID продавца
      2. Тип запроса "на создание"
      3. Основную категорию товара
      4. Атрибуты продукта
      5. Атрибуты размера
      6. Цены

      Вы можете добавить фотографии через API /v1/nomenclature-images.update, указав уникальный идентификатор товара (SKU), полученный в ответе после успешного создания товара.

      Создание нового размера товара

      Получите информацию о товаре через API /v1/attributes.sku.list.

      Используя полученную информацию, отправьте запрос в /v1/nomenclatures.store, указав:

      1. Ваш ID продавца
      2. Тип запроса "на создание".
      3. Основную категориютовара
      4. Атрибуты продукта
      5. Атрибуты размера (укажите новые значения которые хотите создать)

      Обновление информации о товаре

      Получите информацию о товаре через API /v1/attributes.sku.list.
      Используя полученную информацию, отправьте запрос в /v1/nomenclatures.store, указав:
      1. Ваш ID продавца
      2. Тип запроса "на обновление".
      3. Основную категорию товара
      4. Обязательные атрибуты продукта для обновления
      5. Атрибуты которые вы хотите обновить с новыми значениями
      6. Обязательные атрибуты размера для обновления
      7. Атрибуты размера которые вы хотите обновить с новыми значениями

      Обновление статуса активности товара

      Получите информацию о товаре через API /v1/attributes.sku.list.
      Используя полученную информацию, отправьте запрос в /v1/nomenclatures.update-activation, указав filter.key: "lamodaSku", либо же воспользуйтесь другим фильтрующим параметром указав:

      1. Текущий статус активности
      2. Страну продажи, для которой меняется статус активности

      Сценарии

      • Получение информации о справочниках и меппингах для создания товара
      • Отправка информации о товаре для создания
      • Создание нового размера товара
      • Обновление информации о товаре
      • Получение информации о товарах
      • Обновление статуса активности товара

      Получение информации о справочниках и меппингах для создания товара

      • Информация о вашем профиле продавца
      • Список основных категорий товара
      • Список доступных атрибутов для товара
      • Список доступных опций для атрибутов с опциями
      • Список маппингов опций атрибутов друг на друга

      Информация о вашем профиле продавца

      API: /v1/dictionaries.get
      Возвращает информацию о вашем профиле продавца, в том числе ваш ID, который используется для доступа к другим API.

      1482_0KHQvdC40LzQvtC6INGN0LrRgNCw0L3QsCAyMDI0LTEyLTEzIDEyMjczNA==.png

      1499_0KHQvdC40LzQvtC6INGN0LrRgNCw0L3QsCAyMDI0LTEyLTEzIDEzMzA1Ng==.png

      Отправка информации о товаре для создания

      Отправьте информацию о товаре через API

      API: /v1/nomenclatures.store

      Создает товар, включая атрибуты и цены. Для создания нужно отправить параметр "тип запроса" равным create для создания номенклатуры со всеми доступными атрибутами и своими фотографиями или create_reduced для номенклатуры с сокращенным списком атрибутов и отправкой номенклатуры на съемку и доописание на фотостудию.

      Чтобы определить, какие динамические атрибуты передать, нужно сделать запрос на получение списка атрибутов по основной категории. Подробнее тут.

      • Для того чтобы узнать все доступные атрибуты, нужно смотреть на атрибуты, у которых поле "allowed_for_templates" содержит значение "full" для полного списка атрибутов и "reduced" для сокращенного..
      • Для того чтобы узнать обязательные атрибуты для создания, нужно смотреть на атрибуты, у которых поле "required_for_templates" содержит значение "full" для полного списка атрибутов и "reduced" для сокращенного.
      • Для того чтобы узнать обязательные атрибуты по типу доставки, нужно смотреть на атрибуты, у которых поле "required_for_shipment_types" содержит значение вашего типа доставки.
      • Чтобы узнать обязательные атрибуты по гендеру, нужно смотреть на атрибуты, у которых поле "required_for_genders" содержит пол/гендер, который вы выбрали для продукта.
      Минимальный набор атрибутов для создания: обязательные атрибуты для создания + обязательные по типу доставки + обязательные по гендеру.

      Структура запроса:
      1500_0KHQvdC40LzQvtC6INGN0LrRgNCw0L3QsCAyMDI0LTEyLTEzIDEzMzE1MQ==.png

      Структура ответа:
      1501_0KHQvdC40LzQvtC6INGN0LrRgNCw0L3QsCAyMDI0LTEyLTEzIDEzMzUwMw==.png

      После создания товара вы можете добавить фотографии через API /v1/nomenclature-images.update, указав уникальный идентификатор товара (SKU), полученный в ответе после успешного создания товара.

      Создание нового размера товара

      Получите информацию о товаре через API /v1/attributes.sku.list, передав Lamoda sku полученный после создания товара.

      Структура ответа:
      1504_0KHQvdC40LzQvtC6INGN0LrRgNCw0L3QsCAyMDI0LTEyLTEzIDEzNTIwMA==.png

      Используя полученную информацию, отправьте запрос в /v1/nomenclatures.store как описано для создания продукта.

      Важно указать атрибут supplier_parent_sku таким же, какой он передавался при первоначальном создании продукта. Корректное значение можно найти в API v1/attributes.sku.list.

      Укажите тип и значение по всем обязательным атрибутам из ответа API в поле product.
      Укажите только новые размеры с обязательными атрибутами в поле variations.

      Обновление информации о товаре

      Получите информацию о товаре для обновления через API.
      Получите информацию о товаре через API /v1/attributes.sku.list, передав Lamoda sku полученный после создания товара.

      Структура ответа:
      1505_0KHQvdC40LzQvtC6INGN0LrRgNCw0L3QsCAyMDI0LTEyLTEzIDE0NDU1Nw==.png
      1506_0KHQvdC40LzQvtC6INGN0LrRgNCw0L3QsCAyMDI0LTEyLTEzIDE0NDkzMQ==.png

      Используя полученную информацию, отправьте запрос в /v1/nomenclatures.store.

      Отправьте информацию о товаре через API

      API: /v1/nomenclatures.store

      Обновляет товар, включая атрибуты и цены. Для обновления нужно отправить параметр "тип запроса" равным update.

      Чтобы определить, какие динамические атрибуты передать, нужно сделать запрос на получение списка атрибутов по основной категории.

      • Для того чтобы узнать все доступные атрибуты, нужно смотреть на атрибуты, у которых поле "allowed_for_templates" содержит значение "full_update".
      • Для того чтобы узнать атрибуты, которые можно отредактировать, нужно смотреть на поле "allow_edit_for_seller".
      • Для того чтобы узнать обязательные атрибуты для обновления, нужно смотреть на атрибуты, у которых поле "required_for_templates"
        содержит значение "full_update".
      • Для того чтобы узнать обязательные атрибуты для обновления, нужно смотреть на атрибуты, у которых поле "required_for_genders"
        содержит значение гендера вашего продукта.
      • Для того чтобы узнать обязательные атрибуты для обновления, нужно смотреть на атрибуты, у которых поле "required_for_shipment_types" содержит значение вашего типа доставки.

      Минимальный набор атрибутов для обновления: обязательные атрибуты которые нужно указать для обновления + обязательные атрибуты
      которые нужно указать по типу доставки + обязательные атрибуты которые нужно указать по гендеру.

      Структура запроса:

      1507_0KHQvdC40LzQvtC6INGN0LrRgNCw0L3QsCAyMDI0LTEyLTEzIDE1MDAxNw==.png

      Структура ответа:
      1509_0KHQvdC40LzQvtC6INGN0LrRgNCw0L3QsCAyMDI0LTEyLTEzIDE1MDIwNg==.png

      Обновление фотографий продукта

      Получите информацию по существующим фотографиям продукта в API .
      По всем фотографиям продукта вам вернется идентификатор фото в системе (external_id).
      Теперь вы можете сделать запрос в API /v1/nomenclatures-images.update и

      1. обновить порядок фотографий, указав новый order нужному external_id
      2. удалить фотографию, убрав её из запроса
      3. добавить новую фотографию, указав ее кодирование в base64 и нужный order

      Получение информации о справочниках и меппингах для создания товара

      Информация о вашем профиле продавца
      Список основных категорий товара
      Список доступных атрибутов для товара
      Список доступных опций для атрибутов с опциями
      Список маппингов опций атрибутов друг на друга

      Информация о вашем профиле продавца

      API: /v1/dictionaries.get

      Возвращает информацию о вашем профиле продавца, в том числе ваш ID, который используется для доступа к другим API.

      Обновление статуса активности товара

      Массовое обновление активности товаров

      API: /v1/nomenclatures.update-activation

      Swagger: https://backend.lamoda.dev.academy-seller.ru/swagger-ui/#/%D0%A2%D0%BE%D0%B2%D0%B0%D1%80%D1%8B%20Lamoda%20Seller/v1
      Позволяет скрыть или отобразить товары на сайте, которые соответствуют переданному фильтру
      Детализация возможных значений в реквесте:

      В случае, если все прошло успешно, то в структуре ответа будет пустой массив errors, иначе - будут перечислены ошибки по товарам, которые не получилось обновить.
      Если товар будет обновлен повторно до того, как обработается прошлый реквест, то вернется ошибка Nomenclature sell value in processing

      Сущности

      • Основная категория
      • Категория сайта
      • Атрибуты
      • Тип доставки

      Основная категория

      Синонимы: ERP-категория, Axapta-категория
      Категория, по которой определяем атрибуты доступные для продукта.
      Категории наследуются друг от друга.
      Все атрибуты доступные для категории N уровня доступны и для детей категории N+1 уровней.

      Все продукты привязаны к категориям третьего уровня.
      Выгрузка шаблонов экспорта и создания доступно для категорий начиная с первого уровня.

      Категория сайта

      Синонимы: сайтовая категория, маркетинговая категория

      Категория, которая отвечает за размещение товара в секциях и разделах на самом сайте Lamoda.ru.
      Так же отвечает за отображаемые атрибуты на сайте.

      К продукту может быть привязано сразу несколько категорий сайта

      Атрибуты

      Атрибуты описывают характеристики продукта. Атрибуты бывают нескольких типов:

      Тип доставки

      Доступны несколько способов сотрудничества с Lamoda, которые определяют тип доставки вашего продукта. 

    Помогла эта информация?

    Да Нет

    Спасибо за отзыв

    Отправить
    Настройки на портале и работа на локальном маркетплейсе Казахстана
    Передача заказа
    Сайт использует cookie с целью анализа поведения посетителей для улучшения Сайта. Продолжая пользоваться Сайтом, вы соглашаетесь на использование файлов cookie в соответствии с нашими Cookie-правилами
    Хорошо
    Спросить у Lamoda Seller Assistant в Telegram