Ritzy One • User Manual

Payroll

Run the monthly payroll end to end — keep employee records, set up allowances, deductions and loans, process and post salaries for a period, hand out payslips, pay the bank file, track leave and document expiry, and read the whole picture back as salary lists, posting summaries and payslips.

Applies to Ritzy One (web)  |  Audience: HR & Payroll users  |  Sign in as ADMIN for set-up

1 What is the Payroll module?

Payroll turns your employee records into a monthly pay run. You set up who works for you and how they are paid once; each period you generate the salaries, adjust for the month’s extras and absences, check what changed, then post — which pays the staff out of a bank account and closes the month.

Payroll sits in its own Payroll section of the menu bar, with its own Dashboard, Quick View, Transactions, Masters and Reports. It is a separately licensed module: if you cannot see the section, Payroll is not switched on for your company.

How it meets Accounts

Payroll writes ordinary journal vouchers into Accounts — nothing is kept in a private ledger. There are two of them per month, and knowing which is which explains almost every question about the module:

JournalWritten whenWhat it says
Salary GenerationEvery time you click Generate — the same voucher is rewritten, not added toDebits each salary expense account, by department; credits each employee’s account with what they have earned. The company now owes the staff.
Salary PostingOnce, when you click Post…Debits each employee’s account, clearing what is owed; credits the bank or cash account they are paid from. The staff have been paid.

Each employee has their own account in the chart, in the Employees subgroup under Current Liabilities (code 2106 in the standard chart; an employee’s account is 2106A001 and so on), since what the company owes its staff is a liability. Companies set up with the older 1206 codes under Current Assets were re-coded automatically, keeping each account’s suffix and every posted voucher with it.

Generate is repeatable, Post is not
Re-generating rewrites the generation voucher in place, so you may generate as often as you like while you are still working on the month. Posting is the end of it: a posted month can no longer be generated, cleared or re-posted. See §7.
Payroll’s journals are changed only from Payroll
Accounts recognises the Salary Generation and Salary Posting journals, and the journal behind each staff loan, and will not edit or cancel them: This voucher was posted from Payroll. Change it from Payroll (Generate / Clear the salary, or the Loan screen). This keeps the ledger and the payroll month in step. If one of these journals was cancelled before this rule applied, Payroll does not write into it again — the next Generate, Clear or loan change raises a new journal instead.

2 Before you start

Who can do what

Every Payroll screen is a menu item with its own permissions, granted under Tools → User Manager. Payroll uses all of them:

RightOn a payroll screen it means
ViewOpen the screen and read it.
Add / EditCreate and change records — including Generate on Salary Process.
DeleteRemove records — including Clear on Salary Process.
PostPost the salary period. Keep this narrow; it is the step that cannot be undone.
PrintPrint and email payslips, and download the bank transfer file.
Staff do not need a Ritzy login
Employees see their own payslips, leave and contract in the Ritzy Employee phone app, which has its own sign-in: tick it on the employee’s record and give them a password (§9). They are not application users, and the rights on this page are only for the people who run the payroll.

The financial year and its periods

Payroll works one period (calendar month) at a time inside the financial year chosen in the top bar. The periods themselves come from Accounts, so a month exists for payroll only if it exists as an accounting period.

Set-up order

  1. Masters — Positions, Payments, Documents, Leave Types (§3). Everything else picks from these.
  2. Employees — the register, with each person’s pay components, leave entitlement and documents (§4).
  3. Payroll Settings — the weekly holiday, the year’s public holidays and the expense claim accounts (below).
  4. Permissions — who may process, who may post, who gets self-service.
  5. Alerts — optional, and the cheapest thing in the module: a few minutes to set up, and visas stop expiring unnoticed (§11).

Payroll Settings

Payroll → Settings → Payroll Settings (also under Tools → Preferences) holds three cards. Its rights start as the rights on Salary Process.

CardWhat it does
Weekly HolidayNone, Friday, Friday & Saturday, Saturday & Sunday or Sunday. These days are not counted when a leave entry works out its days. A change needs a From month, and only months after the last one generated are offered: each month keeps the weekly holiday it was paid under, so changing it never re-counts leave already in a generated or posted payroll.
Holiday CalendarThe public holidays of a financial year, which leave days also skip. Once a month’s payroll is generated, its holidays are locked: they can be renamed, but not added, moved or removed.
Expense Claim AccountsThe expense account each claim category is booked to by default: the Employee app’s nine categories (Travel, Fuel, Taxi / Parking, Meals, Accommodation, Phone / Internet, Supplies, Medical, Other) plus any an employee has typed, with how many claims each has. Approving a claim suggests this account (§5).

3 Masters — the vocabulary

Under Payroll → Masters. These four lists define the words every employee record and salary line is built from, so create them before adding people.

Positions, payments, documents and leave types can also be loaded from a spreadsheet with Import CSV on their screens, or from Tools → Import (CSV) — see Importing Masters from CSV.

Position

Job titles — Accountant, Operations Officer, Driver. One field, and it prints on the payslip. A position in use on an employee record, an employment contract or a payslip cannot be deleted; the refusal says where it is used.

Payments

The pay components: every earning and every deduction that can appear on a payslip. This is the master that repays careful thought.

FieldWhat it does
Payment DescriptionWhat the employee reads on the payslip — Basic Salary, Housing Allowance, Staff Loan.
CodeA short code of your own, for reports and sorting.
Payment TypeFour kinds — see the table below. This decides both the sign and where the component may be used.
Expense A/CThe account this component is charged to in the salary journal. Offered from your profit-and-loss expense accounts and balance-sheet accounts.
Basic PayTick the component that is the basic salary. It sorts first on the payslip and marks the figure other rules read: the automatic Leave Deduction counts only Basic Pay components, not allowances.
Display OrderThe order components appear in. Leave it blank and Ritzy numbers them for you.
Payment TypeUsed onEffect
1 — Payment (fixed monthly)The employee recordPaid every month without being re-entered. Increases pay.
2 — Deduction (fixed monthly)The employee recordDeducted every month. Reduces pay, whichever sign its amount is typed with.
3 — Addition (one-off)Add/Deduction, for one periodThis month only — overtime, a bonus. Increases pay.
4 — Deduction (one-off)Add/Deduction, for one periodThis month only — a fine, an advance recovered. Reduces pay.
Fixed or one-off, not both
A component that changes every month (overtime) should be type 3 or 4 and entered on Add/Deduction. A component that is the same every month (housing) should be type 1 or 2 and sit on the employee record, where it is paid without anyone having to remember it.

