Raven Connected Whip Around Integration

Raven Connected now offers an integration with Whip Around for those customers looking to add advanced fleet maintenance. The Whip Around Integration can be enabled by Raven Customers via the Web App. Note that the Whip Around Pro Plan is required.

How to configure the Whip Around integration in your Raven Account

1. Log in to your Whip Around account, open the “Account” Menu, and select “Profile.”
2. Select “API management,” then “Create an integration API key.”
3. Select "Raven Connected," then click "Create." You will require this API Key to configure the integration.
4. Log in to your Raven Connected Web App and select ‘Settings’.
5. Scroll down to ‘Integrations’, then select “Add Credentials” in the Whip Around section.
6. Paste your API Key, and select “Save.”

Configured vehicles with matching VINs, Names, or Raven Serial Numbers in both your Whip Around and Raven Accounts will begin populating GPS Location, DTC, and Odometer values from collected Raven data into your Whip Around dashboard daily.

The Raven Connected Whip Around Integration

The Raven Connected integration with Whip Around relays three data points to Whip Around each morning: last known GPS location, Diagnostic Trouble Codes (DTCs), and the latest odometer, if available.

To establish the link between the two systems, we require the Account Token and a Security Token (API Key) set up on the Whip Around system. Please refer to your Whip Around Account for more details. No other information needs to be shared with Raven Connected.

Vehicle Identification (Matching)

The integration automatically identifies vehicles that are shared between the two systems by attempting the following steps, in order, until a match is found:

1. VIN Match: Raven Connected compares the Vehicle Identification Number (VIN) between the vehicles the Ravens are currently in with the registered vehicles in Whip Around. If there is a match, it uses that vehicle pairing.
2. Name Match: If no match is found via VIN, it then compares an exact match for the vehicle name between Raven and Whip Around. Raven Connected selects the first match, if one is available.
3. Serial Number Match: If no match is found by name, it then compares the Raven serial number with the vehicle names in Whip Around.

Troubleshooting Vehicle Mismatches

If your odometer readings or other data points are not syncing, your vehicles may be mismatched.

1. To verify the VIN:
   1. In Raven, go to Reports > Device Report to verify if the VIN is listed (only if the vehicle's CANBus reports it to Raven).
2. To verify and correct the Name:
   1. In Whip Around, go to Assets > your vehicle > Edit.
   2. In Raven, go to Vehicles > your vehicle and click the pencil icon.

Additional Information on the Shared Data Points

GPS Location

The last known GPS location (as well as the date and time) of the Raven is sent to Whip Around each morning. If the Raven has been offline or otherwise did not have cellular connectivity the previous day, then no new GPS location will be sent.

Diagnostic Trouble Codes

Active DTC codes and a brief description, if available, are sent to Whip Around each morning. If the DTC code is no longer active, the Raven has been offline or otherwise did not have cellular connectivity the previous day, it will no longer be sent.

Odometer

Vehicle Reported Odometer (Newer Vehicles)

For vehicles newer than 2020, Raven sends up the last known odometer reading from the vehicle, as reported by the vehicle. This is the most accurate odometer reading available.

Inferred Odometer (Older Vehicles)

Vehicles older than 2020 typically do not report their odometer value to Raven. As a result, Raven needs to infer the odometer value from various sources, then add it to the last meter value stored in Whip Around.

• It starts with the most recent odometer value stored in Whip Around.
• Raven Connected then compares the date of the odometer value with the driving history to determine which trips occurred since the last odometer reading.
• Raven Connected then uses the GPS information to measure the distance traveled over that time and adds it to the existing odometer.

Note: For this distance accumulation mode to function, the odometer reading in Whip Around must be non-zero. If the vehicle exists in Whip Around, but there is no odometer set, or the odometer is set to 0, then no odometer calculations are performed.

Troubleshooting Odometer Readings

If your odometer readings are not showing or are incorrect, review the following:

Whip Around Has a Higher Odometer Reading

Raven sends nightly updates to Whip Around. However, if the new reading is lower than the current value in Whip Around, it will be ignored.

• In Whip Around, go to Assets > your vehicle and note the mileage. The reading from Raven must be higher than this value to update.

Fuel Card Entries Overwrite

When you import fuel card records, it may update mileage on the vehicle record, which can potentially interfere with Raven's odometer updates in some cases.

• In Raven, go to Reports > Trip Report > your vehicle and note the distance traveled.
• In Whip Around, check for recent fuel card meter entries and compare with Raven's distance. Delete any incorrect fuel card entries and re-upload with the correct readings if needed.

Old Vehicle's Odometer Not Reported

Vehicles older than 2020 may not report odometer readings via the OBD port, forcing Raven to rely on less accurate GPS trip estimation.

• In Raven, go to Reports > Device Report and note the vehicle's odometer reading. For older vehicles, it may not be listed.

Correcting the Odometer Value

The inference method for older vehicles is not as accurate as the true odometer reading due to various factors (including GPS inaccuracies or loss of data, tire size on the vehicle, initial odometer value, among others). As a result, the value may drift higher or lower than the actual odometer value.

• If the Whip Around value is too low or high
  • Simply update the vehicle's mileage with the correct value in Whip Around. It is best to read the value at night or early in the morning, and set the reading date to be the date in the morning (not the night before).

Support

We're here to help! If additional support is needed, reach out to:

Raven Connected Support (Monday to Friday, 9am-5pm ET during normal business hours)

• Email: [e-mail]
• Phone: [phone]

Whip Around Support

• Help Center
• Email: [e-mail]
• Phone: [phone]