Skip to content
P4 Software P4 Software / logisticaHQ-en

Add these docs to Claude

Ask Claude questions about these docs. Claude reads the published pages and links you back to them. Copy this address:

https://p4-software.opendocs.page/mcp

In claude.ai or Claude Desktop: open Settings, then Connectors, choose Add custom connector and paste the address.

In Claude Code, run:

claude mcp add --transport http docs https://p4-software.opendocs.page/mcp

Shipping rules

Shipping rules
← Back to Fulfillment

Where: Fulfillment › Setup › Shipping rules

A shipping rule says how an order is shipped. When a new order is created, LogisticaHQ looks for the rule that matches it best and copies the rule's shipping method and options onto the order: whether the shipment must be counted or signed for, which carrier and service to use, how the freight is paid, and the Small Parcel settings. The order can still be changed afterwards; the rule only gives it its starting values.

The rule applies when an order is created, not to orders that already exist. Changing a rule does not touch the orders already in the System. To change existing orders, tick them on the Pick tickets list and use Bulk update.

The header

The page is titled Shipping rules, with the sub-title "What every new order gets when it is created: signatures, counts, carrier and service, matched by ship via, client, customer or postal code". Refresh and New rule are at the top right. Three cards sit above the list and read every rule:

  • By shipping method. A doughnut chart of how many rules there are per shipping method (Truck Load, Small Parcel, Private fleet, External). Click a slice or a legend entry to show only that method's rules in the list; click it again to show all. Under the chart one line gives how many rules there are, how many different Carriers they name, and whether every rule applies to every client or some are for one client, for example "15 rules · 5 Carriers · all rules apply to every client".
  • What new orders get. Four dials, one per requirement a new order can inherit: Sign on ship, Count on ship, Sign on Delivery and Count on Delivery. Each dial shows how many of your rules switch that requirement on, out of all the rules; the line under the dials reads "rules out of N that switch each one on".
  • Try an order. Type what a new order would carry (Ship via, Client, Customer, Zip/Postal; every box shows any while empty) and, in the Creating list, choose an order or a Truck Load. About a third of a second after you stop typing, the card asks the server, showing "Checking..." meanwhile, and then reads "Would match" followed by the rule's code, its method, its carrier line and its requirements (or "no signature or count"). The server runs the very same matching it runs when an order is created, so the answer is exactly what would happen. Click the rule's code to open the rule. If no rule would match, the card says "No rule matches: the order could not be created."

The list

The rules are grouped by shipping method. Each group has a header line with the method, its rule count and a one-line note, for example "Truck Load · 10 rules · all require a driver signature on ship":

Method The note
Truck Load "all require a driver signature on ship", or "N require a driver signature on ship" when only some do.
Small Parcel "N carrier services · label bought in LogisticaHQ" (N is how many different carrier and service combinations the rules name).
Private fleet "includes Default, used when no other rule matches" when the Default rule is in the group, otherwise "your own vehicles".
External "shipped by another System".

Each row shows:

Column What it shows
Rule The rule's code (given automatically when it is created) with the Ship via it matches underneath, or any ship via in grey when it matches any. Click the code to open the rule.
Applies to The client, customer and postal code the rule matches, each in grey italics as any client, any customer or any postal code when that field is empty.
Freight type The shipping method the rule gives its orders.
What the order gets SIGN ON SHIP and COUNT ON SHIP as green tags when the rule switches them on and struck-through grey when it does not; the carrier, service and carrier SCAC the rule sets, or carrier chosen on the order when it sets none; and a pill with the freight charge terms (Truck Load rules) or the payment type (Small Parcel rules).
Actions Edit opens the rule; Copy makes a second rule with the same matching fields, method and options.

The plain Ship via, Client, Customer and Zip/Postal columns are still available from Columns, hidden by default; add them back to filter or sort on them.