Every company starts with Expense Reimbursement (code EXR, type 3), the addition approved expense claims are paid as. It posts to the account your Basic Pay uses until you change it here. A new company’s other components come linked to their own accounts: Basic Pay and Overtime to Salaries, House Rent Allowance to Staff Accommodation, Leave Deduction to Leave Deduction, Insurance to Employee Insurance Payable and Incentives to Gratuity/Bonus/Ex-Gratia.

A payment cannot be deleted while it is on any employee’s salary lines, salary history, payslips, additions/deductions (cancelled ones included), contracts or expense claims, or while Payroll Settings name it as the overtime, leave, timesheet or contribution payment; the refusal says where it is used. Once a payment is in use (salary lines, payslips, additions/deductions, contracts or Payroll Settings) its Payment Type cannot be changed either: create a new payment instead.

Documents

The document types you track per employee — Passport, Visa, Labour Card, Contract. A code and a name; the expiry dates live on each employee record and drive both the Document Expiry report and the daily alert.

Leave Types

Annual, Sick, Unpaid, Compassionate — with the rules that make balances work by themselves.

FieldWhat it does
Leave NameWhat staff see when applying.
KindPaid Leave — normal, salary unaffected. Unpaid Leave — taken without pay. Deduct Salary — pay is reduced by the deduct factor.
Deduct FactorDays of salary lost per day of leave: 1 a full day, 0.5 a half day, 0 nothing. It cannot be negative, and it cannot be changed once the type is on leave in a posted payroll month: create a new leave type for the new factor.
Days per YearThe annual entitlement. One twelfth of it accrues each month, automatically.
Max BalanceThe most that may be carried. Accrual stops at this ceiling, so unused annual leave does not pile up for ever.

A leave type cannot be deleted while it is on leave entries (cancelled ones included), leave requests, timesheet days or an employee’s entitlements, or while it is the Annual Leave Type in Timesheet Settings; the refusal says where it is used. The system leave types cannot be deleted at all.

Entitlement grows on its own
You do not credit leave to anybody. Each time a payroll period is generated, Ritzy advances every employee’s accrual by one month of Days per Year ÷ 12, up to Max Balance, from their joining date onward. Set those two figures on the leave type and the balances look after themselves.

4 Employees

Payroll → Masters → Employee is the register of everyone on the payroll. Each record carries the personal details, the employment dates, the pay components, leave entitlements, documents, bank details and a photo.

  1. Click New — the next employee code is allocated for you.
  2. On General, fill the name, Date of Joining, Department, Position and Reports To.
  3. On Payments & Deductions, add the fixed monthly components and their amounts.
  4. On Leave, add the leave types this person is entitled to, with any opening balance.
  5. On Documents, list passport, visa and contract with their expiry dates.
  6. On Others, set Pay From A/C — the payroll cannot be posted without it — plus the bank account number. To give the employee the phone app, tick May sign in to the Ritzy Employee app and generate a password (§9).
  7. Click Save.
Employee
E0042
Daniel Okafor
Operations Officer
15/06/2026
E0007 — Maria Santos
15/09/2026
Pay components
ComponentAmount
Basic Salary450.000
Housing Allowance150.000
Transport Allowance50.000
Save
An employee record — personal details, position, reporting line and pay components in one place.

The tabs

TabHolds
GeneralName, ID and national ID, gender, date of birth, marital status, blood group, address and contact details, passport number, department, position, Reports To, and the three dates that matter — joining, confirmation and retirement.
Payments & DeductionsThe fixed monthly components (types 1 and 2) with their amounts — this is the salary. Below the grid, the change history (see below).
ProfileQualifications, previous employment and emergency contacts.
DocumentsPassport, visa, contract and the rest, with issue and expiry dates.
LeaveThe leave types this employee is entitled to, their opening balance and what has accrued.
ContractsThe employee’s employment contracts, newest first, with a New Contract button. Shown when editing an existing employee, to users with rights on Employment Contracts (§13).
OthersPayslip delivery (none / print / email / both), Pay From A/C, bank account number, the salesman link, and the Ritzy Employee app sign-in: whether the employee may use the app, and their password (§9).

Dates worth filling in

Four dates on General do more than record history:

An alert can only warn you about a date you have entered; an empty field is simply silent.

Reports To — the reporting line

On the General tab, Reports To names the employee’s supervisor. It does two jobs: it draws the Reporting Structure chart on the Payroll Dashboard, and it decides who approves this person’s leave (§6). Leave it blank and their requests go to the HR desk instead. An employee cannot be set to report to themselves.

Profile tab

The Profile tab holds the parts of an HR record that are not pay: qualifications (education or professional), previous employment and emergency contacts. Tick one contact as Primary — that is the number called first, and ticking a new one clears the old.

Salary change history

Every change to an amount on the Payments & Deductions tab is written to a log that cannot be edited: what it was, what it became, who changed it and when. Type a short Reason for change before saving a raise — the figures record themselves, but only you can say why. The history appears under the grid whenever you edit an employee, and it is the answer to “when did this allowance change, and who approved it?”

Leavers

