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¶
- Sign in to FreightLens at your portal URL.
- Select Track & Trace from the main navigation sidebar.
- Access is role-governed — ensure your user profile has tracking visibility assigned.
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¶
- Enter a booking reference, B/L, or container number in the search bar.
- Select the matching result.
- The shipment detail view opens with the current status and full event timeline.
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.
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.
- Open a shipment detail view and select Subscribe / Notify me.
- Choose which events trigger a notification (e.g. departure, arrival, exception alerts).
- Choose your delivery channel — Email or Outbound Webhook.
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.