5.2 Остатки FBO

Обновлено

16.02.2026

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

<h1>5.2 Остатки FBO</h1> 
 
 
Lamoda B2B Platform предоставляет возможность получения информации о товарных запасах на складе Lamoda, актуальных на момент выполнения запроса. Это критически важно для FBO-модели, где весь сток хранится на стороне Lamoda. 
 
 
⚠️ Важно: При создании заказа Lamoda автоматически проверяет доступность товаров на складе. Если товара нет в наличии, он перейдёт в статус <code>canceled</code>. Регулярная синхронизация остатков помогает избежать таких ситуаций. 
 
<h2>Метод получения остатков</h2> 
 
GET <a href="<a class="txttohtmllink" href="https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%A1%D1%82%D0%BE%D0%BA/get_api_1_get_stock">https://academy.lamoda.ru/articles/api/apispec/lamoda-b2b-platform-api/#/%;D0%A1%D1%82%D0%BE%D0%BA/get_api_1_get_stock</a>" target="_blank">/api/v1/stock/goods</a> 
Возвращает список товаров с количеством на складе Lamoda. 
 
<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> 
<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>page</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">integer</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Нет</td> 
<td style="border: 1px solid #ddd; padding: 8px;">1</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;">Нет</td> 
<td style="border: 1px solid #ddd; padding: 8px;">25</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Количество SKU на странице (макс. 100)</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>withZeroQuantity</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">0 или 1</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Нет</td> 
<td style="border: 1px solid #ddd; padding: 8px;">1</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Включать товары с нулевым остатком: 1 — да, 0 — нет</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>partnerCode</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">string</td> 
<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;">Код партнёра (только заглавные A-Z)</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>updatedAt</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">string</td> 
<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;">Получить только изменения после указанной даты. Формат: <code>YYYY-MM-DD+hh:mm:ss</code></td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>sku[]</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">array</td> 
<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;">Фильтр по конкретным артикулам (до 100 SKU)</td> 
</tr> 
</tbody> 
</table> 
 
<h2>Примеры запросов</h2> 
 
<h3>Получение полного стока</h3> 
 
<pre> 
curl -X GET "<a class="txttohtmllink" href="https://api-b2b.lamoda.ru/api/v1/stock/goods?page=1&limit=50">https://api-b2b.lamoda.ru/api/v1/stock/goods?page=1&limit=50</a>" \ 
 -H "Authorization: Bearer YOUR_ACCESS_TOKEN" 
</pre> 
 
<h3>Получение стока без нулевых позиций</h3> 
 
<pre> 
curl -X GET "<a class="txttohtmllink" href="https://api-b2b.lamoda.ru/api/v1/stock/goods?withZeroQuantity=0&limit=100">https://api-b2b.lamoda.ru/api/v1/stock/goods?withZeroQuantity=0&limit=100</a>" \ 
 -H "Authorization: Bearer YOUR_ACCESS_TOKEN" 
</pre> 
 
<h3>Получение стока по конкретным SKU</h3> 
 
<pre> 
curl -X GET "<a class="txttohtmllink" href="https://api-b2b.lamoda.ru/api/v1/stock/goods?sku[]=SELLER-SKU-001&sku[]=SELLER-SKU-002">https://api-b2b.lamoda.ru/api/v1/stock/goods?sku[]=SELLER-SKU-001&sku[]=SELLER-SKU-002</a>" \ 
 -H "Authorization: Bearer YOUR_ACCESS_TOKEN" 
</pre> 
 
<h3>Получение дельты (изменений с определённого момента)</h3> 
 
<pre> 
curl -X GET "<a class="txttohtmllink" href="https://api-b2b.lamoda.ru/api/v1/stock/goods?updatedAt=2025-01-15+;10:00:00">https://api-b2b.lamoda.ru/api/v1/stock/goods?updatedAt=2025-01-15+;10:00:00</a>" \ 
 -H "Authorization: Bearer YOUR_ACCESS_TOKEN" 
</pre> 
 
<h3>Получение стока для конкретного партнёра</h3> 
 
<pre> 
curl -X GET "<a class="txttohtmllink" href="https://api-b2b.lamoda.ru/api/v1/stock/goods?partnerCode=PARTNER">https://api-b2b.lamoda.ru/api/v1/stock/goods?partnerCode=PARTNER</a>" \ 
 -H "Authorization: Bearer YOUR_ACCESS_TOKEN" 
</pre> 
 
<h2>Пример ответа</h2> 
 
<pre> 
{ 
 "_links": { 
 "self": { "href": "/api/v1/stock/goods?page=1&limit=25" }, 
 "next": { "href": "/api/v1/stock/goods?page=2&limit=25" } 
 }, 
 "_embedded": { 
 "stockStates": [ 
 { 
 "sku": "SELLER-SKU-001", 
 "quantity": 15 
 }, 
 { 
 "sku": "SELLER-SKU-002", 
 "quantity": 0 
 } 
 ] 
 }, 
 "page": 1, 
 "limit": 25, 
 "pages": 10, 
 "total": 245 
} 
</pre> 
 
⚠️ Важно: Wrapper в ответе — <code>_embedded.stockStates</code> (не <code>_embedded.goods</code>). 
 
<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>sku</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">string</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Артикул товара (supplier SKU)</td> 
</tr> 
<tr> 
<td style="border: 1px solid #ddd; padding: 8px;"><code>quantity</code></td> 
<td style="border: 1px solid #ddd; padding: 8px;">integer</td> 
<td style="border: 1px solid #ddd; padding: 8px;">Количество на складе</td> 
</tr> 
</tbody> 
</table> 
 
<h3>Про резервы и доступность</h3> 
 
API возвращает базовые поля <code>sku</code> и <code>quantity</code>. Резервы (<code>reserved</code>) и доступное количество (<code>available</code>) вычисляются динамически: 
 
<ul> 
<li>reserved — количество товаров в неподтверждённых заказах (статусы <code>initial</code> и <code>new</code>)</li> 
<li>available = quantity - reserved</li> 
</ul> 
 
Для партнёров с флагом <code>isNewFashion</code> резервы не вычисляются, возвращается только <code>quantity</code>. 
 
<h2>Стратегии синхронизации остатков</h2> 
 
<h3>Полная синхронизация</h3> 
 
Рекомендуется выполнять 1-2 раза в сутки для полной сверки: 
 
<pre> 
# Получаем все страницы 
page = 1 
all_stock = [] 
 
while True: 
 response = get_stock(page=page, limit=100, withZeroQuantity=1) 
 all_stock.extend(response['_embedded']['stockStates']) 
 
 if page >= response['pages']: 
 break 
 page += 1 
 
# Обновляем локальную базу 
sync_local_database(all_stock) 
</pre> 
 
<h3>Инкрементальная синхронизация (дельта)</h3> 
 
Для частых обновлений (каждые 15-30 минут) используйте параметр <code>updatedAt</code>: 
 
<pre> 
# Сохраняем время последней синхронизации 
last_sync = "2025-01-20+14:00:00" 
 
# Получаем только изменения 
response = get_stock(updatedAt=last_sync, withZeroQuantity=1) 
 
# Обновляем изменённые позиции 
for item in response['_embedded']['stockStates']: 
 update_local_stock(item['sku'], item['quantity']) 
 
# Сохраняем новое время синхронизации 
last_sync = datetime.now().strftime("%Y-%m-%d+%H:%M:%S") 
</pre>

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

Да Нет

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

Отправить

6.1 Генерация этикеток

5.1 Остатки FBS