Управление заказами
Конечный автомат заказа
Каждый заказ проходит через заданный конечный автомат состояний:
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 - Статистика заказов