Manage Organizations

Organization Definition

  • Organization in PDP Model are defined and served exactly the same way as in VRP/DC Model. For more information on Organization, please refer to this article: Organization Definition

Organization Types and Hierarchy Chart

  • Organization Types and Hierarchy Chart in PDP Model are defined and served exactly the same way as in VRP/DC Model. For more information on Organization Types and Hierarchy Chart, please refer to this article: Organization Types and Hierarchy Chart
Organization TypeDirect Upper-level Organization typeFunctions and Resources
Manufacturer
(Required)
Manufacturer (Itself)Have the management rights over all resources
Branch
(Required)
ManufacturerDirectly manages the routing plan
Depot
(Required)
BranchDirectly manages the customers; products inventory; vehicles; drivers; orders

Account Setup Orientation

  • Account Setup Orientation in PDP Model are defined and served exactly the same way as in VRP/DC Model. For more information on Account Setup Orientation, please refer to this article: Account Setup Orientation

Locate Organizations list

  • Navigate to Organizations > Organizations tab
  • This tab lists all the organizations you belong in or have the management rights over
1920

Illustration (English)

1920

Illustration (Vietnamese)

Create Organizations

  • You have two methods to create the Organizations: Webform and Excel import file

Create the Manufacturer

  • The Manufacturer is the first Organization you have to create. This Organization can only be created using the Webform
  • On the Webform, input the Organization Code and the Organization Name of the Manufacturer into the Organization Code and Organization Name fields, then click Save
834

Illustration (English)

837

Illustration (Vietnamese)

  • After the Manufacturer has been created, click its Edit icon On the Update Organization form, click on the Parent Organization field and select itself as its own Parent Organization. Next, click on the Organization Categories field, select the Manufacturer Organization Type from the drop-down menu. Click Save to confirm the change
1699

Illustration (English)

1598

Illustration (Vietnamese)

  • Now the Manufacturer has been fully set up. You can move on to create other lower-level Organizations using either the Webform or the Excel import file

Create Lower-level Organizations

  • After the Manufacturer has been created, you can create other lower-level Organizations using either the Webform or the Excel import file
  • If you create the Organizations using the Excel import file, there are some notes that you should be aware of:
  • 1 - When you create the direct lower-level Organizations of the Manufacturer - The Distributor or the Branch, you must copy the exact Organization Code of the Manufacturer on the Web app then paste it into the Parent Organization Code cell of the Distributor/Branch in the Excel import file
1674

Illustration (English)

1920

Illustration (Vietnamese)

2 - When you create the Organizations that have yet to exist on the Web app, follow this step to create the parent-child relationship between an upper-level Organization and its direct lower-level Organizations (For example, a Branch and its Depot) in the Excel import file: Copy the Organization Code of the upper-level Organization from its Organization Code cell then paste that value into the Parent Organization Code cells of its direct lower-level Organizations

1917

Illustration (English)

1919

Illustration (Vietnamese)

Organization information fields

  • Below is the list of information fields of organizations of this model

📘

You don't necessarily need to input into every information fields

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

Information fieldDescription & Input
Parent Organization (Web form);
Parent Organization Code (Excel template)
(Required)
1. Description:
The direct upper level organization of the organization being created
2. Input rules:
Web form:
Click on this field. Input the Organization Name/Organization Code of the upper level organization of the organization being created into the search bar, then select from the drop down menu
Excel template:
Copy the Organization Code of the upper level organization of the organization being created on Web app, then paste into this cell
Note:
The Organization Name and Organization Code of organizations can be found under "Organization Name" and "Organization Code" columns in "Organizations > Organization List" tab
Organization Code
(Web form + Excel template)
(Required)
1. Description:
Organization Code assigned to the organization being created
2. Input rules:
Format: Must not contain spaces
For example: "Org 01" is not acceptable; "Org_01" is acceptable
Note:
When you use the Web form, the organization code will automatically be capitalized
For example: If you input "Sample_Organization_Code", it will automatically be converted into "SAMPLE_ORGANIZATION_CODE"
This code is case sensitive
For example: "Sample_Organization_Code" is different than "SAMPLE_ORGANIZATION_CODE". Please pay attention when copying the code
Organization Name
(Web form + Excel template)
(Required)
1. Description:
Name of the organization being created
2. Input rules:
Format: Free-form
Organization Category (Web form);
Organization Category Code (Excel template)
(Required)
1. Description:
Specify the Organization Type of the Shipper being created

