Создание товаров через API

Seller API Метод: POST v1.nomenclatures.store

Товар в Lamoda — это карточка с атрибутами (бренд, материал, цвет) и размерными вариациями (SKU). Один товар может иметь несколько размеров.

Процесс создания товара

1 Получить ID продавца: /v1/dictionaries.get ↓ 2 Получить категории: /v1/erp-categories.list ↓ 3 Получить атрибуты категории: /v1/attributes.list ↓ 4 Получить справочники атрибутов: /v1/attribute-dictionaries.list ↓ 5 Создать товар: /v1/nomenclatures.store ↓ 6 Загрузить фото: /v1/nomenclature-images.update

Шаг 1: Получить ID продавца

POST v1.dictionaries.get

{
  "jsonrpc": "2.0",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "method": "v1.dictionaries.get",
  "params": {}
}

В ответе получите seller_id — он нужен для всех последующих запросов.

Шаг 2: Получить категории

POST v1.erp-categories.list

{
  "jsonrpc": "2.0",
  "id": "...",
  "method": "v1.erp-categories.list",
  "params": {}
}

Ответ содержит список категорий с rec_id — это ID основной категории товара.

Шаг 3: Получить атрибуты категории

POST v1.attributes.list

{
  "jsonrpc": "2.0",
  "id": "...",
  "method": "v1.attributes.list",
  "params": {
    "rec_id": "5637156453"
  }
}

Структура атрибута

Поле	Описание
code	Уникальный идентификатор атрибута
label	Название атрибута
type	Тип: string, number, boolean, dictionary_entry
dictionary	Справочник (если type = dictionary_entry)
required_for_templates	Обязательность: full, reduced, full_update
required_for_shipment_types	Обязательность по типу доставки: 1, 2, 3
required_for_genders	Обязательность по полу: men, women, kids...

Минимальный набор атрибутов

= Обязательные для создания (required_for_templates: full)
+ Обязательные по типу доставки (required_for_shipment_types)
+ Обязательные по полу (required_for_genders)

Шаг 4: Получить справочники

Для атрибутов с type: dictionary_entry нужно получить допустимые значения:

POST v1.attribute-dictionaries.list

{
  "jsonrpc": "2.0",
  "id": "...",
  "method": "v1.attribute-dictionaries.list",
  "params": {
    "dictionary": "gender"
  }
}

Шаг 5: Создать товар

POST v1.nomenclatures.store

{
  "jsonrpc": "2.0",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "method": "v1.nomenclatures.store",
  "params": {
    "seller_id": 12345,
    "type": "create",
    "rec_id": "5637156453",
    "product": {
      "supplier_parent_sku": {
        "type": "string",
        "value": "MYPRODUCT-001"
      },
      "brand": {
        "type": "dictionary_entry",
        "value": "Nike"
      },
      "gender": {
        "type": "dictionary_entry",
        "value": "men"
      },
      "color": {
        "type": "dictionary_entry",
        "value": "black"
      },
      "material_upper": {
        "type": "string",
        "value": "Полиэстер - 100%"
      }
    },
    "variations": [
      {
        "supplier_sku": {
          "type": "string",
          "value": "MYPRODUCT-001-S"
        },
        "size_value": {
          "type": "dictionary_entry",
          "value": "S"
        },
        "barcode": {
          "type": "string",
          "value": "4607123456789"
        },
        "tax_class": {
          "type": "dictionary_entry",
          "value": "full"
        }
      },
      {
        "supplier_sku": {
          "type": "string",
          "value": "MYPRODUCT-001-M"
        },
        "size_value": {
          "type": "dictionary_entry",
          "value": "M"
        },
        "barcode": {
          "type": "string",
          "value": "4607123456790"
        },
        "tax_class": {
          "type": "dictionary_entry",
          "value": "full"
        }
      }
    ],
    "prices": [
      {
        "supplier_sku": "MYPRODUCT-001-S",
        "country": "RU",
        "price": 5990,
        "sale_price": null,
        "sale_start": null,
        "sale_end": null
      },
      {
        "supplier_sku": "MYPRODUCT-001-M",
        "country": "RU",
        "price": 5990,
        "sale_price": null,
        "sale_start": null,
        "sale_end": null
      }
    ]
  }
}

Параметр type

Значение	Описание
create	Создание с полным набором атрибутов и своими фото
create_reduced	Создание с сокращённым набором, отправка на фотостудию
update	Обновление существующего товара

Шаг 6: Загрузить фото

POST v1.nomenclature-images.update

{
  "jsonrpc": "2.0",
  "id": "...",
  "method": "v1.nomenclature-images.update",
  "params": {
    "lamoda_sku": "MP002XM0ABCD",
    "images": [
      {
        "order": 1,
        "file": "/9j/4AAQSkZJRgABAQEBLAEsAAD..."
      },
      {
        "order": 2,
        "file": "/9j/4AAQSkZJRgABAQEBLAEsAAD..."
      }
    ]
  }
}

Формат изображений

• Base64-encoded строка
• Формат: JPEG или PNG
• order определяет порядок (1 = главное фото)
• Используйте lamoda_sku из ответа на создание

Обновление товара

Для обновления используйте тот же метод с "type": "update":

{
  "params": {
    "seller_id": 12345,
    "type": "update",
    "rec_id": "5637156453",
    "product": {
      "supplier_parent_sku": {
        "type": "string",
        "value": "MYPRODUCT-001"
      },
      // Обязательные атрибуты для триггера обновления
      // + атрибуты, которые хотите изменить
    },
    "variations": [
      {
        "sku": {
          "type": "string",
          "value": "MP002XM0ABCD01"  // Lamoda SKU обязателен!
        },
        "supplier_sku": {...},
        "size_value": {...},
        "tax_class": {...},
        "product_identifier": {...}
        // + атрибуты для изменения
      }
    ]
  }
}

При обновлении обязателен sku (Lamoda SKU)

В variations для каждого размера нужно указать атрибут sku со значением Lamoda SKU. Без него обновление не пройдет.

Добавление нового размера

Чтобы добавить новый размер к существующему товару:

1. Получите текущие атрибуты: /v1/attributes.sku.list
2. Отправьте /v1/nomenclatures.store с type: create
3. Укажите тот же supplier_parent_sku
4. В variations укажите только новые размеры

Частые ошибки

Ошибка	Причина	Решение
Указанный материал не найден	Неверный формат материала	Формат: Материал - XX% (пробел-тире-пробел)
Отсутствует обязательный атрибут	Не все required атрибуты переданы	Проверьте required_for_templates + shipment_types + genders
Ошибка обновления	Не указан Lamoda SKU	Добавьте атрибут sku в variations
Значение атрибута недоступно	Значение не в справочнике	Проверьте /v1/attribute-dictionaries.list

См. также

• Получение списка товаров
• Обновление цен
• Рекомендации по надежной интеграции от партнеров