> For the complete documentation index, see [llms.txt](https://rute.gitbook.io/carrier/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rute.gitbook.io/carrier/add-and-edit-truck.md).

# Add & Edit Truck

You can add or edit a truck using a two-tab modal: **Basic Info** and **Additional Info**. These tabs allow you to enter all technical and administrative details needed to manage your fleet — whether the truck is company-owned or owned by a contractor.

The form adjusts based on what type of truck you're entering, and whether the company owns it.

***

### When to Use It

Use this when:

* You’re onboarding a new truck into your fleet
* You're adding an owner-operator’s truck for dispatch and payroll
* You need to update truck specs, VIN, or ownership details
* You're assigning a truck to a driver or trailer

***

### How to Add or Edit a Truck

To **add** a truck:

1. Click the **➕ Add Truck** button from the truck list view
2. Complete both the **Basic** and **Additional** tabs
3. Click **Save**

To **edit**:

1. Click the three-dot menu on a truck row or card
2. Select **Edit**
3. Modify any required data
4. Save your changes

***

### Basic Info Tab

This tab captures the truck's core details and ownership status. If you mark the truck as “Owner’s Truck,” the form automatically shows the **Commission** field and hides company-specific financial data.

#### Fields in the Basic Info Tab

<table><thead><tr><th width="200">Field</th><th width="110" align="center">Required</th><th>Description</th></tr></thead><tbody><tr><td>Unit Number</td><td align="center">✅</td><td>Internal ID used for dispatch, payroll, and reporting</td></tr><tr><td>VIN</td><td align="center">✅</td><td>17-digit vehicle identification number (must be unique)</td></tr><tr><td>Make</td><td align="center">✅</td><td>Manufacturer (manual or autofill from VIN)</td></tr><tr><td>Model</td><td align="center">✅</td><td>Model name (manual or autofill from VIN)</td></tr><tr><td>Year</td><td align="center">✅</td><td>Production year</td></tr><tr><td>Color</td><td align="center">Optional</td><td>Truck color (used for list/card color indicators)</td></tr><tr><td>Truck Type</td><td align="center">✅</td><td>Determines whether fields like Length and Fuel Type appear</td></tr><tr><td>Length</td><td align="center">Conditional</td><td>Required if truck type is Box, Cargo, or Reefer</td></tr><tr><td>Owner</td><td align="center">✅</td><td>Company or third-party owner</td></tr><tr><td>Commission</td><td align="center">Conditional</td><td>Required if Owner’s Truck is selected (percentage)</td></tr><tr><td>Assign Driver</td><td align="center">Optional</td><td>Assigns a driver to this truck (linked in Dispatch/Payroll)</td></tr><tr><td>Assign Trailer</td><td align="center">Optional</td><td>Assigns a trailer to this truck</td></tr></tbody></table>

***

### Additional Info Tab

This tab includes technical specs, engine data, axle info, and financial records. If the truck is **owner-owned**, some fields like purchase price and mileage are hidden automatically.

#### Fields in the Additional Info Tab

<table><thead><tr><th width="200">Field</th><th width="110" align="center">Required</th><th>Description</th></tr></thead><tbody><tr><td>Gross Weight</td><td align="center">✅</td><td>Maximum allowed weight (in lbs)</td></tr><tr><td>Empty Weight</td><td align="center">✅</td><td>Weight without cargo or fuel</td></tr><tr><td>Engine Model</td><td align="center">✅</td><td>Engine specification (e.g., Cummins X15)</td></tr><tr><td>Engine Oil Type</td><td align="center">✅</td><td>e.g., 15W-40 Full Synthetic</td></tr><tr><td>Fuel Type</td><td align="center">Conditional</td><td>Required for Box, Cargo, Reefer trucks</td></tr><tr><td>Fuel Tank Size</td><td align="center">Optional</td><td>Capacity in gallons</td></tr><tr><td>APU Unit</td><td align="center">Optional</td><td>Auxiliary power unit (e.g., Thermo King)</td></tr><tr><td>Transmission</td><td align="center">✅</td><td>Transmission model</td></tr><tr><td>Shifter</td><td align="center">✅</td><td>Manual or automatic</td></tr><tr><td>Gear Ratio</td><td align="center">Optional</td><td>Differential ratio (e.g., 3.55)</td></tr><tr><td>Tire Size</td><td align="center">✅</td><td>e.g., 285/75 R 17.5</td></tr><tr><td>Axles</td><td align="center">✅</td><td>Number of axles</td></tr><tr><td>Brakes</td><td align="center">✅</td><td>Drum or Disc</td></tr><tr><td>Front Wheels</td><td align="center">✅</td><td>Steel or Aluminum</td></tr><tr><td>Rear Wheels</td><td align="center">✅</td><td>Steel or Aluminum</td></tr><tr><td>Toll Transponder</td><td align="center">Optional</td><td>Device number</td></tr><tr><td>Insurance Policy</td><td align="center">✅</td><td>ID or reference to current policy</td></tr><tr><td>Title</td><td align="center">✅</td><td>Internal ID or number</td></tr><tr><td>Purchase Date</td><td align="center"><p>✅</p><p>(Company-Owned)</p></td><td>Purchase date</td></tr><tr><td>Purchase Price</td><td align="center"><p>✅</p><p>(Company-Owned)</p></td><td>Total cost in USD</td></tr><tr><td>Mileage</td><td align="center"><p>✅</p><p>(Company-Owned)</p></td><td>Current odometer value</td></tr></tbody></table>

***

### Logic & Field Behavior

* VIN must always be 17 characters and unique across all trucks
* Truck type controls visibility for `Length` and `Fuel Type`
* Selecting “Owner’s Truck” reveals Commission field and hides pricing/mileage
* Assignments (Driver, Trailer) are optional, but required to be unassigned to deactivate

***

**Image Placeholder:**\
`![AddTruckAdditional](../assets/5860d9b5-e561-490e-ac04-0aab7414ccdd.png)`\
*Figure: Add Truck – Additional tab for company-owned truck with all fields visible.*
