Остатки
Передать остатки
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_id | string | Артикул продавца |
quantity | integer | Доступно к продаже |
reserved | integer | В резерве под заказы |
updated_at | string | Время последнего изменения |