These features are available on your Test site as of the evening of January 31st, on your Preproduction site in the evening of February 2nd and on your Production site in the evening of February 6th.


In OData Table Account, the following 2 fields:
FuelSurchargeScheduleId and FuelSurchageScheduleId have been replaced by FuelSurchargeScheduleConfigurationId



New Features in This Release



TABLE OF CONTENTS






Definitions

The release notes refer to different sections of the application:

Back Office: Where Customer Service Representatives (CSR) create and edit orders, create accounts, review drivers, etc.

Dispatch Board: Where Dispatchers assign orders to drivers, get notifications for invalid orders, etc.

Auto-Dispatch: This section refers to the automated order assignment setup and its process.

Administration: This section is in the Back Office but refers to sections only an administrator will use like Settings and Pricing.

Customer Portal: Where account users log in to create orders, view their order history, enter a credit card, etc.

Tracking site: Where customers enter a tracking number like the order ID or a reference number to view the status of their order.

OData: Data fields and variables saved in OData

Account API: API provided to your accounts to create, update and get orders. For documentation, please follow this link: https://api.dispatchscience.com/
Tenant API: API provided to you to create orders for your accounts, retrieve invoices and change invoice status. For documentation, please follow this link: https://api.dispatchscience.com/  

Scripting: Custom script building abilities and functions within Dispatch Science

 

Driver App Version 1.63

Display Order Information Panel when Validating at Pickup and Delivery

When this option is enabled on the Driver Profile, the Order Information Panel will be displayed at Pickup and Delivery. 

When option is turned off, Driver will see the number of Parcels and Orders that have been scanned:

Image

When option is turned on, there will be an impact on performance in the Driver App. The Order information panel will display when parcels are scanned:

Image


License Plates under Warehouse

You had a Complete button at the bottom and a Cancel button at the top of the screen. 

In the new release, those were removed because as soon as an item is scanned, it is added to the License Plate. 

You can always delete items by clicking on the See Items and removing the items you do not wish to add. And you can also delete the License Plate by taping the garbage can.



Back Office

Orders

Order List

A new Contains filter is available in the Account Caller column and is now selected by default:


Creation of Orders with Add to Contact

If you create an order with the “Add to Contact” option checked, the new contact will be created when the order is created. If you entered the contact’s address through the “Enter address from ZIP/Postal Code” option, and you check the “Add to Contact” checkbox after saving the global address, both the contact and a global address will be created.


Create an Order and a Contact without a Global Address

1) Create a new Order and enter the pickup or delivery information. 

2) Enter an optional Company, enter a Contact name and check the Add to Contact.

3) Start typing the address and click on Enter address from ZIP/Postal Code as Contact address.

4) The Contact Address dialog box will open. You can enter the address and contact info, set the latitude and longitude as well as import a KML file for the address inner and outer zone. 

5) Click on Save.

6) Finalize the Order and click on Create Order. 

The contact will be created with the information and KML file if used. No global address will be created.


Create an Order, a Contact and a Global Address

1) Create a new Order and enter the pickup or delivery information. 

2) Enter an optional Company, enter a Contact name and DO NOT check the Add to Contact.

3) Start typing the address and click on Enter address from ZIP/Postal Code as Contact address.

4) The Global Address dialog box will open. You will be able to enter the address and contact info, set the latitude and longitude as well as import a KML file for the address inner and outer zone. 

5) Click on Save.

6) Check the Add to Contact checkbox.

6) Finalize the Order and click on Create Order. 

The contact will be created with the information and KML file if used. A global address will also be created.


Creating or Editing Orders with New Filtered Service Levels

For more information about this new feature please see Filtered Service Levels.

For more information on the behavior in Orders, please see Using Filtered Service Levels in Orders.


Route Plan

Trigger Recurring Route

Recurring Routes can now be triggered manually.

1) Open a Recurring Route by selecting its the Route Plan:

2) In the Route Plan, open the schedule to view the Recurring Route:

3) All Recurring Routes within a scheduled day and time can be triggered at the same time. Click the Trigger icon on the Schedule:

If only one Recurring Route within a schedule should be triggered, click the Trigger icon beside the Route Recurrence:

4) In the Trigger Recurrences dialog box, select the Date. This will update the Start Time with the list of Schedules available for the day. 

The  will show you the Scheduled Recurring Route which will be triggered.

5) Select the Scheduled Start Time in the Start Time drop-down.

6) Click on Trigger.

If the Route Container for that day does not exist, the Route Container will be created, the Route will be created in the Container and the Orders will be placed in the Route. The Driver from the Route being triggered will be allocated to the Route.


If the Route Container for that day is not dispatched or closed and the Route does not exist in the Container, the Route will be created in the Container and the Orders will be placed in the Route. The Driver from the Route being triggered will be allocated to the Route.


If the Route Container for that day is not dispatched or closed and the Route does exist in the Container but has not yet been dispatched, the Orders will be added to the Route. The Driver already allocated to the Route will remain. If no Driver is allocated, the Driver from the Route being triggered will be allocated to the Route.


