Получение товаров

Для получения информации о товарах используются разные методы в зависимости от задачи.

Методы

Lamoda Seller Partner API: Список товаров (POST /jsonrpc/v1/nomenclatures.list)

POST /jsonrpc
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN

{
  "jsonrpc": "2.0",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "method": "v1.nomenclatures.list",
  "params": {
    "country": "RU",
    "page": 1,
    "limit": 25
  }
}

Параметры запроса

Фильтрация

Фильтры передаются в массиве filter. Каждый элемент — объект с полями key, operator, value:

"filter": [
  {
    "key": "sellerSku",
    "operator": "IN",
    "value": ["SKU-001", "SKU-002"]
  }
]

Важно: value — всегда массив, даже для одного значения. Ключи используют camelCase (не snake_case).

Строковые поля

Числовые поля (ограниченная поддержка)

Логические поля (только EQ)

Поля даты

Полнотекстовый поиск

Специальные фильтры

Примеры фильтрации

Найти товар по артикулу продавца

{
  "jsonrpc": "2.0",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "method": "v1.nomenclatures.list",
  "params": {
    "country": "RU",
    "filter": [
      {
        "key": "supplierSku",
        "operator": "IN",
        "value": ["BT-0790_DBROWN"]
      }
    ]
  }
}

Товары, созданные в январе 2025

{
  "jsonrpc": "2.0",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "method": "v1.nomenclatures.list",
  "params": {
    "country": "RU",
    "filter": [
      {
        "key": "createdAt",
        "operator": "BETWEEN",
        "value": ["2025-01-01", "2025-01-31"]
      }
    ]
  }
}

Комбинированный фильтр: активные товары Nike с остатком

{
  "jsonrpc": "2.0",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "method": "v1.nomenclatures.list",
  "params": {
    "country": "RU",
    "filter": [
      {
        "key": "brand",
        "operator": "EQ",
        "value": ["Nike"]
      },
      {
        "key": "isSellable",
        "operator": "EQ",
        "value": ["true"]
      },
      {
        "key": "quantity",
        "operator": "GREATER",
        "value": ["0"]
      }
    ]
  }
}

Пример ответа

{
  "jsonrpc": "2.0",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "result": {
    "page": 1,
    "limit": 25,
    "pages": 10,
    "total": 245,
    "nomenclatures": [
      {
        "nomenclature": {
          "lamodaSku": "MP002XM0ABCD01",
          "lamodaParentSku": "MP002XM0ABCD",
          "sellerSku": "MYPRODUCT-001-S",
          "sellerParentSku": "MYPRODUCT-001",
          "sellerSize": "S",
          "barcode": "4607123456789",
          "brand": "Nike",
          "name": "Кроссовки Nike Air Max",
          "axaptaCategoryLevel1": "SHOES",
          "axaptaCategoryLevel1Ru": "Обувь",
          "axaptaCategoryLevel2": "SPORT SHOES",
          "axaptaCategoryLevel2Ru": "Кроссовки",
          "quantity": 50,
          "status": "active",
          "isSellable": true,
          "isExportable": true,
          "price": 5990,
          "ruPrice": 5990,
          "salePrice": null,
          "ruSalePrice": null,
          "saleStartDate": null,
          "saleEndDate": null,
          "priceUpdateStatus": "APPLIED",
          "images": [
            {
              "url": "https://a.lmcdn.ru/img600x866/M/P/MP002XM0ABCD_1.jpg",
              "type": "main",
              "order": 1
            }
          ]
        }
      }
    ]
  }
}

Lamoda Seller Partner API: Полные атрибуты товара (POST /jsonrpc/v1/attributes.sku.list)

Для получения всех атрибутов конкретного товара:

POST /jsonrpc
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN

{
  "jsonrpc": "2.0",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "method": "v1.attributes.sku.list",
  "params": {
    "sku": "MP002XM0ABCD01"
  }
}

Пример ответа

{
  "jsonrpc": "2.0",
  "id": "...",
  "result": {
    "product": [
      {
        "code": "supplier_parent_sku",
        "label": "Артикул поставщика",
        "type": "string",
        "value": "MYPRODUCT-001"
      },
      {
        "code": "brand",
        "label": "Бренд",
        "type": "dictionary_entry",
        "dictionary": "brand",
        "value": "Nike"
      },
      {
        "code": "gender",
        "label": "Пол",
        "type": "dictionary_entry",
        "dictionary": "gender",
        "value": "men"
      }
    ],
    "variation": {
      "MP002XM0ABCD01": [
        {
          "code": "sku",
          "label": "Lamoda SKU",
          "type": "string",
          "value": "MP002XM0ABCD01"
        },
        {
          "code": "supplier_sku",
          "label": "Артикул поставщика",
          "type": "string",
          "value": "MYPRODUCT-001-S"
        },
        {
          "code": "size_value",
          "label": "Размер",
          "type": "dictionary_entry",
          "dictionary": "size_value",
          "value": "S"
        },
        {
          "code": "product_identifier",
          "label": "Штрих-код",
          "type": "string",
          "value": "4607123456789"
        },
        {
          "code": "tax_class",
          "label": "Ставка НДС",
          "type": "dictionary_entry",
          "dictionary": "tax_class",
          "value": "vat22"
        }
      ]
    }
  }
}

Когда использовать: перед обновлением товара — метод возвращает текущие значения всех атрибутов, включая sku (Lamoda SKU), который обязателен в variation_attributes при обновлении.

Пагинация

Для получения всех товаров используйте пагинацию:

// Страница 1
{ "params": { "country": "RU", "page": 1, "limit": 100 } }

// Страница 2
{ "params": { "country": "RU", "page": 2, "limit": 100 } }

// Продолжайте, пока page * limit < total

Сортировка

Доступные поля для сортировки:

Префикс - означает сортировку по убыванию.

См. также

• Создание товаров
• Управление ценами
• Ценовой карантин
• Обновление товаров