Обновление остатка продукта

Максим

Максим

Обновлено Oct 6, 2026

Устанавливает остаток продукта на складе. Передается итоговый остаток, а не изменение: Controlata создаст корректировку на разницу между текущим и новым остатком.

v1/products/update_stock.php

Параметры

Поле Тип Обязательное Описание
product_id int Да ID продукта
storage_id int Да ID склада
stock float Да Новый остаток
notes string Нет Заметки к корректировке

Как работает

  • Увеличение остатка оценивается по себестоимости последнего прихода продукта на этот склад (создание, производство, поставка, перемещение). Если приходов не было, используется текущая себестоимость продукта. Уменьшение списывает партии по FIFO.
  • Остаток можно установить на любом складе, даже если продукт там раньше не числился. На таком складе продукт будет числиться, пока остаток не станет нулевым (см. Продукты).
  • Если в Controlata подключена синхронизация остатков с Wildberries или Ozon, новый остаток передается в маркетплейс по ее настройкам, как и при любом другом изменении остатка.

Пример запроса

{
    "product_id": 3120,
    "storage_id": 3999,
    "stock": 12,
    "notes": "Инвентаризация на складе"
}

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

{
    "success": true
}

Ошибки

Ошибка Причина
No stock in input Не передано обязательное поле (вместо stock будет имя поля)
Invalid stock value. Must be a number Остаток не число, например "" или "4,2"
Storage ID not found Склад не найден или удален
Product not found or access denied Продукт не найден или удален