Tariff groups
A tariff group holds a set of related fees and the properties they share. You set up the group first, then add tariffs inside it.
On the tariff-groups overview (for the application area you're in), click New to create one, or open an existing group to edit it.
The group fields
- Name (required) — what the group is called, e.g. "Harbour dues".
- System code (required) — a short internal code SHIPM8 uses to refer to the group (letters, numbers, underscores). Other rules can target a group by this code, so keep it stable.
- Currency code (required) — the currency for the group's amounts.
- VAT code — the default VAT code for the group's tariffs.
- Starts on (required) / Ends on — the period the group is valid. Outside these dates the group isn't used. Leaving Ends on empty means open-ended.
- UI template — controls how the group is presented.
- Grouping code — an optional code used to group results together on the output.
- Application area — which part of SHIPM8 the group belongs to (read-only; set by where you created it).
- Tariff group type (required) — the kind of group, which influences how its tariffs are applied.
- Company — optionally tie the group to a specific debtor.
Maximum applied tariffs
A saved group also shows a configuration: the maximum applied tariffs and the group type. This decides how many of the group's matching tariffs are actually used in a calculation — for example all of them, or only one (such as the first match). It's the main lever for "should several of these fees stack, or just one?".
Validity and versioning
Because a group has Starts on / Ends on dates, you set up a new version by giving it a new validity period rather than overwriting the old one — so past calculations stay correct. Plan changes by date.
Decide the system code carefully and don't change it later — conditions and dependencies elsewhere refer to groups and tariffs by their system code.