Step-by-step flow to correct the integration
Review the troubleshooting for the error
Update identifier in Tracking tab
Recommendation for best practice
Introduction
When a GPS integration stops working, the first warning usually comes through notifications in Gmail channels, where we can interpret the type of error by following the corresponding troubleshooting article; However, understanding the error is not always enough to fix it in Back Office, so in this article you will find the specific step-by-step instructions you need to follow within the system to correct the configuration and reset automatic tracking.
Step-by-step flow to correct the integration
If your integration is not tracking, we recommend always following this order:
-
Review the troubleshooting for the error
Before accessing the Back Office, open the notification channels and review the error received. This will assist you in understanding the nature of the issue:
- General or specific error?
- Specific unit or entire integration?
- Coverage, credentials, or identifier problem?
If the error is related to a specific unit, then we can proceed to the next step.
-
Check the Tracking tab
- Open the Tracking tab for the affected segment.
- Check that you have entered all the information.
- Check what integration the carrier of that loadhas.
- In the article of How GPS integrations work you can see which element that integration matches (tractor (tractor plates/etc...).
-
Review Integration Report
- Access the GPS report in question.
- Look for the unit that most closely matches the one entered in the Tracking tab (since the most common mistakes are adding an extra letter, missing a hyphen, etc.).
- Once located, we copy it and return to the Tracking tab.
-
Update identifier in Tracking tab
- Now we must enter the data we obtained from the Integrations Report in the correct field within the Tracking tab.
Recommendation for best practice
Once it has been confirmed that the data for a unit is working correctly with the integration, it is good practice to always save and store it in the corresponding carrier's inventory.
This prevents human typing errors, keeps everything organized, and ensures that automatic integration works correctly for future uploads.