MacroPoint - Shipment Load Tracking

Table of Content

• Integration Source Setup
  • Additional Features Setup
• Initiating Tracking

  • Track By Driver's Cell

  • Track by ELD

• Automated Shipment Tracking
• Tracking Status Updates
• Schedule Updates and Delay Alerts
• Tracking Problem Alerts
• Driver Comments
• Live Map Link
• Location History Time Zones
• Tracking Duration
• Multi-Stop Shipments
• Tracking Ends Automatically on Delivery
• Cancellation Workflow
• Cold Chain Temperature Tracking
• Company Loadboard and Shipment Search Tracking
• Common Questions
• If Tracking Isn't Working

Integration Source Setup

MacroPoint will provide API credentials that are specific to the TMS. 

• Username
• Password
• Source Settings
  • MacroPointID = MPID provided by MacroPoint
  • StaffID (Required) = Staff ID used to process Rate Quote sheet attachment. Note that when a driver advances a shipment to In Transit from Committed, the system will attach the rate quote sheet to the shipment. The staff ID is required in order to process the document and attach it to the shipment. 
• Optional ELD Source Settings (see below for ELD info)
• If SFTP source settings are added, you need to enter the PartnerStatus source setting as well. 
  
  • PartnerStatus = true
  • FTPUserName
  • FTPPassword

Back to Top

Additional Features Setup

• SendCustomerName =true/false
  •  This source setting enables the broker to transmit the customer name to MacroPoint.
• GeofenceInMiles = number
  • The arrival radius, in miles, that MacroPoint uses to decide the driver has reached a stop.
  • It is sent for every stop on the shipment, including middle stops, not just the origin and destination.
• ShipperReferenceNumber = true/false
  • Default is false.
  • When true, this sends the shipper reference number in notifications. 
• CustomerPONumber = true/false
  • Default is false.  
  • When true, sends customer PO number in notifications. 
• EmailCopiesOfUpdatesTo = true/false
  • When true, sends customer staff email copies of updates
• PartnerMPID = value (partnerMPID provided by MacroPoint)
  • If set, this will send as 2nd notification in array, along with information about driver track frequency. 
  • This is used primarily to update a second system with updates that the TMS receives. 
• StopSequencingRequired when set to true, for multi-stop shipments, stops will be submitted and completed in the exact planned order. The geofence will only trigger if each stop is reached in sequence; out-of-order stops will prevent geofencing events from initiating.
  • Default is true: if you do not add this setting, stops are sent as required in sequence. Only the value false turns it off.
  • For new integrations, we recommend setting it to false unless MacroPoint instructs otherwise.

• StartTrackHoursOffset = value (positive or negative number of hours, between -24 and 24; values outside that range are ignored)

  • This is used to offset when the tracking can begin in MacroPoint's mobile app
    • For example, if the value is set to "-24", this will still submit the actual pickup time (or appointment pickup time if available) but will change the Tracking Start time to minus 24 hours.
• DelayedArrivalInMinutes = a whole number from 1 to 120
  • The delayed-arrival allowance, in minutes, sent to MacroPoint with the tracking request. MacroPoint uses it when deciding whether the driver is arriving late.
  •  If you don't add this setting, it isn't sent and MacroPoint uses its own default. 
• MaximumAllowableDrivingHoursPerDay = a whole number from 1 to 24
  • The number of hours a driver can drive in a day. MacroPoint uses it to work out ETAs and whether the driver is behind schedule.
  •  If you don't add this setting, it isn't sent and MacroPoint uses its own default. 
• MaximumTrackDurationInHours = a whole number from 1 to 168
  • The longest MacroPoint will track a load, in hours. See Tracking Duration.

Back to Top

Initiating Tracking

Truckload shipment load tracking can be initiated in 3 different sections of the TMS. 

• Shipment Detail --> Location History
• Company LoadBoard
• Update Status Modal
  
  

Appointment Details

• Appointments will use a waterfall effect with the date / time
  •  Pickup Appointment Date, Start Time, End Time are sent first, if they don't exist, then Pickup Ready Date Time
  • Delivery Appointment Date, Start Time, End Time are sent first, if they don't exist, then Delivery Estimated Date, Ready Time, Close Time
• A start and end time are sent for every stop, including middle stops. The appointment start and end are used when they are set; otherwise the stop's ready and close times. If a stop has no close time, only the start time is sent.
• Times are converted from each stop's own time zone, including stops in Canada.

What else is sent for each stop

• Stop name: the stop's company name. If the company name is blank, the stop is sent as its city and state (for example "Louisville, KY"), and if there is no city either, as "Stop 2 - Pickup" or "Stop 2 - Delivery".
• Address, including the country.
• Carrier DOT number and SCAC, when the carrier has them, so MacroPoint can identify the carrier.

