MTData API Integration

Overview

 

Gearbox integrates with MTData via API every night to retrieve odometer and hourmeter readings. These readings play a crucial role in Gearbox for calculating Services Due and tracking running costs per hour/kilometer. Automatic readings sourced from telematics are preferred over manual entries due to their reduced susceptibility to user error. Furthermore, the API feed from MTData ensures consistent and timely capture of readings.

 

To complete the below steps, you must have an active MTData account with API Access and Gearbox administrative privileges. Please reach out to [e-mail] to request the creation of an account with API Access.

 

Please Note: Gearbox uses vehicle 'Fleet Number', 'Registration' or "VIN" to match Assets in MTData using the 'displayName', 'registration' or 'VIN' fields, Please ensure these are matching within Gearbox and MTData for the integration to work.

 

 

Enabling MTData Telematics Integration

1. Click on your User Icon (1), then click on Settings (2)

MTData API Integration - Admin Dashboard

 

 

2. On the left-hand side of the screen scroll down and click on Integrations (3)

MTData API Integration - Settings

 

 

3. Scroll down until you see MTData Telematics, click Enable Web API (4), enter your Username & Password (5) given by MTData, enter your Fleet ID(s) (6), click Connect Vehicles (7) once completed click Save (8)

MTData API Integration - MTData API Login

 

Refresh Readings

Hour and odometer readings automatically sync every night. Additionally, users have the option to manually trigger an update at any time. Follow these steps to initiate a manual update:

 

1. Click on your User Icon, then click on Settings.

2. On the left-hand side of the screen scroll down and click on Integrations.

3. Scroll down to MTData, click Get Readings, Gearbox will fetch the latest readings from MTData.