Set an employee Inactive rather than deleting them. Inactive employees are left out of the next generate but keep their history, their payslips and their ledger account. Use the Active / Inactive / All filter at the top of the list to find them again. Nothing new can be entered for an inactive employee, or dated before an employee joined: timesheet days, additions/deductions, loans, leave entries and approvals, and contracts are refused. Their existing entries can still be corrected. Deleting an employee is possible only while nothing refers to them, and it takes their history with it.

Quick View

Payroll → Quick View gives a fast, read-only look at any employee — useful for a phone call you do not want to open the full record for, and safe to grant to people who should look but not touch.

5 The month’s inputs

Three transaction screens feed the salary run with the month’s variables. Enter them before you generate the period, or generate again afterwards so they are picked up.

Add/Deduction

Payroll → Transactions → Add/Deduction records one-off earnings and deductions for a single period — overtime, a bonus, a fine. Pick the employee, the component (payment types 3 and 4 only), the amount and a narration; the narration prints on the payslip beside the line, so use it.

Enter the amount as a positive figure, a deduction too: the component’s type decides whether it is added or deducted. A negative amount is refused, on the screen and in a bulk import.

Rows belong to the financial year and period at the top of the screen, which opens on the current month. An add/deduction entered against the wrong month is the commonest cause of “the payslip is wrong”.

Loan

Loan registers a staff loan: the amount, the instalment and when repayment starts. Each period’s salary then carries that instalment as a deduction automatically until the loan is cleared, and the Loan List report shows how much is left.

Every instalment needs a date and an amount above zero. No instalment can fall before the employee’s joining date or in a payroll month already posted (an existing loan keeps the posted instalments it already had, but a copy of one is refused), and the balance cannot be more than the loan amount. A loan belongs to the financial year of its date, which must be in the year picked in the top bar; its date cannot be moved into another year.

Opening Balance is what was owed when the loan was entered, and posting never changes it. When you edit a loan, Recovered so far and Balance Now beside it show what the posted payrolls have taken back and what is left.

Once a salary is generated with the loan’s instalment in it, that instalment is used. The loan can then no longer be cancelled, its used instalments are read-only, and the employee, date, loan amount, opening balance and start month are locked (shown grey). Apply Schedule rebuilds only the instalments still to come, and they must still add up to the opening balance. An instalment is used only when its employee is in that month’s payroll. A balance too small to split into whole units (1.000 over 3 instalments, say) is spread to the fils, or taken as one instalment when even that rounds to nothing.

Cancelling a loan from the loan list asks Cancel this loan? If none of it has been repaid, its journal is cancelled in Accounts too. A loan nothing has been repaid on is cancelled together with the journal that paid it out — the journal stays in Accounts, marked cancelled, with its ledger effect reversed. Once an instalment has been deducted, the loan can no longer be cancelled.

Stopping a loan early. For a loan that is being repaid, the loan list has Stop: deduct the rest in one go. Everything not yet deducted becomes a single instalment, taken in full from the next salary due, and the loan ends with that month. The instalments already deducted stay as they are, and so does the loan’s journal: the payroll still recovers the whole balance. If that month’s payroll is already generated, Post works it out again, so the payslip deducts the new amount.

Leave Entry

Leave Entry books leave that has already been agreed, against a leave type. It reduces the entitlement balance as soon as it is saved. A leave whose type has a deduct factor (an absence, such as Absent or Absent Half-day) also reduces the salary, but only once it is posted.

  1. Save the absence. It shows an orange Not posted tag and can still be edited.
  2. Click Post on the entry. The month’s Leave Deduction is written in Additions / Deductions: one thirtieth of the employee’s Basic Pay components for each day deducted, times the deduct factor. The entry shows a green Posted tag (hover it for who posted it and when) and can no longer be edited.
  3. If the month is already generated, the warning tells you to generate it again so the payslip follows.

Annual and Sick Leave reduce no salary, so there is nothing to post: they stay editable. Leave over the balance of a balance-tracked type, such as Sick Leave with none left, is refused; enter the extra days as Absent.

An entry is never deleted. Cancel it with a reason: it no longer counts against the balance or the salary (a posted absence has its deduction taken out), but it stays on the list struck through with a red Cancelled tag, and its printout carries a CANCELLED stamp. An absence can be cancelled until the employee’s payroll for that month is posted. If the entry came from an approved leave request, the request is marked withdrawn. Print prints one entry, or the list from the toolbar; untick Show cancelled to leave cancelled entries out.

Generate deducts posted absences only. An absence in the month that is not posted is left out, and Generate names it in a warning: post it, then generate again. Saving a change to an employee’s pay works the posted absences of every open month out again.

Leave that overlaps leave already recorded for the employee is refused, with the dates of the existing entry (and posted from the timesheet when it came from there), so no day is counted twice. An absence in a month whose payroll is already posted for the employee cannot be added, changed, posted or cancelled.

A leave must start and end on a working day. A From or To date on the weekly holiday or a holiday in the Holiday Calendar is refused, for example The From date 06/11/2026 is a weekly holiday (Friday). A leave must start and end on a working day. Days off inside the leave are allowed, and are not counted. The same rule applies to leave requests and their approval.

For an employee on timesheet, leave cannot contradict the timesheet. A working day the timesheet already fills is refused: with the same leave (Timesheet leave becomes a leave entry when the month is posted…, so it is not entered twice), with another leave type, or with hours worked (The timesheet shows … at work on …, which clashes with this leave.). Correct the timesheet day first, or choose other dates. When you edit an entry, its own days are allowed. Leave requests and approvals are checked the same way, and a request is refused straight away when Leave Entry, or leave posted from the timesheet, already covers its dates. The check is made again at the moment of saving, so a timesheet day and a leave saved by two people at the same time cannot both get in.

Absences entered before the Post button
Absences saved before the Post button existed were deducted when they were saved, so they show as Posted (with no name or time), and every month’s salary stays as it was.

