Caterpillar VisionLink Integration

Overview

Gearbox integrates with Caterpillar via API each night to retrieve odometer, hour-meter and fuel-usage readings. These readings are used in Gearbox to calculate services due and to track running costs per hour. Automatic readings from telematics are preferred over manual entries due to lower risk of user error. The Caterpillar API feed also ensures consistent and timely capture of readings.

You must have an active Caterpillar (CAT) account with API access and Gearbox administrator privileges to complete the steps below.

Matching logic: Gearbox records are matched to Caterpillar by Serial Number or Equipment ID. Matches are made against the Gearbox Fleet Number or VIN.

Integrating with Caterpillar

1. Click your (1) User icon, then select (2) Integrations, then scroll down until you see Caterpillar, select (3) Setup

   

   2. In the Caterpillar Settings page, select the tickbox (3) Integrate Caterpillar, then (4) Add credentials

   

   3. Fill out the (5) Client ID, (6) Client secret, and (7) Scope

   4. Click on (4) Get Readings - this will pull the data in from the integration.

   5. Once you are finished, you can press (10) Save and close

   

Additional Caterpillar Accounts

If you have multiple Caterpillar accounts, click (9) Save and continue, let the page reload, then select (11) Add credentials - follow the same instructions Step 3. and repeat if necessary.

Get current readings

Hour and odometer readings sync automatically every night. Administrators can also trigger an on-demand update at any time. To refresh immediately, click (12) Get readings.