User GuideDeveloper GuideRelease Notes

Manage Vehicles

Suggest Edits
  • In this model, each warehouse (Of Depot and Sun type, not Crossdock type) will have its own delivery fleet. By default, there are three Vehicle Types: Truck; Semi-truck; Motorbike
  • Apart from the three default Vehicle Types, you can also create and manage custom Vehicle Types

Locate Vehicle List

  • The Vehicles are listed on the Transportation > Vehicles tab
16711671

Create Vehicles

  • You have two methods to create the Vehicles:
  • Method 1: Create single Vehicles via Webform
  • Method 2: Create multiple Vehicles via Excel import file

Vehicle information fields

  • Below is the list of all information fields for vehicles of this model:

📘

Apart from the information fields mentioned below, other information fields can be left blank

Information field

Description & Input

Organization (Webform); Organization Code (Excel import file)
(Required Field)

1. Description:
The Organization (Of Depot or Sun type) which directly manages the Vehicle being created
2. Input rules:
Webform:
Click on this field. Input the Organization Name/Organization Code of the appropriate Depot/Sun into the search bar, then select from the drop-down menu
Excel import file:
Copy the Organization Code of the appropriate Depot or Sun on the Web app then paste it into this cell
Note:
The Organization Name and Organization Code can be found under the "Organization Name" and "Organization Code" columns in the "Organizations > Organizations" tab
This information can not be changed once the vehicle has been created. Therefore, please pay extra attention

Vehicle Type
(Web form + Excel template)
(Required)

1. Description:
The Vehicle Type of the Vehicle being created
2. Input rules:
Webform:
Click on this field. On the drop-down list, select the appropriate Vehicle Type only from the three following types: bike; truck; semi-truck. Do not select any other type as they are not used in this model
Excel import file:
Input only one of the following three values into the cell (Input only the English values as shown, not in any other language): bike; truck; semi-truck
These values represent the following default Vehicle Types of this model: Motorbike; Truck; Semi-truck
Note when using the Excel import file:
Do not input values that include uppercase letters into this cell, for example, Bike; TRUCK
If you use the Flexible Vehicle Type configuration and have created the custom Vehicle Types, copy the Vehicle Type Code of the appropriate Vehicle Type on the Web app and paste it into this cell
The Vehicle Type Code can be found under the "Type Code" column in the "Transportation > Vehicle Type" tab
Read more about the Flexible Vehicle Type configuration in the following article:

Vehicle Code
(Web form + Excel template)
(Required)

1. Description:
The management code assigned to the Vehicle being created
2. Input rules:
Length: Maximum 15 characters
Can contain letters, numbers. Must not contain special characters and spaces

Start time; Stop time
(Web form + Excel template)
(Optional)

1. Description:
The official times of day when the Vehicle being created starts and stops working
These attributes will be used during the Route Plan optimization process
2. Input rules:
Format: HH:mm (24-hour format)
For example, the Vehicle being created starts working at 07:30 A.M and stops working at 08:30 P.M. Input the following values into the "Start time" and "Stop time" fields/cells, respectively: 07:30; 20:30
Special Note:
If the Vehicle being created is usually assigned Delivery Routes that need more than 24 hours to perform, the value input into the "Stop time" field/cell should be larger than the sum of the "Start time" value and the approximate time to perform those Delivery Routes
For example, the Vehicle being created starts working at 06:30 A.M. It is often assigned Delivery Routes that take more than 72 hours to perform. In this case, the value input into the "Stop time" field/cell should be larger than the sum of the above values, which is 78:30
On the Webform, if you leave these fields blank, upon saving the system will automatically fill the following values into these fields correspondingly: 07:00; 18:00

License Plate
(Web form + Excel template)
(Required)

1. Description:
The license plate number of the vehicle being created
2. Input rules:
Can contain letters and numbers. Cannot contain special characters (Characters that are not letters and numbers) and spaces

Vehicle Name
(Web form + Excel template)
(Optional)

1. Description:
A name assigned to the vehicle being created for easier management
2. Input rules:
Format: Free-form

Temperature
(Web form + Excel template)
(Optional)