For an employee on timesheet, Post Timesheet writes the leave days of the month’s timesheet here, shown with a blue Timesheet tag. They count against the balance like any other entry, but cannot be edited, posted or cancelled here: change the timesheet days and post the month again (see the Timesheet manual). Their salary deduction comes from the timesheet, not from Salary Process. A month whose timesheet is posted for an employee stays that way even if their timesheet option is turned off later, so the same absence is never deducted twice; turning the option on or off works the open months’ leave deduction out again straight away. Payroll’s own Leave, New Joiner and Leaver deductions never overwrite the lines Post Timesheet wrote.

Order of work
Add/deductions, loans and leave → Generate → review and compare → Post.

Expense Claims

Employees claim back what they spent for the company from the Ritzy Employee app: on the Expenses tab they photograph the bill (up to six photos, or a PDF), enter the date, what it was for, the amount and any details, and send it. The users with Edit on Expense Claims are notified.

  1. HR opens Payroll → Expense Claims, which opens on the claims still to do. Click the employee to see the claim with its photos.
  2. Verify once the bill matches the claim, or Reject with a reason the employee sees on their phone.
  3. Approve a verified claim: enter the Approved Amount (at most what was claimed) and the Expense account it is booked to, with a note if you pay less. The account offered is the category’s default from Payroll Settings, else the one last used for that category. The employee is told; nothing reaches the payroll yet.
  4. Post the approved claim: choose the Payroll month and the addition it is Paid as (payment type 3; Expense Reimbursement is offered first). The months offered are the open ones of the year in the top bar and of the year after; it suggests the current month, else the next open one. Post writes the addition into that month with the narration Expense claim <no>: <what for>. If the month is already generated for the employee, it goes straight onto their payslip and into the generation journal (debit the expense account, credit the employee), so the payslip is not left out of date and the claim is paid with the salary without generating again.
StatusMeans
PendingSent by the employee; they may still withdraw it.
VerifiedHR has checked the bill.
ApprovedAmount and expense account agreed; waiting to be posted. Take back returns it to Verified.
PostedIn a payroll month. It is paid with that month’s salary, and its Add/Deduction row cannot be edited or deleted.
Rejected / WithdrawnClosed, by HR with a reason, or by the employee.

A claim cannot be posted for an inactive employee, into a month before they joined or after the month of their leaving date, into a payroll month already posted, or into a month their salary is already posted for. Generate books a posted claim to its own expense account, not the payment type’s. Rights: View sees the claims, Edit verifies and rejects, Add approves and takes back, Post posts; they start as the rights on Add/Deduction.

6 Leave Request — asking and approving

Leave Entry records leave that has already been agreed. Leave Request is the other half: the employee asks, and their supervisor decides.

  1. The employee opens Payroll → Transactions → Leave Request and clicks Apply for Leave. Their remaining balance for each leave type is shown at the top of the screen, so they can see what they are spending before they spend it.
  2. The request goes to the person named in Reports To on their employee record, who receives a notification. If nobody is named, it goes to the HR users who may edit Leave Entry, including members of Payroll’s ADMINISTRATOR group.
  3. The approver opens the Approvals tab and approves, or rejects with a reason. Either way the employee is notified, and a rejection carries the reason back with it.
  4. A request can be withdrawn while it is still pending, and after approval up until the day the leave starts.
A request is not leave until it is approved
A pending request uses no entitlement and deducts nothing from salary. Approving it creates the ordinary leave entry — the same record Leave Entry would have made — and only then does the balance move. An absence reaches the salary when HR posts the entry on Leave Entry. Withdrawing an approved request removes that entry again while it is not posted; once HR has posted it, HR cancels it on Leave Entry instead. The check looks at the entry as it is now, so a withdrawal is also refused when the entry has become timesheet leave, or HR has moved it into a posted month that deducts salary.

Employees apply in the Ritzy Employee app, and their supervisor (Reports To on the employee record) approves it in the same app, on the Approve tab. Approving is a matter of the reporting line, not the menu: the server checks on every decision that the employee really does report to the person deciding, or that they are HR.

On the web, Payroll → Leave Request is HR’s screen (it needs Edit on Leave Entry). Approvals lists the requests whose supervisor is not set or cannot sign in to the app, and HR is told of those in the inbox; All Requests shows every one, and HR can approve or reject any of them. File a Request files one for an employee who asked by phone or in person.

What to set up
Switch the app on for the employees who should apply (§9), and for their supervisors too, and set Reports To. Nobody needs a Ritzy login or a right for this.

7 Processing a salary period

The heart of the module is Payroll → Transactions → Salary Process. Pick the financial year in the top bar and the month in the period list (it opens on the current month) — each month is labelled Generated or Posted so you can see at a glance where you are.

  1. Generate. Click Generate. Ritzy builds each employee’s pay from their fixed components, folds in this month’s add/deductions and loan instalments, accrues a month of leave for everyone, prorates mid-month joiners, and writes the Salary Generation journal.
  2. Review. The grid lists every employee with their net pay; select a row to see the payslip lines behind it. Re-generate as often as you like.
  3. Check what changed. Click Discrepancy… to compare this month with the one before it.
  4. Post. Click Post…, confirm the posting date, tick the employees to pay, and post. On a month not yet closed, Post generates it once more first, so a change made since the last Generate is always paid. This writes the payment journal for the employees posted. The month closes once every employee in it is posted.
Additions and deductions are cancelled, never deleted
On Payroll → Transactions → Additions / Deductions an entry has Cancel instead of Delete. Cancelling asks for the reason, then takes the entry out of the salary: Generate and Post no longer pay it. It stays on the list, struck through and tagged Cancelled (hover the tag for who cancelled it, when and why), and Show cancelled hides or shows such entries. Each entry has a Print slip, and the toolbar's Print prints the month's list; a cancelled entry prints with the red CANCELLED stamp across the page, its cancellation line and reason.
  • Only an entry that can still change can be cancelled: the month is open, the employee is not posted in it, and it is not a line an expense claim posted.
  • Lines the payroll works out itself (Leave Deduction, New Joiner Deduction, Leaver Deduction) and timesheet lines are tagged Automatic and cannot be cancelled: change the leave, the dates or the timesheet instead.
