Allocation Controller

Allocation Controller

Allocation Controller

The Pickup Allocation screen allows the pickup controller/staff member to see unassigned pickups and allocate them to a driver or agent.
You can also see assigned pickups, but the primary function of the pickup allocation screen is to assist with assigning new pickups to the relevant driver or agent.

1. To go to the Pickup Allocation screen, in the TransVirtual Web Portal, go to Transport > Operational Tasks > Pickup Controller, the allocation page will display as shown below.

2. If your screen appears blank, it could be due to the below settings not having been enabled by clicking on the Radio Button a shown below.


3. Each setting here does a slightly different thing; you can click the helper icon () next to them to learn what each setting does.
These are based on the time zone of the Accounts General Contact setting e.g. if account is based in Melbourne, then the selectors will reflect days accordingly including taking into account state based public holidays.
4. You can enter a booking date will remove options for Show Current, Show Tomorrow etc. Remove the booking date and tab away for these options to be returned.


How to Assign a Pickup

  1. To assign a pickup to a driver or agent, first select a consignment by either clicking on the consignment row or clicking the checkbox next to the consignment as shown below.

Bulk assignment is possible by simply selecting multiple consignments at once!

      2. On the right side of the screen, give a brief overview (located top-right in Job Information and Assignment section) of the pickup & its location. This information allows you as the allocator to make an informed             decision about whom to assign the pickup. 
      3. After deciding whom to assign the pickup, click on the name of either the relevant Driver or Agent located bottom right as shown below.

      4. After step 3, a confirmation pop up will display, to assign the selected connote/connotes to that driver/agent as shown below.


      5. Now click on Yes, Assign Job, consignment will be assigned to that driver or agent.
If assigning to a driver and that driver is using a recent version of the mobile app, the pickup notification informing them they have been assigned a new pickup will display on their device almost immediately.
They can then work this into their run and action accordingly.

How to see Consignments Assigned to a Driver

1. When consignments are assigned to a driver, a consignment count will display alongside their name indicating how many connotes they have been assigned, as shown below.


2. If you want to see more detail about the number, then click on the consignment count icon more detailed information will display on screen as shown below.


3. In the above screen, you can see that both consignments assigned to this driver are listed and details are provided for quantities, weights as well as what type of assignment has been performed - both of these were assigned as deliver but there is the ability to assign pickup type consignments to a driver.

There is the ability to turn the pickup allocation screen into an allocation screen which allows you to also assign deliveries!
To do this, go to Configuration> General > Global Setup > General Tab, on Other section, Enable the below setting by clicking on the Radio Button a sshown below.


Information on Jobs Assigned to an Agent

This operates in a slightly different manner and will display any prices an agent may have against a consignment:


In the above, the consignment being assigned to this agent has an agent price of $110.00. This figure is the amount the agent will charge (your cost or part of) and is based on the agent rate card that this agent is attached to.
Jobs assigned to an agent are viewable via their Agent Manifest. Click here for further information on this.
Note: Agents are displayed as closest at the top to furthest away at the bottom (in relation to selected consignment and based on last known GPS). 

Extra Information on Assigning to a driver

1. In TransVirtual, there is also the ability to see a driver location on a map. It is the distance between a driver's current location and the selected consignment that you are thinking of assigning to them. To do this, click on the Pindrop icon below the consignment driver's name a sshown below.


2. Once you click, you will then be presented with a map showing where the selected consignment is located. The driver will display as a truck icon on the map if GPS data for their device is available as shown below.


Un-allocating a Consignment

If you or someone else accidentally assigns a consignment to a driver or agent by mistake when using the pickup allocation page, there is the ability to un-allocate the job from that driver or agent (remove the job from them).
1. To un-allocate the consignment, first select the consignment and then click on the Unallocate button as shown below.


2. After step 1, a confirmation Popup screen will come, click on Yes, the selected consignment will be Unallocate, as shown below.

If the assignment was to a driver initially, un-allocating a consignment would remove the consignment from that user's device as they are no longer required to action it.

Creating a saved search filter

This operates in much the same way as the search filter in the consignment search page - the purpose of this functionality is to allow you to create a saved search query for information you regularly wish to look up or search for when using the Pickup Allocation page. Click here for further information on this.

Keep in mind that if there are columns you don't have but require, use the column selector to add them in as shown below.

What do all the different colours mean?

You will likely notice when using the Pickup Allocation screen that the consignment rows flash or appear in different colours. Each colour represents something different.
1. To identify what each colour is used for, scroll to the bottom of the page and click on the Color Legend located bottom-left, the Color Legend Popup will display as shown below.

This is also where the export button is located! Much like the consignment search page and other pages in TransVirtual, this button allows you to export the data seen in the grid to an excel or csv file.

2. To see the Advanced Color, click on Advanced Color checkbox will provide further breakdown if required as shown below.


  1. Drivers and Agents will be sorted by the distance from the pickup to the driver's current location or agent's headport - if their position is known. This means the list of drivers shown bottom-right will have the driver closest to the selected consignment listed at the top and drivers further away will appear in ascending order (closest and smallest distance at top, to farthest and biggest distance at bottom).
  2. Drivers will have total pickups allocated to them on the right hand side of the row.
  3. You can search the Drivers or Agents if you have a large number - use the filters to search for certain results.
  4. You have a few switches at the top of the screen to filter the display list.
    1. Show Current: Show consignments that are booked in for pickup today.
    2. Show Tomorrow: Show consignments that are booked in for pickup tomorrow.
    3. Show Beyond Tomorrow: Show consignments that are booked in for pickup beyond tomorrow.
    4. Show Allocated: Show consignments that have already been allocated.
  5. All columns are searchable by entering details in the boxes below the headings.
  6. You can create filters by clicking on filters - illustrated in the above under heading "Creating a Saved Search Filter".
  7. If a Staff member appears and is not required consider Disabling Mobile Access in the user card file.
  8. Agent Drivers who have mobile access will display in the drivers list.

    • Related Articles

    • Manual Pickup Allocation (via Allocation Screen) QSG

      Manual Pickup Allocation (via Allocation Screen) On the TMS Web Portal, go to Transport > Operational Tasks > Allocation Controller. 1. To allocate a job, select the applicable consignment by clicking on the checkbox. You can tick multiple checkboxes ...
    • Linehaul Controller

      On linehaul controller page, you can create and monitor daily linehaul routes. To see the linehaul controller page, go to Transport > Operational Tasks > Linehaul Controller, linehaul controller page will display as shown below. On linehaul ...
    • Transvirtual Standard XML Import V1.0

      XML Import Sending XML consignment data to TransVirtual using the following format is the most efficient and cost effective option. <Consignments> <Consignment> <ConsignmentNumber>ABDEM90241Aasdasdas</ConsignmentNumber> ...
    • Single Depot Pickup and Delivery Process

      Single Depot Pickup and Delivery Process This article provides an overview of the basic steps from creation to delivery. Quick Start Guides 1. Create a consignment via web app here. 2. Allocate pickup to driver here. 3. Complete pickup using mobile ...
    • Multi Depot Pickup and Delivery Process

      Multi Depot Pickup and Delivery Process This article provides an overview of the basic steps from creation to delivery incorpoarating movement between depot locations. Quick Start Guides 1. Create a consignment via web app here. 2. Allocate pickup to ...