1. Description:
The product temperature levels that the vehicle being created can carry
Read more about this configuration at the following article: Cold Chain
2. Input rules:
Web form:
Click on this field, tick on check boxes of the supported temperature levels
For example: The vehicle being created can carry Frozen and Ambient products. Tick on the following check boxes: Frozen; Ambient
Excel template:
Input only one of these six values into the cell to specify the temperature levels supported by the vehicle being created: F; A; C; FA; FC; FAC
The letters F; A; C represents the following temperature levels respectively: Frozen; Ambient; Chilled
Notes:
On Web form, if you leave this field blank, upon saving the system will automatically choose the following checkbox: Ambient

Temp Zone
(Web form + Excel template)
(Optional)

1. Description:
The number of temperature zones available on the vehicle being created
Read more about this configuration at this article: Optimize routes with Cold Chain
2. Input rules:
Input only the value in numbers. Do not input the unit
For example: The vehicle being created has two temperature zones in its cargo area. Input the following value into the field/cell: 2
Note:
The number of temperature zones available on a vehicle can be less than the number of temperature levels supported by that vehicle
For example: A vehicle has only one specialized temperature zone for Frozen product, but can still carry Ambient and Chilled products
On Web form, if you leave this field blank, upon saving the system will automatically fill the following value into this field: 1

Volume (Web form); Capacity Volume (m3) (Excel template)
(Required)

1. Description:
The maximum product capacity in cubic meter (m3) that the vehicle being created can carry
2. Input rules:
Input only the value in numbers. Do not input the unit
For example: The vehicle being created can carry maximum twelve cubic meters. Input the following value into the field/cell: 12
Notes:
On Web form, if you leave this field blank, upon saving the system will automatically fill the following value into this field: 3

Weight (Web form); Capacity Weight (kg) (Excel template)
(Required)

1. Description:
The maximum product capacity in kilograms (kg) that the vehicle being created can carry
2. Input rules:
Input the value in numbers. Do not input the unit
For example: The vehicle being created can carry maximum three thousand kilograms. Input the following value into the field/cell: 3000
Notes:
On Web form, if you leave this field blank, upon saving the system will automatically fill the following value into this field: 1500

Gross Weight
(Web form + Excel template)
(Optional)

1. Description:
The total weight of the vehicle, including all the components of the vehicle, the weight of the driver, product, fuel, and other things
This field is used for Road constraint by Gross weight. Read more about this configuration at the following article: Road Constraints
2. Input rules:
Input the value in numbers. Do not input the unit
For example: The vehicle gross weight is three thousand kilograms. Input the following value into the field/cell: 3000

Real Weight
(Web form)
(Optional)

This field is only used for Freight transport models

Cargo Area Length (m)
(Web form + Excel template)
(Optional)

1. Description:
Length of the cargo area of the vehicle being created
2. Input rules:
Format: Meter (m)
Input only the value in numbers. Do not input the unit
For example: The vehicle being created has the cargo area's length to be four point five metres. Input the following value into this field/cell: 4.5
If you do not have data of this field, just leave the field/cell blank
Note:
If the configuration "Oversized Goods Restriction" of the Manufacturer is enabled, this field/cell will become required, and the value input must be larger than 0

Cargo Area Width (m)
(Web form + Excel template)
(Optional)

1. Description:
Width of the cargo area of the vehicle being created
2. Input rules:
Format: Meter (m)
Input only the value in numbers. Do not input the unit
For example: The vehicle being created has the cargo area's width to be four point five metres. Input the following value into this field/cell: 4.5
If you do not have data of this field, just leave the field/cell blank
Note:
If the configuration "Oversized Goods Restriction" of the Manufacturer is enabled, this field/cell will become required, and the value input must be larger than 0

Cargo Area Height (m)
(Web form + Excel template)
(Optional)

1. Description:
Height of the cargo area of the vehicle being created
2. Input rules:
Format: Meter (m)
Input only the value in numbers. Do not input the unit
For example: The vehicle being created has the cargo area's height to be four point five metres. Input the following value into this field/cell: 4.5
If you do not have data of this field, just leave the field/cell blank
Note:
If the configuration "Oversized Goods Restriction" of the Manufacturer is enabled, this field/cell will become required, and the value input must be larger than 0

