Меняет статус поставки. От статуса зависит, поступили ли материалы и продукты поставки на склад.
v1/purchases/update_status.php
Параметры
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| purchase_id | int | Да | ID поставки |
| status | int | Да | Новый статус: 0 — План, 1 — Заказана, 3 — Получена |
| date_received | string | Нет | Дата получения. Учитывается при переходе в статус «Получена» |
Статус 2 «Частично получена» через API не ставится: он появляется, когда часть поставки получают отгрузками в интерфейсе Controlata.
date_received учитывается при переходе в «Получена»: она записывается в поставку, и поступление датируется ею. В других статусах date_received игнорируется.
Пример запроса
{
"purchase_id": 29645,
"status": 3,
"date_received": "2026-10-09"
}
Пример ответа
{
"success": true
}
Ошибки
| Ошибка | Причина |
|---|---|
| No purchase_id in input | Не передано обязательное поле (вместо purchase_id будет имя поля) |
| Invalid status value. Must be one of: 0, 1, 3 | Неверный статус, в том числе 2 |
| Purchase not found or access denied | Поставка не найдена или удалена |
| Date is not a valid date in format YYYY-MM-DD | Неверная date_received |