Vehicle Management For Fleets
Overview
This tool allows the fleet manager to upload or delete VINs and request or revoke consent. VINs that have provided consent, are eligible to receive Get Vehicle Status.
The tool has 2 formats:
- UI
- API
API format
Download this collection download this collection or check the API reference pages
Vehicle Statuses
Vehicle Statuses Clarification
The table below contains the new version of vehicle statuses as implemented through the platform UI.
The API supports the old version of vehicle statuses Only!
| VIN status | Description |
|---|---|
| Enabled | VIN is enabled both by Otonomo and the provider, and data can be accessed. |
| Pending | Pending approval from Otonomo and the provider. |
| Incomplete | VIN is of a make that is not yet activated, vehicle make activation must be completed to enable the VIN. |
| Disabled | VIN was disabled by either Otonomo, the provider, or the consumer, and near-real-time data cannot be accessed. |
| Error | An error occurred when processing the VIN. |
Upload New VINs
You can upload new VINs to a specific Workspace in the Vehicle Management tool.
Please Note
- Odometer Specification: There is an option to include the odometer measured value when adding a new VIN
- VIN length should be 16 or 17 characters.
Once a VIN was uploaded, it will receive the status Pending, if the vehicle make is activated. If the vehicle make is not activated, it will receive the status Incomplete until the make is activated.
Once approval for the VIN is given by the provider and Otonomo, the status will change from Pending to Enabled.
If a vehicle was deleted and added again, it will enter the status Pending even if it has been enabled in the past.
Disable VINs
Disabled VINs
In case a VIN was disabled via the platform - the vehicle is still visible in the platform but the data is no longer available for consumption since the vehicle is not enabled anymore (both current status and historical data).
You can disable VIN which is in status Enabled.
- Press on the 3 dots symbol next to the VIN
- Choose the Disable option
Now press the APPROVE button to confirm and complete the VIN revoke action.
Once disabled, the VIN’s status will change to Disabled.
Request VIN’s Enablement
You can request to enable a VIN which is in status Disabled.
1. Press on the 3 dots symbol next to the VIN
- Choose the Enable option
Now Press APPROVE button to confirm and complete the VIN enablement.
The VIN will have to go though the approval chain once again.
Delete VINs
VIN Deletion
In case a VIN was deleted from the platform - the data is no longer available for consumption or visible in the UI.
You can re-upload the VIN to recover the data consumption.
You can delete VINs from a Workspace in the Vehicle Management tool:
- Press on the 3 dots symbol next to the VIN
- Choose the Delete option
Now press the DELETE button to confirm and complete the VIN deletion
The deleted vehicles can be in either status Incomplete, Enabled, or Disabled.
Once a VIN was deleted, you won’t be able to see it in the list of vehicles.
Updated about 1 month ago