menu
close_24px
Getting Started

Tracking Statuses

Understand how to optimize tracking performance and success with MacroPoint's tracking statuses. This section will review all critical tracking statuses, what they mean for you, & how you can best troubleshoot your tracking.

Ready To Track

Future Shipment, Ready To Go

Ready To Track indicates the shipment is assigned with a trackable ID and ready to start tracking based on the time set up by the customer. The Start Tracking time can be found in the Control Tower under Load Details.

App Tracking - Ready To Track indicates the driver has the MacroPoint For Truckers app installed. 

Telematics (ELD/GPS) Tracking - Ready To Track indicates the shipment is assigned with a trackable truck or trailer number.

TMS Tracking - Ready To Track indicates the carrier has sent in the first ping on the shipment, assigning the Tracking Request with their Load ID. The order is now ready to accept more inbound data from the carrier.

LTL Tracking - Ready To Track indicates the shipment is assigned with a valid LTL PRO number.

Ocean Tracking - Ready To Track indicates the shipment is assigned with a valid container & BOL number.


Tracking Now

Shipment Actively Tracking

Tracking Now simply indicates MacroPoint is receiving data on the shipment. Tracking will commence when the driver departs the final stop or the the tracking duration on the shipment expires, whichever occurs first. 

Tracking Now

Tracking Completed Successfully

Data Received, Shipment Concluded

Tracking Completed Successfully indicates the tracking sessions has finished. Shipments conclude either by the driver departing the final stop or the tracking duration expiring, whichever occurs first, and data was received on the shipment. Data includes any of the following: an in-transit ping, an arrival or departure, or an additional status messages (LTL or Ocean).

Tracking Now (2)

Unassigned Tracking Requests

Tracking Identifier Missing

Unassigned Tracking Requests are orders missing the tracking ID to obtain location data. A tracking ID can be a phone number, truck number, trailer number, LTL PRO number, or Carrier Load ID if the carrier is connected via TMS. 

Troubleshooting:

Navigate to the shipment in Control Tower. Under the 'Tracking Assignment' column, click the red 'Assign Now' button.

A window will appear enabling users to input a cell phone and any other identifiers supported by the carrier.

Example: Telematics carriers - Truck Number will display, LTL Carriers - PRO Number will display, etc.

Click 'Ok', the Tracking Request is now assigned and the Load Status will update.

For TMS connected carriers, a Load Number will display in the dropdown. It is best practice to not input an ID for these shipments as the TMS connection will automatically fulfill the unassigned tracking request when the carrier has data available. 


Tracking - Waiting For Update

Data Feed Disrupted

Tracking - Waiting For Update is a catch all status, regardless of tracking method, when tracking is initiated but in-transit ping frequency is not consistent with customer's requirement on the shipment. Once MacroPoint starts receiving tracking data again on the load, the status will change to Tracking Now.

App Shipments - Driver has the mobile app installed but data is not being returned. This is often due to the driver not configuring Location Services to 'Always Allow' for the MacroPoint For Truckers app. If the driver does not have Location Services set to Always Allow, they would be required to have the MacroPoint For Truckers app open on their phone for data to be accessible. 

Drivers with their phone turned off or in an area with no service will also cause shipments to go into a Tracking - Waiting For Update status.

Telematics (ELD/GPS) Shipments - Telematics shipments will fall into a Tracking - Waiting For Update status if the truck/trailer number is valid but no new data is available from the carrier's telematics provider. MacroPoint will ping the telematics provider's API with the truck/trailer ID supplied by the customer on the frequency set in the order. If the only data point available is the exact same lat/long coordinates and time stamp of the last ping, MacroPoint will not consume the data and continue pinging until new data is available or the shipment expires.

With both app and telematics shipments, a very common use case is a driver swap but MacroPoint not updated with new truck or cell phone numbers. Either a local driver picks up the shipment and transitions to a long-haul driver or a carrier relays the shipment mid-transit. 

TMS Shipments - TMS shimpents will go into a Tracking - Waiting For Update status if inbound data from the carrier's feed is missing data for the shipment. Once the carrier supplies in-transit data for the shipment, the tracking status will update to Tracking Now.

Troubleshooting:

App Shipments - Confirm the driver's phone is on, has service, & has location services set to 'Always Allow' for the MacroPoint for Truckers app. If all of these are confirmed and data is still not being received, have the driver uninstall and reinstall the mobile app (this is not common).

Telematics (ELD/GPS) Shipments - Confirm with the carrier the truck/trailer assigned to the shipment is accurate. If not, update assignment in the Control Tower. If the truck/trailer number is correct, confirm with the carrier the driver is moving. Often telematics units will not generate new data if the vehicle has not been started from it's previous shipment. 

