Great tracking starts with the right primary key. LSP teams juggle Bill of Lading numbers, container IDs, and booking references. Each key fits a different job. This guide shows when to anchor on the BL, when the container ID should drive the screen, and how to stitch events across keys so operations, customers, and finance see the same truth.
Why The Key You Choose Matters
Your tracking workflow is only as strong as its anchor. Pick the wrong key and you lose the thread at transshipment, split BL, or slot-charter handoffs. Pick the right key and you keep continuity through vessel changes, container swaps, and document updates. The goal is simple. One truth that survives handoffs and still lets each team search the way they work.
Understand The Keys
Bill of Lading
- Master BL identifies the contract of carriage with the vessel-operating carrier. It persists when containers change and across feeder to mother transfers.
- House BL identifies the forwarder-issued document. It is the customer-facing reference for many LSPs and brokers.
- Strength: best continuity across handoffs and consolidations. The BL is the commercial constant.
- Weakness: carrier portals can lag BL updates. Some events publish first at container level.
Container number
- Format: ISO 6346 owner code plus serial number with a check digit.
- Strength: best for physical milestones such as gate in, load on vessel, discharge, and out-gate.
- Weakness: breaks at transshipment when cargo moves to a different box. Containers are reused quickly, so numbers repeat across voyages.
Booking reference
- Carrier booking binds space and planned service string at origin. One booking can span multiple containers.
- Forwarder booking or internal file number maps your commercial job to multiple carrier bookings.
- Strength: best at the pre-carriage and planning stage.
- Weakness: can fragment after rollovers or split shipments.
Supplementary keys
- Voyage or service string: useful for reliability and hub risk by string, not a customer-friendly search key.
- PO number: valuable for shipper-facing portals and DC planning. Needs a clean crosswalk to BL lines.
Which Key To Use By Role
- Operations desk: search by container for day-of-move actions and terminal status. Anchor the shipment record on BL to keep continuity when boxes change.
- Customs brokerage: anchor on BL and line items. PO is optional context. Container is secondary.
- Customer success and sales: use BL as the primary reference on portals and reports. Offer container and PO as filters.
- Finance: reconcile invoices to BL and service contract. Show container status to support detention and demurrage disputes.
Event Normalization That Prevents Confusion
Map all feeds to a common event vocabulary so teams do not argue over synonyms. A simple baseline follows the DCSA Track and Trace verbs.
- Ocean leg: received for shipment, loaded, departed, arrived, discharged, available.
- Gate and yard: gate in empty, gate in full, gate out full, gate out empty.
- Exceptions: rolled, port omission, customs hold, carrier hold, terminal closed.
Use a precedence rule when feeds conflict. For example, use carrier intent for planned dates and AIS pace for arrival forecasts. Always show the source next to the event.
Edge Cases And How To Keep The Thread
Transshipment and container change
- Risk: the container ID changes at the hub. If you anchor on the old box, tracking stops.
- Solution: stitch the new container to the same BL and continue the timeline. Keep both container IDs visible on the record with leg labels.
Split BL or partial rollovers
- Risk: some containers move while others wait. Booking may split into multiple voyages.
- Solution: keep one BL record with multiple legs. Present a per-container sub-timeline under the BL so the customer sees partial deliveries clearly.
Multiple BL on one container
- Risk: co-load or groupage can place more than one BL on a single box.
- Solution: avoid making the container the only key in customer portals. Show which BL segments sit in that container and keep privacy rules intact.
Alliances and slot charters
- Risk: your booking shows a marketing carrier while AIS shows an operating carrier and a different voyage code.
- Solution: store both the marketing and operating voyage identifiers. Display both on internal views and one simple label on the customer view.
Container number reuse
- Risk: the same container number appears on a new voyage while your prior BL is still open.
- Solution: scope container events by BL and leg dates. Do not attach new voyage events to the old BL.
What To Show Customers
- Clean search: let them paste BL, container, or PO. Resolve to the BL view every time so continuity is clear.
- Two-part time: ETA to berth plus berth-to-availability band for the destination terminal. Avoid hiding dwell inside transit time.
- Per-container sub-timelines: show which containers have arrived, which are pending, and any rollover notes.
- Free time and last free day: include LFD on the BL timeline with alerts at T minus 72 and T minus 24 hours.
Paste-ready SOP Snippets
Primary key rule
“Shipment records are anchored on the Master or House BL. Containers, bookings, and PO lines are linked as children. Customer portals always resolve searches to the BL view.”
Conflict resolution
“For arrival forecasts we prefer AIS pace. For planned dates and changes of intent we prefer carrier schedule. When sources diverge, we display both and add a one-line reason.”
Transshipment continuity
“When a container changes at the hub, we attach the new container to the same BL, label each leg, and keep the timeline unbroken.”
Partial delivery copy
“Your BL contains multiple containers. Some have arrived and are available. Others are in transit. See per-container status below and last free day for units at terminal.”
How TRADLINX Helps
TRADLINX Ocean Visibility anchors on the BL and stitches container and booking events into one timeline. Search by BL, container, booking, or Booking number. See ETA to berth and a labeled availability band. Expose last free day, rollover notes, and hub leg details. Use the API to push the same record into your TMS so operations, customers, and finance work from one truth.

Assumption Checks
- Do not use the container as the only truth. It breaks at transshipment and during reuse.
- Do not hide hub legs. Label feeder and mother legs so rollover risk is obvious.
- Do not promise SKU tracking. Keep scope to BL, container, booking, and PO unless you have deeper integrations.
References
- Digital Container Shipping Association. Track and Trace standard and event vocabulary
- Bureau International des Containers. ISO 6346 container identification standard
- FIATA. Model rules and BL guidance for freight forwarders
- U.S. Department of Commerce. Know your Incoterms
Why overpay for visibility? TRADLINX saves you 40% with transparent per–Master B/L pricing. Get 99% accuracy, 12 updates daily, and 80% ETA accuracy improvements, trusted by 83,000+ logistics teams and global leaders like Samsung and LG Chem.
Prefer email? Contact us directly at min.so@tradlinx.com (Americas) or henry.jo@tradlinx.com (EMEA/Asia)





Leave a Reply