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:

  1. UI
  2. 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 statusDescription
EnabledVIN is enabled both by Otonomo and the provider, and data can be accessed.
PendingPending approval from Otonomo and the provider.
IncompleteVIN is of a make that is not yet activated, vehicle make activation must be completed to enable the VIN.
DisabledVIN was disabled by either Otonomo, the provider, or the consumer, and near-real-time data cannot be accessed.
ErrorAn error occurred when processing the VIN.
1563

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.
1547 500

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.

  1. Press on the 3 dots symbol next to the VIN
1549
  1. Choose the Disable option
1553

Now press the APPROVE button to confirm and complete the VIN revoke action.

444

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

1551
  1. Choose the Enable option
1553

Now Press APPROVE button to confirm and complete the VIN enablement.

444

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:

  1. Press on the 3 dots symbol next to the VIN
1549
  1. Choose the Delete option
1555

Now press the DELETE button to confirm and complete the VIN deletion

446

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.