ДокументацияУправление заказами

Управление заказами

4 минПоследнее обновление: 2026-03-31

Конечный автомат заказа

Каждый заказ проходит через заданный конечный автомат состояний:

pending → confirmed → preparing → shipped → delivered
   ↓                                         ↓
cancelled                              return_requested → returned → refunded

Каждый переход между состояниями проверяется: перейти можно только в разрешенные следующие состояния. Недопустимые переходы отклоняются.

События заказа

Каждое изменение статуса создает запись события заказа с отметкой времени, предыдущим статусом, новым статусом и необязательными заметками. Так для каждого заказа формируется полный журнал аудита.

Интеграция с воркфлоу

Заказы запускают триггеры воркфлоу в ключевых точках:

  • storefront_order_placed: создан новый заказ
  • payment_verified: продавец подтвердил оплату
  • payment_overdue: срок оплаты счета истек
  • cart_abandoned: клиент оставил товары в корзине

Используйте эти триггеры, чтобы автоматизировать уведомления, обновлять остатки или передавать данные в систему выполнения заказов.

Отмена и возврат

Заказ можно отменить до отправки (статус меняется на cancelled, зарезервированный товар возвращается в остаток). После доставки клиент может запросить возврат. Продавец рассматривает запрос и может одобрить возврат, что запускает цепочку returned → refunded.

Эндпоинты API

GET    /api/v1/commerce/orders         - Список заказов (с фильтрацией)
GET    /api/v1/commerce/orders/:id     - Данные заказа с событиями
PUT    /api/v1/commerce/orders/:id/status: Обновить статус заказа
GET    /api/v1/commerce/orders/stats   - Статистика заказов

Была ли эта статья полезна?