Overview
When Luminous pushes a fulfilled shipment to Shopify, it normally sends a tracking number and carrier name. Shopify then guesses the carrier's tracking URL from the tracking number's format. This works well for parcel carriers (FedEx, UPS), but breaks for LTL freight:
- Most LTL carriers (R+L Carriers, XPO, Estes Express, ABF Freight, Southeastern Freight Lines) are not recognised by Shopify, so no tracking link appears.
- SAIA gets misidentified as FedEx because its tracking number format matches FedEx's pattern, sending customers to the wrong carrier's site.
The fix
Luminous now builds and sends an explicit, carrier-correct tracking URL for the following LTL carriers:
| Carrier | Common code variants recognised |
|---|---|
| SAIA | saia |
| R+L Carriers | rlca, rl, rlcarriers, rlfreight, r+l carriers |
| XPO Logistics | xpo, xpologistics, xpofreight, cnwy |
| Estes Express | estes, exla, estesexpress |
| ABF Freight | abf, abfs, abffreight |
| Southeastern Freight Lines | sefl, southeasternfreightlines |
Luminous uses the correct identifier for each carrier (for example, SAIA uses the PRO number stored on the shipment, not the FedEx-shaped tracking number that FreightView populates). Shopify then renders the carrier's own tracking page verbatim.
Carriers Shopify already resolves correctly today (FedEx, UPS, Old Dominion) are unaffected ā their behaviour is unchanged.
Requirements and enablement
This feature is off by default and enabled per tenant. To activate it for your account, contact Luminous support.
Once enabled, no changes to your workflow are required. Luminous resolves the tracking URL automatically when pushing fulfillments.
What if a carrier is not listed above?
If your LTL carrier is not in the table, Shopify's existing carrier-guess behaviour is preserved (no regression). Contact support to request that carrier be added.
Manually entered tracking URLs
If you manually enter or update a tracking URL on a shipment (via the manual shipment form), Luminous now correctly saves and uses that URL when pushing to Shopify ā a prior bug that silently discarded manually entered URLs has been resolved.