Introduction

Extra Fees are used to apply additional accessorial charges to an order, such as off-hours service, waiting time, weight-based fees, and similar surcharges.

Extra Fees are located under the Pricing left-hand side menu:

Extra Fee Types

There are two types of extra fees in Dispatch Science:

System-Defined Extra Fees

User-Defined Extra Fees

Create a User-Defined Extra Fee

1. Open Pricing > Extra Fees > Extra Fee Types and click the New Extra Fee Type button.
2. Fill in the New Extra Fee Type form:
   
   1. Enter a required Id. Id consists of letters, numbers, -, _ only.
   2. Enter a required name in the primary language and an optional name in the secondary language.
   3. Enter an optional description in the primary language and in the secondary language.
   4. Enter a required unit of measure in the primary language and an optional unit of measure in the secondary language.
   5. Enter an optional reference.
3. Click Save.

Display on the Order

The name will show on the order. The description appears as an info icon beside the fee name. The unit of measure is displayed beside the quantity:

Extra Fee Schedules

Extra Fee Schedules are used to group multiple extra fees together and associate them with an account.

When adding extra fees to a schedule, each fee can be configured with its appropriate:

• Rating method
• Pricing structure
• Applicable options

This allows you to standardize and apply a consistent set of accessorial charges across accounts.

Create an Extra Fee Schedule

1. Open Pricing > Extra Fees — you will land on the Extra Fee Schedules list.
2. Click New Schedule, enter the name of the schedule, then click Save:
   
3. Above the list of extra fees, click the Add Extra Fee button:
   
4. Select an extra fee from the drop-down and click Save:
   
5. Fill in the Configuration section:
   
   1. Set the calculation type: Rated, Sliding, or Scripted. See Rate Types below for details.
   2. Depending on the type selected:
      1. Rated: Fill in the rate, per, max ($) if needed, Included if needed, default quantity if needed.
      2. Sliding: Download and fill in the template and import the file. Enter the per, max ($) if needed, Included if needed, default quantity if needed.
      3. Scripted: Select the script, download the template if available. Fill in the file and import it. Enter the per, max ($) if needed, Included if needed.
   3. Check Hide quantity and unit price if you only want to see the total. This will prevent a user from updating the quantity.
   4. Check Quantity is read-only if you wish users not to be able to update the quantity. Quantity is set as read-only for scripted fees but this can be unchecked if needed.
   5. Select the total price calculation method. See Rounding Options below.
   6. Check Fuel Surcharge if it should be calculated on the extra fee. Fuel surcharge will only be calculated if set as a percentage — if set as distance, it will not be calculated on the extra fee.
6. Fill in the Commission section. The sales commission will be based on the percentage of the extra fee total entered here:
   1. Enter the maximum percentage in Driver Commissionable.
   2. Enter the maximum percentage in Sales Commissionable.
7. Fill in the Visibility section. Depending on the fee type (system or user-defined), the available fields will differ.
   1. User-defined extra fee:
      For more information, see Visibility Options below.
   2. Rank (common to both types): Enter the sort order for how extra fees are displayed on the order. This is not required.
8. Click Save. The extra fee will appear on the Extra Fee Schedule.

Rate Types with Examples

There are three types of rate configurations available for extra fees:

Rated Fee

Formula: (Quantity ÷ Per) → Rounded (optional) → × Rate

Rounding options: Up, Down, None

Sliding Fee

Formula: (Quantity ÷ Per) → Rounded (optional) → Rate lookup (quantity, distance, vehicle type) → × Rate

Rate is retrieved from a configured matrix (typically Excel-based).

Example Setup (Excel file):

Scripted Fee

Uses a C# script to read and manipulate order data, apply custom logic, and optionally retrieve rates from a spreadsheet. Supports complex, multi-dimensional pricing scenarios.

Availability:

• Growth plan (with Developer Toolkit)
• Enterprise plan
• Contact sales to enable if not available

Quick Comparison

Extra Fee Visibility Options

Extra fees can be configured to control their visibility and usage across different user types.

Visibility for Internal Users

Visibility for Self-Serve Order Creation

Driver Visibility

Rounding Options on Extra Fees

Multiple rounding options are available on Extra Fees.

Round Up: The quantity will round up to the next Per Unit value. For example, if 2.1 is entered in the quantity on an order's Extra Fee and the Per unit is 1, then 3 is used to calculate the total Extra Fee.

No Rounding: The quantity field is used as-is to calculate the extra fee total. Using the same example, a quantity of 2.1 with a Per unit of 1 would use 2.1 to calculate the total Extra Fee.

Round Down: The quantity is rounded down to the previous Per unit. A quantity of 2.1 with a Per unit of 1 would use 2 to calculate the total Extra Fee.

Support for Negative Extra Fees on Order Details

Internal users can change the price of a rated extra fee to a negative number on an order. Negative values cannot be entered in the Per field within the Extra Fee Schedule.

For sliding and scripted extra fees, the price can be stored in the Excel sheet as a negative value.

Improved Controls upon Changing the Account on an Order

When changing the Account on an order to an Account that is blocked, a warning message will be displayed and the user will be able to cancel the change.

1. From the Order Details menu, select Change Order Account, then enter the account or user email and select from the list.
2. If the new Account is blocked, the following warning message will be displayed:
   
3. Click Save to change to the blocked account, or Cancel to return to the Order Details, keeping the original account.