Uniapgrate Node

Остатки

Передать остатки

POST /api/v1/stock — до 1000 позиций за запрос. Повторная передача с тем же Idempotency-Key в течение 24 часов не применяется дважды.

POST /api/v1/stock
Authorization: Bearer pk_live_…
Idempotency-Key: 6f1c2b9e-0d57-4a0b-9d0e-3c5f8a1e7b42
Content-Type: application/json

{
  "warehouse_id": "msk-01",
  "items": [
    {"offer_id": "TR-170-BLK", "quantity": 42},
    {"barcode": "4607012345678", "quantity": 0}
  ]
}
HTTP/1.1 202 Accepted

{"task_id": "st_01JB8Z6X3Q", "accepted": 2, "rejected": []}

Остатки применяются асинхронно, обычно в течение 1–3 минут. Состояние задачи — GET /api/v1/stock/tasks/{task_id}.

Получить остатки

GET /api/v1/stock?warehouse_id=msk-01&offer_id=TR-170-BLK

ПолеТипОписание
offer_idstringАртикул продавца
quantityintegerДоступно к продаже
reservedintegerВ резерве под заказы
updated_atstringВремя последнего изменения