Skip to main content

Pay Items & Monthly Matrix

Overview

Pay items are the building blocks of salary calculation: basic pay, allowances, deductions, CPF-liable components, and manual adjustments.

Routes:

  • Pay items catalogue — /pay/pay-items
  • Employee Pay Item Update (matrix) — /pay/payroll/pay-item-update

Pay items are classified as system, MOM/statutory, or custom. Items marked with a green Matrix label can receive monthly manual amounts on the Pay Item Update screen.

Unpaid leave — two mechanisms

Code Name How it works
UNPAID_LEAVE Unpaid Leave (Reduction) Attendance-driven day deduction — not entered on the matrix
UNPAID_LEAVE_CASH Unpaid Leave ($) Manual dollar amounts on Pay Item Update when Matrix is enabled

Important: Do not apply both mechanisms to the same leave event.

Step-by-Step Guide

Review the pay items catalogue

  1. Open Pay → Pay items (/pay/pay-items).
  2. Browse System, MOM, and Custom sections.
  3. Note items with the green Matrix badge — these accept monthly adjustments.
  4. Toggle Matrix on/off per item if you have configuration rights (save on this page).

Configure matrix-eligible items

  1. On Pay items, locate the item (for example AWS_13TH, PERF_BONUS, UNPAID_LEAVE_CASH).
  2. Enable Matrix if monthly manual entry is required.
  3. Save configuration.
  4. Amounts are not entered here — only eligibility.

Enter monthly matrix amounts

  1. Open Pay → Payroll → Employee Pay Item Update.
  2. Select the target month/year and batch if applicable.
  3. Columns represent matrix-enabled pay items.
  4. Enter amounts per employee row.
  5. Click Save Adjustments — mandatory before running payroll.
  6. Return to Payroll and Run Payroll to pick up values.

Unpaid leave best practice

  1. If attendance integration posts UNPAID_LEAVE automatically, do not also enter UNPAID_LEAVE_CASH for the same dates.
  2. Use UNPAID_LEAVE_CASH only when you need a manual dollar override outside attendance sync.
  3. Document exceptions in your internal payroll SOP.

Audit matrix changes

  1. Matrix saves are tied to the payroll period.
  2. Payroll approvers should reconcile matrix totals against supporting documents (bonus letters, adjustment memos).

FAQ

Q: Why is my matrix column missing on Pay Item Update?
A: The pay item may not have Matrix enabled on the Pay items page, or you lack permission to view salary data.

Q: Can I add a new custom pay item?
A: Owners and payroll admins can create custom items subject to subscription and compliance review. Consult your implementation consultant for CPF mapping.

Q: What does the green Matrix label mean?
A: The item appears as an editable column on Pay Item Update for the selected period.

Q: Do matrix values carry forward to next month?
A: No. Matrix amounts are period-specific. Re-enter or import each month as needed.

Q: How does unpaid leave from Leave module interact with Pay?
A: Approved unpaid leave may sync to attendance and payroll policy. Align Leave types, attendance confirmation, and pay item configuration with your HR policy.

No comments to display

Back to top