Above the list: the search box, three chips that narrow the list (Method: any, Carrier: any, Sign on ship: any, each a drop-down; the Carrier chip appears only once at least one rule names a carrier; Sign on ship offers any, on and off) with Clear all once any is set, Filters (a filter row under the headers), Columns (show or hide columns; the layout you choose is remembered), Export (to Excel) and AI Assist (hidden while AI is switched off for your company). Refresh reloads the list and the header. New rule opens an empty rule.

Tick rules to show the dark action bar at the bottom: "N selected", the codes of the first few ticked rules, Copy, Delete... and a cross (Clear selection). Under the list, a reminder: an order takes the most specific rule that matches it; Default applies when nothing else does; rules apply when an order is created; existing orders change with Bulk update on the Pick tickets list.

The Default rule

Every Tenant has one rule with the code Default. It has no matching fields, so it matches every order no other rule matches, and it cannot be deleted. Its panel is labelled Fallback rule and its four matching fields are read-only; its shipping method and options can be changed like any other rule's. Set the Default rule to what most of your orders need, and add rules for the exceptions.

How a rule is chosen

When an order is created, LogisticaHQ keeps only the rules whose matching fields fit the order. A matching field left empty fits any order; a filled one must equal the order's value exactly:

  • Ship via must equal the order's Ship via text.
  • Client must equal the name of the order's client.
  • Customer must equal the order's customer code.
  • Zip/Postal must equal the order's ship-to postal code.

Of the rules that fit, the most specific wins, in this order of importance: a rule with a Ship via beats one without; then a rule with a Zip/Postal; then one with a Customer; then one with a Client. Two rules that are equally specific are told apart by their code, the newest first. The Default rule, with nothing filled in, is what is left when no other rule fits.

If no rule fits at all (which can only happen when the Default rule has been given matching fields), the order cannot be created and LogisticaHQ says "No shipping rule found. Please configure a default shipping rule or specify ShipVia."

When a Truck Load is created for an order, only rules whose freight type is Truck Load are considered; the same matching then applies. The Try an order card lets you check both cases.

Opening, creating and editing a rule

Click a row, its code or Edit, or press New rule. The rule opens in a panel beside the list.

At the top: a small label (Rule, Fallback rule for Default, or New rule), the rule's code (a new rule shows "Numbered when saved"), its method, a close button, and a sentence that says what a new order matching it gets ("A new Truck Load order via UPS gets a driver signature on ship, shipped UPS LTL."). The sentence changes as you change the fields, so you can read the effect before you save. Click the same row again, or the panel's close button, to close it without saving.

Fields that do not apply to the chosen shipping method are not shown (groups appear and vanish as you change the method). The groups below say which method shows them: Applies to and What the order gets always; Carrier for Small Parcel and Truck Load, and for any rule that already holds a carrier; Small Parcel for Small Parcel; Bill to when somebody else's account is billed; Collect on Delivery for Truck Load. A Private fleet or External rule (the Default rule is Private fleet) therefore shows Applies to, the four switches and a one-sentence Carrier section explaining that nothing needs picking. If such a rule already holds a carrier or service (the Default rule can: it is the fallback for every order that matches no other rule), the Carrier and Service drop-downs are shown for it as well, so the value can be seen and changed.

Applies to

The section reads "A field left empty matches any order." and each empty box shows any ship via, any client, any customer or any postal code.

