Driver Vehicle Assignments (DVAs) are a part of the quote where a vehicle is assigned to a driver. A vehicle can be marked as the primary vehicle (primaryVehicle:true) or non-primary vehicle (primaryVehicle:false).

Rules to Remember

Each driver must have least one DVA, and one of those DVAs must be for their primary vehicle.
- After one of the vehicles is selected as primaryVehicle:true for a driver, any additional vehicles assigned to the driver should be designated a non-primary vehicle with primaryVehicle:false.
Each vehicle must have at least one DVA, whether primary or not for any driver.

📘
NOTE: This is currently only a requirement in CA and VA.

Examples

1 Driver / 1 Vehicle:

"profile": {
  ...
  drivers: [
    { id: "<driver-1-uuid>", ... }
  ],
  vehicles: [
    { vin: "<vehicle-1-vin>", ... }
  ],
  ...
}

The vehicle must be assigned to the driver with primaryVehicle:true.

"profile": {
  ...
  "driverVehicleAssignments": [
    {
      "driverId": "<driver-1-uuid>",
      "primaryVehicle": true,
      "vin": "<vehicle-1-vin>"
    }
  ],
  ...
}

1 Driver / 2+ Vehicles:

"profile": {
  ...
  drivers: [
    { id: "<driver-1-uuid>", ... }
  ],
  vehicles: [
    { vin: "<vehicle-1-vin>", ... },
    { vin: "<vehicle-2-vin>", ... }
  ],
  ...
}

One vehicle must be assigned to the driver with primaryVehicle:true, while the remaining vehicles must be assigned to the driver with primaryVehicle:false.

 "profile": {
  ...
  "driverVehicleAssignments": [
    {
      "driverId": "<driver-1-uuid>",
      "primaryVehicle": true,
      "vin": "<vehicle-1-vin>"
    },
    {
      "driverId": "<driver-1-uuid>",
      "primaryVehicle": false,
      "vin": "<vehicle-2-vin>"
    }
  ],
  ...
}

2+ Drivers / 1 Vehicle:

"profile": {
  ...
  drivers: [
    { id: "<driver-1-uuid>", ... },
    { id: "<driver-2-uuid>", ... }
  ],
  vehicles: [
    { vin: "<vehicle-1-vin>", ... }
  ],
  ...
}

Each driver must be assigned to the vehicle with primaryVehicle: true.

 "profile": {
  ...
  "driverVehicleAssignments": [
    {
      "driverId": "<driver-1-uuid>",
      "primaryVehicle": true,
      "vin": "<vehicle-1-vin>"
    },
    {
      "driverId": "<driver-2-uuid>",
      "primaryVehicle": true,
      "vin": "<vehicle-1-vin>"
    }
  ],
  ...
}

2+ Drivers / 2+ Vehicles:

 "profile": {
  ...
  drivers: [
    { id: "<driver-1-uuid>", ... },
    { id: "<driver-2-uuid>", ... }
  ],
  vehicles: [
    { vin: "<vehicle-1-vin>", ... },
    { vin: "<vehicle-2-vin>", ... },
    { vin: "<vehicle-3-vin>", ... }
  ],
  ...
}

Each driver must be assigned to one vehicle with primaryVehicle:true. Each vehicle must have a DVA, even if it is not any driver's primary vehicle.

"profile": {
  ...
  "driverVehicleAssignments": [
    {
      "driverId": "<driver-1-uuid>",
      "primaryVehicle": true,
      "vin": "<vehicle-1-vin>"
    },
    {
      "driverId": "<driver-2-uuid>",
      "primaryVehicle": true,
      "vin": "<vehicle-2-vin>"
    },
    {
      "driverId": "<driver-2-uuid>",
      "primaryVehicle": false,
      "vin": "<vehicle-3-vin>"
    }
  ],
  ...
}