Workforce

Run payroll

Prepare payroll inputs, create pay runs, generate payslips, lock periods, mark payment, and use localization tools.

Payroll is a sensitive module. /payroll requires the Payroll entitlement and SUPER_ADMIN or MANAGER. Several finalization and period lock actions require SUPER_ADMIN.

Prepare the period

Before calculation:

  1. Review attendance, overtime, approved excuses, and approved time off for the period.
  2. Confirm employee compensation, contracts, benefits, commissions, and any salary attachments.
  3. Resolve expenses marked for the next payslip.
  4. Confirm the working schedule and payroll period dates.
  5. Add permitted payroll adjustments from the main Payroll page.

Do not lock or finalize while material input disputes remain.

Create a pay run

Open /payroll/pay-runs and select the create action.

  1. Create the run for the intended period.
  2. Generate payslips.
  3. Review every employee result and the payroll register.
  4. Move the run from Ready to Done after review.
  5. Mark it Paid only after the payment process is complete.

The Pay Runs page describes the lifecycle as Ready, Done, and Paid. A permitted manager can revert a Done run to Ready when the workflow allows it.

Lock and finalize

Only a SUPER_ADMIN can lock or unlock a payroll period and run the final payroll action. A lock prevents edits that would change a closed payroll result.

Use register export and payslip print actions after confirming the period, workspace currency, and final state.

Other payroll routes

RoutePurpose
/payroll/work-entriesWork entry review
/payroll/working-schedulesPayroll working schedules
/payroll/attachmentsSalary attachments
/payroll/commissionsCommission runs
/payroll/payoutsPayout methods and runs
/payroll/reporting/analysisPayroll analysis
/payroll/reporting/headcountHeadcount reporting
/payroll/reporting/work-entriesWork entry reporting

Localization routes exist for the United States, Saudi Arabia, and the UAE. They contain jurisdiction specific forms and exports. Responsible payroll and tax professionals must review compliance output before filing or payment.

Common problems

What you seeWhat to check
Payroll is missingThe module or plan entitlement is unavailable, or your role is not SUPER_ADMIN or MANAGER.
Payslip calculation is wrongReview compensation, work entries, attendance, approved leave, and adjustments before changing the run state.
Period is lockedA SUPER_ADMIN must review whether reopening is appropriate.
Mark Paid is unavailableThe run has not completed the required Ready and Done steps.
Localization form is incompleteComplete the employee and workspace jurisdiction fields required by that route.