Lunch start time; Lunch stop time
(Web form + Excel template)
(Required)

1. Description:
The official times of day when the driver of the vehicle being created starts and stops the lunch break
2. Input rules:
Format: hh:mm (24 hour)
Input the value in numbers. Do not input the unit
For example: The lunch break starts at 12:30 A.M and stops at 1:30 P.M. Input the following values into the "Lunch start time" and "Lunch stop time" fields/cells correspondingly: 12:30; 13:30
Notes:
On Web form, if you leave these fields blank, upon saving the system will automatically fill the following value into these fields: 12:00

Speed
(Web form + Excel template)
(Required)

1. Description:
Movement speed of the vehicle being created
Unit: Kilometer per hour (km/h)
2. Input rules:
Input the value in numbers. Do not input the unit
For example: The vehicle being created runs at thirty kilometers per hour. Input the following value into the field/cell: 30
Notes:
On Web form, if you leave this field blank, upon saving the system will automatically fill the following value into this field: 40

Cost per km
(Web form + Excel template)
(Optional)

1. Description:
The cost for the vehicle being created per one kilometer during a delivery route
2. Input rules:
Input the value in numbers. Do not input the unit
For example: The vehicle costs two thousand dollars to operate per one kilometer. Input the following value into the field/cell: 2000
Notes:
On Web form, if you leave this field blank, upon saving the system will automatically fill the following value into this field: 0

Fixed Cost
(Web form + Excel template)
(Required)

1. Description:
The fixed cost of the vehicle being created during a delivery route, not depending on the route length
2. Input rules:
Input the value in numbers. Do not input the unit
For example: The Fixed cost of the vehicle is two thousand dollars. Input the following value into the field/cell: 2000
Notes:
On Web form, if you leave this field blank, upon saving the system will automatically fill the following value into this field: 0

Rental Cost
(Web form + Excel template)
(Optional)

1. Description:
The expense your organization have to pay a Subcontractor to rent the vehicle being created for a whole delivery route
Read more about this configuration at the following article:
2. Input rules:
Input the value in numbers. Do not input the unit
For example: The Rental cost of the vehicle is five hundred dollars. Input the following value into the field/cell: 500
If the vehicle being created is not a rental vehicle, leave this field/cell blank
Notes:
On Web form, if you leave this field blank, upon saving the system will automatically fill the following value into this field: 0

MDP
(Web form + Excel template)
(Optional)

1. Description:
The code assigned to the vehicle being created, to be used for Route optimization with Familiarity constraint
Read more about this configuration at the following article: Familiarity Constraint
2. Input rules:
Format: Must not contain spaces
For example: "MDP 1" is not acceptable; "MDP_1" is acceptable
Leave the cell blank if there is no MDP code assigned to the vehicle
If the vehicle is assigned multiple MDP codes, separate two adjacent MDP codes by a comma and a space
For example: MDP_1, MDP_2

Maximum Single Order Volume (m3)
(Web form)
(Optional)

1. Description:
The maximum volume per single Order that the vehicle allows
Unit: Cubic meter (m3)
Read more in the following article: Vehicle Capacity Constraint
2. Input rules:
Input the value in numbers. Do not input the unit
For example, the vehicle only allows the maximum volume per single Order to be zero point six cubic meters. Input the following value into this field: 0.6
Note:
If you leave this field blank, the system will assume that the maximum volume per single Order that the vehicle allows equals to the total volume capacity of that vehicle, which is the value of the "Volume (m3)" field

Maximum Single Order Weight (kg)
(Web form)
(Optional)

1. Description:
The maximum weight per single Order that the vehicle allows
Read more in the following article: Vehicle Capacity Constraint
Unit: Kilogram (kg)
2. Input rules:
Input the value in numbers. Do not input the unit
For example, the vehicle only allows the maximum weight per single Order to be six kilograms. Input the following value into this field: 6
Note:
If you leave this field blank, the system will assume that the maximum weight per single Order that the vehicle allows equals to the total weight capacity of that vehicle, which is the value of the "Weight (kg)" field

Default driver
(Web form + Excel template)
(Optional)

