Overview
Shipping Automation picks the carrier for each order automatically, based on rules you define. When a rule's Partner Type is OTO Rates, it chooses among the carriers available on OTO's own discounted rates (15+ carriers, no contract of your own needed). Rules with Partner Type Own Rates work the same way with the carriers you connected on your own contracts.
Plans and limits
Shipping Automation is available from the Starter plan. It is not available on Free.
Number of automation rules: Starter 5, Scale 10, Pro and Enterprise unlimited.
How it works
The engine runs in two passes, and the Shipping Automation page has a tab for each:
Delivery Company Feasibilities: decides which carriers are allowed to take the order at all (for example, exclude a carrier for orders over a certain weight). See the Feasibility Rules article.
Automation Rules: among the carriers still allowed, chooses one. Rules are evaluated in the order set with Sort Rules, and the first rule whose conditions match the order decides.
Create an automation rule with OTO Rates
Go to Settings > Advanced > Shipping Automation and open the Automation Rules tab.
Click Add OTOmation Rule.
Enter a Rule Name that states what the rule is for (for example, "Riyadh COD orders - cheapest carrier").
Set the Status: Test Mode while you are checking the rule, Active when it should assign orders, or Inactive.
Set Partner Type to OTO Rates.
Add the Conditions that decide which orders the rule applies to, such as destination city or city group, shipment weight, boxes count, COD value, payment type, brand, category, SKU or order tags.
Choose the Method (see below). For Manual Selection or Distribute by Percentage, fill in the Actions table with the carriers and their rank or share.
Turn on Switch to next carrier on failure if you want OTO to try the next carrier when booking with the chosen one fails.
Save, then use Sort Rules to place specific rules above general ones, with a catch-all rule at the bottom.
Selection methods
Manual Selection: you rank the carriers; rank 1 is tried first, then rank 2, and so on.
Least Cost Selection: the cheapest feasible carrier.
Delivery Rate: the carrier that completes deliveries most often.
SLA Met: the carrier that most often delivers within its promised SLA.
Delivery Time: the carrier that is fastest in practice.
Customer Rating: the carrier your customers rate highest.
Distribute Equally: spreads orders evenly across the feasible carriers.
Distribute by Percentage: splits orders by the percentage you set for each carrier.
For the four performance methods (Delivery Rate, SLA Met, Delivery Time, Customer Rating), a Data Period field sets how many months of history the score is based on.
Test before you rely on it
Test Mode: the rule is evaluated and its result recorded, but it does not assign orders. Use it to see what a new rule would do before making it Active.
Automation Test: enter an Order Number to see every rule's result for that order, in evaluation order. Turn on Reverse Shipment to test the return leg, since return shipments are also assigned by these rules.
Troubleshooting
The wrong rule is assigning orders: a broader rule higher in the list is matching first. Move the specific rule above it with Sort Rules. The Orders column shows how many orders each rule has taken; a rule stuck at zero is usually shadowed by one above it.
"No eligible carriers matched the rule conditions": the rule matched the order, but every carrier had already been excluded by a feasibility rule, by City Coverage or by a Daily Capacity that was used up. Check the Delivery Company Feasibilities tab and the carrier's coverage, not the rule itself.
A rule does nothing: check that its Status is Active (not Test Mode or Inactive) and that its Partner Type matches the carriers you expect (OTO Rates vs Own Rates).
FAQs
Q: Can one rule choose between OTO Rates and my own contracts?
A: No. Each rule works inside one Partner Type. Create separate rules for OTO Rates and Own Rates.
Q: Can I use different methods for different orders?
A: Yes. Each rule has one method, so create several rules (for example, least cost for standard domestic orders and a percentage split for a carrier you have a volume commitment with) and order them with Sort Rules.
