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.
- Add new records — a form opens for the details.
- Change existing records.
- Delete records (you are asked to confirm).
- Bring records in from a file.
- Export what you see to a file.
- Print or save as PDF.
- Attach or upload files.
- Search within the page.
- Filter the data shown.
- Sort by a column.
- Page through long lists.
- 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.
| Field | Type | Required | Details | Refers to |
|---|---|---|---|---|
| Code | text | Yes | — | — |
| Description on the invoice | text | Yes | — | — |
| Type | select | No | Per 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 |
| Calculation | select | No | — | Chosen from a list loaded by the page |
| Value | number | No | Percent, flat amount or per-unit rate depending on the calculation. | — |
| Per-unit basis | select | No | — | Chosen from a list loaded by the page |
| Minimum Amount | number | No | — | — |
| Maximum Amount | number | No | 0 = no cap. | — |
| Applies when | heading | No | — | — |
| Mode | select | No | — | Chosen from a list loaded by the page |
| Vehicle Type | text | No | — | — |
| Origin City | text | No | — | — |
| Destination City | text | No | — | — |
| Season Start (MMDD) | number | No | Recurring yearly window on the booking date, e.g. 1015 = 15 Oct. | — |
| Season End (MMDD) | number | No | A start after the end wraps the year, e.g. 1015 to 115. | — |
| Only when this exceeds the threshold | select | No | — | Chosen from a list loaded by the page |
| Threshold (free allowance) | number | No | For waiting/detention: the free hours. Hourly charges apply to the hours beyond it, per hour or part thereof. | — |
| Validity and posting | heading | No | — | — |
| Valid From | date | No | — | — |
| Valid To | date | No | — | — |
| Priority | number | No | Higher wins among rules of the same type. | — |
| Taxable | checkbox | No | — | — |
| Active | checkbox | No | — | — |
#What the list shows
The list displays these columns; use search and filters to narrow it.
- Code
- Rule
- Type
- Charges
- Priority
- Valid From
- Valid To
- Season
- Taxable
- Active
#How to add a surcharge rule
Steps follow this page’s form. You need permission to create records here.
- Open Transport › Surcharge Rules from the menu.
- Choose the Add button (a plus icon) above the list.
- Complete the required fields: Code, Description on the invoice.
- Save. The new record appears in the list; use search or the filters to find it again.
- To change it later, open the record from the list and edit it.
- 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
- No data: confirm the company or context selected in the top bar, and any filters or date range in use.
- An action is hidden or disabled: it usually needs a permission your role does not have. Ask an administrator to check your effective access.
- 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