1. Description:
The default driver of the vehicle being created
2. Input rules:
Web form:
Click on this field. Select the default driver from the drop down menu
Excel template:
Copy the Username of the appropriate driver on Web app, then paste into this cell
Note:
Username of the driver can be found under "Username" column in "Organizations > Organization List" tab
Note:
You can set one single driver to be the default driver for multiple vehicles
Only the drivers who are configured to have the same Vehicle Type attribute with the vehicle being created can be set as the default driver for that vehicle
For example: If a driver is configured to have the "Vehicle Type" attribute to be "bike", then you will only be able to select him as the default driver for a vehicle of "bike" type but not for a vehicle of "truck/semi-truck" types

Accompanied vehicle
(Web form)
(Optional)

Note: This configuration applies only to the vehicles of this type: truck
1. Description:
The motorbikes that will accompany the truck being created to deliver orders
2. Input rules:
Click on the field, then select the motorbike(s) from the drop down menu
Read more about this feature at this article: Accompanied Vehicles

Registration Date
(Web form)
(Optional)

1. Description:
The date when the registration certificate of the vehicle being created is deemed expired
2. Input rules:
Click on the field, choose the suitable date from the drop down calendar

Active
(Web form)

1. Description:
The active status of the vehicle being created
2. Input rules:
By default, the status of the vehicle is Active, represented by this icon:
To turn the status into Inactive, click on that icon

Update vehicle information

  • Please refer to the CRUD functions article to know the general steps about updating objects in Abivin vRoute

Update single vehicle

  • To update single vehicle, click on Edit icon of that vehicle
19151915

Update multiple vehicles

  • You can update multiple vehicles using Excel template. The process is similar to when you create multiple vehicles using Excel template. Just change the information in the exact Excel template you used earlier to create the vehicles (Important note: The attributes Organization Code and Vehicle Code of the existing vehicles must remain the same), then, as you upload the updated Excel template, click on the check box Overwriting existing data
590590

Export Vehicles

Compulsory Configuration

  • Before being able to export vehicle, you need to tick the check box Export of the module Vehicle for the User group in which your User account belongs
  • To export vehicle, navigate to the tab Transportation > Vehicles. On this tab, hover over the icon , then click the icon Export Data . The vehicles will be downloaded as an Excel spreadsheet that you can view offline

Delete vehicles

  • Please refer to the CRUD functions article to know the general steps about deleting objects in Abivin vRoute
  • You can only delete vehicles which have the Vehicle Status to be Open, not Planned/Locked
19151915

Change Active status of vehicle

  • By default, all vehicles will have their status as active right after being created, symbolized by a icon under the Active tab
  • If one or more vehicles have the Vehicle status to be Open - Meaning they are currently not assigned any delivery task, then you can change the active status of them
  • First you have to select the vehicles by clicking on the corresponding check box icon of those vehicles on the first column of the vehicle list. You can also select all vehicles currently displayed on the page by clicking on the check box icon on the title bar above the vehicle list
  • After you have selected the vehicles, click on the button Bulk Updates, then click on the text Update Vehicles' active status. The form Vehicle Active Status Update will appear. On that form, select the appropriate value (Active or Inactive) then click OK. Click OK one more time on the confirmation form
19121912

Bulk Update Start Time & Stop Time of Vehicles

  • You can change the attributes Start Time and Stop Time of multiple vehicles. First, follow the instruction for changing vehicle active status above to select multiple vehicles. Upon clicking on Bulk Updates button, click on Update Vehicles' Start time and Update Vehicles' Stop time, respectively. The form Bulk updating vehicles' start time/Bulk updating vehicles' stop time will appear. Input the desired Start Time/Stop Time into the field, then click OK to confirm changing
590590

Setup vehicles as Sub-contractor's

  • During the creation/editing process on both Web form and Excel template, you can setup the vehicles as Sub-contractor's
  • On Web form, first you need to click on the check box Sub-contractor. Upon clicking on that check box, three new information fields will appear right below
785785

Sub-contractor information fields

Description & Input

Sub-contractor Name

1. Description:
Name of the Sub-contractor
2. Input rules:
Format: Text and numbers

Sub-contractor Code

1. Description:
Code of the Sub-contractor
2. Input rules:
Format: Text and numbers, must not contain spaces
For example: "Contractor 01" is invalid; "Contractor_01" is valid

