12.12.2024 15:30

SetStatus

Статусы документов розничных заказов:

  1. New - Новый, необработанный заказ;
  2. Approved - Подтверждённый заказ;
  3. Processing - Заказ собирается;
  4. Paying - Заказ оплачивается;
  5. Finished - Заказ выполнен;
  6. Canceled - Заказ отменён;
  7. ReturnPaying - По заказу выполняется оплата возврата;
  8. ReturnProcessing - По заказу выполняется процесс возврата.

Логика работы со статусами:

Статус Возможные статусы Доступные методы
New Approved, Canceled Нет
Approved Processing, Canceled DocOrderDelivery/SetOperatingCash (устанавливает статус Processing); DocOrderDelivery/ToBeginning (вернёт в статус New)
Processing New, Canceled, Paying DocOrderDelivery/Actualize; DocOrderDelivery/ToBeginning (вернёт в статус New)
Paying New, Canceled, Finished DocOrderDelivery/ToBeginning (вернёт в статус New)
Finished ReturnProcessing, ReturnPaying Нет
Canceled Нет Нет
ReturnProcessing ReturnPaying, Finished DocOrderDelivery/ToBeginning (вернёт в статус Finished); DocOrderDelivery/Return
ReturnPaying Finished, Canceled* DocOrderDelivery/ToBeginning (вернёт в статус Finished); DocOrderDelivery/Return (перейдет в статус Canceled, если документ заказа не содержит операции после выполнения метода или в статус Finished, если документ заказа содержит операции после выполнения метода)


[POST] …/v1/docorderdelivery/setstatus

Установка статуса документу розничного заказа.

Важно:

  • Для метода требуется право doc_order_delivery_edit (ID 479).
  • Повторная установка уже текущего статуса возвращает ошибку 1009.
  • Статус не изменяется для документов с deleted_mark = true или deleted = true.
  • Для перехода New -> Approved должен быть установлен склад и в документе должна быть минимум одна операция.
  • Для перехода ReturnPaying -> Canceled в документе не должно быть операций.

Входные параметры

Название Тип данных Обязательность Описание
id Int64 Обязательный ID документа розничного заказа
status Enum Обязательный Статус документа розничного заказа: New - Новый, Approved - Утверждён, Processing - В обработке, Paying - Оплата(продажа), Finished - Завершён, Canceled - Отменён, ReturnPaying - Оплата(возврат), ReturnProcessing - В процессе (возврат)

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

{
    "id": 1,
    "status": "Finished"
}

Выходные параметры

Название Тип данных Описание
row_affected Int64 Количество измененных строк

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

{
    "ok": true,
    "result": {
        "row_affected": 1
    }
}