Заказы
Откройте Пакеты → MiniShop3 → Заказы. Слева грид всех заказов, по клику открывается карточка.
Список
Грид OrdersGrid фильтрует и сортирует строки. Поиск идёт по номеру, email, телефону и другим колонкам из конфигурации грида. Клик по строке открывает карточку.
Сводка по фильтрам (счётчики статусов, суммы) подгружается отдельно: GET /api/mgr/orders/stats с теми же query-параметрами, что и список.
Создание заказа из менеджера
Кнопка «Создать заказ» вызывает POST /api/mgr/orders — пустой или частично заполненный заказ без витрины. Дальше добавьте позиции и завершите оформление. События: msOnBeforeMgrCreateOrder, msOnMgrCreateOrder.
Черновики
Пока покупатель на витрине не нажал «Оформить», в БД лежит заказ со статусом черновика (ms3_status_draft). Системная настройка ms3_order_show_drafts задаёт, показывать ли черновики в гриде по умолчанию.
В тулбаре есть переключатель «Показывать черновики». Браузер пишет выбор в localStorage (ms3_orders_show_drafts) и шлёт в API параметр show_drafts.
Старые черновики чистит Scheduler по ms3_delete_drafts_after. См. Scheduler.
Карточка
Карточка OrderView держит вкладки (ключи useOrderPluginTabs):
| Ключ | Содержимое |
|---|---|
info | Сведения о заказе, покупатель, доставка и оплата, комментарии |
products | Состав заказа (скрыта при создании) |
address | Адрес доставки |
ms3_shipment | Трекинг отправления (скрыта при создании) |
history | История изменений (скрыта при создании) |
Вкладки дополнений появятся, если вы их зарегистрировали через plugin tabs.
Трекинг: GET /api/mgr/orders/{id}/shipment (чтение), PUT /api/mgr/orders/{id}/shipment (сохранение). Права: msorder_list / msorder_save.
Статус
Меняйте status_id в форме. Сохранение уходит как PUT /api/mgr/orders/{id}. Смена статуса может запустить письма и Telegram по правилам Центра уведомлений.
Черновик в «настоящий» заказ переводите кнопкой финализации: POST /api/mgr/orders/{id}/finalize. Это другой путь, чем отправка формы на витрине.
Дополнительные поля заказа
Свои колонки на заказе создают через extra fields. В утилите «Свои поля» класс хранится как MiniShop3\Model\msOrder.
Карточка заказа запрашивает GET /api/mgr/extra-fields?class=msOrder (короткий алиас), а фильтр в контроллере сравнивает строку точно. Поле создаётся корректно, но секция на заказе может остаться пустой — известная проблема MiniShop3#812. Обход: создавать поле с классом msOrder или выровнять query на FQCN в коде.
Сохранение: PUT /api/mgr/orders/{id} ключом поля на верхнем уровне JSON (msorder_save). Чтение схемы extra fields (GET /api/mgr/extra-fields) доступно любому авторизованному менеджеру. Право mssetting_save нужно только на создание, правку и удаление полей.
Пересчёт стоимости
На сводке сохранённого заказа нажмите пересчёт. Запрос:
POST /api/mgr/orders/{id}/recalculate-cost
Режимы: auto, manual, force_provider. Кнопка неактивна, пока идёт сохранение, выполняется пересчёт или вы не сохранили правки доставки и оплаты.
Пересчёт заново считает корзину, доставку и оплату по текущим провайдерам. Детали ответа: Backend API заказа.
Доставка и оплата
Выберите пару, которую связали в карточке доставки. Иначе сохранение или финализация вернут ошибку недопустимой пары.
Права и API
Все операции идут через Manager API /api/mgr/orders/* под сессией MODX. Чтение — право msorder_list, изменения — msorder_save. Каркас маршрутов: API Router.
События позиций заказа (msOnBeforeCreateOrderProduct и др.) при добавлении строк из карточки: События позиций заказа.