Dispatcher Assignments

The most common use of dispatchers is assigning orders to specific fulfillment paths.

Warehouse Assignment

Tag orders with warehouse identifiers:


{
  "name": "East Coast orders",
  "conditions": {
    "operator": "or",
    "conditions": [
      { "field": "shippingAddress.state", "operator": "in", "value": ["NY", "NJ", "CT", "MA", "PA"] }
    ]
  },
  "action": { "type": "add_tag", "value": "warehouse:east" }
}

Carrier Assignment

Route to specific carriers based on criteria:


{
  "name": "Heavy items to freight",
  "conditions": {
    "field": "metadata.totalWeight",
    "operator": "gt",
    "value": 150
  },
  "action": { "type": "add_tag", "value": "carrier:freight" }
}

Priority Routing

Escalate high-value or time-sensitive orders:


{
  "name": "Express for VIP",
  "priority": 1,
  "stopOnMatch": true,
  "conditions": {
    "operator": "and",
    "conditions": [
      { "field": "tags", "operator": "contains", "value": "vip" },
      { "field": "totalPrice", "operator": "gte", "value": 200 }
    ]
  },
  "action": { "type": "add_tag", "value": "shipping:express" }
}

Combining Multiple Dispatchers

Use priority ordering to build a routing pipeline:

Priority	Name	Condition	Action
1	VIP Express	VIP tag + $200+	Tag: shipping:express (stop)
10	East Coast	States: NY, NJ, etc.	Tag: warehouse:east
10	West Coast	States: CA, WA, etc.	Tag: warehouse:west
20	Cold Chain	Tag: perishable	Tag: carrier:coldtrack
99	Default	All others	Tag: warehouse:central