Получение списка товаров через API

Статья на модерации

Обновлено

18.12.2025

Содержание статьи

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

Методы

Метод	API	Что возвращает
`/v1/nomenclatures.list`	Seller API	Список товаров с базовой информацией
`/v1/attributes.sku.list`	Seller API	Полные атрибуты товара по SKU
`GET /api/v1/nomenclatures`	B2B Platform	Список товаров FBO

Seller API: Список товаров

POST v1.nomenclatures.list

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

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

Параметр	Тип	Описание
`seller_id`	integer	ID продавца (обязателен)
`page`	integer	Номер страницы (с 1)
`limit`	integer	Количество на странице (по умолчанию 25)
`seller_sku`	array	Фильтр по вашим артикулам
`lamoda_sku`	array	Фильтр по артикулам Lamoda
`is_active`	boolean	Только активные товары

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

{
  "jsonrpc": "2.0",
  "id": "...",
  "result": {
    "data": [
      {
        "lamoda_sku": "MP002XM0ABCD01",
        "lamoda_parent_sku": "MP002XM0ABCD",
        "seller_sku": "MYPRODUCT-001-S",
        "supplier_parent_sku": "MYPRODUCT-001",
        "barcode": "4607123456789",
        "brand": "Nike",
        "title": "Кроссовки Nike Air Max",
        "color": "Чёрный",
        "size": "S",
        "is_active": true,
        "created_at": "2025-01-15T10:30:00Z",
        "updated_at": "2025-12-01T14:20:00Z"
      },
      {
        "lamoda_sku": "MP002XM0ABCD02",
        "lamoda_parent_sku": "MP002XM0ABCD",
        "seller_sku": "MYPRODUCT-001-M",
        "supplier_parent_sku": "MYPRODUCT-001",
        "barcode": "4607123456790",
        "brand": "Nike",
        "title": "Кроссовки Nike Air Max",
        "color": "Чёрный",
        "size": "M",
        "is_active": true
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 100,
      "total": 1250
    }
  }
}

Seller API: Полные атрибуты товара

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

POST v1.attributes.sku.list

{
  "jsonrpc": "2.0",
  "id": "...",
  "method": "v1.attributes.sku.list",
  "params": {
    "lamoda_sku": "MP002XM0ABCD01"
  }
}

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

{
  "result": {
    "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": [
      {
        "sku": {
          "type": "string",
          "value": "MP002XM0ABCD01"
        },
        "supplier_sku": {
          "type": "string",
          "value": "MYPRODUCT-001-S"
        },
        "size_value": {
          "type": "dictionary_entry",
          "value": "S"
        },
        "barcode": {
          "type": "string",
          "value": "4607123456789"
        }
      }
    ]
  }
}

Когда использовать attributes.sku.list

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

Типы артикулов

Поле	Описание	Пример
`seller_sku`	Ваш артикул (с размером)	MYPRODUCT-001-S
`supplier_parent_sku`	Ваш артикул (без размера)	MYPRODUCT-001
`lamoda_sku`	Артикул Lamoda (с размером)	MP002XM0ABCD01
`lamoda_parent_sku`	Артикул Lamoda (без размера)	MP002XM0ABCD
`barcode`	Штрих-код EAN/GTIN	4607123456789

Какой SKU использовать?

Для цен/остатков: seller_sku
Для обновления: lamoda_sku (в атрибуте sku)
Для FBO цен: lamoda_parent_sku
Для склада: barcode

B2B Platform API: Список товаров FBO

GET /api/v1/nomenclatures?page=1&limit=100

Возвращает товары, загруженные в систему FBO.

Пагинация

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

// Страница 1
POST v1.nomenclatures.list
{ "params": { "seller_id": 12345, "page": 1, "limit": 100 } }

// Страница 2
POST v1.nomenclatures.list
{ "params": { "seller_id": 12345, "page": 2, "limit": 100 } }

// И так далее, пока total > page * limit

Фильтрация по статусу

// Только активные товары
{
  "params": {
    "seller_id": 12345,
    "is_active": true
  }
}

// Конкретные артикулы
{
  "params": {
    "seller_id": 12345,
    "seller_sku": ["SKU-001", "SKU-002", "SKU-003"]
  }
}

См. также

Создание товаров
Обновление цен
Получение остатков: F BS, FBO

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

Да Нет

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

0/1000 Отправить