Preventing Carrier Multi-Piece Consolidation with UUID Disambiguation
When multiple single-piece parcels are dispatched on the same calendar date with matching sender and recipient addresses, automated sorting systems (notably Purolator Automated Parcel Sorting / ARC, UPS Hundredweight, and FedEx Multiweight) frequently merge those separate tracking numbers into a consolidated Multi-Piece Shipment (MPS) consignment. Weeks later, the carrier re-rates the batch at freight tariffs and issues retroactive adjustment invoices.
To guarantee every parcel travels as an isolated single-piece shipment, ShipStationService injects an 8-character uppercase hexadecimal hash derived from the shipment UUID into both the consignee name (Nancy Gabriel (Ref: 42A74C4B), strictly capped at 40 characters) and address_line2 (Apt / Ste / Unit 42A74C4B). Simultaneously, all metric dimensions are converted to imperial inches using (int) ceil($cm * 0.393701) to match optical parcel scanner rounding rules.