Suggested shipping (Orders)
The Suggested shipping column on the Orders list is an auto-suggestion that picks:
- a Carrier integration (Carrier Credential)
- an optional Service code (if the rule specifies one)
This suggestion is driven by the client’s Shipping routing rules.
Where it appears
- Orders → list view: the Suggested shipping column.
- Suggestions are not shown for orders flagged as virtual (no shipping required).
- If no rules match, users with the right access will see a one-line debug reason instead of a blank value.
Where the settings live
Go to:
- Clients → Edit client → Shipping routing rules
Each rule is evaluated top-to-bottom by priority (lowest priority number runs first).
What a routing rule contains
Each rule has:
- Enabled toggle
- Priority (lower runs first)
- Name (shown on Orders for visibility)
- Target carrier (the Carrier Credential to use)
- Target service (optional) (preselects the service when creating shipments)
Rule conditions (match criteria)
A rule can optionally constrain on:
- Channel (exact match)
- Currency (exact match)
- Store ID (exact match; primarily for Magento)
- Destination country (ISO-2, exact match)
- Destination postcode prefix (starts-with)
- Shipping title
- if you enter plain text: ParcelPilot looks for that wording anywhere in the shipping method name
- if you enter an advanced pattern: ParcelPilot can use that too, but plain text is usually best for most teams
- Item qty (order-level): min/max
- Weight (grams, order-level): min/max
- Shipping price: min/max
- Order total: min/max
How the suggestion is calculated
When the Orders table needs to display the suggestion, the system:
- Loads all enabled routing rules for this tenant+client.
- Computes “order facts” once (destination, weight, item count, totals, etc.).
- Walks rules in priority order and returns the first match.
- Confirms that the chosen carrier setup is active and belongs to the same account and client.
Order facts used by routing
- Ship-to destination uses the cleaned shipping address on the order.
- Country is normalized to uppercase.
- Postcode is normalized to uppercase with spaces removed.
- Shipping title is taken from the order's shipping method details or the details imported from the ecommerce platform.
- Currency is taken from the order where available.
- Store ID is taken from the order's imported store information when available, mainly for Magento.
- Item count is computed from the order’s stored order lines.
- Weight is computed from catalog item weights.
- If the calculated weight is extremely low, usually because the items are not fully set up yet, routing will try to use the weight that came in from the ecommerce platform as a fallback.
Notes:
- Routing uses the best available item weights and/or upstream grams. Packaging (box) tare weight is applied later during shipment booking if enabled.
Short-lived caching
To keep the Orders list fast, routing uses short caches:
- Routing rules: ~15 seconds per tenant+client
- Carrier Credential lookup: ~30 seconds
If you edit routing rules and don’t see changes immediately, wait a few seconds and refresh.
Parcel/label count shown in the Orders column
The Orders list also estimates how many shipments/labels are likely needed for the suggested carrier.
This is only a display hint and is based on the suggested Carrier Credential’s split limits:
- Max items per shipment
- Max weight (grams) per shipment
The estimate uses the larger of:
- item quantity from stored order lines, and
- item quantity as shown in the order “viewer” lines
…and it caps the displayed number at 25.
Important:
- This is an estimate based on stored order data and carrier limits. The actual booked weight/dimensions can be overridden during shipment creation.
How to override the suggestion
The suggestion is a default, not a lock.
- When you Create shipment for an order, you can pick a different carrier integration and/or service in the modal.
- When you Bulk create shipments, you can optionally apply each order’s suggested service per order (from routing rules) when available.
- This only applies when the selected carrier is the same for the batch; otherwise the bulk action uses the chosen service for all orders.
Troubleshooting
If Suggested shipping is blank:
- Check the client has at least one enabled routing rule.
- Confirm the rule’s Target carrier (Carrier Credential) is enabled and belongs to that client.
- Confirm the order matches the rule conditions (country/postcode prefix/weight/items/etc.).
- If you have access to the debug view, use the debug line shown in the column to see the top mismatch reasons.