2. Input rules:
Webform:
Click on this field. Select the appropriate Organization Type from the drop-down menu
Excel import file:
If the Organization being created is a Distributor, input the following value into this cell (Remove the quotation marks when inputting): "DISTRIBUTOR"
If the Organization being created is a Branch, input the following value into this cell (Remove the quotation marks when inputting): "BRANCH"
If the Organization being created is a Depot, input the following value into this cell (Remove the quotation marks when inputting): "DEPOT"
If the Organization being created is a Sun, input the following value into this cell (Remove the quotation marks when inputting): "SUN"
If the Organization being created is a Crossdock, input the following value into this cell (Remove the quotation marks when inputting): "CROSSDOCK"
If the Organization being created is a Shipper, input the following value into this cell (Remove the quotation marks when inputting): "SHIPPER"

Notes when using the Excel import file:
You must input the values exactly in English and in uppercase letters, as shown above. Do not input in any other language and lowercase letters
Latitude, Longitude
(Web form + Excel template)
(Required)
1. Description:
Coordinate information of the organization being created
2. Input rules:
Format: Decimal Degrees
For example: 41.40338 and 2.17403
Read this article for instruction: Get coordinate information of places
Open Time; Close Time
(Web form + Excel template)
(Required for organizations of Depot/Sun/Crossdock type)
1. Description:
The regular time of day at which the organization being created officially starts working and closes
2. Input rules:
Format: hh:mm (24 hour format)
For example: The organization being created regularly starts working at 8:30 A.M and closes at 5:30 P.M everyday. You need to input the following values in the Open Time and Close Time fields/cells respectively: 08:30 and 17:30
Min Time; Max Time
(Web form + Excel template)
(Required for organizations of Depot/Sun/Crossdock type)
1. Description:
The minimum and maximum time period (In minutes) the Depot/Sun/Crossdock being created requires each vehicle to load products
2. Input rules:
On Web form, you need to click on "More Configurations" to see this information field
Input only the value in number. Do not input the unit
For example: The Depot/Sun/Crossdock being created requires each vehicle to load products no less than fifteen minutes and no more than thirty minutes. Input the following values into the Min Time and Max Time fields/cells respectively: 15; 30
Read more about this configuration at this article:
Phone Number
(Web form + Excel template)
(Required)
1. Description:
Phone contact of the organization being created
2. Input rules:
Format: Numbers only. Must not contain spaces
For example: "090 181 0800" or "090.181.0800" is not acceptable; "0901810800" is acceptable
Address
(Web form + Excel template)
(Required)
1. Description:
Official address where the organization being created is located
2. Input rules:
Format: Free-form

Organization Information On Webform

  • On the Webform, the information of an Organization is present on two tabs: Main Information and More Configuration
  • The Main Information tab holds the basic information of the Organization
  • The More Configuration tab holds the specific information for each Organization Type. As you select the attribute Organization Category on the Main Information tab, this tab will update accordingly and gray out the information fields not related to the selected Organization Type
  • For example, if the Organization Category is Manufacture, on the More Configuration > Algorithm tab, there would be a tooltip specifying which type of Organization for the grayed-out information fields not related to the selected Organization Type.
1674

Illustration (English)

1676

Illustration (Vietnamese)

Update Organization

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

Delete Organization

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

📘

BE VERY CAREFUL WHEN DELETING ORGANIZATIONS

If you delete an organization, all resources of that organization as well as the resources of all organizations beneath it will be deleted
For example: If you delete a Branch, the resources of that Branch as well as of all Depots directly under that Branch will be deleted

Search and Filter Organization

Search Organization

  • Enter either the Organization Code or the Organization Name of the organization you want to search in the search box
  • The system will filter and return result shortly
1702

Illustration (English)

1711

Illustration (Vietnamese)

Filter Organization

  • You can filter Organization that are the same Organization Type or share the same Parent Organization by clicking on the Organization Categories and Parent Organization columns then ticking on boxes in the drop down menus
1726

Illustration (English)

1705

Illustration (Vietnamese)

  • You can also search an organization quicker by typing the Organization Name or Organization Code of its upper level organization in the search bar of Parent Organization column; or the Organization Type in the search bar Organization Categories column
1729

Illustration (English)

1729

Illustration (Vietnamese)

  • You can combine these two filters for more accurate search results

Locate Organizations on the map

  • To view locations of organizations on the map, click on View Map icon (Next to the Search field)
1703

Illustration (English)

1710

Illustration (Vietnamese)

  • On the map, each organization is marked by a symbol
  • Click on each symbol to show the label of the organization
  • Click on View data table icon to get back to the organization list screen
1709

Illustration (English)

1705

Illustration (Vietnamese)