Drivers and Earning Rules
The Driver Team section manages internal delivery drivers and the rules used to calculate driver earnings.
Drivers
The Drivers page manages own-fleet delivery drivers.
A driver record usually connects:
- Branch.
- Linked employee or user account.
- Driver status.
- Current assignments.
- Delivery history.
- Driver earning rules.
Driver Statuses
| Status | Meaning |
|---|---|
| Available | Driver can receive assignments. |
| Busy | Driver is currently handling work. |
| Offline | Driver is not available in the driver panel. |
| On Break | Driver is temporarily unavailable. |
| Inactive | Driver should not receive assignments. |
For payroll integration, link the driver to an HR employee. Without this link, driver earnings cannot be posted to that employee's payslip.
Driver Earning Rules
Driver Earning Rules define how internal drivers earn money from delivery work.
Advanced earning rules apply only to own-fleet deliveries with an internal driver.
Rule Types
| Rule Type | Calculation | When It Applies |
|---|---|---|
| Per Delivery | base_amount | A completed own-fleet delivery. |
| Zone Flat | base_amount | A completed delivery in the selected delivery zone. |
| Batch Multiplier | per_delivery_base_amount * (multiplier - 1) | Delivery is inside a batch with at least two stops and a per-delivery rule exists. |
| Peak Hour Bonus | base_amount | Delivered time falls inside the configured branch-timezone day/time window. |
| COD Commission | Fixed: base_amount; Percentage: cod_amount * rate / 100 | Payment collection channel is driver COD. |
| Cancellation Compensation | base_amount | Driver fails or returns a delivery using an eligible reason code. |
Calculation Methods
| Method | Used For |
|---|---|
| Fixed Amount | Per delivery, zone flat, peak hour bonus, cancellation compensation, and flat COD commission. |
| Percentage | COD commission based on collected COD amount. |
| Multiplier | Batch multiplier bonus. |
Required Fields By Rule
| Rule Type | Required Fields |
|---|---|
| Per Delivery | Driver, branch, calculation method, base amount, effective from. |
| Zone Flat | Driver, branch, zone, base amount, effective from. |
| Batch Multiplier | Driver, branch, multiplier greater than 1, effective from. |
| Peak Hour Bonus | Driver, branch, days of week, time from, time to, base amount, effective from. |
| COD Commission | Driver, branch, calculation method, base amount or rate, effective from. |
| Cancellation Compensation | Driver, branch, eligible reason codes, base amount, effective from. |
Important Rule Behavior
- Different rule types can stack on the same delivery.
- Only one active matching rule is allowed per rule type and scope.
- Batch multiplier creates a separate earning row; it does not change the per-delivery row.
- If a batch multiplier matches but no per-delivery base earning exists, the multiplier is skipped.
- Rules create snapshot-based earning entries, so future rule edits do not change historical earnings.
Payroll Component
The payroll component is optional for normal earning calculation.
It becomes important when Delivery earnings are exported to HR payroll:
- Entries with a payroll component can be grouped into HR payslip lines.
- Entries without a payroll component are skipped with warning during payroll export.
Setup Examples
Fixed amount per completed delivery
Use:
- Rule type: Per Delivery.
- Calculation method: Fixed Amount.
- Base amount: the driver amount per completed delivery.
Extra amount for specific zone
Use:
- Rule type: Zone Flat.
- Zone: selected delivery zone.
- Base amount: extra driver amount for that zone.
COD percentage commission
Use:
- Rule type: COD Commission.
- Calculation method: Percentage.
- Rate: commission percentage.
Troubleshooting
Driver earning was not generated
Check:
- Delivery is own-fleet.
- Driver is internal and linked correctly.
- Delivery reached the trigger status: delivered, failed, or returned.
- An active rule exists for the driver, branch, rule type, and effective date.
- Rule-specific conditions match, such as zone, COD channel, peak window, batch size, or reason code.
Rule cannot be saved
Check:
- Required fields for the selected rule type are filled.
- Effective to is not before effective from.
- Active rule does not overlap another active rule in the same scope.
- Multiplier is greater than 1 for batch multiplier.
- Rate is greater than 0 for percentage COD commission.