Payroll

The Payroll module is for paying your staff — instructors, coaches, managers, front desk team. It generates payslips (or whatever document name you choose), tracks payment status, and supports several common pay structures.

After enabling the module, you'll see Payroll in the sidebar with these sub-pages:

The Payroll Staff list is the union of all active instructors (always payable) and team members opted in via a checkbox on their edit dialog. Each entry shows an Instructor or Team badge.

By default, team members aren't on payroll — most don't get paid (e.g. volunteers, owner family). To include one:

A pay type defines what a payment is for and how the amount is calculated. Manage them in Payroll → Settings → Pay Types.

There are two ways to pay by the hour:

Rates for manual per-hour pay types are configured in Payroll → Settings → Hourly Rates.

Malaysian statutory contributions — EPF, SOCSO, EIS, PCB — are controlled in Payroll → Settings → Statutory Deductions. Each is a master on/off switch for your whole organisation. EPF, SOCSO, and EIS auto-calculate from gross taxable earnings; PCB is entered manually per record unless auto-PCB is set up.

Each pay type separately marks which schemes it counts toward. A deduction only happens when both the pay type's tag and the organisation-wide switch are on — turning EPF on in Statutory Deductions starts deducting it for every pay type already tagged, no need to touch each one.

Each pay type has a Document Label (e.g. "Payslip", "Payment Voucher", "Commission Statement") — what prints as the heading on the PDF.

Pay types can be marked recurring. When recurring, REMMU auto-generates a payroll record every month for any staff member who has a rate set for that pay type. Payroll runs on a monthly cycle configured once in Payroll → Settings → Pay Cycle, billing for the month that just ended.

Allowances are extra earnings added on top of base pay — travel, phone, meal allowances, bonuses. Manage them in Payroll → Settings → Allowances. Each has a name, a default amount, a recurring toggle, and statutory toggles (off by default — turn on for allowances that genuinely count toward a scheme's base).

Custom Deductions are take-backs subtracted from pay — late penalties, salary advance repayments, uniform fees. Manage them in Payroll → Settings → Custom Deductions, with the same name/amount/recurring/statutory structure as allowances.

Hourly Rates power the Manual Per Hour calculation method — instead of one rate per instructor, keep a list of named rates (e.g. "Standard", "Private", "Workshop"), and finance staff enter hours against each when generating payroll.

Manage the tenant-wide list in Payroll → Settings → Hourly Rates. An instructor can also have their own custom rate list instead of the global one, set from their profile's Manual Hourly Rates section.

Day-based payments can carry a Work date (optional) so you can say which day, or range of days, a payment is for instead of typing it into the description. Enter it on the entry form for flat/manual pay types, or in Edit for any type. The Work date shows as a tag under the pay type in the Records list, in the record details, and on the payslip's Pay Period (a single day prints as that day rather than the month). The Records list also has a Work date range filter.

Go to Payroll → Generate, pick the staff member and pay type, set the reference month and (for hourly/per-class) the period, and REMMU auto-fills the amount where possible. Use Fetch from attendance or Fetch from student payments to pull rate-based amounts automatically.

To create payroll entries for many staff at once, go to Payroll → Generate → Bulk Generate: pick the reference month, optionally pick specific pay types, and REMMU shows a preview split into calculated pay (pre-selected, ready to go) and manual per-hour (enter hours per rate). Expand any row to see the full breakdown, then untick anyone to exclude and click Generate entries.

Staff who already have an entry for the month are skipped automatically. All bulk-generated entries start as unpaid.

Hours entered for per-hour instructors auto-save as a draft, so you can leave and come back later without losing your work.

Team members with payroll permissions can generate records but can't self-approve — their records start in an Awaiting Approval state until an admin approves them. Records generated directly by an admin are already approved. Admins approve individual records or use Approve all on the Payroll dashboard.

Payroll → Cost Forecast shows what payroll will cost for the selected month — cost so far, projected month-end, and remaining to incur — broken down by pay type and instructor. It's a read-only planning view that never creates records, and honours your calendar (holidays/closures subtracted).

A class only appears in the forecast while it has a live, active student — no need to archive a class to keep it out of the forecast; setting the enrollment or student inactive is enough.

Payroll → Month Audit gives finance a full, downloadable breakdown of one month's payroll — staff count, gross, statutory deductions, net, paid, and outstanding, with a per-record itemised table and a PDF export.

Every payroll record generates a PDF using the document label from its pay type, with your tenant header, pay period, a calculation line specific to the pay type, adjustments, total, and a paid/unpaid/cancelled watermark.

Once you've paid a staff member, open the record, click Mark as Paid, fill in payment method, reference, and paid date, and optionally attach a payment proof. The status flips to Paid and the staff member is notified automatically.

To pay several records at once, select them and use the bulk Mark as Paid. You can Attach payment proof (an image or PDF, e.g. a single bank transfer receipt covering the batch) and it's attached to every record. If the proof upload fails, the records are still marked paid — the dialog lists which ones need the proof attached again.

Configure prefix, padding, reset schedule, and default payment due days under Payroll → Settings → Document Settings. Optionally enable a separate numbered remittance-advice document stamped when a record is marked paid.

If a record was created in error, open the record menu → Cancel, pick a reason, and add optional notes. You can't cancel a record that's already paid — refund or reissue separately if needed.

Each instructor's profile has a Payroll section (visible when the module is on) for setting their monthly salary, hourly rate, per-class rate, and commission %, plus which day of the month their payroll generates on (or use the tenant default). It also has a Manual Hourly Rates section for their named per-hour rates, inheriting the tenant-wide list by default.

Each instructor also has a Statutory Profile storing their identification numbers and tax settings — used to calculate EPF, SOCSO, EIS, and PCB and printed on payslips.

EPF — mark exempt, or set a custom voluntary rate on top of the standard employee rate.

SOCSO — mark exempt, or pick a scheme (standard for staff under 60, or the reduced scheme for staff 60+).

EIS — mark exempt for exempt categories.

PCB (income tax) — REMMU can auto-calculate monthly PCB using LHDN's MTD method from tax category, children relief, citizenship, age category, and allowable deductions/zakat. A manual override lets you enter a fixed monthly amount instead.

For instructors paid per class or per hour, you can set a different rate for each class they teach instead of one flat rate everywhere. Enable it on the pay type in Payroll → Settings → Pay Types, then set a custom rate per class when assigning the instructor — leave it blank to use their reference rate.

Instructors and team members included in payroll get a dedicated My Payroll page showing their own payslip history — paid this year, pending amount, and total records — with a downloadable PDF per payslip. Staff can never see other people's payroll records.

The Payroll Dashboard summarises total paid, total pending, record counts by status, and a per-staff breakdown when you drill into a staff member's profile.