← Back to Home

Container Tracker for Salesforce

Container Tracker follows your ocean containers on Salesforce accounts and opportunities. Paste the container numbers on a record, and the package keeps status, ETA, vessel, ports and the last and next event up to date. Every event from the carrier is stored as a Salesforce record, so your reports, list views and dashboards work with it. You don't need carrier accounts or any refreshing.

New in 1.3: Free time (demurrage & detention). Enter the free days you get from each carrier, and every box shows its last free day and the days left, with a morning email before a last free day.

Carriers tracked automatically: MSC, Maersk, CMA CGM, Hapag-Lloyd, ONE, Yang Ming and Evergreen.

The Overview tab of the Container Tracker app: the Free time card, a dashboard with arrivals this and next week, ETA changes, containers waiting after discharge, sync problems and boxes in charges or due soon, charts by status, carrier and port of discharge, and the list of all containers with their last free day
The Overview tab: the Free time card and the included dashboard above the list of all your containers.

1. What it does

2. Install the package

  1. Click Install in Production or Developer Edition, or Install in a Sandbox, and log in as a Salesforce admin.
  2. Choose Install for Admins Only and click Install. You give access to your users with the permission sets in the next step.
  3. When the install has finished, open the App Launcher and pick Container Tracker.

Installing takes a few minutes.

3. Assign the permission sets

In Setup ▸ Permission Sets, assign:

4. Get your API key

  1. Open the Container Tracker app ▸ Container Tracker Setup tab ▸ Get your API key. The key page already knows your org.
  2. Enter your work email. We send you a link.
  3. Open the link and copy the key.
  4. Paste the key on the Setup tab and click Save and test. This also turns on the hourly sync.
The Container Tracker Setup tab: API key saved, hourly sync on, the Free plan with 1 of 10 containers used, how to show containers on records, and Slack alerts connected to a channel
The Setup tab: API key, hourly sync, plan, record pages and Slack alerts.

5. Add containers to your record pages

  1. Open an account, then Setup ▸ Edit Page.
  2. Drag the Containers component onto the page and save (activate the page if Salesforce asks).
  3. Do the same on an opportunity.

Container records come with their own page, nothing to set up there: see The container page.

An account page with the Containers component listing a container with carrier, status, ETA, last event and date
The Containers component on an account.

6. Track containers

In the Containers component (or on the Overview tab), click Track containers and paste one or more container numbers: 4 letters and 7 digits, as printed on the container door. The list shows the carrier for each number. When the owner code doesn't tell the carrier (a leased container, for example TGHU or TCLU), pick it; one pick fills the empty ones below. Click Track.

The Track containers form with three pasted numbers: two carriers filled in from the number, one asking to pick the carrier
The carrier comes from the number; leased containers ask you to pick it.

The first status comes in once the carrier answers; from then on the hourly sync keeps it up to date. Stop tracking archives a container (it moves to Archived, where Track again restarts it). Containers the carrier can't find get the status Can't be tracked with the reason.

7. The container page

A container page: status, carrier, port of discharge and vessel at the top, the Events timeline with Add event, Refresh and Stop tracking, the Milestones card, the Free time card with the last free day and the Summary card
Events, Milestones, Free time and Summary on a container record.

8. Free time (demurrage & detention)

See the last free day and the days left for every box, worked out from the free days you get and the carrier's own events (discharge, gate-out, empty return; for exports empty pick-up, gate-in, loading).

  1. Open the Free time tab. Under Free days, alerts and contracts, click Add free days (Container Tracker Admin).
  2. Pick the carrier (also the ones you track by hand, like COSCO, ZIM or HMM) and enter your free days: what the free time covers (demurrage + detention combined, demurrage and detention separately, demurrage only or detention only), calendar or working days, import or export. Click Save free days.
  3. Free days differ by port or box type? Add more rows for the same carrier with a port or country (e.g. Jebel Ali, AEJEA or AE) and/or a box type. The most specific row wins.
The Add free days form: carrier Evergreen, any port and box type, demurrage and detention combined, 7 calendar days, import
Free days per carrier, optionally per port or box type.

The Free time list shows every box, most urgent first: status (in charges, due soon, OK, no free time set), last free day, days left, charged days, port and box type. Open a row for the terms used and how the last free day was counted. The buttons above the list filter it; Direction marks a box as export. The hourly sync keeps the list current; Refresh counts again now.

The Free time tab: the free time list with a box at status OK, last free day Wed 18 Nov, 3 days left, and its details: the terms used and how the date was counted
The Free time tab: every box with its last free day and days left.

The same values are fields on each container, so they work in reports, list views and your own Flows. The Overview tab has a Free time card and the dashboard a tile for boxes in charges or due soon.

One box is different? On the container page, open the Free time card ▸ Terms for this box: free days for this box, extra free days you were granted, import or export, and a discharge, gate-out or empty return date when the carrier's is wrong or missing.

The Free time card on a container page: combined D&D, your free days for Evergreen 7 calendar days, last free day Wed 18 Nov, 3 days left, and the Terms for this box form
The Free time card on a container, with the terms for this box.

Morning alerts: on days with news, Container Tracker emails about 07:00: a warning before a box's last free day, and on Mondays the week ahead. On the Free time tab ▸ Morning alerts, admins switch the email and Slack (when connected) on or off and choose who gets the email under Send to: up to 5 addresses, each confirmed by a link first. Until one is confirmed, the email goes to the address that got the API key. "Today" is counted in the time zone set on the Setup tab (your org's default time zone unless you change it).

The numbers are an estimate from your terms and the carrier's events: the carrier's or terminal's invoice is what you pay. Your free days are kept in Container Tracker, not in your org; the containers keep only the result. D&D tariffs and contracts with rates are not in the Salesforce package yet (they are in Google Sheets on paid plans).

9. Reports and the dashboard

The Container Tracker report folder and dashboard come with the package: arrivals this and next week, ETA moved, containers waiting 7+ days after discharge, sync problems, and active containers by status, carrier and port of discharge, and boxes in charges or due soon. The dashboard is on the Overview tab. To build your own, use the report types Containers and Containers with Events.

10. Slack alerts

  1. On the Container Tracker Setup tab, under Slack alerts, click Connect Slack (Container Tracker Admin only).
  2. Slack opens in a new tab: pick the channel and click Allow. Back in Salesforce, click Refresh.
  3. Choose what gets posted: milestones, ETA changes of a day or more, and containers that stop updating. Send test posts a test message.

Container Tracker checks every 15 minutes and posts only to that channel; it can't read your Slack messages. Open in CTMS in a message opens the Container Tracker app in your org.

11. Field history and the log

The Related tab of a container: the list of its events and the Container History list with ETA and status changes
The Related tab: stored events and the container's field history.

12. Updates

When a new version is out, the Setup tab and the Containers component show a banner with the install link. Install it the same way (Install for Admins Only). Your data stays, and you can skip versions.

13. Plans

14. Your data

The package sends only container numbers and carriers (to track them), events you add by hand, and your API key and org ID (to identify your account). When you connect Slack, it also sends your org's address, so the links in Slack messages open your org. For free time, it sends the free days and box terms you enter, the direction you set, your org's time zone and address (for the morning alerts), your org's name (only for the email that asks a new address to confirm) and the email addresses you add under Send to. No account names, contacts, opportunity data or other org data leave Salesforce. The API key is stored in a Salesforce External Credential, encrypted and never shown again. See the privacy policy (section 1.F) for the details.

Need help?

Email us at support@get-ctms.com. Please include the container number and carrier if your question is about a specific container, and the log number if the Setup tab shows a problem.