Vacation and Leave
Leave types, entitlements and balances, recording vacations, paying leave salary in advance, returns and balance adjustments.
How leave works in Bizmagnet
Every kind of leave (annual vacation, sick leave, emergency leave, maternity leave, unpaid leave…) is a leave type. Each employee has an entitlement for each leave type: an opening balance plus a number of days per year. When HR records leave, the days are taken from that balance and the payroll pays or deducts the days automatically.
The leave year is the calendar year (1 January to 31 December). Depending on your company settings, this year's entitlement is either the full annual days from 1 January, or the days earned up to the vacation start date (for example 30 days a year ÷ 365 × days worked so far).
1. Set up leave types (Leave Configuration)
Create one leave type for each kind of leave your company gives.
| Field | What it means | Example: Annual Leave | Example: Unpaid Leave |
|---|---|---|---|
| Code / Name Eng / Name Arb | How the leave type appears in lists | 01 · Annual Leave | 05 · Unpaid Leave |
| Absence Days (Days/Year) | Days an employee earns every year | 30 | 0 |
| Ded. for 1st Day % | For unpaid leave: how much of a day's salary is deducted per day | 0 | 100 |
| Company | The company this leave type belongs to | Your company | |
| Deduct Leave From Annual Vacation | Tick it to make the type available in Vacation Entry | ✔ | ✔ |
| Paid Leave | Ticked: the days are paid. Unticked: the days are deducted from salary | ✔ | ✘ |
| Carry Forwardable | Unused days move into next year | ✔ | ✘ |
| No Week End Days Off | Weekend days inside the leave are counted as leave | As per your policy | |
| Gender | Who can take it (e.g. maternity leave: Female only) | Male + Female | Male + Female |
| Earnings checkboxes | Which salary parts are paid during this leave | Basic, Housing | — |
| Update Entitlement | When creating the leave type: gives every existing employee (of the chosen gender) this leave type with the yearly days | ✔ | ✔ |
Open Leave Configuration, click Create Leave Config, fill the fields and click Save. The Calculations button in the list shows which salary parts a leave type uses.
How the leave pays
- Paid leave: pay for the leave = (salary parts ticked on the leave type) × leave days ÷ days in the month.
- Unpaid leave: the leave days are deducted from the month's salary according to Ded. for 1st Day %.
2. Check or correct an employee's entitlement
When you create a new employee, Bizmagnet automatically gives them an entitlement for every leave type that applies to them. If they join mid-year, the opening days are worked out in proportion (rounded to half a day).
To see or correct one employee's entitlement, open Office Absence Entitlement:
- Choose the leave type in Office Absence Type (the list stays empty until you do) and click Refresh.
- Click the edit icon next to the employee, or click Create Office Absence Entitlement and pick the type and employee.
- Enter the figures: Opening Date (the date the balance applies from), Opening Days (days brought forward), Entitled Days (days per year). Total is calculated for you.
- Click Save. Only whole numbers are accepted.
3. Record a vacation (Vacation Entry)
Use Vacation Entry to record leave that has been approved.
- Click Create Vacation on the Vacation Entry List.
- Select the Employee Code, then the Vacation Type (only leave types with "Deduct Leave From Annual Vacation" for the employee's company are shown).
- Enter the Vacation Start Date and End Date. The Hijri dates fill in automatically.
- Check the figures that appear:
- Total Vacation Days – opening + adjustments + this year's entitlement
- Days Consumed – days already taken of this type
- Approved Days – calendar days from start to end, minus public holidays
- Balance Days – what is left after this vacation
- Tick En Cash only if the employee is being paid for the days instead of taking them off.
- Optionally fill the Requested section (who asked, when, remarks) and Remarks, then click Save. You'll see "Vacation Entry Created" with the document number.
- Public holidays set on the employee's pay group are not counted in Approved Days. Weekly days off are counted.
- Overlaps are blocked: "Employee Already had Vacation Entry in the selected date".
- After payroll: once the month's payroll has included the vacation, the entry can only be viewed, not edited or deleted.
- After return: a vacation that has a Vacation Return can't be deleted.
4. Pay leave salary in advance (Vacation Salary Generation)
In many companies an employee going on annual leave receives the salary for the leave days, and the salary for the days worked that month, before they travel. Use Vacation Salary Generation for this, and also for leave that is encashed.
- Click Create Vacation salary generation and choose the Ref Vacation No. (the Vacation Entry). The employee, leave dates, approved days, last day of work and "Salary Upto (Due Back for Duty)" are filled for you.
- Tick Advance if the employee is leaving now and will return later. (EnCash is ticked for you if the vacation was entered as encashed.)
- Click Generate Regular Salary to calculate the salary for the days worked in the vacation month (overtime, deductions and loan instalment included). Tick Include Loan In Regular Salary first if the month's loan instalment should be recovered now.
- Click Generate Vacation Salary to calculate the leave pay.
- Click Save. The amounts become the employee's payroll for that month.
If the regular payroll for that employee and month already exists, you'll see "Already generated payroll". The ticket amount shown on this screen is for information only and is not added to the pay.
5. Record the return to work (Vacation Return)
When an employee who received advance vacation salary comes back, record it in Vacation Return.
- Click Create Vacation Return and pick the Vacation. Only vacations with an advance vacation salary that have not been returned are listed.
- Enter the Joining Date – the day the employee actually came back. Exceeded Days is calculated: positive = came back late, negative = came back early.
- Keep Re-activate Employee ticked (default) so the employee is active again and included in payroll.
- If the employee came back early:
- tick Add Days To Vacation Balance to give the unused days back to the balance, and
- tick Deduct Amount From Payroll to recover the advance pay for those days in the next payroll.
- Click Save.
Deleting a return: leave all three boxes in the delete dialog unticked.
6. Add days to a balance (Office Absence Adjustment)
Use Office Absence Adjustment to give an employee extra days, for example compensation days for working on a holiday.
- Click Create Entry.
- Choose the Employee and the Vacation Type, enter the Days and a Remark explaining why.
- Click Save. The days are added to the balance for the year of the adjustment date.
7. See an employee's leave history (Vacation Inquiry)
Open Vacation Inquiry, select the employee and leave type, and click Refresh. You'll see:
- Vacation History – every opening balance, vacation, absence and adjustment;
- Loan History – loans still being repaid (useful before approving leave salary);
- a status chip Vacation if the employee is on leave now, or Not Return if an earlier vacation has no return recorded.
For the exact balance of a leave type, start a Vacation Entry for the employee: Total Vacation Days, Days Consumed and Balance Days show the current position. Leave and balance reports are listed in HR Reports.
Practical scenarios
Ahmed takes 21 days of annual leave, paid in advance
Ahmed earns Basic 6,000 and Housing 1,500 SAR. Annual Leave gives 30 days a year and pays Basic + Housing. He carried 10 days from last year and has already taken 5 days this year.
| # | Screen | Action | Result |
|---|---|---|---|
| 1 | Vacation Entry | Ahmed · Annual Leave · 10 Jun → 30 Jun (no public holiday) | Total 40 · Consumed 5 · Approved 21 · Balance 14 |
| 2 | Vacation Salary Generation | Ref Vacation = that entry · tick Advance · Generate Regular Salary · Generate Vacation Salary · Save | Salary for 1–9 June + leave pay; Ahmed becomes inactive |
| 3 | Payroll (July) | Run payroll as usual | Ahmed is not included while on vacation |
| 4 | Vacation Return | Joining Date 1 Jul · Re-activate Employee ✔ · Save | Exceeded Days 0; Ahmed active again |
Ahmed comes back 3 days early
Same leave as above, but Ahmed rejoins on 28 June.
- Vacation Return: Joining Date 28 Jun → Exceeded Days shows −3.
- Tick Add Days To Vacation Balance (3 days go back to his balance) and Deduct Amount From Payroll.
- Save. An "other deduction" of 5,250 ÷ 21 × 3 = 750.00 SAR is created and recovered in the next payroll, because he will also be paid salary for 28–30 June.
Sara needs 5 days but has only 2 days left
- Vacation Entry 1: Annual Leave, 2 days → balance 0.
- Vacation Entry 2: Unpaid Leave (Paid Leave unticked, Ded. 100%), the next 3 days.
- Payroll pays the 2 annual leave days as normal and deducts 3 days' salary.