Остатки по местам хранения

GET https://mrp.zolotenkov.ru/api/external/v1/stock

Требуемое право ключа: read:stock

Остаток каждого варианта изделия в разрезе мест хранения. Фильтры item_id и item_variant_id отвечают на вопрос «сколько этого товара на складе», не обходя весь список страницами.

Отвечать клиенту надо по available, а не по amount: amount — это все, что лежит физически, включая обещанное другим заказам (committed) и карантин (quarantine_qty). available — сколько еще можно обещать.

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

limit целое число необязателен

Сколько записей вернуть: от 1 до 200, по умолчанию 50
cursor строка необязателен

Курсор из поля next_cursor предыдущего ответа. Без него чтение начинается сначала
item_id целое число необязателен

Только остатки этого товара — по всем его вариантам
item_variant_id целое число необязателен

Только остатки этого варианта. Номер варианта возвращает GET /products полем variants[].id

Ответы

200 Страница остатков по местам хранения
401 Ключ не передан, недействителен или отозван
403 У ключа нет права read:stock
429 Превышена частота обращений. Задержка до повтора — в заголовке Retry-After

const response = await fetch("https://mrp.zolotenkov.ru/api/external/v1/stock?limit=1", { method: "GET", headers: { "Authorization": "Bearer zol_pat_live_ВАШ_КЛЮЧ", }, }); const data = await response.json();

import requests response = requests.get( "https://mrp.zolotenkov.ru/api/external/v1/stock?limit=1", headers={ "Authorization": "Bearer zol_pat_live_ВАШ_КЛЮЧ", }, timeout=30, ) response.raise_for_status() print(response.json())

<?php $curl = curl_init('https://mrp.zolotenkov.ru/api/external/v1/stock?limit=1'); curl_setopt_array($curl, [ CURLOPT_CUSTOMREQUEST => 'GET', CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer zol_pat_live_ВАШ_КЛЮЧ", "Accept: application/json", ], ]); $response = curl_exec($curl); var_dump(json_decode($response, true));

{ "data": [ { "amount": 25, "available": 14, "committed": 9, "id": "42", "item_id": "42", "item_variant_id": "42", "quarantine_qty": 2, "storage_place_id": "42" } ], "next_cursor": "eyJpZCI6NDJ9" }