Audit Log
Every payroll action is recorded with who did it and when: Generate, Post and Clear; additions and deductions added, changed, imported and cancelled (with the reason); loans added, changed, stopped and cancelled; employees added, changed and deleted; contracts; expense claims verified, approved, rejected and posted; payslips e-mailed; Payroll Settings and the payroll masters; and, as before, leave and timesheet actions. Open it from Audit Log on the Salary Process screen (anyone who can open Salary Process can read it). Filter by date, user, area (Payroll, Leave, Timesheet) and action. Administrators also see these lines in Tools → Transaction Log.

What the month view warns you about

Select an employee to see their payslip lines and, below them, the month’s loan instalments, which net pay has already deducted.

Salary Process — July, 2026
EmployeeEarningsDeductionsNet PayStatus
Daniel Okafor650.00045.000605.000Pending
Maria Santos520.00030.000490.000Pending
James Okoro780.000120.000660.000Pending
GeneratePost…Discrepancy…Bank Transfer…Email AllClear
A generated period, ready to review and post.

What Generate does, in order

Checking the month before you post it

Nobody can read two hundred payslips, so the useful question is not “is this right” but “what changed since last month, and did we mean it”. Discrepancy… answers exactly that: it compares this month against the previous generated month and lists only the employees who differ, biggest change first.

Months that were never generated are skipped when choosing what to compare against, so a gap in processing does not report the whole payroll as new. The Payroll Discrepancy report (§10) runs the same comparison across a range of months.

Posting

Post… opens a dialog with the posting date and the list of employees not yet posted, all ticked. Untick anybody who is not being paid in this run.

Clear — the undo, while you still have one

Clear throws away a generated month: the figures, the payslips and the contents of the generation journal (its voucher number is kept and reused next time you generate, unless that journal has been cancelled in Accounts, in which case a new one is raised). Use it when you would rather start the month again than patch it.

Generate, Clear and Post check the month end against closed accounting periods and years, and Post refuses if the month’s generation journal is missing or cancelled.

Posting is per employee
Posting some employees of a month locks only them: their payslip, additions and deductions, leave in that month and loan instalment can no longer change. For everyone else the month stays open, shown as Partly posted: their additions, deductions and leave can still be entered, and Generate works out just them again (and adds anyone who joined since), leaving the posted employees’ payslips and journal lines as they are. Clear is off once anyone is posted. Ritzy 8 closed the whole month at the first post; Ritzy One does not.
  • In order. Each employee’s months are posted oldest first. Someone back from a long leave, unposted for several months, has those months posted one after another; Post names the earlier month if you try a later one first.
  • Closed. The month closes once everyone in it is posted. A closed month is never generated again: someone who joined in it and is not in its payroll is paid for it by Accounts directly, with a payment voucher.
  • Timesheet. The month’s timesheet can no longer be posted or unposted once anyone in that month is posted.
Clear works only before posting
Once a month is posted it is closed: Clear and Post… refuse it, and Generate only adds employees not yet in it. A correction to a posted month is made in Accounts, as a journal voucher, like any other correction to a closed period — which is also why the Discrepancy… check belongs before you post, not after.

8 Payslips and paying the salaries

Paying — the bank transfer file

On Salary Process, click Bank Transfer… for the month. Ritzy shows what it is about to hand the bank — the total, the number of employees, the value date, and a line per person — and Download File writes it as a CSV you can upload or pass to your bank.

The Bank Transfer report (§10) reads the same figures back over a date range, for checking what was paid.

Payslips

Once a period is generated you can hand out payslips from Salary Process or from Reports.

Payslip totals
Earnings show as positive and deductions as negative; the net pay is the sum. If a payslip looks blank or unbalanced, generate the period again and reprint — the payslip is rebuilt from scratch every time.

9 The Ritzy Employee app

Ritzy Employee is the payroll module turned around to face the employee, on their phone. It is a web app installed to the home screen (no app store), and it works on Android and iPhone. Not every employee is a Ritzy user, so the app has its own sign-in: the employee chooses the company and signs in with their Employee ID (the ID No on their HR record) and a password HR gives them. They see their own record and nobody else’s.

The tabs run along the bottom of the screen. The header shows the tab and the employee’s name, with Refresh and Sign out.

TabWhat the employee sees and does
ClockWith the Timesheet add-on, for employees on timesheet only — and the tab the app opens on for them. Clock in and out, choosing the job they are working on (from their department’s jobs, or the jobs assigned to them); the job stays locked until they clock out. Staff allowed to work from home choose Office or Home, and can switch during the day. See section 13 of the Timesheet manual.
HomeTheir photo, position, department and who they report to. Four tiles: Last payslip (net pay), Leave balance (with requests awaiting approval), Documents expiring within 90 days, and Loan outstanding. Their employment contracts, with Sign now on one HR has issued (§13); documents needing attention, expired ones in red; My details (Employee ID, joining and confirmation dates, mobile, email, bank account); the Notify me on this phone switch; and Change my password.
PayslipsEvery closed month with its net pay. Tap one for the slip: payments and deductions with their narrations, totals, net pay in the company currency and the bank account it was paid to.
LeaveA tile per leave type they are assigned, with the balance and “taken of entitled”. Apply for leave (type, from, to, reason) sends it to their supervisor (§6). Their requests list shows each status and a rejection’s reason; Withdraw works while a request is pending, and on an approved one until the day the leave starts.
ExpensesNew expense claim: photos of the bill (up to six, from the camera or gallery, or a PDF; photos are shrunk before sending), the date (not in the future), what it was for (a category or their own words), the amount and details. Their claims show the amount, status and photos, the approved amount when HR paid less, and a rejection’s reason; a total Waiting for HR is shown at the top. A claim can be withdrawn while it is still Pending. HR’s side is in §5.
ApproveOnly for someone with people reporting to them (or who may decide leave): their team’s pending leave requests, each with Approve and Reject (with a reason the employee sees), and the twenty most recently decided.

