OEM Integration: CAT
Setting up and managing your Tenna OEM Integration with CAT 2.0 by Caterpillar.
💥Integrations is a premium product and requires a separate license. Please contact your Account Manager for more information on premium product licenses or reach out to Customer Support at [email protected] or call 888.836.6269.
In this article:
Requesting API Credentials
- 1
- Coordinate with your CAT dealer.
Only your dealer can request API subscriptions for your company.
Pro Tip! Have your CAT UCID handy!
IMPORTANT: Make sure you instruct the dealer that you are requesting the ISO 2.0 API credentials, NOT the Visionlink API.
- 2
- You should receive an email from CAT Digital Support providing your API credentials.
It should be a client and a secret in an attached .txt file:
- client credentials (Ex: fleet_mgmt_cust_XXXXXXXXXX_cc_client)
client secret (64-characters)
(Ex: lvUyxWvnr53siEuR3GCUw6NxpcVB0XGTe9TViBZ66gXulecUYdqlkaR65Z9UuYtz)
CAT may request you download Postman (an API testing tool) and have a meeting with them. This session would just be to test your credentials. You can do this if you like, or Tenna can test them for you if you prefer.
Enabling the Integration within Tenna
NOTE: You must have a Power User identified and set up with a Tenna account to complete the following. If you are unsure who is a Power User in your organization please contact Tenna Customer Success at 888.836.6269. To add a new Power User or modify an existing user, see How to Create Users and Contacts (Desktop).
- 1
- Click on "Settings" on the top right.
- 2
- Click on the "Integrations" tab.
- 3
- Select "OEM" from the Integrations landing page.
- 4
- Enter the ISO API credentials provided and click "Sync".
- 5
- If this is your first integration setup, a disclaimer acceptance window will pop up. Please review and click "Accept".
Important! After a Power User accepts this on the company's behalf, the disclaimer will not be displayed again.
- 6
- If the integration connects successfully, "Connection Online" will be shown on the screen.
Managing your Integration
Map Unmatched Assets
- 1
- Select "Asset Mapping" to view a list of unmatched assets.
Most assets will sync automatically if the PIN in Tenna matches the CAT ID. The Asset Mapping grid will include a list of all CAT assets that did not match a Tenna asset.
- 2
- Enter the PIN or search for the Asset using the Asset Name or Fleet No.
Asset not available for mapping?
Only the following assets can be mapped to CAT:
- Any asset with a TennaCANbus tracker installed that has Secondary Telematics selected as CATERPILLAR
- Any asset that does not have a tracker installed and Telematics set to CATERPILLAR
- 3
- Select "Update" to complete.
Remove an Asset's Association to the OEM
- 1
- Select "Manage" on the integration tile to open the Manage Sync window.
- 2
- To remove an asset from the association with the OEM, select the checkbox under the Remove Association column.
You may select multiple assets at once.
- 3
- Select "Update" to complete.