If the Route within the Container was already dispatched, you will be asked if a new Route should be created. The new Route name will be the original zone with a suffix _01. If a _01 already exists, it will create a _02, etc. Click on Create Routes to create the new Route(s). The Driver from the Route being triggered will be allocated to the Route.


If the Route Container for that day was already dispatched, you will get an error message and the Route Recurrence(s) will not be generated:


Order Templates

Order Template as a Separate Menu Item

The link Manage Order Templates has been moved from Recurrences to the horizontal menu under Orders for easier access:


Recurring Orders

Prevent Moving to Other Tabs when Creating a Recurring Order/Route

When creating Recurring Orders/ Routes, you can navigate to other tabs to view pricing and address information only once the Recurring Order/Route has been saved. To ensure this, the tabs have been disabled during creation:



Accounts

Pricing

Filtered Service Level Schedules

When this feature is enabled, Service Levels will be filtered according to the User type creating the Order:


Self-Serve, Back Office, Tenant API, Integration API and Order Templates. 

This feature allows to restrict the list of available Service Levels and Vehicles depending on the sequence setup in the Service Level Schedule. 


Price Lists will no longer be dependent on the Service Level Schedule or the Vehicle selection as all Service Level and Vehicle types will automatically be associated to all Price Lists. 


This will allow you to set the Service Level Schedule directly at the Account.


For more information about this feature, please review the Filtered Service Level Schedules article. 

This feature is turned off by default in Production and Pre-production and turned on in Test for Subscriptions activated before February 6, 2024. Please contact your Professional Services representative to enable and schedule a review of this new feature.


Master Account as a Separate Menu

Master Accounts have been moved to the horizontal menu:


Drivers

Driver List Default Sort Order

The Driver List now sorts by First Name then Last Name by default when opening the Driver List. 


Driver Zones

The Driver Zone List now sorts alphabetically for easier review and modification:


New Driver Profile Option

A new option has been added to the Driver Profile to view the Order Information Panel during the Pickup and Delivery Scan.

Setting this option to Yes will impact the Driver App performance therefore by default, this option is turned off.


Set Option to On

1) Open Drivers, Click on Profiles and open the Driver Profile to edit.

2) Click on Edit in General Options:

3) Check the box beside Display Order Panel info during pickup/delivery scan.

4) Click on Save. 


Dispatch Board

Order Details in Dispatch Board

In the Order Details on the Dispatch Board, the Edit Service and Edit Vehicle will now open the Order in the Back Office so changes can be made.

1) Open an Order by clicking on its Order number in the Dispatch Board or from the Route:

2) Click on Edit Service Level or Edit Vehicle Type

The Order details will open so you can make your changes:



Administration

Company

The Service Level Schedule is added on the Company setup when Filtered Service Level is enabled.


Pricing

Price Lists

When Filtered Service Level Schedule is enabled, all Service Levels and Vehicles will be associated to all Price Lists.

The Price List details will show without the Service Level Schedule in the Price List:

Create a Price List with Filtered Service Level Feature Enabled

When Filtered Service Level Schedule is enabled, all Service Levels and Vehicles will be associated to all Price Lists.

1) Open Pricing, Price List and click on New Price List button.

2) Enter the name of the Price List, the type and the zone if set by Zone.

There is no longer a need to specify a Service Level Schedule. 
All Service Levels will automatically be associated to the Price List.

3) In the list of Vehicles, you no longer specify which Vehicle is the default nor which Vehicle should be part of the Price List as all Vehicles will automatically be part of the Price List. 


4) Download the Price template and all Service Levels will automatically be available in the spreadsheet. 

If Separate Price Sheet by Vehicle was checked, all Vehicle types will automatically be added as a tab in the spreadsheet.


Edit a Price List with Filtered Service Level Schedule Enabled

When Filtered Service Level Schedule is enabled, all Service Levels and Vehicles will be associated to all Price Lists.

1) Open Pricing, Price List and click on a Price List to edit.

2) Notice that you no longer select the default Vehicle

3) Download the Price file for a By Distance and you will notice that you have all Service Levels in the spreadsheet. 

Download the template for a By Zone and you will notice that you have all Service Levels in the spreadsheet.

If Separate Price Sheet by Vehicle was checked, all Vehicle types will automatically be added as a tab in the spreadsheet.


Fuel Surcharge Schedules

On the Fuel Surcharge Schedule, a(i) was added to explain that the Default Fuel Surcharge Table will be used only if the Order does not match the rules in the rules in the list. If no rule is added to the schedule, the default fuel surcharge will always be used.


Filtered Service Level Schedules

When this feature is enabled, you can filter the Service Levels available to the different aspects within Dispatch Science;
Self-Serve, Back Office, Tenant API, Integration API and Order Templates. 

The Service Level Schedule and vehicle selection are removed from Price Lists. This modification allows the same Price Lists to be used in different Accounts and can be configured with all Service Levels and Vehicle Types.

This feature is turned off by default in Production and Pre-production and turned on in Test for Subscriptions activated before February 6, 2024. Please contact your Professional Services representative to enable and schedule a review of this new feature. 


