Komatsu Komtrax Integration Instructions & Requirements

Tenna Integration instructions for Komatsu.

NOTE: To gain access please visit a local Komatsu Dealer.

💥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 help@tenna.com or call 888.836.6269.

In this article:

Requesting ISO API Credentials

Enabling the Integration within Tenna

Requesting ISO API Credentials

1: Identify the Komatsu/Komtrax administrator on your account.

2: Have your Komtrax Admin send the following email to your Komtrax Distributor, specifically the Training Specialist (if you have a relationship with one).

Email Template

“Hello,

We are looking to get ISO API credentials and access. Can you please create an ISO URL, username/account and password so that we can access the telematics data for our machines.

Thank you,

[Your full name]”

3: Your Komtrax Distributor should then send an email directly to Komatsu on your behalf requesting ISO API Log-in credentials.

4: You should receive an email back from your distributor with your ISO API credentials.

It should include the following:

URL	https://komtraxisoapi.azure-api.net/provider/v1/XXXXX/Fleet/1
Account	XXXXXX_XXXXXXXX
Password	XXXXXXXXXXXXXXXX

5: If your Komtrax Distributor is unable to assist with obtaining the AEMP API credentials, send the same email to Komtrax@komatsuna.com.

This is the general support email for Komtrax. They will route it to their API team, but it may take a few days.

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 "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 by Komtrax and click "Sync".

NOTE: Your account can be found within the URL you received: https://komtraxisoapi.azure-api.net/provider/v1/XXXXX/Fleet/1

5: If this is your first integration setup, a disclaimer acceptance window will pop up. Please review and click "Accept".

NOTE: 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.

7: Next, you will need to manually sync the OEM's asset to a Tenna Asset by selecting "Fix Issues".

8: Selecting the "Manage" button will allow you to view all synced assets and remove an asset's association to the OEM.

NOTE: If an asset is disassociated from an OEM integration and later reassociated, the system will record the next OEM data sync as an Initial OEM Sync. The user shown with the initial OEM Sync is the user who reassociated or remapped the asset to the OEM integration. This is expected behavior, even if the asset was previously associated with the same OEM integration.

NOTE: Please contact Tenna Customer Success at (833) 50-TENNA with any questions or for troubleshooting.

Komatsu Komtrax Integration Instructions & Requirements

Requesting ISO API Credentials

Identify the Komatsu/Komtrax administrator on your account.

Have your Komtrax Admin send the following email to your Komtrax Distributor, specifically the Training Specialist (if you have a relationship with one).

Your Komtrax Distributor should then send an email directly to Komatsu on your behalf requesting ISO API Log-in credentials.

You should receive an email back from your distributor with your ISO API credentials.

If your Komtrax Distributor is unable to assist with obtaining the AEMP API credentials, send the same email to Komtrax@komatsuna.com.

Enabling the Integration within Tenna

Click "Settings" on the top right.

Click on the "Integrations" tab.

Select "OEM" from the Integrations landing page.

Enter the ISO API credentials provided by Komtrax and click "Sync".

If this is your first integration setup, a disclaimer acceptance window will pop up. Please review and click "Accept".

If the integration connects successfully, "Connection Online" will be shown on the screen.

Next, you will need to manually sync the OEM's asset to a Tenna Asset by selecting "Fix Issues".

Selecting the "Manage" button will allow you to view all synced assets and remove an asset's association to the OEM.