Смена статуса поставки

Меняет статус поставки. От статуса зависит, поступили ли материалы и продукты поставки на склад (см. Поставки).

v1/purchases/update_status.php

Параметры

Статус 2 «Частично получена» через API не ставится: он появляется, когда часть поставки получают отгрузками в интерфейсе Controlata.

Как работает

• Остатки. В статусе «Получена» материалы и продукты поступают на склад. В статусах «План» и «Заказана» количество попадает в запланированное изменение остатка. Остатки пересчитываются сразу.
• Цены. Смена статуса цены материалов не меняет: они обновляются уже при создании и редактировании поставки.
• Дата получения. При переходе в «Получена» переданная date_received записывается в поставку, и поступление датируется ею. Без date_received дата получения не меняется. В других статусах date_received игнорируется.
• Частичное получение. Если поставка была в статусе «Частично получена», при переходе в «Получена» неполученная часть оформляется еще одной отгрузкой.
• Возврат из полученных. При переходе из «Получена» или «Частично получена» в «План» или «Заказана» отгрузки поставки удаляются, и все количество снова становится запланированным.
• Тот же статус. Если поставка уже в переданном статусе, ничего не меняется, и метод отвечает успехом.

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

{
    "purchase_id": 29645,
    "status": 3,
    "date_received": "2026-10-09"
}

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

{
    "success": true
}

Ошибки