Order Management System
Overview
An Order Management System (OMS) handles the full order lifecycle from placement to delivery: routing orders to the right fulfillment source (own warehouse, 3PL, or dropship supplier), splitting orders when items must ship from multiple locations, handling backorders, and maintaining a complete audit trail. For most merchants, platform-native features plus a shipping app cover 80–90% of OMS needs. A custom OMS is warranted when you have multiple fulfillment locations, complex routing rules, or are building a platform for other brands.
When to Use This Skill
- When your order volume has outgrown a single-warehouse workflow and you need multi-location routing
- When orders that mix in-stock and out-of-stock items need to ship in separate shipments without blocking fulfillment
- When integrating multiple fulfillment sources (own warehouse, 3PLs, dropship suppliers) into a unified routing engine
- When building the core order processing pipeline for a new platform that will support high order volume
- When you need a complete audit trail of every order state change for customer service and finance
Core Instructions
Step 1: Determine your platform and choose the right OMS approach
| Scenario |
Recommended Approach |
Why |
| Single warehouse, Shopify |
Shopify + ShipStation |
ShipStation handles order management, label creation, and tracking natively |
| Multi-location, Shopify |
Shopify Locations + ShipStation or Shopify Fulfillment Network |
Shopify supports up to 10 locations; ShipStation routes to the right location based on rules |
| 3PL integration |
ShipBob, Whiplash, or Flexport + your platform's app |
Each 3PL has native apps for Shopify, WooCommerce, and BigCommerce |
| Complex routing + backorders |
Skubana (Extensiv), Linnworks, or ShipHero |
These purpose-built OMS tools handle multi-warehouse routing, backorder queues, and split shipments |
| Custom / Headless |
Build an OMS state machine + integrate Shippo/EasyPost for labels |
Full control over routing rules, state transitions, and audit trail |
Step 2: Set up multi-location order routing
Shopify
Shopify Locations (up to 10 locations on standard plans):
- Go to Settings → Locations → Add location for each warehouse or fulfillment center
- In Settings → Shipping and delivery → Fulfill orders from, set your fulfillment priority:
- Shopify will automatically route orders to the location closest to the customer with available stock
- For each product variant, set which locations stock that item: go to Products → [Product] → Inventory → Check each location's stock level
- When an order is placed, Shopify selects the optimal fulfillment location automatically based on your priority rules
For 3PL integration:
- Install the 3PL's native Shopify app (ShipBob, Whiplash, Flexport all have Shopify apps)
- Configure which products are fulfilled by the 3PL vs. your own warehouse in the app settings
- The 3PL app creates an additional "location" in Shopify and receives order notifications automatically
For split shipments:
- Shopify automatically creates separate fulfillments when an order ships from multiple locations
- Each fulfillment gets its own tracking number and triggers its own shipping notification to the customer
WooCommerce
Using ATUM Inventory Management:
- Install ATUM Inventory Management (free/premium, WordPress.org)
- ATUM adds multi-location inventory tracking to WooCommerce
- Configure fulfillment priority in ATUM → Settings → Multi-inventory
- Orders are routed to the location with available stock based on your priority rules
For 3PL integration:
- ShipBob has a WooCommerce plugin; install it and configure which products ship from ShipBob
- ShipStation's WooCommerce plugin connects to multiple carriers and warehouses; configure routing rules in ShipStation → Automation → Rules
BigCommerce
- Go to Inventory → Locations to add multiple fulfillment locations (available on Plus and above)
- Set inventory levels per location for each product
- BigCommerce routes orders to the location with stock closest to the customer based on your settings
- For 3PL integration: ShipBob, Whiplash, and ShipStation all have native BigCommerce integrations via the App Marketplace
Step 3: Handle backorders
A backorder occurs when an order is placed for an item that is out of stock. The customer still wants the item; you need to fulfill it when stock arrives.
Shopify
Enable backorders:
- Go to Products → [Product] → Variants → [Variant]
- Set inventory tracking: check "Continue selling when out of stock" — this allows orders to come in even when stock = 0
- Be transparent: show a "Ships in 2–3 weeks" message on the product page when stock is 0
Communicate backorders:
- When a product is backordered, Shopify's standard order confirmation doesn't flag this automatically
- Use Klaviyo or Shopify Email to create a trigger: when order has a line item with quantity > available stock → send a "Backordered" email with the estimated restock date
Fulfilling backordered orders:
- When stock arrives (you receive a shipment): manually fulfill the backordered orders in Shopify → Orders → filter by "Unfulfilled" and sort by order date
- For automatic backorder fulfillment: use Shopify Flow (Plus) or a webhook to trigger fulfillment when inventory is replenished
WooCommerce
- Go to WooCommerce → Settings → Products → Inventory
- Enable "Allow backorders" at the global level, or set per product: Products → [Product] → Inventory → Allow Backorders
- Options: "Do not allow", "Allow but notify customer", "Allow without notification"
- Recommend: "Allow but notify customer" — WooCommerce adds a "On backorder" badge and notifies the customer at checkout
- Backordered orders appear in WooCommerce → Orders with status "On Hold" or "Processing" depending on your payment flow
BigCommerce
- Go to Products → [Product] → Inventory
- Enable "Allow Purchasing Out of Stock" — BigCommerce shows the product as "Available for Pre-Order" automatically when stock = 0
- Set "Back Ordering" message text in Store Setup → Store Settings → Product Settings
Step 4: Maintain an order audit trail
Every order status change should be logged with who made the change and when. This is essential for customer service and fraud investigation.
Shopify
- Shopify automatically logs all order status changes in Orders → [Order] → Timeline
- The Timeline shows every event: payment confirmed, fulfillment created, shipping label purchased, tracking updated, etc.
- Add manual notes to the Timeline (visible to staff only) for any manual actions taken
WooCommerce
- WooCommerce logs order notes in each order's Order Notes section
- Status changes are logged automatically ("Order status changed from Processing to Completed")
- For more comprehensive audit logging: install WooCommerce Order Status Manager or Activity Log plugin
BigCommerce
- BigCommerce logs order status changes in the Order Activity section of each order
- The activity log shows all status changes, notes added, and system actions
Custom / Headless — order state machine with event log
// Order status state machine with full audit trail
type OrderStatus =
| 'pending'
| 'payment_processing'
| 'paid'
| 'awaiting_fulfillment'
| 'partially_fulfilled'
| 'fulfilled'
| 'delivered'
| 'cancelled'
| 'refunded';
const VALID_TRANSITIONS: Partial<Record<OrderStatus, OrderStatus[]>> = {
pending: ['payment_processing', 'cancelled'],
payment_processing: ['paid', 'cancelled'],
paid: ['awaiting_fulfillment', 'cancelled'],
awaiting_fulfillment: ['partially_fulfilled', 'fulfilled', 'cancelled'],
partially_fulfilled: ['fulfilled'],
fulfilled: ['delivered', 'refunded'],
delivered: ['refunded'],
};
async function transitionOrder(params: {
orderId: string;
newStatus: OrderStatus;
actorId: string;
note?: string;
}): Promise<void> {
const order = await db.orders.findById(params.orderId);
const allowed = VALID_TRANSITIONS[order.status] ?? [];
if (!allowed.includes(params.newStatus)) {
throw new Error(`Invalid transition: ${order.status} → ${params.newStatus}`);
}
await db.transaction(async tx => {
await tx.orders.update(params.orderId, { status: params.newStatus, updated_at: new Date() });
// Every transition is recorded — this IS the audit trail
await tx.orderEvents.insert({
order_id: params.orderId,
from_status: order.status,
to_status: params.newStatus,
actor_id: params.actorId,
note: params.note ?? null,
occurred_at: new Date(),
});
});
}
// Route an order to the right fulfillment source
async function routeOrder(orderId: string): Promise<void> {
const order = await db.orders.findById(orderId);
const lines = await db.orderLines.findByOrderId(orderId);
for (const line of lines) {
// Check own warehouse first
const warehouseStock = await db.inventory.findAvailable(line.sku, line.quantity);
if (warehouseStock) {
await db.fulfillmentLines.insert({
order_id: orderId,
order_line_id: line.id,
source: 'warehouse',
source_id: warehouseStock.location_id,
status: 'pending',
});
continue;
}
// Fall back to dropship supplier
const supplier = await db.supplierProducts.findBestSupplier(line.product_id, line.quantity);
if (supplier) {
await db.fulfillmentLines.insert({
order_id: orderId,
order_line_id: line.id,
source: 'dropship',
source_id: supplier.supplier_id,
status: 'pending',
});
continue;
}
// No source available — create a backorder
await db.backorders.insert({
order_id: orderId,
order_line_id: line.id,
product_id: line.product_id,
quantity: line.quantity,
status: 'pending',
});
// Notify customer about the backorder
}
}
Best Practices
- Use a purpose-built OMS before building custom — Skubana/Extensiv ($500+/month) or Linnworks handles multi-warehouse routing, backorders, and split shipments with proven reliability; custom development should only start when these tools can't meet your specific needs
- Keep orders and fulfillments as separate entities — an order is a financial contract with the customer; fulfillments are physical shipments; one order can generate multiple fulfillments
- Queue fulfillment planning asynchronously — don't route orders synchronously during checkout; enqueue routing immediately after payment confirmation and process in a background worker
- Never silently drop backordered lines — always notify the customer and give them the option to wait or cancel; silent backorders erode trust when the customer discovers weeks later
- Alert on orders stuck in "awaiting fulfillment" for 24+ hours — set up a daily alert for orders that haven't moved to fulfillment; these usually indicate a routing error or system issue
Common Pitfalls
| Problem |
Solution |
| Order splits into multiple shipments unexpectedly |
Pre-warn customers at checkout if an order will ship from multiple locations; show estimated delivery per shipment separately |
| Backorder never fulfilled after stock arrives |
Set up an automatic trigger: when inventory is replenished above the backorder quantity, trigger fulfillment for the oldest pending backorder (FIFO) |
| Partial cancellation leaves the order in a broken state |
Implement partial cancellation — cancel only lines that haven't been picked; issue a refund for cancelled lines; update the order total |
| Shopify shows "partially fulfilled" but customer thinks full shipment is coming |
Send a clear email explaining each shipment as it ships, with the items in that specific shipment and the remaining items to follow |
Related Skills
- @order-fulfillment-workflow
- @returns-management
- @multi-channel-selling
- @dropshipping-integration
- @demand-forecasting
1---2name: order-management-system3description: Design an order management system that routes orders to the right warehouse, handles split shipments, and manages backorders gracefully4---56# Order Management System78## Overview910An Order Management System (OMS) handles the full order lifecycle from placement to delivery: routing orders to the right fulfillment source (own warehouse, 3PL, or dropship supplier), splitting orders when items must ship from multiple locations, handling backorders, and maintaining a complete audit trail. For most merchants, platform-native features plus a shipping app cover 80–90% of OMS needs. A custom OMS is warranted when you have multiple fulfillment locations, complex routing rules, or are building a platform for other brands.1112## When to Use This Skill1314- When your order volume has outgrown a single-warehouse workflow and you need multi-location routing15- When orders that mix in-stock and out-of-stock items need to ship in separate shipments without blocking fulfillment16- When integrating multiple fulfillment sources (own warehouse, 3PLs, dropship suppliers) into a unified routing engine17- When building the core order processing pipeline for a new platform that will support high order volume18- When you need a complete audit trail of every order state change for customer service and finance1920## Core Instructions2122### Step 1: Determine your platform and choose the right OMS approach2324| Scenario | Recommended Approach | Why |25|----------|---------------------|-----|26| **Single warehouse, Shopify** | Shopify + ShipStation | ShipStation handles order management, label creation, and tracking natively |27| **Multi-location, Shopify** | Shopify Locations + ShipStation or Shopify Fulfillment Network | Shopify supports up to 10 locations; ShipStation routes to the right location based on rules |28| **3PL integration** | ShipBob, Whiplash, or Flexport + your platform's app | Each 3PL has native apps for Shopify, WooCommerce, and BigCommerce |29| **Complex routing + backorders** | Skubana (Extensiv), Linnworks, or ShipHero | These purpose-built OMS tools handle multi-warehouse routing, backorder queues, and split shipments |30| **Custom / Headless** | Build an OMS state machine + integrate Shippo/EasyPost for labels | Full control over routing rules, state transitions, and audit trail |3132### Step 2: Set up multi-location order routing3334#### Shopify3536**Shopify Locations (up to 10 locations on standard plans):**371. Go to **Settings → Locations → Add location** for each warehouse or fulfillment center382. In **Settings → Shipping and delivery → Fulfill orders from**, set your fulfillment priority:39 - Shopify will automatically route orders to the location closest to the customer with available stock403. For each product variant, set which locations stock that item: go to Products → [Product] → Inventory → Check each location's stock level414. When an order is placed, Shopify selects the optimal fulfillment location automatically based on your priority rules4243**For 3PL integration:**44- Install the 3PL's native Shopify app (ShipBob, Whiplash, Flexport all have Shopify apps)45- Configure which products are fulfilled by the 3PL vs. your own warehouse in the app settings46- The 3PL app creates an additional "location" in Shopify and receives order notifications automatically4748**For split shipments:**49- Shopify automatically creates separate fulfillments when an order ships from multiple locations50- Each fulfillment gets its own tracking number and triggers its own shipping notification to the customer5152#### WooCommerce5354**Using ATUM Inventory Management:**551. Install **ATUM Inventory Management** (free/premium, WordPress.org)562. ATUM adds multi-location inventory tracking to WooCommerce573. Configure fulfillment priority in ATUM → Settings → Multi-inventory584. Orders are routed to the location with available stock based on your priority rules5960**For 3PL integration:**61- ShipBob has a WooCommerce plugin; install it and configure which products ship from ShipBob62- ShipStation's WooCommerce plugin connects to multiple carriers and warehouses; configure routing rules in ShipStation → Automation → Rules6364#### BigCommerce65661. Go to **Inventory → Locations** to add multiple fulfillment locations (available on Plus and above)672. Set inventory levels per location for each product683. BigCommerce routes orders to the location with stock closest to the customer based on your settings694. For 3PL integration: ShipBob, Whiplash, and ShipStation all have native BigCommerce integrations via the App Marketplace7071### Step 3: Handle backorders7273A backorder occurs when an order is placed for an item that is out of stock. The customer still wants the item; you need to fulfill it when stock arrives.7475#### Shopify7677**Enable backorders:**781. Go to **Products → [Product] → Variants → [Variant]**792. Set inventory tracking: check "Continue selling when out of stock" — this allows orders to come in even when stock = 0803. Be transparent: show a "Ships in 2–3 weeks" message on the product page when stock is 08182**Communicate backorders:**83- When a product is backordered, Shopify's standard order confirmation doesn't flag this automatically84- Use **Klaviyo** or **Shopify Email** to create a trigger: when order has a line item with quantity > available stock → send a "Backordered" email with the estimated restock date8586**Fulfilling backordered orders:**87- When stock arrives (you receive a shipment): manually fulfill the backordered orders in Shopify → Orders → filter by "Unfulfilled" and sort by order date88- For automatic backorder fulfillment: use **Shopify Flow** (Plus) or a webhook to trigger fulfillment when inventory is replenished8990#### WooCommerce91921. Go to **WooCommerce → Settings → Products → Inventory**932. Enable "Allow backorders" at the global level, or set per product: Products → [Product] → Inventory → Allow Backorders943. Options: "Do not allow", "Allow but notify customer", "Allow without notification"954. Recommend: "Allow but notify customer" — WooCommerce adds a "On backorder" badge and notifies the customer at checkout965. Backordered orders appear in WooCommerce → Orders with status "On Hold" or "Processing" depending on your payment flow9798#### BigCommerce991001. Go to **Products → [Product] → Inventory**1012. Enable "Allow Purchasing Out of Stock" — BigCommerce shows the product as "Available for Pre-Order" automatically when stock = 01023. Set "Back Ordering" message text in Store Setup → Store Settings → Product Settings103104### Step 4: Maintain an order audit trail105106Every order status change should be logged with who made the change and when. This is essential for customer service and fraud investigation.107108#### Shopify109110- Shopify automatically logs all order status changes in **Orders → [Order] → Timeline**111- The Timeline shows every event: payment confirmed, fulfillment created, shipping label purchased, tracking updated, etc.112- Add manual notes to the Timeline (visible to staff only) for any manual actions taken113114#### WooCommerce115116- WooCommerce logs order notes in each order's **Order Notes** section117- Status changes are logged automatically ("Order status changed from Processing to Completed")118- For more comprehensive audit logging: install **WooCommerce Order Status Manager** or **Activity Log** plugin119120#### BigCommerce121122- BigCommerce logs order status changes in the **Order Activity** section of each order123- The activity log shows all status changes, notes added, and system actions124125#### Custom / Headless — order state machine with event log126127```typescript128// Order status state machine with full audit trail129type OrderStatus =130 | 'pending'131 | 'payment_processing'132 | 'paid'133 | 'awaiting_fulfillment'134 | 'partially_fulfilled'135 | 'fulfilled'136 | 'delivered'137 | 'cancelled'138 | 'refunded';139140const VALID_TRANSITIONS: Partial<Record<OrderStatus, OrderStatus[]>> = {141 pending: ['payment_processing', 'cancelled'],142 payment_processing: ['paid', 'cancelled'],143 paid: ['awaiting_fulfillment', 'cancelled'],144 awaiting_fulfillment: ['partially_fulfilled', 'fulfilled', 'cancelled'],145 partially_fulfilled: ['fulfilled'],146 fulfilled: ['delivered', 'refunded'],147 delivered: ['refunded'],148};149150async function transitionOrder(params: {151 orderId: string;152 newStatus: OrderStatus;153 actorId: string;154 note?: string;155}): Promise<void> {156 const order = await db.orders.findById(params.orderId);157 const allowed = VALID_TRANSITIONS[order.status] ?? [];158159 if (!allowed.includes(params.newStatus)) {160 throw new Error(`Invalid transition: ${order.status} → ${params.newStatus}`);161 }162163 await db.transaction(async tx => {164 await tx.orders.update(params.orderId, { status: params.newStatus, updated_at: new Date() });165 // Every transition is recorded — this IS the audit trail166 await tx.orderEvents.insert({167 order_id: params.orderId,168 from_status: order.status,169 to_status: params.newStatus,170 actor_id: params.actorId,171 note: params.note ?? null,172 occurred_at: new Date(),173 });174 });175}176177// Route an order to the right fulfillment source178async function routeOrder(orderId: string): Promise<void> {179 const order = await db.orders.findById(orderId);180 const lines = await db.orderLines.findByOrderId(orderId);181182 for (const line of lines) {183 // Check own warehouse first184 const warehouseStock = await db.inventory.findAvailable(line.sku, line.quantity);185 if (warehouseStock) {186 await db.fulfillmentLines.insert({187 order_id: orderId,188 order_line_id: line.id,189 source: 'warehouse',190 source_id: warehouseStock.location_id,191 status: 'pending',192 });193 continue;194 }195196 // Fall back to dropship supplier197 const supplier = await db.supplierProducts.findBestSupplier(line.product_id, line.quantity);198 if (supplier) {199 await db.fulfillmentLines.insert({200 order_id: orderId,201 order_line_id: line.id,202 source: 'dropship',203 source_id: supplier.supplier_id,204 status: 'pending',205 });206 continue;207 }208209 // No source available — create a backorder210 await db.backorders.insert({211 order_id: orderId,212 order_line_id: line.id,213 product_id: line.product_id,214 quantity: line.quantity,215 status: 'pending',216 });217 // Notify customer about the backorder218 }219}220```221222## Best Practices223224- **Use a purpose-built OMS before building custom** — Skubana/Extensiv ($500+/month) or Linnworks handles multi-warehouse routing, backorders, and split shipments with proven reliability; custom development should only start when these tools can't meet your specific needs225- **Keep orders and fulfillments as separate entities** — an order is a financial contract with the customer; fulfillments are physical shipments; one order can generate multiple fulfillments226- **Queue fulfillment planning asynchronously** — don't route orders synchronously during checkout; enqueue routing immediately after payment confirmation and process in a background worker227- **Never silently drop backordered lines** — always notify the customer and give them the option to wait or cancel; silent backorders erode trust when the customer discovers weeks later228- **Alert on orders stuck in "awaiting fulfillment" for 24+ hours** — set up a daily alert for orders that haven't moved to fulfillment; these usually indicate a routing error or system issue229230## Common Pitfalls231232| Problem | Solution |233|---------|----------|234| Order splits into multiple shipments unexpectedly | Pre-warn customers at checkout if an order will ship from multiple locations; show estimated delivery per shipment separately |235| Backorder never fulfilled after stock arrives | Set up an automatic trigger: when inventory is replenished above the backorder quantity, trigger fulfillment for the oldest pending backorder (FIFO) |236| Partial cancellation leaves the order in a broken state | Implement partial cancellation — cancel only lines that haven't been picked; issue a refund for cancelled lines; update the order total |237| Shopify shows "partially fulfilled" but customer thinks full shipment is coming | Send a clear email explaining each shipment as it ships, with the items in that specific shipment and the remaining items to follow |238239## Related Skills240241- @order-fulfillment-workflow242- @returns-management243- @multi-channel-selling244- @dropshipping-integration245- @demand-forecasting