If MacroPoint accepts the tracking request but returns a warning, the warning is written to the shipment's Activity Log. If MacroPoint ignored the stops it was sent, a Load Track Exception alert is also raised. See Tracking Problem Alerts.

Back to Top

Track By Driver's Cell

A driver's cell number is required in order to track. 

• Select the MacroPoint Shipment Tracker
• Ensure the Driver Cell has been entered
• Select the frequency in the "Update Every" dropdown

Note: How long tracking stays open is based on the last drop's appointment or delivery date. See Tracking Duration.

Back to Top

Track by ELD

In order to track by ELD, MacroPoint needs to know the carriers in your network (LSP Broker Carriers). The carrier list is submitted every 15 minutes with MacroPoint. To communicate the list to them, MacroPoint will need to issue FTP Credentials, which will need to be added to the source settings (see above). 

To track by ELD, when the MacroPoint Shipment Tracker is selected in the UI, behind the scenes, we will call MacroPoint to check what tracking methods are available. MacroPoint will return the following: 

• ELD = Truck Number
• Trailer GPS = Trailer Number
• Telematics = Both

If one of the above is returned, the TMS will open up those data elements so that they can be input. The data will be transmitted to MacroPoint where it is validated and the tracking is started. 

Back to Top

Automated Shipment Tracking

To make tracking easier, you can choose MacroPoint as your default shipment tracking option. With this feature enabled, the app will automatically send a tracking request as soon as the shipment status changes to Dispatched or In Transit.

To learn how to enable this option, click HERE.

Automated Tracking Settings

• The following source settings will ONLY work if the organization has this tracking integration selected within its Driver Tracking module. You can add source settings to the integration to let the system know when you want to receive updates and whether you require the consignee's signature and a POD image.

• Source Settings

  • DriverTrackFrequency: Default is Four Hours

    It can be any of the below:

    TenMinutes or 10

    TwentyMinutes or 20

    ThirtyMinutes or 30

    FourtyFiveMinutes or 45

    OneHour or 60

    TwoHours or 120, 

    FourHours or 240

    SixHours or 360

    EightHours or 480

    TwevleHours or 720

• RequirePODImage: true or false. Default is true

• RequireSignature: true or false. Default is true

Back to Top

Tracking Status Updates

MacroPoint will provide four event codes in the received callbacks. Tai TMS is mapped to them as follows:

X3 = Arrived at Pickup → This will trigger the On Hand Origin Alert

AF = Departed from Pickup → This will clear the On Hand Origin Alert and update shipment status to In Transit
X1 = Arrived at Dropoff → This will trigger the On Hand Destination Alert

D1 = Departed from Dropoff → This will clear the On Hand Destination Alert. When it is the shipment's last drop, the shipment status is updated to Delivered and tracking ends (see Tracking Ends Automatically on Delivery). Departing a middle drop records the departure on that stop and leaves the shipment In Transit.

How events are applied:

• Each arrival and departure is recorded on the stop MacroPoint names, including middle stops.
• The shipment status only moves forward. An event that arrives late or out of order never moves the shipment back (for example, from In Transit to Dispatched), and a shipment is only set to Delivered after a departure from the last drop.
•  Each arrival and departure is noted in the Activity Log with who reported it (Driver, Carrier, Customer or MacroPoint) and, when MacroPoint sends one, its confirmation status, for example "Actual Pickup Arrival Date set to 11/3/2026 4:47:08 PM via Driver." A time that's already recorded on the stop is never overwritten.
• An event for a stop that isn't on the shipment is written to the Activity Log and not applied.

Shipment Location History - Verbose messages titled "MacroPoint Schedule Update" will be logged in the Shipment Location History modal. These will include messages such as the "ETA to Pickup", "ETA to Destination", and "ETA to stop" followed by the stop name when MacroPoint is reporting on a middle stop. See Schedule Updates and Delay Alerts.

Back to Top

Schedule Updates and Delay Alerts

MacroPoint sends schedule updates that say whether the driver is on time for the next stop. Each update is written to the shipment's Activity Log and Location History as a "MacroPoint Schedule Update" with the status, the miles to the stop and the ETA. Each update also raises or clears three shipment alerts:

• Behind Schedule: MacroPoint reports the driver is behind schedule for the stop, by any amount.
• Cannot Make It: MacroPoint reports the driver cannot make the stop on time.
• Past Appointment Time: MacroPoint reports the driver has missed the appointment time.

How the alerts clear

• An On Time update clears all three.
• A Behind update clears Cannot Make It and Past Appointment Time.
• A Cannot Make It update clears Past Appointment Time.
• More than one alert can be open at once. If a driver goes from Behind to Cannot Make It, the shipment shows both until an On Time or Behind update arrives.
• You can also resolve any of them yourself from the shipment's Alerts panel.

