Остатки FBS в API

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

Обновлено

26.12.2025

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

Остатки показывают, сколько товаров доступно для продажи на складе Lamoda (FBO) или зарезервировано в заказах.

Методы по моделям

Модель	API	Метод
FBO	B2B Platform	`GET /api/v1/stock/goods`
FBS	Seller API	`POST v1.stock.list`

FBO: Получение остатков

Полный сток

curl -X GET "https://api-b2b.lamoda.ru/api/v1/stock/goods?page=1&limit=100" \
-H "Authorization: Bearer YOUR_TOKEN"

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

Параметр	Формат	По умолчанию	Описание
`page`	число > 0	1	Номер страницы
`limit`	число > 0	25	Количество SKU на странице
`withZeroQuantity`	0 или 1	1	Включать нулевые остатки
`updatedAt`	YYYY-MM-DD+hh:mm:ss	—	Получить только изменённые с момента
`sku[]`	массив строк	—	Конкретные артикулы (до 100)

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

{
  "data": [
    {
      "sku": "SELLER-SKU-001",
      "lamodaSku": "MP002XM0ABCD01",
      "quantity": 45,
      "warehouseCode": "bykovo",
      "updatedAt": "2025-12-02T10:30:00Z"
    },
    {
      "sku": "SELLER-SKU-002",
      "lamodaSku": "MP002XM0ABCD02",
      "quantity": 0,
      "warehouseCode": "bykovo",
      "updatedAt": "2025-12-01T15:20:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 25,
    "total": 1250
  }
}

Получение дельты (изменений)

Чтобы получать только изменённые остатки, используйте updatedAt:

GET /api/v1/stock/goods?updatedAt=2025-12-02+10:00:00&withZeroQuantity=0

Best practice: инкрементальная синхронизация

Запрашивайте дельту каждый час с updatedAt = время предыдущего запроса. Это быстрее, чем выгружать весь сток.

Получение по конкретным SKU

GET /api/v1/stock/goods?sku[]=SKU-001&sku[]=SKU-002&sku[]=SKU-003

Ограничение: До 100 SKU в одном запросе.
При передаче sku[] параметры limit, page и withZeroQuantity игнорируются.

FBS: Получение остатков

Для FBS используется Seller API:

POST v1.stock.list

{
  "jsonrpc": "2.0",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "method": "v1.stock.list",
  "params": {
    "seller_id": 12345,
    "warehouse_code": "your_warehouse",
    "seller_sku_list": ["SKU-001", "SKU-002"]
  }
}

Параметры

Параметр	Тип	Описание
`seller_id`	integer	ID продавца
`warehouseCode`	string	Код вашего склада
`seller_sku`	array	Список артикулов (опционально)

Что влияет на остатки

Событие	Влияние на сток
Приемка поставки	Увеличение
Создание заказа	Резервирование
Отмена заказа	Возврат в сток
Доставка клиенту	— (уже зарезервировано)
Возврат от клиента	После обработки
Брак / повреждение	Списание

Важно про резервы

quantity в ответе — это доступный для продажи остаток, уже за вычетом товаров в неподтверждённых заказах.

Пагинация

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

# Страница 1
GET /api/v1/stock/goods?page=1&limit=100

# Страница 2
GET /api/v1/stock/goods?page=2&limit=100

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

Частые вопросы

Почему остаток 0, хотя товар на складе?

Весь товар зарезервирован в заказах
Товар в статусе брака / повреждения
Поставка ещё не закрыта (статус не closed)

Как узнать, сколько зарезервировано?

API возвращает только доступный остаток. Для полной картины нужно учитывать активные заказы.

Как часто обновляются данные?

Данные актуальны на момент запроса. Изменения отражаются в течение нескольких минут после события.

См. также

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

Да Нет

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

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