Routing Rules

Routing rules define the logic used to assign orders to a fulfillment location. You can create several rules that are evaluated one after another in a fixed order.

What can I do here?

  • View all routing rules with type, priority, and status (Active/Inactive)
  • Search by rule name or description and filter by Active/Inactive
  • Create a new rule: name, description, rule type, priority, plus conditions and actions
  • Edit or delete an existing rule
  • Change the order of rules with the up/down arrows — priority is automatically recalculated

Step by step

  1. Create a new rule: Click "New Rule", give it a name and description, and choose a rule type (Ranked, Closest Location, Minimize Splits, or Market-Based).
  2. Define conditions and actions: Enter the conditions (when the rule applies) and actions (what should happen) in the provided field.
  3. Adjust the order: Move rules up or down in the list using the arrow buttons — rules with a lower priority number are evaluated first.
  4. Deactivate instead of delete: If you want to temporarily disable a rule, turn off the Active flag instead of deleting it.

Fields explained

Field Meaning Notes/Effect
Name Name of the rule Required
Description Explains when and how the rule is applied Optional, but recommended for traceability
Type The rule's underlying logic (see values below) Determines how the assignment is calculated
Priority Order in which rules are evaluated Lower number = evaluated first; automatically reassigned when reordering
Conditions Freely defined criteria for when the rule applies Entered as a technical data record (JSON) — for experienced users only
Actions Freely defined outcome the rule triggers Entered as a technical data record (JSON) — for experienced users only
Active Whether the rule is currently applied Inactive rules are skipped during assignment

Values & statuses

Rule type (routing_rule_type)

Value Meaning What happens then
Ranked Locations are preferred according to a fixed ranking The highest-ranked available location is chosen
Closest Location The geographically nearest location is preferred Reduces shipping time/cost
Minimize Splits An order is fulfilled from a single location whenever possible Avoids multiple partial shipments
Market-Based Assignment is based on the order's target market For regional/country-specific assignment

Frequently asked questions

What happens if several rules match?
Rules are evaluated in order of priority — the first matching rule with the lowest priority number determines the assignment. The exact technical evaluation logic for conditions/actions is not fully documented in the code.

Can I temporarily disable a rule without deleting it?
Yes, turn off the Active flag. The rule is kept and can be reactivated later.

How do I change the order of rules?
Use the up/down arrows next to each rule in the list. Priority is automatically recalculated.