If you regularly track containers shipped via drayage, ocean, or rail, you can integrate your Turvo tenant with an existing OpenTrack account to receive live tracking information for your containers.
Important note: This feature is currently a limited release. If you’d like the feature enabled for your tenant to participate in the beta testing, reach out to your Turvo representative.
The OpenTrack integration only provides container tracking for drayage, ocean, and rail shipments if the Service Type is set to Import.
This article describes:
- Enabling the OpenTrack integration
- Setting up carriers for OpenTrack
- Linking a shipment to OpenTrack
- Tracking a shipment with OpenTrack
- Features unique to shipments with drayage route segments
- Held at Customs exception
Enabling the OpenTrack integration
In order to integrate OpenTrack with Turvo, you must have your own OpenTrack account. If you do not have an account, visit the OpenTrack signup page. Once an account is created, a unique Opentrack-API-Key will be generated for you.
Next, reach out to your Turvo representative and provide the key to have the OpenTrack integration enabled.
You will then need to configure your carriers with the correct information to link them to OpenTrack.
Setting up carriers for OpenTrack
The Standard Carrier Alpha Codes (SCAC) of an ocean or rail carrier will be used to match carriers between Turvo and OpenTrack.
Note: Carriers will need to be configured individually with the information OpenTrack requires.
Add a SCAC to the carrier
Add new carriers to Turvo by searching for their SCAC, or add a SCAC when creating a carrier manually.
To add a SCAC to an existing carrier, navigate to Accounts > Carriers in the left navigation bar. Open the carrier’s profile and then click the Details tab. In the General section, select the Profile segment and then the +Add SCAC button.
Fill in the SCAC and then click SAVE at the bottom of the Profile segment.
Add modes to carrier
Once a carrier has been created or updated with a SCAC, you will need to add Drayage, Ocean, and/or Rail as modes that are supported by the carrier. To learn more about adding new modes to a carrier, see our article on Viewing and editing carrier details.
Linking a shipment to OpenTrack
In order for your shipments in Turvo to receive OpenTrack information, you will need to ensure the shipment’s route information has key information fields filled in:
- Carrier with SCAC
- Container #
- Master Bill of Lading (MBOL) number
Note: All shipments you wish to receive OpenTrack information from will need to be configured individually.
In your shipment, open the Details tab and click Route in the Shipment block. Each segment of the shipment’s route will appear when you open Route. There are three sets of fields detailing each route segment, one for the route segment’s shipment details, one for the origin location, and one for the delivery location.
If there are multiple segments with different modes, find the leg of the route that falls under the drayage - import, ocean, or rail mode. In the route segment’s shipment details fields, add the Carrier for the Ocean or Rail route segment. The carrier’s SCAC will appear in parenthesis next to the carrier’s name in the Carrier field and under the Segment IDs field. In the same set of fields, fill in the Container # and MBOL fields.
UN/LOCODE is an optional field that can be added manually to locations on the route segment. If a location associated with a shipment has a UN/LOCODE added to its profile, the field will be filled in automatically. See our article on Managing advanced location details to learn how to add the UN/LOCODE to a location.
Note: This field can be updated manually even after it has synced with OpenTrack.
Last Free Day field
The Last Free Day field in the route segment’s shipment details fields will be automatically filled in once the shipment in Turvo has been synced with OpenTrack. This field provides the last date before the port terminal or rail ramp will start to charge fees for storage (Demurrage).
Tracking a shipment with the OpenTrack integration
Once the integration is enabled and the carrier and shipments are properly configured, the location updates icon will appear indicating the shipment is receiving live updates from OpenTrack.
The location updates icon can be found next to the Port of Origin and delivery locations in the shipment card, as shown in the screenshot below:
Clicking the location updates icon will provide a map that shows the route taken by the shipment.
Additionally, the shipment’s Timeline tab will display updates with OpenTrack as the source.
Features unique to drayage - import shipments using the OpenTrack integration
The Summary and Details tabs for drayage - import shipments using the OpenTrack integration will have some differences from shipments that only have ocean and/or rail route segments.
Drayage import-only shipments
In the Summary tab for shipments that have only a drayage - import route segment (which is the default for drayage shipments), that are synced to OpenTrack will feature the OpenTrack status field in the Summary card, which displays the latest container milestone from OpenTrack and a timestamp for that milestone. Other fields specific to drayage shipments are also present on the Summary card, as detailed in our Drayage Shipment Guide article.
These shipments will also display the OpenTrack status field in the route segment details found in the shipment’s Details tab.
Note: The drayage-specific fields in this section are filled in automatically by the OpenTrack integration, if provided by OpenTrack, but can be updated manually at any time. However, the OpenTrack status field is read-only.
Shipment Details tab
The route segment details section will contain a small section that has the same fields from the OpenTrack card detailed above, as well as the Steamship Line field. The Steamship Line field lists the name and SCAC for the ocean carrier that brought the container to the pickup location. Typically, the first four characters of the MBOL are the SCAC for the ocean carrier. Turvo will automatically enter the SCAC automatically based on this.
Note: The fields in this section are filled in automatically by the OpenTrack integration and are read-only.
Holds categories & types
When using the OpenTrack integration, the Holds categories & types field will automatically populate with the type of hold received from OpenTrack. While using OpenTrack, these fields are read-only, but they can be filled in manually if the shipment is not integrated with OpenTrack.
Shipments with drayage - import and ocean and ocean mode-only segments
For shipments that utilize OpenTrack with both a drayage - import segment and an ocean segment, both segments will have fields for the Container #, MBOL, and ocean carrier’s SCAC. OpenTrack will only track the route segment(s) that have these fields filled in. For example, if these details are only filled in for the ocean segment, OpenTrack will only provide updates for that segment.
Held at Customs exception
When OpenTrack sends a notification to Turvo that an ocean mode-only shipment has a customs hold, a Held at Customs exception will be raised. See our article on Managing exceptions with Workbench to learn more about resolving exceptions.