Skip to content

Track & Trace

Track the real-time status and location of your ocean shipments in FreightLens — from booking confirmation through final delivery.

Note: This guide is a starting structure. Replace bracketed [...] placeholders and screenshot placeholders with your product's actual UI and terminology.


Overview

FreightLens Track & Trace gives you a single, live view of every shipment. It consolidates milestone events from carriers into a standardized timeline so you can see where a container is, what's happened, and what's next — without logging into individual carrier portals.

What you can do:

  • Look up a shipment by booking reference, Bill of Lading, or container number.
  • View a standardized event timeline (gate-in, loaded, vessel departure/arrival, discharge, gate-out, etc.).
  • Monitor estimated vs. actual times and spot delays early.
  • Subscribe to notifications for milestone changes.
  • Access tracking data via the API — see API Access below.

Getting Started

Accessing Track & Trace

  1. Sign in to FreightLens at your portal URL.
  2. Select Track & Trace from the main navigation sidebar.
  3. Access is role-governed — ensure your user profile has tracking visibility assigned.

Track & Trace landing page The Track & Trace dashboard showing active shipments.

What you'll need

To track a shipment, have one of the following identifiers ready:

  • Carrier Booking Reference — issued when the booking is confirmed.
  • Bill of Lading (B/L) number — issued at cargo receipt.
  • Container number — 4 letters + 7 digits (e.g. MSKU1234567).

Tracking a Shipment

Search by identifier

  1. Enter a booking reference, B/L, or container number in the search bar.
  2. Select the matching result.
  3. The shipment detail view opens with the current status and full event timeline.

Search bar with results Searching by container number.

Reading the shipment timeline

The timeline shows each milestone in sequence. Each event includes:

  • Event type — what happened (e.g. Loaded on vessel).
  • Location — the port or facility (UN/LOCODE).
  • Date/time — actual (confirmed) or estimated (planned).
  • Status indicator — completed, in-progress, or delayed badges.

Shipment timeline A shipment timeline from gate-in to discharge.

Understanding statuses and event types

Event Meaning
Booking confirmed Carrier has accepted the booking (CONF).
Gate-in (empty/full) Container entered the origin terminal (GTIN).
Loaded on vessel Container loaded at origin port (LOAD).
Vessel departure Vessel departed origin port (DEPA).
Transshipment Container transferred between vessels at intermediate hub.
Vessel arrival Vessel arrived at destination port (ARRI).
Discharged Container unloaded at destination port (DISC).
Gate-out Container left the destination terminal (GTOT).

Estimated vs. actual times

FreightLens differentiates preliminary schedule milestones from confirmed execution: - PLN / EST (Planned / Estimated): Expected milestone date/times published by the carrier schedule. - ACT (Actual): Verified event execution timestamps. Once an actual event is recorded, it supersedes earlier estimates.


Notifications & Subscriptions

Stay informed without checking manually.

  1. Open a shipment detail view and select Subscribe / Notify me.
  2. Choose which events trigger a notification (e.g. departure, arrival, exception alerts).
  3. Choose your delivery channel — Email or Outbound Webhook.

Notification settings Configuring milestone notifications for a shipment.


API Access

For programmatic tracking, FreightLens exposes the Track & Trace API.

  • Authentication: OAuth 2.0 client credentials (client_id & client_secret) exchanged via /oauth/token.
  • Querying Tracking: Fetch shipment tracking records via GET /v2/shipments?carrierBookingReference=...&carrierCode=....
  • DCSA Schema: Returns DCSA-compliant milestone and container event history in structured JSON.

Troubleshooting & FAQ

My shipment isn't showing any events.
The carrier may not have published initial tracking events yet, or the booking was recently created. Events will populate as soon as the carrier EDI / API polling cycle synchronizes.

The container number isn't recognized.
Check the container number format: it must contain 4 letters followed by 7 digits (e.g. MSKU1234567).

The status looks out of date.
Carrier polling runs automatically on a scheduled cadence (typically every 2 hours). Select Refresh Tracking in the UI to trigger a fresh carrier poll.

I see a delay — what now?
Check the Exception Alerts tab to view details on the revised ETA/ETD and recommended operational next steps.


Glossary

  • UN/LOCODE — UN standard 5-character code for a port or location (e.g. USNYC, NLRTM, SGSIN).
  • B/L (Bill of Lading) — Official transport document issued by the carrier.
  • ETA / ETD — Estimated Time of Arrival / Estimated Time of Departure.
  • ATA / ATD — Actual Time of Arrival / Actual Time of Departure.
  • Transshipment — Transfer of cargo from one vessel to another en route.

Need more help?

Reach out to our support team at support@freightlens.io or submit a ticket through the FreightLens portal.