# 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)`\
\&#xNAN;*Figure: Add Truck – Additional tab for company-owned truck with all fields visible.*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://rute.gitbook.io/carrier/add-and-edit-truck.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
