Driver Earnings

Driver Earnings is the admin workspace for reviewing and controlling driver earning entries.

Earnings may be generated automatically from driver earning rules or created manually as bonus/penalty entries.

Earning Types

• Per Delivery
• Zone Flat
• Batch Multiplier
• Peak Hour Bonus
• COD Commission
• Cancellation Compensation
• Bonus
• Penalty

Earning Statuses

Status	Meaning
Pending	Entry was generated or created but has not been approved.
Approved	Entry is approved and ready for payout batching or payroll export.
Exported To Payroll	Entry was posted into an HR payroll run and waits for payroll-paid sync.
Paid	Entry is settled in Delivery. This is terminal for the current workflow.
Void	Entry was cancelled before payout.

Admin Actions

Action	Allowed When	Result
Create Manual Bonus/Penalty	User has create permission	Creates a pending manual earning entry.
Approve	Entry is pending	Moves entry to approved.
Bulk Approve	Selected entries are pending	Approves selected entries.
Void	Entry is pending or approved	Moves entry to void with a reason.
Export To Payroll	Entry is approved, unreserved, and payroll-ready	Posts grouped lines into HR payslips.
Mark Paid From Payroll	Payroll run is fully paid	Moves exported entries for that payroll run to paid.

Manual Bonus and Penalty

Manual entries are used for adjustments outside automatic delivery rules.

Use Bonus when a driver should receive extra pay.

Use Penalty when a driver should have an amount deducted from earnings.

Manual entries start as pending and must be approved before payout.

Activity Timeline

The earning entry show page includes read-only activity history for important changes such as:

• Create.
• Approve.
• Void.
• Payroll export.
• Payroll-paid sync.

This gives admins an audit trail for payout-sensitive changes.

Export To Payroll

Approved entries can be exported directly to payroll only when they:

• Are approved.
• Belong to one branch.
• Are not already reserved in a payout batch.
• Are not already exported.
• Have a payroll run selected.

Entries missing payroll component, linked employee, or target payslip are skipped with warning.

Troubleshooting

Earning cannot be approved

Only pending entries can be approved.

Earning cannot be voided

Only pending or approved entries can be voided. Paid and exported-to-payroll entries are locked from normal voiding.

Earning cannot be exported

Check:

• Entry is approved.
• Entry is not already exported.
• Entry is not reserved in a payout batch.
• Payroll component exists if payroll export is required.
• Driver is linked to an HR employee.
• Selected payroll run contains a payslip for that employee.