Setup & Configuration¶

This guide covers the configuration options specific to commercial weighing operations. For general station setup, user management, and TruConnect installation, see the enforcement setup guide and TruConnect installation — the process is identical.

Commercial Settings¶

Navigate to Setup > Settings > Commercial to configure organisation-wide commercial parameters.

Setting	Description	Default
Weighing Business Model	`Third-Party Weighbridge` (charges transporters per transaction) or `Facility-Owned Scale` (no per-transaction fee, internal use only)	—
Weighing fee (KES)	Per-transaction fee charged for commercial weighing. Only applies when model is `Third-Party Weighbridge`. Leave at 0 for facility-owned scales.	—
Default tare expiry (days)	Number of days a stored tare weight remains valid before re-verification is required	90
Payment gateway	Integrated payment provider (read-only; configured by platform admin)	—

Business model

Set the Weighing Business Model before going live. When set to Facility-Owned Scale, the system skips invoice creation and payment collection for every transaction. See Business Models for a full comparison.

Tare expiry

When a stored tare expires, the system prevents single-pass operations on the affected vehicle and prompts the operator to capture a fresh tare weight. The tare expiry period can be overridden per vehicle in the tare register.

Tolerance Settings¶

Tolerances define the acceptable variance between expected and actual net weight. They apply per cargo type and are business rules set by the site operator — not legal compliance limits (those belong to the enforcement module).

Navigate to Setup > Tolerances to configure:

Field	Description	Example
Cargo type	Apply this rule to a specific commodity, or leave blank for a global rule	Maize
Tolerance type	`Percentage` or `Absolute (kg)`	Percentage
Tolerance value	Numeric value (% or kg)	2.0
Maximum tolerance (kg)	Cap applied when using percentage mode — the discrepancy will not be flagged as exceeded beyond this kg ceiling	2,000 kg
Description	Label for operators (e.g. "Maize moisture variance")	—

How tolerance is evaluated¶

Operator enters Expected Net Weight in the Ticket step.
After both weights are captured and net is calculated, TruLoad compares the actual net weight against the expected.
If the discrepancy exceeds the configured tolerance, the transaction is flagged Tolerance Exceeded.
The ticket cannot be finalised until a supervisor with weighing.override permission approves the exception.

Discrepancy (kg) = |Actual Net Weight − Expected Net Weight|

For percentage tolerance:  Threshold = ExpectedNetWeight × ToleranceValue / 100
                            Cap applied: min(Threshold, MaxToleranceKg)
For absolute tolerance:     Threshold = ToleranceValue (kg)

Flag if: Discrepancy > Threshold

Expected net weight required

Tolerance is only evaluated when the operator provides an Expected Net Weight in the Ticket step. If omitted, no tolerance check runs.

Tolerances vs. enforcement limits

In enforcement mode, axle-load limits are defined by the Kenya Traffic Act. In commercial mode, tolerances are business rules you configure. Exceeding a tolerance generates a supervisor approval gate on the transaction — not a legal case or prosecution record.

Cargo Type Configuration¶

Cargo types determine the commodity-specific rules applied to each transaction.

Navigate to Setup > Weighing Metadata > Cargo Types:

Field	Description
Name	Display name (e.g., "Maize", "Cement", "Ballast")
Code	Short code for tickets and reports (e.g., `MZ`, `CM`, `BL`)
Default tolerance	Override the global tolerance for this cargo type
Moisture target %	Target moisture content for deduction calculation
Foreign matter limit %	Threshold above which foreign matter deductions apply
Active	Enable/disable the cargo type

Adding a new cargo type¶

Click Add Cargo Type.
Fill in the name, code, and tolerance override (leave blank to use the global default).
Configure quality parameters if deductions are enabled for this commodity.
Click Save.

The cargo type is immediately available in the weighing capture screen.

Origin and Destination Management¶

Origins and destinations are used for logistics tracking and reporting. They appear on weight tickets and can be filtered in reports.

Navigate to Setup > Weighing Metadata > Origins/Dest.:

Click Add Location.
Enter the name, code, country, and location type (Origin / Destination / Both).
Click Save.

Route-based reporting

Configuring origins and destinations enables the Tonnage by Route report, which shows cargo flows between locations.

Driver and Transporter Management¶

Drivers and transporters are pre-registered for fast lookup during weighing capture.

Navigate to Setup > Weighing Metadata:

Transporters tab — add hauling companies with contact details and portal email (for transporter portal access)
Drivers tab — add drivers with licence number and expiry date
Vehicles tab — register vehicle plates with default tare weight and tare expiry override

Station Configuration¶

Each station (physical weighbridge site) has its own configuration. Navigate to Setup > Stations:

Setting	Description
Station name	Display name in the UI and on tickets
Station code	Short code for ticket numbering
Address	Physical location
Operating hours	Define shift boundaries
Default weighing mode	`Enforcement` or `Commercial`
Printer configuration	Thermal printer model and connection
Ticket template	Select the ticket layout (commercial or enforcement format)

Quality Deduction Rules¶

When quality deductions are enabled, the system applies deductions based on measured quality parameters:

Moisture deduction¶

\[ \text{Moisture Deduction (kg)} = \text{Net Weight} \times \frac{\text{Actual Moisture \%} - \text{Target Moisture \%}}{100} \]

Only applied when actual moisture exceeds the target
Target moisture is configured per cargo type

Foreign matter deduction¶

\[ \text{FM Deduction (kg)} = \text{Net Weight} \times \frac{\text{Actual FM \%}}{100} \]

Applied when foreign matter exceeds the configured limit
The full percentage is deducted (not just the excess)

Adjusted net weight¶

After all deductions, the system computes:

\[ \text{Adjusted Net (kg)} = \text{Net Weight} - \text{Quality Deduction} \]

The adjusted net is the billable weight shown on the final ticket.