RTA Inspect/Xerifleet Integration
The RTA Inspect Integration currently supports the following functions:
Vehicle sync from RTA to RTA Inspect
Issue sync from RTA Inspect to RTA, and resolution/assignment statuses from RTA to RTA Inspect
Before configuring the RTA Inspect Integration, ensure you meet the following prerequisites:
You are on the RTA SaaS Subscription which provides access to the APIs that make this integration possible.
Setting up the Integration
Log into the RTA Web App
Click the “Admin” link in the sidebar
Click the “Integrations” link in the “General” card
Click the “Manage” link in the “RTA Inspect” card
Click the “Create/Link” button on the center of the screen
Select whether you’re creating a brand new RTA Inspect account or linking to an existing one
If creating a brand new account:
1. Complete the form
- The “Fleet Size” defaults to your active vehicle count
- The “Billing” information is required for setting up trial accounts
- You will not be charged during your RTA Inspect trial (30 days)
2. Click the “Save” button
If linking to an existing account:
1. Generate an “integration key” on the RTA Inspect Web App
a) Open the following link in a new tab/window
b) Complete the form
- Name: RTA
- Description: Integration with RTA Fleet Management Software
c) Click the “Create Key” button
- Save the generated key information in a secure location
2. Return to the RTA Web App Integrations screen
3. Complete the form
a) Enter a “Name” for your integration
- The name is just an identifier for companies with multiple integrations
- Defaults to your company name
b) Paste the generated integration key into the “Refresh Token” field
4. Click the “Save” button
7. Now that your integration has been created, you can begin syncing your vehicles
Syncing vehicles is meant to be as painless as possible.
Log into the RTA Web App
Click the “Vehicles” link in the left sidebar
You should see a list of vehicles. From here, you are able to check boxes, and sync vehicles over to RTA Inspect by pressing the “Sync to RTA Inspect” button.
After hitting save, the vehicles you have selected will begin to be created in RTA Inspect.
That’s it! If you refresh the page after some time, you should start to see some vehicle's integration status change from “SYNC_PENDING” to “SYNCED”.
Common Reasons for Syncs to Fail
You have exceeded your license limit in RTA Inspect. In RTA Inspect, you are only allowed a certain number of licensed vehicles, so syncing vehicles over the limit will result in failures. No fret! You can simply “Unsync” a vehicle by checking its box and clicking the “Unsync to RTA Inspect” button. Once that is done, a license should be freed up, and you can try to sync again!
Duplicate VIN numbers on vehicles that were manually added to RTA Inspect. When syncing over, if you have preexisting vehicles in RTA Inspect, RTA tries to match vehicles based on VINs. If RTA Inspect has 2 vehicles with the same VIN, the integration will fail to sync because simply, we don’t know which RTA Inspect vehicle that RTA vehicle maps to!
Issues found from RTA Inspect will be automatically added to the Driver Reports module in the vehicle’s home facility that they were reported on, and update the vehicle odometers accordingly. As status changes are made (for example, the issue is assigned to a work order in RTA), the integration will call back to RTA Inspect and update its status accordingly (such as “In Progress”). That’s it! Nothing else you need to do, except do your work and let RTA and RTA Inspect handle the rest!
Currently, it could take up to 15 minutes for issues to be synced both ways. So, if you expect something to be there, wait for at least 15 minutes, and then reach out to RTA Support (firstname.lastname@example.org) for troubleshooting.
Did you know that you can have the component and location split out and digested by RTA by using a special convention? Simply use a pipe “|” character, and the left side will go into the component field in RTA, and the right side will go into the location field!
For example, take “Fender | Passenger Side”. It would end up like this in RTA:
Location: Passenger Side
Fore more information, please see https://docs.rtafleet.com/rta-manual/rta-inspect/