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

Lamoda Seller Partner API Метод: POST /jsonrpc/v1/nomenclatures.store

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

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

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

POST /jsonrpc/v1/dictionaries.get

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

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

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

POST /jsonrpc/v1/erp-categories.list

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

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

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

POST /jsonrpc/v1/attributes.list

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

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

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

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

POST /jsonrpc/v1/attribute-dictionaries.list

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

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

POST /jsonrpc/v1/nomenclatures.store

{
  "jsonrpc": "2.0",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "method": "v1.nomenclatures.store",
  "params": {
    "partner_id": 12345,
    "nomenclature": {
      "request_type": "create",
      "erp_category": "5637156453",
      "attributes": {
        "supplier_parent_sku": {
          "type": "string",
          "value": "MYPRODUCT-001"
        },
        "brand": {
          "type": "dictionary_entry",
          "value": "37589"
        },
        "gender": {
          "type": "dictionary_entry",
          "value": "men"
        },
        "color_family": {
          "type": "array_of_dictionary_entry",
          "value": ["635"]
        },
        "season": {
          "type": "dictionary_entry",
          "value": "41726"
        },
        "material_upper": {
          "type": "string",
          "value": "Полиэстер - 100%"
        }
      },
      "variation_attributes": [
        {
          "supplier_sku": {
            "type": "string",
            "value": "MYPRODUCT-001-S"
          },
          "size_value": {
            "type": "dictionary_entry",
            "value": "S"
          },
          "product_identifier": {
            "type": "string",
            "value": "4607123456789"
          },
          "tax_class": {
            "type": "dictionary_entry",
            "value": "vat22"
          }
        },
        {
          "supplier_sku": {
            "type": "string",
            "value": "MYPRODUCT-001-M"
          },
          "size_value": {
            "type": "dictionary_entry",
            "value": "M"
          },
          "product_identifier": {
            "type": "string",
            "value": "4607123456790"
          },
          "tax_class": {
            "type": "dictionary_entry",
            "value": "vat22"
          }
        }
      ]
    },
    "prices": [
      {
        "country": "RU",
        "price": 5990
      }
    ]
  }
}

Параметр request_type

Структура ответа

{
  "jsonrpc": "2.0",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "result": {
    "storedProducts": [
      {
        "sku": "MP002XM0ABCD01",
        "parentSku": "MP002XM0ABCD",
        "sellerSku": "MYPRODUCT-001-S"
      },
      {
        "sku": "MP002XM0ABCD02",
        "parentSku": "MP002XM0ABCD",
        "sellerSku": "MYPRODUCT-001-M"
      }
    ],
    "errors": [],
    "price_statuses": [
      {
        "code": "OK",
        "country": "RU"
      }
    ]
  }
}

Сохраните sku (Lamoda SKU) из ответа — он понадобится для обновлений и загрузки фото.

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

POST /jsonrpc/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 (jpg/jpeg)
• Разрешение: 762×1100 или 1524×2200
• Максимальный размер: 2 МБ
• Максимум 40 изображений
• order определяет порядок (1 = главное фото)
• Используйте lamoda_sku из ответа на создание

Добавление нового размера к существующему товару

Чтобы добавить новый размер к уже существующему товару, используйте тот же метод POST /jsonrpc/v1/nomenclatures.store с request_type: "create", указав тот же supplier_parent_sku. Система автоматически добавит новый размер к существующей карточке.

POST /jsonrpc/v1/nomenclatures.store

{
  "jsonrpc": "2.0",
  "id": "...",
  "method": "v1.nomenclatures.store",
  "params": {
    "partner_id": 12345,
    "nomenclature": {
      "request_type": "create",
      "erp_category": "5637156453",
      "attributes": {
        "supplier_parent_sku": {
          "type": "string",
          "value": "MYPRODUCT-001"
        }
        // ... все обязательные атрибуты категории
      },
      "variation_attributes": [
        {
          "supplier_sku": {
            "type": "string",
            "value": "MYPRODUCT-001-44"
          },
          "size_value": {
            "type": "dictionary_entry",
            "value": "44"
          },
          "product_identifier": {
            "type": "string",
            "value": "4607123456791"
          },
          "tax_class": {
            "type": "dictionary_entry",
            "value": "vat22"
          }
        }
      ]
    }
  }
}

Важно: В variation_attributes укажите только новые размеры. Не нужен sku (Lamoda SKU) — он назначается системой при создании.

Частые ошибки при создании

См. также

• Обновление товаров — обновление атрибутов и добавление размеров
• Получение списка товаров
• Управление ценами
• Атрибуты и справочники
• Частые проблемы (материалы)