ClearPath GPS Integration

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

Integration Feature Included
Fuel exception
Odometer

Note: 

  • A ClearPathGPS Pro Edition subscription is required.  Please contact your ClearPathGPS Sales Representative for more information.
  • Please contact your Fleetio Sales Representative for information regarding which Fleetio subscription required for advanced Fleetio features : e.g. DTC Code reporting.

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.
  • DTC Codes : Diagnostic Trouble 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 -> 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