When a contract is waiting for their signature, a banner above every tab says so, with Open. Signing means reading the contract, typing their full name, drawing their signature and ticking that they accept; or they send it back to HR saying what needs to change.

Notifications on the phone

The employee turns on Notify me on this phone on Home and allows notifications when the phone asks. They are then told when their leave is approved or rejected, when an expense claim is approved or rejected, and when HR issues them a contract; a supervisor is also told when a leave request arrives. If the switch says notifications are blocked, they allow them for the app in the phone’s browser settings. The switch is per phone.

Giving an employee the app

  1. Open the employee in Employee Master. Make sure the ID No on the General tab is filled in: it is their sign-in name, and no two employees with the app can share one.
  2. On Others, tick May sign in to the Ritzy Employee app. A password is generated for you; click Generate for another, or type your own (at least 6 characters).
  3. Click Save, and give the employee their ID No and password. The password is stored encrypted and is shown only while you set it. Copy puts it on the clipboard.
  4. Give them the install QR code from Tools → PWA Apps. On Android the app offers Install; on an iPhone they tap Share, then Add to Home Screen.

An employee who should only clock in, with no payslips or leave in the app, still signs in the same way. Supervisors need the app switched on too, to approve their team’s leave.

The employee can change their password in the app (Change my password on Home). If they forget it, generate a new one in Employee Master. Setting a new password, or unticking the box, signs them out of the app on every phone at once. Five wrong passwords in a row lock that ID No for 15 minutes.

Only closed months appear
A payroll month that has been generated but not yet posted is still being worked on, so it is not shown in the app. Employees see a month’s payslip once you close it.
No more My HR or My Payslip on the web
Self-service lives in the app, so the web app’s My HR page, the My Payslip report and Link to User on the employee record have gone. A Ritzy user who is also an employee uses the app like everyone else.

10 Reports

Under Payroll → Reports. Each one previews on screen and prints from the preview window; grids export to CSV.

ReportShows
PayslipThe formatted payslip for any employee and period.
Salary ListThe full salary sheet for a period — earnings, deductions and net pay per employee.
Salary PostingThe accounting side of a posted period — the journal that hit Accounts.
Payroll DiscrepancyWhat changed between each month and the one before it — new employees, employees no longer paid, and net pay that moved.
Bank TransferNet pay per employee with the bank account it goes to, loan instalments already deducted — the payment side of each month.
Loan ListOutstanding staff loans and their repayment progress.
Leave BalanceEntitlement, taken and remaining leave per employee.
Document ExpiryEmployee documents due to expire — the same list that drives the daily alert.
Employee DetailsA consolidated employee information listing.
Contract RegisterEmployment contracts in force during the period — type, term, agreed salary, how each was signed, and days left on those still running.
The three worth running every month
Salary List to see the month whole, Payroll Discrepancy to see what moved, and Document Expiry to see what is about to lapse.

11 Daily alerts

Payroll can send a once-a-day notification for each of the dates worth knowing about in advance. Open Payroll → Document Expiry Alert, turn the master switch on, then enable the alerts you want and choose who receives each one. An alert with no recipients sends nothing.

AlertSent whenLead days mean
Document ExpiryEmployee documents — passports, visas, contracts — are approaching expiry.Days before the expiry date.
Probation EndingAn employee is reaching their confirmation date.Days before the confirmation date.
Retirement ApproachingAn employee is reaching their retirement date.Days before the retirement date.
BirthdaysStaff birthdays are coming up.Days ahead; 0 means on the day itself.
Work AnniversariesStaff reach another year of service.Days ahead; 0 means on the day itself.
Leave Balance OverdrawnSomeone has taken more leave than they have.Days of tolerance before it is flagged.
Leave Requests Awaiting ApprovalLeave requests are sitting undecided.Days a request may wait before it is chased.
Employment Contracts EndingActive contracts are reaching their end date (or have passed it) and nobody has started a renewal.Days before the contract end date.
One message a day, always the latest figure
Each alert sends at most one notification per day, and a new one replaces the previous unread copy rather than stacking up. Probation, retirement, birthday and anniversary alerts read dates from the employee record — an alert stays quiet until those dates are filled in. See the Notifications guide for how alerts are delivered.

12 Dashboard & reporting structure

Payroll → Dashboard summarises the module at a glance: headcount, the state of the current period, recent joiners, documents about to expire and anything waiting on a decision.

It also draws the Reporting Structure — the organisation chart built from each employee’s Reports To. Expand a branch to see a supervisor’s team. Below it, Ritzy tells you how many employees have no supervisor set; that is the same list whose leave requests fall to the HR desk, so it is worth keeping short.

The Contracts Ending card lists active contracts that end in the next 60 days (or already have), with how many contracts are waiting for a signature and how many active employees have no contract at all. Click a row to open that contract.

13 Employment contracts

Payroll → Transactions → Employment Contracts records what each employee agreed to — the contract type and term, probation, notice, working hours, leave, the salary package and any benefits — and gets it signed.

A contract does not change anyone’s pay
The salary on a contract is a copy of what was agreed. Payroll keeps paying from the Payments & Deductions tab of the employee record (§4), exactly as before. So a signed contract is never rewritten by a later raise — and when you agree a raise, change the employee record for the pay and renew the contract for the paperwork.

Drafting a contract

  1. Click New (or New Contract on the employee’s Contracts tab) and choose the employee.
  2. Ritzy fills the form in for you: position and department from the employee record, the salary from their current fixed pay components, and the working terms and clauses from their last contract — or, for a first contract, from the company’s most recent one.
  3. Check the Contract Type and dates. Fixed-term and Temporary contracts need an end date; Unlimited and Part-time may be open-ended.
  4. Adjust the salary lines if the offer differs from the payroll. Load from payroll copies the current fixed pay again.
  5. Write any Other benefits (housing, air ticket, medical) and review the Terms and conditions. The standard clauses supplied with Ritzy defer to “applicable labour law” — replace them with your own wording; the next contract you draft starts from what you wrote.
  6. Click Save. The contract is a Draft until it is issued.