Rental Cost

1. Description:
Rental cost of the vehicle per route
Note: This is a fixed cost, regardless of the route length
2. Input rules:
Format: Numbers only
For example: The rental cost of the vehicle is five million Vietnam dong per route. Input the following value into this field: 5000000

Vehicle Status

  • Below are the possible vehicle statuses in accordance with the Route Plan Optimization Process

Vehicle Status

Description

Open

The vehicle has not been assigned any Delivery Route, or the current time point has passed the estimated finish time of the Delivery Route assigned to the vehicle

Planned

The vehicle has been assigned a Delivery Route, but the Delivery Route has not yet been locked

Locked

The Delivery Route assigned to the vehicle has been locked or finalized

  • You can filter the vehicles having certain statuses by clicking on this field title then tick the appropriate checkboxes
  • The vehicle status of a vehicle will update accordingly to every user or system activity related to that vehicle. The table below lists all possible vehicle status changes

User/System Activity

Vehicle Status (Before)

Vehicle Status (After)

Create vehicle

None

Open

Delete vehicle

Open

None

Vehicle is put into a Route Plan

Open
Planned

Planned

The assigned planned Delivery Route is locked

Planned

Locked

The assigned locked Delivery Route is unlocked

Locked

Planned

The current time point has passed the estimated finish time point of the assigned Delivery Route

Locked

Open

The driver submits the last task of the assigned Delivery Route ("End of Day" task)

Locked

Open

The assigned Delivery Route is assigned to another vehicle (Change vehicle)

Planned

Open

The assigned Delivery Route is moved to other vehicles or is removed from the Route Plan

Planned

Open

The assigned Delivery Route is manually closed

Locked

Open

External TMS returns the assigned Delivery Route result as Finished

Locked

Open

Filter Vehicles

Filter by Vehicle Type

  • To filter vehicles by vehicle type, follow the steps below:
  • Step 1: Click on the Type column title
  • Step 2: Upon clicking, a drop-down list will appear. On this list, tick the checkboxes of the wanted vehicle types. Alternatively, you can input the Type Code/Type Name attribute of the vehicle type into the search bar to filter faster
  • After the vehicle types have been selected, the system will refresh the vehicle list and show the vehicles of the selected vehicle types
16921692

Search Vehicles

  • You can search for a single vehicle or multiple vehicles at once

Search single vehicle

  • To search for a single vehicle, first, make sure the textbox to the left of the search box displays Single. If this textbox displays Multiple, click on this textbox and select the Single text on the drop-down list
423423
  • After that, input the Vehicle Code or License Plate of the vehicle you want to search into the search box. The system will return that vehicle
954954

Search multiple vehicles

  • To search for a single vehicle, first, make sure the textbox to the left of the search box displays Multiple. If this textbox displays Single, click on this textbox and select the Multiple text on the drop-down list
419419
  • After that, input the Vehicle Codes/License Plates of the vehicles you want to search into the search box (You can mix both Vehicle Codes and License Plates). Each time you input a Vehicle Code/License Plate in the search box, click the Space key on your keyboard to let the system know that you have fully input a Vehicle Code/License Plate. Continue to input other Vehicle Codes/License Plates using this method
  • Note: You can only input a maximum of 50 Vehicle Codes/License Plates in the search box
888888
  • You can remove a particular Vehicle Code/License Plate from the search box by clicking its corresponding remove icon
  • To clear the whole search list, click the clear icon at the right end of the search box
426426

Beginner's Guide

Here is the guide to help create a single vehicle using 2 methods:

Create a Vehicle

  • Method 1: Create a single vehicle using Web form:
  • Step 1: Navigate to Transportations > Vehicles tab.
  • Step 2: Click on the symbol Create (the symbol).
