Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The RTA Whip Around integration automatically imports defects and mileage reported by your drivers using the Whip Around app.    Vehicles are identified via the VIN number (stored in the serial number field in RTA).

Defects: 

When your drivers report a defect using the Whip Around mobile app, the Whip Around RTA Integration will automatically import those defects into RTA using the Driver Reports module. 

...

  1. Go to https://api.whip-around.com/dashboard/v2/settings 

  2. Tap on the “Integrations” tab and follow their instructions for activating the RTA integration. This will generate a message that will be delivered to RTA support. 

  3. Contact RTA support and request that the RTA Whip Around integration be turned on. RTA Support will use the information provided by Whip Around to finish this step. 

...

Configuration Utility 

The RTA Whip Around Configuration Utility is located at https://app.rtafleet.com/admin/tenants/integrations 

 

Before you can begin using the Whip Around integration, you must first map your vehicle records from Whip Around to your vehicle records in RTA. This mapping is done with specific Vehicle GDFs. To assist you in this mapping we have included a mapping utility. 

...

How to use the mapping utility: 

  1. Download your Whip Around linked vehicle data by clicking the “Download and link vehicle data” link as shown in the image above. 

  2. Edit the Excel file to add your Whip Around vehicle Ids to your RTA vehicle records. 

  3. Export the edited Excel file to a CSV 

  4. Upload the exported CSV to the Whip Around integration tool. 

Editing your Excel File 

The Excel file you download with the integration tool includes two pages in the workbook: RTA Vehicles, and Whip-Around Vehicles. 

The RTA Vehicles tab lists all of the vehicles from your RTA system. It also includes a column stating which Whip Around Vehicle ID maps to each of your RTA Vehicles. 

The Whip Around Vehicles tab includes all of the vehicles you have configured in your Whip Around system.  

To complete this task, open the Whip Around Vehicles tab and Copy a vehicle ID value. Next, open the RTA Vehicles tab and locate the corresponding RTA vehicle row. Finally, paste the Whip Around Vehicle ID you copied into the “whipAroundId” column of the corresponding RTA Vehicle row. 

...

Exporting Excel to CSV 

Once you are done editing your Excel file it is time to export it to CSV and upload it to the integration tool. To do this, first make sure that the RTA Vehicles tab is selected. This is important as CSV files can only be made from the open workbook page and the integration tool needs the RTA Vehicles page as the input. Having selected the RTA Vehicles page, select File -> Save As. In the Save As dialog box, name the file and select the CSV format option and then press “Save”. 

There will be a warning dialog indicating that the selected file type does not support workbooks that contain multiple sheets. Press “OK” to save only the active sheet, this is what we want. 

Uploading CSV to the integration tool 

Return to the integration page in the RTA web app. In the Whip Around box click the link that reads “Upload linked vehicle CSV data”. This will open a file chooser. Select your .csv file and upload.  

Once this is uploaded the process of mapping your RTA Vehicles to your Whip Around vehicles will begin taking effect.  

Updating the RTA-to-Whip Around mappings 

You may return and repeat this mapping process as many times as you like. Each time you come to do this, be sure to download the latest Excel file first and edit this new version. The system will provide you with all the latest mappings and vehicle information on both the RTA and Whip Around systems.