TMS Shipments - Confirm with the carrier they have real-time data stored in their TMS/dispatch system for the shipment in question. If not, immediately change the shipment to cell phone or telematics tracking. If the carrier does have real-time data stored in their system, have the carrier confirm they're sending data to MacroPoint on the frequency set on the load and are referencing the correct Load ID.

Tracking Now (1)

Expired Scenarios

Any load in an expired status cannot be troubleshot. The tracking duration has concluded and the session expired. 

Expired Location Hidden By Driver

Pausing Location

Drivers have the right to pause tracking within the MacroPoint For Truckers app. Loads ending in this status indicate the driver had the app installed on their phone but paused it for the duration of the shipment. 

Drivers must pause location on a load-by-load basis.

Expired Without Installation

App Not Installed

The driver on the shipment refused to install the MacroPoint For Truckers mobile app.

To avoid on future shipments, MacroPoint's Text To Share feature allows drivers to share location without downloading the MacroPoint for Truckers app. For more information on this feature click here: Text to Share

Expired Without Location

Data Unattainable

The tracking duration expired before MacroPoint was able to obtain tracking data from the device.

App Loads - Typically due to drivers not having location services enabled to 'Always Allow'. 

Telematics Loads - No new data was available on the telematics provider's API. Typically a different truck hauled the load or the carrier did not haul it within the date range configured by the customer.

Expired Location Hidden By Driver

Connection Issue

The tracking duration expired without the driver enabling the app correctly. Mainly this is due to either location services not enabled to 'Always Allow', GPS on the device is disabled, or simply the phone is turned off.


Incompatible Phone

Non-Smart Phone Number Assigned

Incompatible Phone indicates the phone number assigned to the shipment is not a device which allows app installs. This may be a flip phone, landline, fax number, etc.

Troubleshooting:

Confirm with the carrier phone number is an actual mobile number. If it is, confirm it's a smart phone. If it is not a smart phone, MacroPoint's Text To Share feature allows drivers to share location without downloading the MacroPoint for Truckers app if they a web browser on their device. For more information on this feature click here: Text To Share

If the phone number is a non-mobile number, update the shipment with the correct phone number of the driver. Simply click 'Update Assignment' under the Tracking Assignment column of the Control Tower and input the new phone number of the driver.


Invalid Truck/Trailer Number

Untrackable Identifier Supplied

Invalid Truck or Trailer Number indicates the truck/trailer number assigned on the order is not recognized as valid ID for the carrier. 

MacroPoint does not store truck lists for each carrier. Instead MacroPoint validates carrier truck/trailer IDs in real-time on individual orders against the telematics (ELD/GPS) provider's API.

Troubleshooting:

Confirm with the carrier the identifier supplied is correct and validate the exact format they have configured with their telematics provider. A common issue is a carrier having leading digits or a name before the ID (ex: T-123 or Bobby-987).

To edit a tracking session with a new ID, click the 'Update Assignment' button under the Tracking Assignment column in Control Tower. A window will populate allowing users to edit truck/trailer numbers or swap the tracking method from telematics to app if desired.

If truck number format is accurate, confirm with the carrier which brand of telematics is installed on the truck. Some carriers utilizes multiple telematics providers across their fleet but may only have one connected with MacroPoint. To view which provider is connected to MacroPoint, click the 'Update Assignment' button in Control Tower and the telematics provider will be listed in the drop down. If the carrier's telematics provider is not listed, instruct the carrier connect their other provider through MacroPoint's Self-Service portal: Carrier Self-Service.

MacroPoint offers a Good Truck List & API feature empowering customers to collect and maintain current truck lists of validated trackable IDs for each carrier. To learn more, reach out to your Customer Success rep or email servicedesk@descartres.com


Requesting App Install

App Download Required 

Requesting App Install indicates the driver does not have the MacroPoint for Truckers mobile app installed on their device. 

The driver will receive two proactive texts automatically from MacroPoint if the app not installed. The first text is sent at the moment of order creation by the customer, regardless of how far into the future the Track Start time is set. The second text is sent to the driver if the app is still not installed 1 hour prior to the track start time. 

Text messages to drivers include a link to either the Apple App Store or Google Play Store depending on the driver's device. 

Troubleshooting:

MacroPoint allows users to manually send a follow-up text to drivers by clicking the 'Send Text To Driver' button under the Load Status column in Control Tower. Only one manual text per shipment is allowed to prevent text abuse to drivers.

If the phone number assigned to the shipment is incorrect, users can manually change it in the Control Tower by clicking 'Update Assignment' under the Tracking Assignment column. If a carrier has an telematics connection with MacroPoint, users can change the tracking method from app to telematics here as well.

 If all else fails, MacroPoint's Text To Share feature allows drivers to share location without downloading the MacroPoint for Truckers app. For more information on this feature click here: Text To Share

unnamed (1)