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

Новость на модерации

Обновлено

18.12.2025

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

Для получения информации о товарах используются разные методы в зависимости от того, что нужно получить. 
 
<h2>Методы</h2> 
 
<table style="border-collapse: collapse; width: 100%;"> 
<tbody> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Метод</td> 
<td style="border: 1px solid #ddd; padding: 8px;">API</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Что возвращает</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>/v1/nomenclatures.list</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Seller API</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Список товаров с базовой информацией</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>/v1/attributes.sku.list</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Seller API</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Полные атрибуты товара по SKU</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code><a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%9D%D0%BE%D0%BC%D0%B5%D0%BD%D0%BA%D0%BB%D0%B0%D1%82%D1%83%D1%80%D1%8B/get_api_1_nomenclature_get_nomenclatures">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%9D%D0%BE%D0%BC%D0%B5%D0%BD%D0%BA%D0%BB%D0%B0%D1%82%D1%83%D1%80%D1%8B/get_api_1_nomenclature_get_nomenclatures</a>" target="_blank">GET /api/v1/nomenclatures</a></code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">B2B Platform</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Список товаров FBO</td> 
</tr> 
</tbody> 
</table> 
 
<h2>Seller API: Список товаров</h2> 
 
<pre><code>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 
 } 
}</code></pre> 
 
<h3>Параметры фильтрации</h3> 
 
<table style="border-collapse: collapse; width: 100%;"> 
<tbody> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Параметр</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Тип</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Описание</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>seller_id</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">integer</td> 
<td style="border: 1px solid #ddd; padding: 8px;">ID продавца (обязателен)</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>page</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">integer</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Номер страницы (с 1)</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>limit</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">integer</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Количество на странице (по умолчанию 25)</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>seller_sku</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">array</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Фильтр по вашим артикулам</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>lamoda_sku</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">array</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Фильтр по артикулам Lamoda</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>is_active</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">boolean</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Только активные товары</td> 
</tr> 
</tbody> 
</table> 
 
<h3>Пример ответа</h3> 
 
<pre><code>{ 
 "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 
 } 
 } 
}</code></pre> 
 
<h2>Seller API: Полные атрибуты товара</h2> 
 
Для получения всех атрибутов конкретного товара: 
 
<pre><code>POST v1.attributes.sku.list 
 
{ 
 "jsonrpc": "2.0", 
 "id": "...", 
 "method": "v1.attributes.sku.list", 
 "params": { 
 "lamoda_sku": "MP002XM0ABCD01" 
 } 
}</code></pre> 
 
<h3>Пример ответа</h3> 
 
<pre><code>{ 
 "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" 
 } 
 } 
 ] 
 } 
}</code></pre> 
 
 Когда использовать attributes.sku.list 
Используйте этот метод перед обновлением товара — он возвращает текущие значения всех атрибутов, включая <code>sku</code> (Lamoda SKU), который обязателен при обновлении. 
<h2>Типы артикулов</h2> 
 
<table style="border-collapse: collapse; width: 100%;"> 
<tbody> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;">Поле</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Описание</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Пример</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>seller_sku</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Ваш артикул (с размером)</td> 
<td style="border: 1px solid #ddd; padding: 8px;">MYPRODUCT-001-S</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>supplier_parent_sku</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Ваш артикул (без размера)</td> 
<td style="border: 1px solid #ddd; padding: 8px;">MYPRODUCT-001</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>lamoda_sku</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Артикул Lamoda (с размером)</td> 
<td style="border: 1px solid #ddd; padding: 8px;">MP002XM0ABCD01</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>lamoda_parent_sku</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Артикул Lamoda (без размера)</td> 
<td style="border: 1px solid #ddd; padding: 8px;">MP002XM0ABCD</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>barcode</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">Штрих-код EAN/GTIN</td> 
<td style="border: 1px solid #ddd; padding: 8px;">4607123456789</td> 
</tr> 
</tbody> 
</table> 
 
 Какой SKU использовать? 
<ul> 
<li>Для цен/остатков: <code>seller_sku</code></li> 
<li>Для обновления: <code>lamoda_sku</code> (в атрибуте sku)</li> 
<li>Для FBO цен: <code>lamoda_parent_sku</code></li> 
<li>Для склада: <code>barcode</code></li> 
</ul> 
<h2>B2B Platform API: Список товаров FBO</h2> 
 
<pre><code><a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%9D%D0%BE%D0%BC%D0%B5%D0%BD%D0%BA%D0%BB%D0%B0%D1%82%D1%83%D1%80%D1%8B/get_api_1_nomenclature_get_nomenclatures">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%9D%D0%BE%D0%BC%D0%B5%D0%BD%D0%BA%D0%BB%D0%B0%D1%82%D1%83%D1%80%D1%8B/get_api_1_nomenclature_get_nomenclatures</a>" target="_blank">GET /api/v1/nomenclatures</a>?page=1&limit=100</code></pre> 
 
Возвращает товары, загруженные в систему FBO. 
 
<h2>Пагинация</h2> 
 
Для получения всех товаров используйте пагинацию: 
 
<pre><code>// Страница 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</code></pre> 
 
<h2>Фильтрация по статусу</h2> 
 
<pre><code>// Только активные товары 
{ 
 "params": { 
 "seller_id": 12345, 
 "is_active": true 
 } 
} 
 
// Конкретные артикулы 
{ 
 "params": { 
 "seller_id": 12345, 
 "seller_sku": ["SKU-001", "SKU-002", "SKU-003"] 
 } 
}</code></pre> 
 
<h2>См. также</h2> 
 
<ul> 
<li><a href="3_1_create_products.html">Создание товаров</a></li> 
<li><a href="3_3_update_prices.html">Обновление цен</a></li> 
<li><a href="4_1_stock.html">Получение остатков</a></li> 
</ul>

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

Да Нет

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

Отправить

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

Быстрый старт работы с API