Getting it signed

HowWhat to do
Electronically, in the appClick Issue for signature. The employee is notified on their phone (and emailed, when they have an email address and SMTP is set up), opens the contract in the Ritzy Employee app, reads it, types their name, draws their signature and accepts — or sends it back with comments. Needs the app switched on for the employee (§9).
On paperClick Print (or Word / PDF), have it signed, then Mark as signed with the date. Attach a scan to the employee record for safe keeping.

Once signed, the contract is Active and the signature, name and date print on it. If the employee sends it back instead, it returns to Draft with their comment shown at the top — amend it and issue it again. To change an issued contract before it is signed, Withdraw it first.

The life of a contract

StatusMeans
DraftBeing prepared. The only state in which it can be edited or deleted.
Awaiting signatureIssued to the employee; read-only.
ActiveSigned and in force. An employee has one active contract at a time.
ExpiredActive, but past its end date. Renew it or terminate it.
RenewedReplaced by a newer contract that has been signed.
TerminatedEnded early, with a date and reason.

Renew drafts the next contract from an active one: the same terms and clauses, starting the day after the current one ends and running for the same length. The current contract stays active until the renewal is signed, then becomes Renewed. Terminate ends the contract record only — deactivate the employee and settle their final pay separately.

Word templates

Word / PDF merges the contract into a Word layout from Payroll → Masters → Contract Templates. Ritzy supplies a Standard Employment Contract; download it, change it in Word (your letterhead, a second language, extra paragraphs) and upload it back, or add others. The placeholder list on that screen shows what each {placeholder} fills in. PDF needs LibreOffice on the server; Word files always work. Print needs no template at all. Deleting a template that a document was generated from, or that a contract past draft uses, retires it instead: it leaves the pick list but those contracts keep their layout. Drafts that named it just lose the link.

Staying ahead of end dates

Turn on the Employment Contracts Ending daily alert (§11), watch the Dashboard card (§12), and run the Contract Register report (§10). A contract drops off the alert as soon as a renewal is started.

What to grant
Employment Contracts to HR — Add to draft and renew, Edit to issue, withdraw, mark signed and terminate, Delete for drafts, Print for Print, Word/PDF and email. Contract Templates to whoever maintains the layouts. Employees need no right: they sign in the Ritzy Employee app (§9).

14 Timesheet (add-on)

Timesheet is an add-on to Payroll, licensed on its own. It records the hours each employee works every day, by job, site and location, and turns the month’s overtime and leave into payroll lines. When it is installed, Payroll gets a Timesheet section with three screens: Timesheet, Post Timesheet and Timesheet Reports (with its Verification tab for HR). Employees can also clock themselves in and out on the Ritzy Employee phone app, and choose the job they are working on; staff allowed to work from home choose Office or Home. See section 13 of the Timesheet manual. The Work Site and Work Location masters appear under Masters. The DBA adds it from DBA Console → Modules, and the licence must include it. This section is the short version; the Timesheet manual covers it in full, and the Help button on a Timesheet screen opens it.

Coming from Ritzy 8
Ritzy 8 kept timesheets in a separate TS_<code>.FDB beside the company database. Ritzy One keeps them with the rest of the company. The Firebird import brings that file in with the company, and DBA Console → Import from Firebird also has Import Timesheet Only for a company that is already here.

Setting it up

  1. Tools → Preferences → Timesheet Settings:
    • Set the Normal Hours of a working day and the company’s Overtime Factor (1.25 is time and a quarter).
    • Choose the Overtime Payment, an addition (pay type 3), and the Leave Deduction, a deduction (pay type 4).
    • Choose the Annual Leave Type.
  2. On the same page, tick the working days of the Work Week. A day’s hours can be set when they differ from the normal hours, as on a short Thursday. Public holidays come from the Holiday Calendar in Payroll Settings (§2).
  3. Create the Work Locations and the Work Sites within them. A job’s site comes from the job. A location cannot be deleted while a site, an employee, a timesheet day or the work-from-home setting uses it, nor a site while a job, an employee or a timesheet day does.
  4. On each employee who fills a timesheet, open the Timesheet tab and tick On timesheet. Then fill in:
    • their working hours and breaks, which start each new day;
    • their own overtime factor, if it differs from the company’s;
    • their default site;
    • any Work Schedule periods, such as Ramadan hours, which override the company’s hours and holidays for those dates.

Entering a day

In Timesheet, choose the department and the date; the payroll month list beside the date jumps to a month.

Click Save to keep the day. The dates already entered this month are shown above the grid. Click one to open it.

ColumnWorked out as
SchedThe day’s scheduled hours. The work week gives them, a holiday makes them 0, and an employee’s own schedule overrides both.
WorkedTime in to time out over the four slots, less each break that falls inside a slot (as Ritzy 8 works it out).
OTWorked hours beyond the scheduled hours. Every hour worked on a holiday or day off is overtime.
Short / Leave DaysScheduled hours not worked, whatever the leave type. Leave days follow the leave type picked (a deduct-salary type counts its deduct factor, Absent Half-day 0.5); with no leave type, the shortfall as a part of the day.

Posting the month

Post Timesheet → Monthly Summary shows each employee’s hours, overtime and leave for the month, and the amounts:

Post Timesheet writes these into Additions / Deductions as Timesheet Overtime and Timesheet Leave Deduction lines. Then run Salary Process as usual. Posting locks the month’s days.

Once the month’s payroll is posted, neither is possible.

Overtime or leave that comes to nothing writes no line. Post Timesheet then lists each employee and why: no pay line whose payment is marked Basic Pay, or an overtime factor of 0. If nothing at all was posted it says Nothing was posted to Additions / Deductions.