Field What it does
Ship via Fits an order whose Ship via text is exactly this. Leave empty to fit any Ship via.
Shipping method The method a matching order starts with: Truck Load, Small Parcel, Private fleet or External. A new rule starts as Private fleet and the list has no empty entry, so a method is always set. Which groups appear below depends on it.
Client Fits an order for this client (by the client's name). Leave empty to fit any client.
Customer Fits an order for this customer code. Leave empty to fit any customer.
Zip/Postal Fits an order shipping to this postal code. Leave empty to fit any postal code.

What the order gets (every shipping method)

Four Yes/No switches, each with a line saying what it means. They are given to every new order the rule matches, whatever its method; a line above the switches says, for every method but Private fleet, which of them that method's orders actually use.

Switch What it does
Sign on ship The driver signs when the order leaves.
Count on ship Totes are counted onto the vehicle before it leaves.
Sign on Delivery The receiver signs when the order arrives.
Count on Delivery Totes are counted again at Delivery.

What the switches do per method:

Method What the orders use
Private fleet All four: the driver's and the receiver's signatures are captured on the order, and the counts are made on ship and on Delivery. No extra line is shown.
Small Parcel Count on ship holds the order until its Totes are counted. The two signatures only decide whether the packslip prints signature boxes, because the carrier delivers the parcel.
Truck Load The order ships from its Truck Load, which does not read these switches. The signatures only decide whether the packslip prints signature boxes.
External The order is shipped outside LogisticaHQ. The signatures only decide whether the packslip prints signature boxes.

Carrier (fields shown for Small Parcel and Truck Load, and for any rule that already holds a carrier)

Carrier and Service are drop-downs; nothing is typed by hand. Both start with Not set, which leaves the carrier or service to be chosen on the order.

Field What it does
Carrier The carrier written on the new order. The list has up to three headings: Your Carriers (Small Parcel) or Truck Load Carriers (Truck Load), Popular Carriers, and Saved on this rule (see below). The order can still be changed afterwards.
Service (Small Parcel, and any rule that holds a carrier; a Truck Load rule shows it only when it already holds one) The carrier's service level, for example Ground. It appears once a carrier is chosen (until then the line reads Choose a carrier to pick a service.) and lists that carrier's services under Configured services, then Popular services, then Saved on this rule. Changing the carrier clears a service the new carrier does not offer, so a rule never pairs a carrier with another carrier's service.
Carrier SCAC (Truck Load only) The carrier's SCAC code. A new Truck Load is assigned the client's carrier with this code, when the client has one. Picking one of your Truck Load Carriers in the Carrier list fills this in with that carrier's SCAC; picking any other carrier (a popular one, or one of yours saved without a SCAC) clears it, because the SCAC alone decides which carrier a new Truck Load is given: leaving the old code would send Truck loads to a different carrier than the one the rule names. Type the SCAC yourself afterwards if that carrier has one. Choosing Not set leaves a typed code alone.
Freight charge terms (Truck Load only) Who pays the freight on the new Truck Load: Prepaid (the shipper), Collect (the receiver) or Third Party (somebody else). Not set leaves it blank. Choosing Third Party shows the Bill to group.

Where the lists come from:

  • Your Carriers (Small Parcel) are the Carriers and services your company is set up to ship with, read the same way an order is rated: the Carrier Services map of the rule's Client when that client has one (Setup › 3PL › Clients › the client › Setup tab › Shipping section, in the form UPS=Ground,NextDayAir;FedEx=FEDEX_GROUND; that section is for administrators only and the box appears only when Small Parcel broker is not Default), otherwise the company's map, the setting Carrier Service Map (Setup › System › Configuration › Business › Fulfillment, under Shipping · Small Parcel; its description reads "Carriers and services map") merged with every client's map. A rule with no Client gets the merged list. Each carrier's Configured services are the services after its = in that map. Carriers with the same name apart from capitals are one entry (UPS and ups).
  • Truck Load Carriers (Truck Load) are the Truck Load Carriers of the rule's Client (Fulfillment › Setup › Carriers), or of every client when the rule has no Client, by company name, with the carrier code and SCAC in brackets, for example FedEx Freight (FEDEX · FXFE). The value stored in the rule is the carrier code (FEDEX), the same text the System writes on the order when the Truck Load is assigned, so the order never shows two spellings. Names are compared ignoring capitals everywhere (UPS and ups are one carrier), as the shipping broker does.
  • Popular Carriers and Popular services are offered after your own, so a rule can be set up before the maps are filled in: UPS (Ground, 3 Day Select, 2nd Day Air, Next Day Air Saver, Next Day Air), FedEx (Ground, Home Delivery, Express Saver, 2Day, Standard Overnight, Priority Overnight, First Overnight), USPS (Ground Advantage, Priority Mail, Priority Mail Express, First-Class), DHL Express (Worldwide, 12:00, 9:00), Purolator (Ground, Express), Canada Post (Regular, Expedited, Xpresspost, Priority), Estafeta (Terrestre, Día Siguiente, 2 Días, 11:30, 12:30, LTL). RateShop is not offered: rating always needs a service, so a rule naming it could not produce an order that can be rated. Truck Load rules show no popular Carriers (they are parcel Carriers); only your Truck Load Carriers and the rule's own value. A popular carrier or service already among your own is not offered twice, but only when the spelling is the same apart from capitals and surrounding spaces: the shipping broker compares nothing else, so if your map says "DHL Express" the popular DHLExpress (the name the broker understands) is still listed. The value stored is the name the shipping broker matches rates by, shown in brackets when it differs from the readable name, for example Next Day Air Saver (NextDayAirSaver) or Día Siguiente (Dia Sig.) (EasyPost names that Estafeta service without the accent, and a rate is only kept when the names match); the order and the Shipping station show the stored name.
  • Saved on this rule appears when the rule already holds a carrier or service that none of the lists offer exactly as written (typed in the old dialog, set up for another client, or written in another case, for example ups next to UPS). It stays selectable so that opening and saving the rule never drops it; pick anything else to replace it.

The full list of popular entries, with the name stored in the rule (the name the shipping broker matches rates by) where it differs from the readable one:

Carrier (as listed) Services (as listed)
UPS Ground, 3 Day Select (3DaySelect), 2nd Day Air (2ndDayAir), Next Day Air Saver (NextDayAirSaver), Next Day Air (NextDayAir)
FedEx Ground (FEDEX_GROUND), Home Delivery (GROUND_HOME_DELIVERY), Express Saver (FEDEX_EXPRESS_SAVER), 2Day (FEDEX_2_DAY), Standard Overnight (STANDARD_OVERNIGHT), Priority Overnight (PRIORITY_OVERNIGHT), First Overnight (FIRST_OVERNIGHT)
USPS Ground Advantage (GroundAdvantage), Priority Mail (Priority), Priority Mail Express (Express), First-Class (First)
DHL Express (DHLExpress) Worldwide (ExpressWorldwide), 12:00 (Express1200), 9:00 (Express900)
Purolator Ground (PurolatorGround), Express (PurolatorExpress)
Canada Post (CanadaPost) Regular (RegularParcel), Expedited (ExpeditedParcel), Xpresspost, Priority
Estafeta Terrestre, Día Siguiente (Dia Sig.), 2 Días (2 Dias), 11:30, 12:30, LTL

If the lists cannot be read (the server did not answer), the popular Carriers and the rule's own value are still offered, and a line under the Carrier list says Your own Carriers could not be loaded, so only the popular ones are listed. Close and open the rule again to retry. When the Client box changes, the previous client's Carriers disappear at once and the new client's appear after a short pause.

For a Private fleet or External rule without a carrier the Carrier section holds no fields, only this sentence: Private fleet and external orders do not need a carrier or service, so none is asked for here. A carrier or service this rule already holds is shown above and kept; every new order matching the rule gets it, and Not set removes it. Third-party billing does not apply to them either: it is set on Small Parcel rules with the Payment type and on Truck Load rules with the Freight charge terms. Nothing is removed when you save: the System copies a rule's carrier and service onto every new order, whatever the method, so a Default rule holding for example UPS and Ground is a working global fallback and keeps it. It is removed only when you pick Not set. The Service of a Truck Load rule is shown only when the rule already holds one.

Changing the Shipping method keeps the carrier and service. Moving a rule to Truck Load with a carrier chosen sets the SCAC to that carrier's SCAC, or clears it when the carrier is not one of your Truck Load Carriers, so the SCAC never points at a different carrier than the one named. A Truck Load carrier code on a Small Parcel rule stays selectable under Saved on this rule.

Small Parcel (shown for the Small Parcel method)

Field What it does
Payment type Who pays the carrier for the shipment: Prepay (the shipper's own account), Collect, Consignee or Third Party. The last three bill somebody else's account and show the Bill to group.
Account number The carrier account for the shipment. It is shown for every payment type so it can be kept on the rule, but the shipping broker sends it to the carrier only when the Payment type is Third Party, together with the Bill to address; with Prepay, Collect or Consignee it is not sent. Collect and Consignee also use the Bill to address.
International tax Id The tax identifier sent to the carrier for international shipments.
Residential Yes: the ship-to address is residential, which some Carriers rate differently.
COD Yes: collect on Delivery.
Saturday pickup Yes: ask the carrier for a Saturday pickup.
Saturday Delivery Yes: ask the carrier for a Saturday Delivery.
Signature required Yes: the carrier must obtain a signature on Delivery.
Print return label Yes: a return label is printed with the shipping label.

Bill to (shown when somebody else's account is billed)

This group appears for a Small Parcel rule whose payment type is Collect, Consignee or Third Party, and for a Truck Load rule whose freight charge terms are Third Party. It never appears for a Private fleet or External rule: third-party billing does not apply to them, and the Carrier section says so.

Field What it does
Account number (Truck Load only here) The carrier account the shipment is billed to, when it is not the shipper's own. On a Truck Load it becomes the third party's account number. For a Small Parcel rule the account number is in the Small Parcel group above; it is sent to the carrier only for Third Party.
Name The name the shipment is billed to. Left empty, new orders take the Bill to address from the customer instead.
Phone, Email The bill-to contact.
Address 1, Address 2, City, State/Province, Zip/Postal, Country The bill-to address. On a Truck Load it becomes the third party's address on the bill of lading.

Collect on Delivery (shown for the Truck Load method)

Field What it does
COD amount The amount to collect on Delivery. It is written on the new Truck Load and printed on the bill of lading. A box that cannot be read as a number is ignored and saved empty. The two fields below appear once an amount is entered.
COD fee terms Who pays the collection fee: Collect or Prepaid. Not set leaves it blank.
Customer cheque accepted Yes: the carrier may take the customer's cheque for the COD amount.

Saving

Press Save (or Enter in a box). The panel closes, the list and the header reload, and the row shows what the rule now sets. If the server refuses the rule, the reason is shown in red in the panel and your edits stay, so you can correct and save again.

Options that are not shown for the chosen method are kept as they were. A rule that was once a Small Parcel rule and is now a Truck Load rule still holds its old Small Parcel settings, and they come back if the method is changed again.

Copying a rule

Press Copy on a row, in the panel, or in the action bar for the ticked rules. A new rule is created straight away with a new code and the same matching fields, shipping method and options. Open it to change what should differ. Nothing is lost by a copy, so there is no question first. The Copy in the action bar copies each ticked rule in turn and then clears the selection; the Copy in the panel leaves the panel open on the original rule.

Deleting rules

Press Delete... in the panel, or tick one or more rules and press Delete... in the action bar. LogisticaHQ asks "Delete shipping rule SR00012?" (naming the rule) or "Delete N shipping rules?" and you confirm. The Default rule is never deleted: it has no Delete in its panel, it is skipped if it is among the ticked rules, and if it is the only one ticked, a No data box says "No valid items selected".

Deleting a rule does not change the orders it already shaped; from then on, new orders match the remaining rules.

Examples

  • Every order for a client ships by a given carrier. New rule: Client = the client's name, Shipping method = Small Parcel, Carrier = UPS (from Your Carriers), Service = Ground, Payment type = Prepay.
  • A customer pays its own freight. New rule: Customer = the customer code, Shipping method = Small Parcel, Payment type = Third Party, Account number = the customer's carrier account, then in Bill to the customer's name and address.
  • Truck loads for a client always go with one carrier. New rule: Client = the client's name, Shipping method = Truck Load, Carrier = the client's Truck Load carrier from the list; the Carrier SCAC fills in by itself and is what assigns the carrier to the new Truck Load.
  • Truck loads to one postal code need a signature. New rule: Zip/Postal = the code, Shipping method = Truck Load, Sign on ship = Yes, Freight charge terms = Collect.
  • Check before you rely on it. In Try an order, type the ship via and postal code of a typical order and see which rule it would get and what it inherits.

Was this page helpful?