Example: A three-stop load is heading to its second stop. MacroPoint reports the driver is behind, so the shipment shows Behind Schedule for that stop. An hour later MacroPoint reports the driver can't make the appointment, and Cannot Make It is added. You call the receiver and move the appointment. When MacroPoint reports On Time, both alerts clear. The driver departs the last drop, the shipment moves to Delivered and tracking completes on its own. 

How updates are matched to the shipment

• Each update applies to the stop MacroPoint names, including middle stops, and the alert note names that stop.
• When the update includes the distance to the stop, Remaining Miles to Destination is refreshed on Company Loadboard and Shipment Search.

By default these three alerts are for your team only and are not shown in the Customer Portal. To show one to your customers, go to LSP > Shipment Alerts, find the alert and turn on Display In FrontOffice. These are Tai-provided (Master) alerts, so click Copy Reference Setting, turn the setting on and click Save. This saves your organization's own copy of the alert, which you can change later with Edit Alert. To set up automatic notifications for them, see the workflow automation article.

Back to Top

Tracking Problem Alerts

MacroPoint also tells the TMS when it cannot track a load, and when the tracking data looks suspicious. The TMS turns those messages into shipment alerts so your team sees the problem on the shipment. Each alert is raised only once while it is open. Repeat messages from MacroPoint don't create duplicates.

Load Track Exception

• Raised when MacroPoint reports it cannot track the load with the details it was given. Examples include an incompatible phone, an invalid truck or trailer number, an invalid bill of lading, PRO, air waybill or container ID, or an unsupported carrier.
•  Also raised when MacroPoint accepts the tracking request but ignores the stops it was sent. Other warnings are written to the Activity Log only.
• The reason MacroPoint gave is shown as the latest tracking update in Shipment Detail > Location History.
• The tracking is not cancelled. It stays active on the shipment, so you don't need to start it again just because this alert appeared.
• We recommend contacting the carrier as soon as you see this alert: until it is fixed, you are not getting location updates for the load.

Possible Fraud Detected

• Raised when MacroPoint flags the tracking session as a potential risk of fraudulent data. The alert shows as a red icon on the shipment.
• MacroPoint's advice is to contact your carrier directly and verify the status of the shipment before relying on the tracking data.
• By default this alert is for your team only and is not shown in the Customer Portal. You can change that in LSP > Shipment Alerts: click Copy Reference Setting on the alert, turn on Display In FrontOffice and save.
• Your team can also add this alert to a shipment by hand from the Alerts panel. 

Back to Top

Driver Comments

When the driver sends a message through the MacroPoint app, it is added to the shipment's Activity Log as a private note that starts with "Driver Comment via MacroPoint:". Private notes are for your team and are not shown to your customer.

Back to Top

Live Map Link

When tracking starts, the TMS saves MacroPoint's live map link for the load in two shipment reference numbers: Third Party Tracking Link and Third Party Tracking Link Public.

• To open the map, go to Shipment Detail > Location History and click Open Live Map, to the right of Cancel Tracking. The button shows while the MacroPoint tracking is active.
• To share the map with your customer, go to LSP > Shipment Reference Numbers, find Third Party Tracking Link Public and click Copy Reference Setting. Turn on Display In: Front Office and click Save. Your customer then sees an Open link button on the shipment in the Customer Portal.
• If MacroPoint sends a new link for the load, both references are updated.
• When you cancel tracking, both links and the Open Live Map button are removed. If MacroPoint ends the tracking on its side, the links stay.
• Links from other tracking providers in these references are left as they are.

Back to Top

Location History Time Zones

For more visibility on tracking times, you can view the location update in your local time or the location's local time using the toggle in location history.

Back to Top

Tracking Duration

Tracking stays open until 72 hours after the last drop's delivery time. The delivery appointment is used when there is one; otherwise the estimated delivery date and time. If there is no delivery date at all, the track lasts 72 hours. We recommend always entering a delivery appointment or estimated delivery date so tracking doesn't fall back to the 72-hour default.

To put a ceiling on how long any load is tracked, add the MaximumTrackDurationInHours source setting (1 to 168 hours). The track then lasts the shorter of the two: the ceiling, or the time to delivery plus 72 hours. Values above 168 are refused when you save the integration source.

Back to Top

Multi-Stop Shipments

Multiple stop shipments are supported in the integration and are passed into MacroPoint with the tracking request.

Each stop is sent to MacroPoint with its own stop type, so MacroPoint knows what happens at every stop:

• Pick stops are sent as pickups.
• Drop and Both stops are sent as drop-offs.
• Every stop carries your GeofenceInMiles arrival radius, if you have set one.

