Surcharge Rules

Fuel, waiting, detention, ODA, COD, peak-season and handling surcharges added when a consignment is rated

On this page

#About Surcharge Rules

Fuel, waiting, detention, ODA, COD, peak-season and handling surcharges added when a consignment is rated. This is a working page: a list or workspace where you find and act on records in BSuit ERP (Transport). It is used by staff (internal users). What you can see and do depends on your role and permissions.

#How to open it

In BSuit ERP, open Transport and choose “Surcharge Rules”, or go directly to the address /transport/surcharge-rules.

#What you can do here

These controls are present in the page’s implementation. Whether you see a given one also depends on your permissions and on the data shown.

  1. Add new records — a form opens for the details.
  2. Change existing records.
  3. Delete records (you are asked to confirm).
  4. Bring records in from a file.
  5. Export what you see to a file.
  6. Print or save as PDF.
  7. Attach or upload files.
  8. Search within the page.
  9. Filter the data shown.
  10. Sort by a column.
  11. Page through long lists.
  12. Open dialogs or drawers for detail and confirmation.

#Fields

When you enter or change a surcharge rule, these fields are on the form. Required fields must be completed before you can save.

Fields on the Surcharge Rules form
FieldTypeRequiredDetailsRefers to
CodetextYes——
Description on the invoicetextYes——
TypeselectNoPer type only the highest-priority applicable rule fires; custom rules all stack. Fuel rules replace the rate card fuel percent.Chosen from a list loaded by the page
CalculationselectNo—Chosen from a list loaded by the page
ValuenumberNoPercent, flat amount or per-unit rate depending on the calculation.—
Per-unit basisselectNo—Chosen from a list loaded by the page
Minimum AmountnumberNo——
Maximum AmountnumberNo0 = no cap.—
Applies whenheadingNo——
ModeselectNo—Chosen from a list loaded by the page
Vehicle TypetextNo——
Origin CitytextNo——
Destination CitytextNo——
Season Start (MMDD)numberNoRecurring yearly window on the booking date, e.g. 1015 = 15 Oct.—
Season End (MMDD)numberNoA start after the end wraps the year, e.g. 1015 to 115.—
Only when this exceeds the thresholdselectNo—Chosen from a list loaded by the page
Threshold (free allowance)numberNoFor waiting/detention: the free hours. Hourly charges apply to the hours beyond it, per hour or part thereof.—
Validity and postingheadingNo——
Valid FromdateNo——
Valid TodateNo——
PrioritynumberNoHigher wins among rules of the same type.—
TaxablecheckboxNo——
ActivecheckboxNo——

#What the list shows

The list displays these columns; use search and filters to narrow it.

  1. Code
  2. Rule
  3. Type
  4. Charges
  5. Priority
  6. Valid From
  7. Valid To
  8. Season
  9. Taxable
  10. Active

#How to add a surcharge rule

Steps follow this page’s form. You need permission to create records here.

  1. Open Transport › Surcharge Rules from the menu.
  2. Choose the Add button (a plus icon) above the list.
  3. Complete the required fields: Code, Description on the invoice.
  4. Save. The new record appears in the list; use search or the filters to find it again.
  5. To change it later, open the record from the list and edit it.
  6. Deleting asks you to confirm. Records that other records refer to may be refused or may affect them (see “Where … is used as a reference”).

#If something is missing or fails

  1. No data: confirm the company or context selected in the top bar, and any filters or date range in use.
  2. An action is hidden or disabled: it usually needs a permission your role does not have. Ask an administrator to check your effective access.
  3. An error message appears: note the message, the page address and what you were doing, and contact support with those details (never include passwords).

#About this guide

This guide was generated from the page’s implementation. It has not yet been reviewed by a person against a running system, so treat it as a reference for what the page contains rather than a complete procedure.

About this guide

Status
Partially reviewed
Application
BSuit ERP
Audience
Staff (internal users)
Owner
BSuit documentation team
Reviewer
Not yet reviewed
Last verified
Never
Checked against
Generated from source revision a36c7a086 on 2026-10-02
Seen on a running system
Not yet
Help version
2026.0.0-preview
Guide ID
erp:/transport/surcharge-rules
Need more help?If feedback above cannot be sent, email support and quote guide ID erp:/transport/surcharge-rules.
Email support