Устанавливает остаток продукта на складе. Передается итоговый остаток, а не изменение: 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 |
Продукт не найден или удален |