Upon enabling the feature, new Service Levels will automatically be created for each Price List Service Level Schedule and set of selected Vehicle Types. 

Only one Service Level Schedule will be created by Price List using the same Service Level Schedule with the same Vehicle Types even if they contain different default Vehicle Types. These will need to be adjusted manually once the feature is turned on.


A new security right was added to the Internal Users and is enabled by default for Admin roles. For more information, please see All Service Levels and Vehicles.


For more information about this feature, please consult Filtered Service Levels.



Settings


Zones

The zones are now sorted alphabetically for easier review and modification:


Roles

All Service Levels and Vehicles

A new security right named All Service Levels and Vehicles has been added for Internal Users. This right is set to enabled for all Admin Roles. 

Admin Users will see all Service Levels and Vehicles and be able to use them when creating or editing Orders in Dispatch Science and the API. This right can be unchecked in the Role to only allow the user to see the Vehicles/Service Levels in the Orders or API.


Script

Script Rules

Two new options have been added to determine how Script Rules should be executed if there is more than one combination of Account and Script. This will allow, when the same script would be run on the same Order with different properties, to have the scripts run in a specific sequence and to stop the execution of a script if needed. 


Options:

Rank: lowest rank will be executed first. Null values will be executed in order of Script Rule Id after the ranked Script Rules. The Script Rule Id is found in the URL when editing the Script Rule.

Stop Execution: When checked, current Script Rule will be the last one executed in the list when there is more than one Script Rule for the same Account+Script.

 

1) Edit a Script Rule by clicking on Settings, System, Script Rules then the Script Rule.

2) In the Script Rule, enter the rank of the current Script Rule.

3) Enter if this should be the last Script Rule executed in the sorted list of same Account+Script combination. 

4) Click Save. 


Example:

A Script is needed to run on all your Accounts but it has a different file for 1 Account. Instead of creating the same Script Rule for all Accounts and have a different Script Rule for the 1 Account, you would be able to create 2 Script Rules:


1 Script Rule for all Accounts + Script 1 with generic file. 

1 Script Rule for the specific Account + Script 1 with Account specific file. 


Enter 1 in Rank for specific Account + Script 1 and check the Stop Processing checkbox. 

Enter 2 in Rank for all Accounts + Script 1. 


When the Script Rule is processed for an Order for the specific Account, it will only execute the script for that Account. 

When the Script Rule is processed for an Order for any other Account, it will only execute the script for the All Accounts. 


Order Update Script

A new task that will allow the script to update the load and unload time has been introduced:

Task UpdatePickupDuration(TimeSpan newDuration, bool preventRelatedSegmentUpdate = false);

Task UpdateDeliveryDuration(TimeSpan newDuration, bool preventRelatedSegmentUpdate = false);


Tenant-Integration API

Subscriptions

New events were added to the Subscriptions:

proof_of_pickup_added : this will be sent when the signature name is added at pickup.

received_on_pickup_from_updated : this will be sent if the signature name at pickup is updated.

received_by_updated : this will be sent if the signature name at delivery is updated.


proof_of_pickup_added content

{
"OrderId": "ORDERID",
"Metadata": null,
"Status": 1,
"Timestamp": "YYYY-MM-DDThh:mm:ss+00:00",
"Language": "en",
"EventType": "proof_of_pickup_added",
"AccountId": "ACCOUNTID",
"FulfillmentType": FULFILLMENTTYPEID,
"POPImageUrl": "URL..../pickup-signature.jpg",
"CustomerName": "SIGNATURE NAME"
}

received_on_pickup_from_updated

{
"OrderId": "ORDERID",
"Metadata": null,
"Status": 2,
"Timestamp": "YYYY-MM-DDThh:mm:ss+00:00",
"Language": "en",
"EventType": "received_on_pickup_from_updated",
"AccountId": "ACCOUNTID",
"FulfillmentType": ACCOUNTID,
"CustomerName": "SIGNATURE NAME"
}

received_by_updated

{
"OrderId": "ORDERID",
"Metadata": null,
"Status": 4,
"Timestamp": "YYYY-MM-DDThh:mm:ss+00:00",
"Language": "en",
"EventType": "received_by_updated",
"AccountId": "ACCOUNTID",
"FulfillmentType": ACCOUNTID,
"CustomerName": "SIGNATURE NAME"
}


Where Status:

0 = Received

1 = Assigned

2 = Picked up

4 = Delivered

91 = Cancelled

Where FulfillmentType:

0 = Regular Order

1 = Multi-segment Order

2 = Segment



Integration API

Subscriptions

Same as the ones added for Integration_Tenants.


ODATA

Accounts

The following two fields were removed in the Accounts table:

FuelSurchargeScheduleId

FuelSurchageScheduleId

These have been replaced by the new FuelSurchargeScheduleConfigurationId field which is located in Dispatch Science under Pricing, Fuel Surcharges, Fuel Surcharge Schedules:


Drivers

The following field was added to the Drivers table:

ReportsToUserId

This field will contain the Agent/Master Driver Id that the current Driver reports to.

This field is found in Drivers, Driver Details, Information Details: