Fleet

Manage vehicles as fleet accounts and assign them to rentals.

Overview#

Fleet manages your vehicles — vans, trucks, artics, trailers, and cars. Vehicles are accounts with a Vehicle account type, so each vehicle inherits the full account toolkit: custom fields, files, activities, warehouse scoping, and its own API. Vehicles are kept out of the CRM account lists, pickers, search lanes, and statement flows by bleed guards, so fleet stays cleanly separated from contacts and companies.

Fleet UI routes:

Vehicle records#

A vehicle carries a registration plate, payload, volume, and dimensions (length × width × height), plus a configurable vehicle type drawn from a lists (Van, Truck 7.5t, Artic, Trailer, Car). Compliance data — MOT, insurance, and service dates — is captured as seeded example custom fields on the Account module, so you can adapt or extend them like any other custom field.

The fleet index supports saved live filters, column configuration, and CSV export via the vehicle column registry. Vehicles also appear in global search under their own group, matched by name and plate.

Assigning vehicles to rentals#

Open a rental and use the Vehicles tab (/rentals/{rental}/vehicles) to assign vehicles for the job. Search the fleet, then optionally set a role (Vehicle Assignment Role list), an advisory starts at / ends at window (placeholders inherit from the rental when left blank), and notes. Roles, windows, and notes can be edited inline when you hold vehicles.assign; Unassign removes the row.

Assignments are advisory in this release — resource conflict detection across rentals is not shipped yet. Assigning the same vehicle twice on one rental shows a soft duplicate warning rather than blocking.

Permissions#

Warehouse-restricted users see only vehicles whose warehouses intersect their accessible warehouses.

API#

Vehicles are served account-wrapped at /api/v1/vehicles, with nested rental assignment routes — see the Vehicles API.