Остатки FBS

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

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

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

Подробнее см. Остатки FBO.

Полный сток

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

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

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

{
  "_links": {
    "self": { "href": "GET /api/v1/stock/goods?page=1&limit=25" },
    "next": { "href": "GET /api/v1/stock/goods?page=2&limit=25" }
  },
  "_embedded": {
    "stockStates": [
      {
        "sku": "SELLER-SKU-001",
        "quantity": 45
      },
      {
        "sku": "SELLER-SKU-002",
        "quantity": 0
      }
    ]
  },
  "page": 1,
  "limit": 25,
  "pages": 10,
  "total": 245
}

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

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

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

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

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

FBS: Получение остатков (Lamoda Seller Partner API)

Для FBS используется JSON-RPC метод Lamoda Seller Partner API:

POST https://public-api-seller.lamoda.ru/jsonrpc/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"],
    "limit": 100,
    "page": 1
  }
}

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

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

{
  "jsonrpc": "2.0",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "result": {
    "stocks": [
      {
        "lamoda_sku": "MP002XM0ABCD01",
        "seller_sku": "SKU-001",
        "seller_id": 12345,
        "quantity": 45,
        "warehouse_code": "your_warehouse",
        "created_at": "2025-01-15T10:30:00+03:00",
        "updated_at": "2025-12-02T10:30:00+03:00"
      },
      {
        "lamoda_sku": "MP002XM0ABCD02",
        "seller_sku": "SKU-002",
        "seller_id": 12345,
        "quantity": 0,
        "warehouse_code": "your_warehouse",
        "created_at": "2025-01-10T09:00:00+03:00",
        "updated_at": "2025-12-01T15:20:00+03:00"
      }
    ],
    "pagination": {
      "limit": 100,
      "page": 1,
      "total": 1250
    }
  }
}

Поля ответа

FBS: Обновление остатков (Lamoda B2B Platform Partner API)

Для обновления остатков FBS используется Lamoda B2B Platform Partner API:

POST https://api-b2b.lamoda.ru/api/v1/stock/goods
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN

{
  "partner": "PARTNER_CODE",
  "stockStates": [
    {"sku": "SKU-001", "quantity": 100},
    {"sku": "SKU-002", "quantity": 50}
  ]
}

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

Пример ответа (201 Created)

{
  "stockStates": [
    {"sku": "SKU-001", "quantity": 100},
    {"sku": "SKU-002", "quantity": 50}
  ]
}

• Максимум 100 SKU в одном запросе
• SKU должен существовать в каталоге с типом контракта marketplace_crossdocking или dropshipping
• Символы ? и * запрещены в SKU

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

Рекомендации по синхронизации

Для FBO

1. Полная синхронизация — раз в сутки ночью
2. Инкрементальная — каждый час с updatedAt
3. Точечная — при необходимости по конкретным SKU

Для FBS

Остатки FBS хранятся на вашей стороне — вы сами управляете наличием через GET /api/v1/stock/goods. Lamoda запрашивает доступность при создании заказа.

Пагинация

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

# Страница 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 не возвращает резервы отдельным полем. Резервы вычисляются динамически на основе неподтверждённых заказов. Для полной картины используйте API заказов.

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

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

См. также

• Остатки FBO (подробнее)
• Создание поставки FBO
• Получение заказов
• Обновление цен