Commerce Backorders
Track unfulfilled demand, allocate incoming inventory, and prioritize backorder fulfillment.
How It Works
- Create backorders when ordered items are out of stock.
- Set priority and expected/promised dates.
- Allocate incoming inventory (from POs, production, or transfers) to backorders.
- Fulfill backorders partially or completely as stock becomes available.
- Monitor backorder summaries by SKU and priority.
Usage
- MCP tools:
list_backorders, create_backorder, update_backorder, allocate_backorder, fulfill_backorder, cancel_backorder, get_backorder_summary, get_sku_backorder_summary.
- Writes require
--apply.
Backorder Statuses
- Pending -> PartiallyFulfilled -> Allocated -> ReadyToShip -> Fulfilled (or Cancelled)
Priority Levels
- Low, Normal (default), High, Critical
Fulfillment Sources
- Inventory (default): existing warehouse stock
- PurchaseOrder: incoming supplier shipment
- Transfer: inter-warehouse transfer
- Production: manufacturing output
Output
{"status":"partially_fulfilled","backorder_id":"BO-2025-0015","sku":"WIDGET-001","quantity_ordered":100,"quantity_fulfilled":60,"quantity_remaining":40}
Present Results to User
- Backorder number, SKU, and priority.
- Quantities ordered, fulfilled, and remaining.
- Expected and promised dates.
- Fulfillment source (PO, production, etc.).
- SKU-level backorder summary across all orders.
Troubleshooting
- Allocation expired: re-allocate or extend expiration date.
- Cannot fulfill: verify available inventory matches allocation.
- Priority conflict: Critical backorders should be fulfilled before Low/Normal.
References
- references/backorder-management.md
- /home/dom/stateset-icommerce/crates/stateset-core/src/models/backorder.rs
- /home/dom/stateset-icommerce/crates/stateset-embedded/src/backorder.rs
1---2name: commerce-backorders3description: Manage backorders for out-of-stock items. Use when tracking unfulfilled demand, allocating incoming inventory to backorders, or prioritizing backorder fulfillment.4---5
6# Commerce Backorders
7
8Track unfulfilled demand, allocate incoming inventory, and prioritize backorder fulfillment.
9
10## How It Works
11
121. Create backorders when ordered items are out of stock.
132. Set priority and expected/promised dates.
143. Allocate incoming inventory (from POs, production, or transfers) to backorders.
154. Fulfill backorders partially or completely as stock becomes available.
165. Monitor backorder summaries by SKU and priority.
17
18## Usage
19
20- MCP tools: `list_backorders`, `create_backorder`, `update_backorder`, `allocate_backorder`, `fulfill_backorder`, `cancel_backorder`, `get_backorder_summary`, `get_sku_backorder_summary`.
21- Writes require `--apply`.
22
23## Backorder Statuses
24
25- Pending -> PartiallyFulfilled -> Allocated -> ReadyToShip -> Fulfilled (or Cancelled)
26
27## Priority Levels
28
29- Low, Normal (default), High, Critical
30
31## Fulfillment Sources
32
33- Inventory (default): existing warehouse stock
34- PurchaseOrder: incoming supplier shipment
35- Transfer: inter-warehouse transfer
36- Production: manufacturing output
37
38## Output
39
40```json
41{"status":"partially_fulfilled","backorder_id":"BO-2025-0015","sku":"WIDGET-001","quantity_ordered":100,"quantity_fulfilled":60,"quantity_remaining":40}
42```
43
44## Present Results to User
45
46- Backorder number, SKU, and priority.
47- Quantities ordered, fulfilled, and remaining.
48- Expected and promised dates.
49- Fulfillment source (PO, production, etc.).
50- SKU-level backorder summary across all orders.
51
52## Troubleshooting
53
54- Allocation expired: re-allocate or extend expiration date.
55- Cannot fulfill: verify available inventory matches allocation.
56- Priority conflict: Critical backorders should be fulfilled before Low/Normal.
57
58## References
59- references/backorder-management.md
60- /home/dom/stateset-icommerce/crates/stateset-core/src/models/backorder.rs
61- /home/dom/stateset-icommerce/crates/stateset-embedded/src/backorder.rs
majiayu000