Entity · fleet_drivers

Fleet Driver Schema

Schema-ID

fleet_driver

Collection

fleet_drivers

Permissions

Lesenfleet_driver_view
Anlegenfleet_driver_create
Ändernfleet_driver_edit
Löschenfleet_driver_delete

Felder

Fleet Driver Schema

fleet_drivers4 Permissions

Schema for validating fleet driver / Fahrer entities

userIduuidoptional

Reference to internal user (optional for external drivers)

nullable

employeeProfileIduuidoptional

Reference to employee_profiles entity. When set, personal data (name, email, phone, department, employeeNumber) is read live from the profile and cannot be edited on the driver.

nullable

firstNamestringerforderlich

First name / Vorname

1–100 Zeichen

lastNamestringerforderlich

Last name / Nachname

1–100 Zeichen

emailemailerforderlich

Email address

max 200 Zeichennullable

phonestringoptional

Phone number

max 50 Zeichennullable

employeeNumberstringoptional

Employee number / Personalnummer

max 50 Zeichennullable

departmentstringoptional

Department / Abteilung

max 200 Zeichennullable

licenseNumberstringoptional

Driver license number / Führerscheinnummer

max 50 Zeichennullable

licenseClassesstring[]optional

License classes (e.g. B, BE, C1, CE)

Default: []

licenseExpirydateoptional

License expiry date

nullable

licenseIssuedDatedateoptional

License issue date

nullable

licenseIssuingAuthoritystringoptional

Issuing authority / Ausstellende Behörde

max 200 Zeichennullable

lastLicenseCheckDatedateoptional

Last driver license check date

nullable

nextLicenseCheckDatedateoptional

Next driver license check due date

nullable

licenseCheckResultstringoptional

Result of last license check

Werte

VALIDEXPIREDSUSPENDEDRESTRICTED

nullable

licenseCheckStatusstringoptional

Self-service license check workflow status

Werte

NONEAWAITING_UPLOADAWAITING_AI_REVIEWAWAITING_MANAGER_REVIEWVALIDREJECTED

Default: "NONE"nullable

licenseCheckTokenHashstringoptional

SHA256 hash of the self-service token

nullable

licenseCheckTokenExpiresAtdatetimeoptional

Token expiry timestamp

nullable

licenseCheckRequestedAtdatetimeoptional

When the check was last requested

nullable

licenseCheckRequestedByuuidoptional

userId of the fleet manager who requested the check

nullable

licenseCheckFrontAttachmentIdstringoptional

File ID for front of license photo

nullable

licenseCheckBackAttachmentIdstringoptional

File ID for back of license photo

nullable

licenseCheckUploadedAtdatetimeoptional

When the driver uploaded their license photos

nullable

licenseCheckAiReviewStatusstringoptional

AI review processing status

Werte

pendingcompletedfailed

nullable

licenseCheckAiReviewFeedbackstringoptional

AI review feedback text

max 5000 Zeichennullable

licenseCheckAiReviewScorenumberoptional

AI review score (0-100)

0 – 100nullable

licenseCheckAiReviewConfidencenumberoptional

AI review confidence (0-1)

0 – 1nullable

licenseCheckAiNameMatchbooleanoptional

Whether the name on the license matches the driver record

nullable

licenseCheckConsentGivenAtdatetimeoptional

Timestamp when the driver consented to digital/AI processing

nullable

licenseCheckAiExtractedDataobjectoptional

AI-extracted license data (number, classes, expiry, holder name)

nullable

uvvStatusstringoptional

UVV inspection status

Werte

CURRENTOVERDUENOT_REQUIRED

Default: "NOT_REQUIRED"

lastUvvDatedateoptional

Last UVV inspection date

nullable

nextUvvDatedateoptional

Next UVV inspection due date

nullable

uvvTrainingRequiredbooleanoptional

Whether this driver requires UVV training (Fahrerunterweisung)

Default: true

uvvRecurrenceMonthsnumberoptional

Recurrence interval in months (typically 12 for annual)

1 – 60Default: 12nullable

lastUvvCompletedAtdateoptional

Date when last UVV training cycle was fully completed (denormalized)

nullable

nextUvvDueDatedateoptional

Deadline for next UVV training cycle (denormalized)

nullable

uvvTrainingCourseIduuidoptional

DEPRECATED — LMS course ID, now lives on training_assignment

nullable

uvvTrainingStatusstringoptional

DEPRECATED — status now derived from training_assignments

Werte

NOT_REQUIREDPENDINGIN_PROGRESSAWAITING_ORAL_CONFIRMATIONAWAITING_DRIVER_ACKNOWLEDGMENTCURRENTOVERDUE

Default: "PENDING"

uvvTrainingRecurrenceMonthsnumberoptional

DEPRECATED — use uvvRecurrenceMonths instead

1 – 60nullable

lastUvvTrainingDatedateoptional

DEPRECATED — use lastUvvCompletedAt instead

nullable

nextUvvTrainingDatedateoptional

DEPRECATED — use nextUvvDueDate instead

nullable

activeTrainingAssignmentIduuidoptional

DEPRECATED — derived from training_assignments query

nullable

uvvOralConfirmedAtdatetimeoptional