As the driver reaches each stop, the TMS records the actual arrival and departure dates and times on that stop (for drop stops, the proof of delivery (POD) arrival and departure dates and times). Arriving at a middle stop raises On Hand Origin (pickups) or On Hand Destination (drop-offs), and departing clears it. Schedule updates and delay alerts are matched to the stop MacroPoint names. The shipment only moves to Delivered when the driver departs the last drop.

We recommend giving every stop a company name before you start tracking, so the driver and MacroPoint see a recognizable stop name. A stop with no company name is sent as its city and state.

Back to Top

Tracking Ends Automatically on Delivery

When a tracked shipment is set to Delivered, the TMS stops the MacroPoint order and marks the tracking Completed, so the load stops being tracked. You don't need to cancel tracking yourself.

• This happens when the driver departs the last drop, and when you set the shipment to Delivered yourself.
• The last drop needs a POD arrival or departure date and time. If you set Delivered without either, tracking stays active until you enter one, and then it completes.
• The Activity Log reads "Tracking has been completed because the shipment was delivered." and Location History reads "Tracking has been completed for this shipment."
• Once tracking is completed, later messages from MacroPoint for that load don't change the shipment: no stop times, notes, alerts or status changes.
• Departing a middle drop does not end tracking.

Back to Top

Cancellation Workflow

To cancel tracking, access the shipment's location history section under the shipment profile and click on "Cancel Tracking."

Back to Top

Cold Chain Temperature Tracking

The Cold Chain Temperature Tracking integration enables real-time monitoring of temperature-sensitive shipments.

• Reference Numbers for Tracking:

  • Desired Temperature – The target temperature for the shipment.

  • Min Temperature – The lowest allowable temperature before an alert is triggered.

  • Max Temperature – The highest allowable temperature before an alert is triggered.

Workflow

Once the temperature settings are configured and tracking is active, MacroPoint reports with each location update whether the trailer temperature is above, below or within range. The TMS keeps one temperature alert open at a time:

• Above Temperature Threshold when the reading rises above the maximum.
• Below Temperature Threshold when the reading falls below the minimum.
• In Temperature Threshold when the reading is back within range.

When a new temperature alert is raised, the other two are resolved automatically, so the shipment always shows the current state. If MacroPoint cannot determine the temperature, no alert changes.

Company Loadboard and Shipment Search Tracking

You can enable two optional fields on both the Company Loadboard and Shipment Search pages to improve shipment tracking visibility:

• Last Known Location
  Displays the most recent location update reported by MacroPoint for the shipment.

• Remaining Miles to Destination
  Shows the estimated distance remaining to the shipment’s final destination, based on the latest MacroPoint tracking data.

These fields update automatically as new tracking data is received.

Back to Top

Common Questions

Why don't late MacroPoint loads raise Shipment Delayed any more?

MacroPoint schedule updates now raise Behind Schedule, Cannot Make It and Past Appointment Time instead. Update any workflow automations or reports that watched Shipment Delayed for MacroPoint loads. See Schedule Updates and Delay Alerts.

Why is the Start Tracking button greyed out?

Enter the driver's cell number, then click outside the field or press Tab. The button enables once the number is accepted.

Does my customer see the MacroPoint alerts?

Not by default. Behind Schedule, Cannot Make It, Past Appointment Time and Possible Fraud Detected are for your team only. You can show any of them in the Customer Portal: go to LSP > Shipment Alerts, click Copy Reference Setting on the alert (or Edit Alert if your organization already has its own copy), turn on Display In FrontOffice and save. To share live tracking with your customer, you can also use the live map link.

How do I share the live map with my customer?

To share the map with your customer, go to LSP > Shipment Reference Numbers, find Third Party Tracking Link Public and click Copy Reference Setting. Turn on Display In: Front Office and click Save. Your customer then sees an Open link button on the shipment in the Customer Portal. 

Do I need to cancel tracking after the load delivers?

No. Tracking completes on its own when the shipment is set to Delivered and the last drop has a POD arrival or departure time. See Tracking Ends Automatically on Delivery.

Why does Cancel Tracking still show after tracking completed?

Cancel Tracking shows for every tracking record, including completed ones. You don't need to click it once tracking is completed.

Back to Top

If Tracking Isn't Working

• The integration source won't save: check that StaffID is set, and that DelayedArrivalInMinutes, MaximumAllowableDrivingHoursPerDay and MaximumTrackDurationInHours are within their ranges.
• You see a Load Track Exception: read the reason in Shipment Detail > Location History and contact the carrier to correct the phone, truck, trailer or reference details.
• No updates are arriving: open Location History and check that the MacroPoint tracking is active and that the driver has accepted tracking in the MacroPoint app.
• Still stuck? Contact Tai Support with the shipment ID and what you expected to see.

Back to Top

Applies to: Tai TMS Back Office, MacroPoint integration · Last updated: 2026-10-30