28802880
  • Step 3: Input information to complete the Vehicle information fields. These are the required fields:
  • Organization: Input the Organization Name/Organization Code of the appropriate management Depot/Sun into the search bar, then select from the drop down menu: Sample Depot
  • Vehicle Type: Select the suitable vehicle type from the following values: bike; truck; semi-truck.
  • Vehicle Code: Input management code assigned to the vehicle being created.
  • License plate: Input license Plate number of the vehicle being created.
  • Temperature: Tick on check boxes of the supported temperature levels: Ambient, Chilled, Frozen.
  • Temp Zone: Input the number of temperature zones available on the vehicle being created.
  • Volume: Input the maximum product capacity in cubic meter (m3) that the vehicle being created can carry.
  • Weight: Input the maximum product capacity in kilograms (kg) that the vehicle being created can carry.
  • Start time (HH:mm): Input the official times of a day when the vehicle being created starts working.
  • Stop time (HH:mm): Input the official times of a day when the vehicle being created stops working.
  • Lunch start time (HH:mm): Input the official times of a day when the driver of the vehicle being created starts the lunch break.
  • Lunch stop time (HH:mm): Input the official times of a day when the driver of the vehicle being created stops the lunch break.
  • Cost per km: Input the cost for the vehicle being created per one kilometer during a delivery route.
  • Speed: Input movement speed of the vehicle being created (Unit: Kilometer per hour (km/h)).
  • Fixed cost: Input the fixed cost of the vehicle being created during a delivery route, not depending on the route length.
  • Rental cost: Input the expense your organization have to pay a Subcontractor to rent the vehicle being created for a whole delivery route.
  • For more information about notes and input rules of the above fields, please click here.
  • Example:
28802880 28802880 28802880
  • Step 3: Click SAVE.
  • Method 2: Create a vehicle using Excel file:
  • Step 1: Navigate to Transportation > Vehicles tab
  • Step 2: Click on the symbol Import Data (the ⤓ symbol)
  • Step 3: A window will pop up. Click DOWNLOAD SAMPLE to download Abivin's import template, then save it to your computer.
28802880
  • Step 4: Open the import template and input data into the required fields:
  • Organization Code: Copy the Organization Code of the Depot/Sun which manages the vehicle being created on Web app, then paste into this cell. For example: Sample Depot
  • Vehicle Type: You must input the exact same value as follows into the cell: truck
  • Vehicle Code: Input management code assigned to the vehicle being created. For example: SAMPLE-TRUCK
  • License plate: Input license Plate number of the vehicle being created. For example: 29C-23456. Note: This cell must not contain spaces.
  • Temperature: Input only one of these six values into the cell to specify the temperature levels supported by the vehicle being created: F; A; C; FA; FC; FAC. The letters F; A; C represents the following temperature levels respectively: Frozen; Ambient; Chilled. In this case, input A into this cell as an example.
  • Temp Zone: Input the number of temperature zones available on the vehicle being created. For example: 1
  • Volume: Input the maximum product capacity in cubic meter (m3) that the vehicle being created can carry. For example: 3
  • Weight: Input the maximum product capacity in kilograms (kg) that the vehicle being created can carry. For example: 600
  • Start time (HH:mm): Input the official times of a day when the vehicle being created starts working. For example: 08:00
  • Stop time (HH:mm): Input the official times of a day when the vehicle being created stops working. For example: 18:00
  • Lunch start time (HH:mm): Input the official times of a day when the driver of the vehicle being created starts the lunch break. For example: 12:00
  • Lunch stop time (HH:mm): Input the official times of a day when the driver of the vehicle being created stops the lunch break. For example: 12:30
  • Cost per km: Input the cost for the vehicle being created per one kilometer during a delivery route. For example: 2000
  • Speed: Input movement speed of the vehicle being created (Unit: Kilometer per hour (km/h)). For example: 30
  • Fixed cost: Input the fixed cost of the vehicle being created during a delivery route, not depending on the route length. For example: 2000000
  • For more information about the input rules of the above fields, please refer to the Vehicle information fields section.
  • Step 5: Drag and drop the Excel file you have just edited into the import area (the highlighted area in the picture below) or click on that area then select the file from your computer.
28742874
  • After following the steps above, you shall see a message at the top right corner of the screen saying: Completed upload. The newly-created vehicle shall also appear on the vehicle list. This means you have successfully created a vehicle using an Excel file.
28802880

Vehicle Usage History

  • Abivin vRoute system allows you to keep track of the Vehicle usage history. The detailed content is presented in the following article: Vehicle Usage History.

Updated over 1 year ago

What's Next
Did this page help you?