ClearPath GPS Integration

ClearPath GPS is an API integration and includes the following features:

Integration Feature Included
Fuel exception
Odometer
Faults / Diagnostic Trouble Codes (DTC)

A ClearPathGPS Pro Edition subscription is required. Please contact your ClearPathGPS Sales Representative for more information.


ClearPathGPS Tech support is happy to help undertake these configuration steps.
Just email or call for assistance!

What does this integration do?

  • Odometer : ClearPathGPS updates Fleetio's odometer reading every time the ignition is turned off.
  • Faults / Diagnostic Trouble Codes (DTC): these codes are automatically added to Fleetio. [Requires diagnostic capable ClearPathGPS vehicle tracker].
  • Fueling Location: ClearPathGPS automatically adds the vehicle's location to Fleetio fueling events

Steps 1, 2 & 3 are performed in Fleetio by the Account Owner

Step 1) 
API Keys:

  • The Account Owner creates an API Key. In Fleetio, click "Your Name" > API Keys > New API Key and name it ClearPathGPS.
  • Copy and paste the API Key and Account Token, you will need these in Steps 5, 6 & 7


Step 2) Create External Vehicle ID

  • In Fleetio :
    • Click "Settings"
    • Click "External Vehicle IDs"
    • Click "+ Add External Vehicle ID".
      • Label : ClearPathGPS
      • Description: ClearPathGPS Vehicle ID


Step 3) Link Fleetio Vehicles to ClearPathGPS

  • On the "External Vehicle IDs" screen, click the menu button to the right of "clearpathgps"
  • Select Assign Vehicles
  • Locate the "Vehicle ID's" for your fleet on the ClearPathGPS Admin > Vehicle Admin page. The "id" begins with "cp" and then a six digit number. Keep this information open and proceed to...
  • Enter the cp #from ClearPathGPS) and assign them to your vehicles
  • After entering each cp # click the blue check mark.  It will turn green if the update is successful.

Step 4) Setup - ClearPathGPS - Add Fleetio Vehicle Group

In ClearPathGPS Add a Vehicle Group called "Fleetio".

  • Administration > Group Admin at the bottom of the screen in the "Group ID" box type "Fleetio", click "New"
  • Click "Edit"
  • Name the Group "Fleetio"


Assign Vehicle(s) to the Group "Fleetio"

  • Administration > Vehicle Admin
  • Select the vehicle to add to the "Fleetio" Group
  • Click Edit
  • Check the "Fleetio" Group
  • Click Save

Step 5) Setup - ClearPathGPS - Odometer

  • Create a rule (Administration > Rule Admin)
    • The rule must be named x-api-fleetio-odo
  • Edit the rule with the following settings:
    • Notification Email : <Leave Blank>
    • System Rule : n/a
    • Active : Yes
    • Cron Rule : No
    • Description : Fleetio Integration - Odometer
    • Rule Selector : $InGroup("fleetio")
    • Trigger Action : Check Only "Queue"
    • Minimum Interval : 0 Seconds
    • Interval Reset : Yes
    • Predefined Actions : <Leave Blank>
    • EMail Subject : <Leave Blank>
    • EMail Message:

{
  "apiAuth":"API KEY PROVIDED BY Fleetio",
  "apiToken":"API TOKEN PROVIDED BY Fleetio",
  "odo":"${odometer}"
}

  • SMS Message : <Leave Blank>
  • Vehicle ID: All Vehicles
  • Status Code: [0xF403] Ignition_Off


Remember :

  • Notifications must be enabled for the rule to send the vehicle's odometer to Fleetio.  Check the setting : Admin->Vehicle Admin->Select Vehicle->Edit->Notfiy Enable (Yes)

Step 6) Setup - ClearPathGPS - DTC Codes

  • Create a rule (Administration -> Rule Admin)
    • The rule must be named : x-api-fleetio-dtc
  • Edit the rule with the following settings:
    • Notification Email : <Leave Blank>
    • System Rule : n/a
    • Active : Yes
    • Cron Rule : No
    • Description : Fleetio Integration - DTC
    • Rule Selector : $InGroup("fleetio")
    • Trigger Action : Check Only "Queue"
    • Minimum Interval : 0 Seconds
    • Interval Reset : Yes
    • Predefined Actions : <Leave Blank>
    • EMail Subject : <Leave Blank>
    • EMail Message:

{
  "apiAuth":"API KEY PROVIDED BY Fleetio",
  "apiToken":"API TOKEN PROVIDED BY Fleetio",
  "faultCodes":"${faultCodes}"
}

  • SMS Message : <Leave Blank>
  • Vehicle ID: All Vehicles
  • Status Code: [0xF911] OBDI_Fault

Step 7) Setup - ClearPathGPS - Add Geolocation to Fueling Events

  • Create a rule (Administration -> Rule Admin)
    • The rule must be named : x-api-fleetio-fuel
  • Edit the rule with the following settings:
    • Notification Email : <Leave Blank>
    • System Rule : n/a
    • Active : Yes
    • Cron Rule : Daily
    • Description : Fleetio - Fueling Location Updates
    • Rule Selector : $InGroup("fleetio")
    • Trigger Action : Check Only "Queue"
    • Minimum Interval : 0 Seconds
    • Interval Reset : Yes
    • Predefined Actions : <Leave Blank>
    • EMail Subject : <Leave Blank>
    • EMail Message:

{
  "apiAuth":"API KEY PROVIDED BY Fleetio",
  "apiToken":"API TOKEN PROVIDED BY Fleetio"
}

  • SMS Message : <Leave Blank>
  • Vehicle ID: All Vehicles
  • Status Code: All Codes

Still need help? Contact Us Contact Us