Assignment

Vehicle assignment to drivers, tracking which driver is assigned to which vehicle for a specific period

13 properties
Schema

Properties

PropertyTypeModeDescriptionRequired
assignmentIdstring

Unique identifier for the assignment

Example: "ASSIGN-2024-001"

Required
vehicleIdstring

Reference to the vehicle being assigned

Example: "VEH-12345"

Required
driverIdstring

Reference to the driver receiving the vehicle assignment

Example: "DRV-67890"

Required
startDatestring

Start date and time of the assignment

Example: "2024-01-15T08:00:00Z"

Required
endDatestring

End date and time of the assignment (null if ongoing)

Example: "2024-12-31T17:00:00Z"

Optional
assignmentTypestring

Type of assignment (permanent, temporary, short-term)

Example: "permanent"

Required
statusstring

Current status of the assignment (active, completed, cancelled)

Example: "active"

Required
startMileagenumber

Vehicle mileage at the start of assignment

Example: 45000

Optional
endMileagenumber

Vehicle mileage at the end of assignment

Example: 52000

Optional
notesstring

Additional notes or comments about the assignment

Example: "Driver requires vehicle for regional deliveries"

Optional
assignedBystring

Person or system that created the assignment

Example: "fleet-manager-001"

Optional
createdAtstring

Timestamp when the assignment record was created

Example: "2024-01-14T10:30:00Z"

Required
updatedAtstring

Timestamp when the assignment record was last updated

Example: "2024-01-15T09:00:00Z"

Optional

Examples

Example 1

{
  "@type": "Assignment",
  "assignmentId": "ASSIGN-2024-001",
  "vehicleId": "VEH-12345",
  "driverId": "DRV-67890",
  "startDate": "2024-01-15T08:00:00Z",
  "endDate": null,
  "assignmentType": "permanent",
  "status": "active",
  "startMileage": 45000,
  "notes": "Primary vehicle for regional deliveries",
  "assignedBy": "fleet-manager-001",
  "createdAt": "2024-01-14T10:30:00Z",
  "updatedAt": "2024-01-15T09:00:00Z"
}

Example 2

{
  "@type": "Assignment",
  "assignmentId": "ASSIGN-2024-002",
  "vehicleId": "VEH-54321",
  "driverId": "DRV-11111",
  "startDate": "2024-02-01T07:00:00Z",
  "endDate": "2024-02-28T18:00:00Z",
  "assignmentType": "temporary",
  "status": "completed",
  "startMileage": 30000,
  "endMileage": 32500,
  "notes": "Temporary replacement while regular vehicle in maintenance",
  "assignedBy": "fleet-manager-002",
  "createdAt": "2024-01-30T14:00:00Z",
  "updatedAt": "2024-02-28T18:30:00Z"
}