Clearance Lifecycle

Lifecycle of clearance for VW Group brands

The following flows are closely related to OEM integrations and our internal software, and are subject to change without prior notice.

Activation

The following flowchart explains the high level of activation procedure

1. If your app is configured as partner, you must provide a tag during vehicle activation. i.e:

   curl -X POST https://api.high-mobility.com/v1/fleets/vehicles \
   --data '
   {
     "vehicles": [
       {
         "vin": "VIN012345678901234",
         "brand": "audi",
         "tags": {
           "vw-group-customer-name": "Car Operations Ltd."
         }
       }
     ]
   }'

2. A vehicle can only be activated in one application
3. A vehicle activation could failed due multiple reasons:

   1. If a vehicle is activated via another provider
   2. If a vehicle is not eligible
   3. VW could block activation of a vehicle due to theft.
4. During the activation if the vehicle is in PrivacyMode, you need to turn the privacy mode off and wait for our system to activate the vehicle. If the PrivacyMode stays on for 5 days, we deactivate the vehicle and change the status to rejected.
5. In total we set a timeout for 15 days for vehicle to turn off the privacy mode and start transmitting data
6. During activation, we wait for the vehicle to send a message before enabling it for your application. You can check pending_reason via the Fleet Clearance API to see the current status. If activation doesn't occur within 10 days, we will deactivate the vehicle and change its status to rejected.