Delivery Payroll Integration

Delivery earnings can be exported into existing HR payroll runs and later marked paid in Delivery after HR confirms payroll payment.

This feature reuses the HR payroll run, payslip, and payslip line workflow.

Supported Export Sources

Delivery payroll export supports:

• Direct selected approved earning entries.
• Approved payout batches.

Export Rules

Rule	Meaning
Approved only	Only approved delivery earning entries can be exported.
One branch	Direct selected entries must belong to one branch.
No direct batch bypass	Entries inside a payout batch must be exported from the payout batch workspace.
Payroll run required	User must select a visible HR payroll run.
Missing payroll setup skips	Entries missing payroll component, employee, or payslip are skipped with warning.
Export locks entry	Exported entries cannot be voided, removed from batch, or marked paid through standalone payout.

What Gets Posted To HR

Delivery groups export rows by:

• Payroll run.
• Employee.
• Payroll component.

One HR payslip line is created per employee/component total.

The system does not overwrite unrelated HR payslip lines.

Traceability

HR payslip line metadata stores delivery traceability:

• Source marker.
• Delivery earning entry IDs.
• Payout batch ID and reference when applicable.
• Branch ID.
• Export timestamp.
• Payroll export batch UUID.

This helps finance trace a payroll line back to its delivery earning entries.

Skipped Entries

The export can skip individual entries without blocking the whole export.

Common skip reasons:

Reason	Meaning
Missing payroll component	Earning entry cannot map to a payslip component.
Missing employee	Driver is not linked to an HR employee.
Missing target payslip	Selected payroll run does not contain a payslip for the employee.
Already exported	Entry was already posted to payroll.

Mark Paid From Payroll

After HR payroll is paid:

1. HR completes the payroll run payment process.
2. Delivery admin runs Mark Paid From Payroll.
3. Delivery verifies the payroll run is in a paid-complete state.
4. Matching exported entries become paid.
5. Paid state is terminal in Delivery.

If HR later reverses or voids a payroll run, Delivery entries do not automatically revert. Any correction must be handled manually through a future correction process.

Payout Batch Payroll Export

Approved payout batches can be exported to payroll.

After export:

• Batch remains approved.
• Batch shows payroll export indicators.
• Standalone Delivery mark-paid action is blocked for the batch.
• Entries are paid only after Mark Paid From Payroll succeeds.

Troubleshooting

Payroll export has zero exported entries

Check:

• Selected entries are approved.
• Selected payroll run belongs to the correct branch.
• Drivers are linked to HR employees.
• Payroll components are assigned to earning entries/rules.
• Employees have payslips in the selected payroll run.

Mark Paid From Payroll is rejected

Check:

• Payroll run exists and is visible to the admin.
• Payroll run is in a paid-complete HR state.
• Delivery entries are exported to that payroll run.
• Entries are not already paid.