Leave is deducted once
Leave Entry does not deduct salary for an employee on timesheet. Post Timesheet does, from the days on the timesheet, so the same absence is never deducted twice.

Reports

Timesheet Reports adds up the hours of a date range in one or two levels. Each level can be job, site, location, department, employee, day or month: job then employee, for example. The Detail view lists every slot. Export saves either view as a CSV file for Excel.

Its Verification tab is HR’s check before Post Timesheet. It opens on the current payroll month and shows a colour-coded Attendance sheet, one row per employee and one cell per day, with totals; it also lists every doubtful day (missing days, in without out, leave that differs from Leave Entry, worked on leave, and more), each linked to its day on the Timesheet screen. See the Timesheet manual.

What to grant
Rights are under the Timesheet package in User Manager:
  • Timesheet to supervisors: Edit to save a day, Delete to clear one.
  • Post Timesheet to payroll staff: Post to post, Edit for the settings.
  • Timesheet Reports to anyone who reads hours.

15 Messages, tips & FAQ

Messages you may see

MessageWhat to do
This payroll is already posted (closed)The month is finished. Generate, Clear and Post all refuse it — correct it in Accounts with a journal voucher.
Payroll has not been generated for this periodClick Generate first; there is nothing to post yet.
No Payment Account (Paid Through) set for…The named employees have no Pay From A/C on their Others tab. Set it and post again.
Cannot post payroll in the previous month / in the next financial yearChoose a posting date inside this month or later, and inside the same financial year.
Select at least one employee to postEvery row in the Post dialog was unticked, or everybody has already been posted.
This contract is waiting for the employee’s signature. Withdraw it first…An issued contract is read-only so the employee signs exactly what they were sent. Withdraw, edit, and issue it again.
Only a draft contract can be changed. Renew it to agree new terms.A signed contract is a record of what was agreed. Use Renew to draft the next one.
… cannot sign in to the Ritzy Employee appA warning when issuing. Print the contract, have it signed, and use Mark as signed — or switch the app on for the employee (§9) and issue it again.
Leave Payment type is not set in Payroll SettingsA warning after generating: new joiners were not prorated because the component to charge the deduction to is not configured. When none is set, Ritzy uses the one-off deduction Leave Deduction (code LD) a new company starts with, so you see this only if that component was removed or renamed. Ask your Ritzy administrator to set it, then generate again.
Enter the amount as a positive figure…On Add/Deduction: type the amount without a minus sign. The component’s type makes it an addition or a deduction.
This employee already has … recorded from … to …, which overlaps these dates.The leave clashes with an existing entry or approved request. Correct the dates, or edit the entry that is already there.
The From (To) date … is a holiday / a weekly holiday … A leave must start and end on a working day.On Leave Entry or a leave request: move the start or end to a working day. Days off inside the leave are fine.
The timesheet already records … / The timesheet records …, which clashes with this leave. / The timesheet shows … at work on …The employee is on timesheet and the day is already filled there. Leave on the timesheet reaches Leave Entry when the month’s timesheet is posted; otherwise correct the timesheet day first, or choose other dates.
This leave type is on leave entries in a posted payroll month, so its deduct factor cannot be changed.Create a new leave type for the new factor.
This payment is already in use … so its Payment Type cannot be changed.Create a new payment with the type you need.
Payroll for … is already posted — the salary deduction for that month was not changed.A warning: the leave is saved, but that month’s posted salary is not touched. Make any correction in Accounts.
Installment date cannot be less than Joining date / Cannot create Installment in a Closed PeriodOn a loan: move the instalments to start after the joining date and in a month not yet posted.
Balance amount cannot be more than the loan amountOn a loan: the balance still to recover is at most the loan itself.
… payslip(s) out of dateOn Salary Process: something changed after the month was generated. Click Generate again; Post also does this for an open month.
Approve the claim before posting it. / Salary for … has already been posted for that month: choose the next one.On Expense Claims: approve first, then post into a month the employee’s salary is not yet posted for.
This claim is posted to the payroll: its approval can no longer be taken back.A posted claim stays in its payroll month. Correct it with a deduction on Add/Deduction if it was wrong.
Choose the month the new weekly holiday starts from: … or later.On Payroll Settings: a weekly holiday change can start only after the last generated month. On the Holiday Calendar, a locked row is in a generated month: rename it, but it cannot be moved or removed.

A new joiner’s first month

Mid-month joiners are prorated automatically from their joining date, as a New Joiner Deduction line on the payslip. Make sure the joining date on the employee record is right — everything else follows from it.

An employee is leaving

Enter their Leaving Date (last working day) and reason on the employee record before you generate their final month; keep them Active until that month is posted, or Generate leaves them out entirely. The final payslip shows a Leaver Deduction for the rest of the month. After posting you can switch them to inactive. A leaving date cannot be set in, moved out of, or moved before a month that is already posted.

Somebody is missing from the run

Generate includes active employees who joined on or before the last day of the period. So check four things in order: are they Active, is their Date of Joining inside or before this month, is any Leaving Date before this month, and have they any pay components on Payments & Deductions?

The payslip does not match what I entered

Add/deductions belong to a specific financial year and period, and the salary was built when you last generated. Confirm the entry is against the right month, then generate the period again.

Deductions and the payslip

Deductions are stored and shown as negative amounts, so the payslip nets down to the correct take-home figure. The bank transfer file and the Ritzy Employee app both use that same net figure, with loan instalments already taken off.

Leave that never seems to accrue

Accrual happens when a payroll period is generated, using Days per Year on the leave type and the employee’s joining date. A leave type with Days per Year of zero never accrues — which is right for unpaid leave and wrong for annual.

Keep the reporting line filled in

Every employee with a supervisor in Reports To is one whose leave request routes itself, and one more branch on the organisation chart. The Dashboard counts the ones still missing.