Troubleshooting

Nothing is palletizing

Run php craft palletizr <order-number> --explain. If no rule is listed, there are no enabled rules for the order's store. If rules are listed but all missed, the reason column names the first condition that failed on each.

Check too that the rule's action is Palletize and not Require — a store whose only rule is a require gate has a gate and nothing to let through it.

Postie's quote has not changed

Work down this list:

1. Is Palletize Postie packings on in the settings?
2. Is the provider a freight provider? Freight providers only is on by default, and a parcel provider is deliberately left alone. Palletizr recognises FedEx Freight and UPS/TForce Freight; for anything else, name the provider handle in the Postie providers setting.
3. Does a rule actually match this order? --explain will say.
4. Turn on Log every packing and watch storage/logs/ — every packing writes one line saying how many pallets it built, or why it built none.

"Palletizr could not palletize a Postie packing and left it alone"

An exception, logged with its stack trace, and Postie's original cartons were sent instead. The shipment still quoted. Please report the trace.

A pallet is over the carrier's limit

That is the warning working. Palletizr quotes it anyway, because your negotiated tariff may allow it, but it will not do so silently. To stop the load being built that tall or that heavy in the first place, lower the maximum load height or maximum load weight on the pallet — those are hard limits the builder respects, whereas carrier limits produce warnings.

Everything is shipping loose

Almost always missing dimensions on the purchasable. Commerce lets a product ship without measurements; a pallet cannot be loaded with a carton of unknown size, and guessing would produce a quote the carrier will not honour. The load names each one.

The load builder is slow

The optimised pattern solver is bounded — MAX_STATES and MAX_CUT_GRID in services\Footprints — and falls back to block loading for very small cartons on very large decks, where blocking is already near-optimal. If a specific cart is slow, the likely cause is a large number of distinct carton shapes rather than a large quantity: the solver runs once per shape, not once per carton.

A tariff is quoting when it should not

Turn on Only when palletized. A freight tariff quoting a single small carton is how a store accidentally charges a fortune to ship a bracket.

A tariff is not quoting at all

If Only when palletized is on, the order has to palletize first — so this is the "nothing is palletizing" question above.

Per-class rates are being ignored

A class with no rate of its own reaches up to the next class that has one, and falls back to the flat hundredweight rate only when no listed class is at or above the shipment's. If a shipment is classing higher than every row in the table, add the higher row.

Numbers look wrong after changing Commerce's units

Pallets store what you typed, in whatever unit Commerce was configured in at the time. Changing Commerce's dimension or weight units re-interprets every stored number in the new unit — a 48-inch deck becomes a 48-millimetre one. Re-enter the catalogue, or convert it in an export/import round trip.