Pre-order grid
Admin → Sales → Operations → Pre-Orders. Lives next to Orders, Invoices, Shipments — just another order-derived artifact, no longer hidden under a separate top-level group.
Standard Magento UI listing component (view/adminhtml/ui_component/byte8_preorder_listing.xml) with full filter, sort, per-row action and mass-action support.
Columns
| Column | Notes |
|---|---|
| Pre-order # | Increment ID, e.g. PRE-000123 |
| Order # | Linked back to the source order |
| Customer email | Plus name when present, guest-friendly |
| Status | pending / awaiting_stock / ready / partial_complete / complete / cancelled — colour-coded pill |
| Payment type | full / percent / fixed |
| Total amount | Original full price for all pre-order items |
| Paid amount | Deposit captured at checkout |
| Remaining amount | Balance still owed — orange when > 0, green at zero |
| Vault capture | Hidden by default; toggle in the column controls |
| Created at | Pre-order creation timestamp |
| Updated at | Hidden by default |
| Actions | Per-row dropdown — see below |
Filters
All visible columns filter. Common operational filters:
- Status = pending — pre-orders that haven't yet hit stock.
- Status = ready + Remaining > 0 — pre-orders awaiting balance collection.
- Vault capture = failed — pre-orders where automated capture failed; needs ops attention.
- Remaining > 0 + Status = complete — accounting check; should normally be zero.
- Created within last 24h — launch-day visibility.
Per-row actions
The actions dropdown is conditional on status — you only see what's applicable.
| Action | When shown | What it does |
|---|---|---|
| View Order | Always | Open the source sales order in admin |
| Mark Ready | pending / awaiting_stock | Flip status to ready, generate the tokenised completion token, and queue the Pay Remaining Balance email for the next cron tick (within 60 seconds) |
| Capture Vault Payment | Has stored vault token + outstanding balance + capture not already running/successful | Charges the saved card via the existing vault for the remaining balance |
| Force Complete | Status not yet complete / cancelled | Zeroes the remaining balance, syncs per-item amounts, runs completePreorder. Use this only after collecting payment out-of-band (bank transfer, in-person, etc.) |
| Cancel | Status not yet complete / cancelled | Cancels the pre-order — the customer will not be charged the remaining balance |
All destructive actions confirm before running. Successful actions redirect you back to whichever surface you came from (the grid or the order view tab).
See Order-view Pre-Order tab for the same actions surfaced inline on the sales order detail page.
Mass actions
Selectable rows + the standard Magento mass-action menu — full coverage of the per-row actions, plus a bulk-email helper:
- Send Availability Notification — re-sends the legacy availability email to the selected customers.
- Mark Ready — batch mark-ready. Each row is queued for the email drainer; one failure doesn't abort the batch.
- Force Complete — batch force-complete. Mirrors the per-row action.
- Cancel — batch cancel.
See Mass actions for full coverage, including the equivalent mass actions on the Sales → Orders grid.
Empty state
When no rows match the active filters the standard Magento "No records found" message appears. Flip the master switch off in General settings if you're done evaluating.
Permissions
The grid is gated by the Byte8_Preorder::preorder_view ACL resource. Mass Cancel / Force Complete and the vault capture action additionally check Byte8_Preorder::preorder_manage. Add these resources to admin roles via System → Permissions → User Roles.
Related
- Order-view Pre-Order tab — same actions on the sales order page.
- Mass actions — full mass-action surface on both grids.
- CLI commands — same operations from a terminal.
- Vault capture configuration — controls what the vault status column shows.