Solavel Docs
English

How do I recover a salary advance through payroll?

Last updated

App: SolaHR (with optional SolaCount accounting delivery). Outcome: record money paid early to an employee and recover it exactly once in the intended payroll month.

#The situation

Palm Grove Furnishings LLC (AED) pays Yousef Nasser a monthly salary of AED 6,000 (no allowances, overtime or other deductions in this case). On 12 October 2026 HR officer Sara Mansour records a salary advance of 1,500, to be recovered in October payroll. Finance manager Mona Fares approves the payroll and accountant Layla Haddad checks the books. Whether deducting an advance from wages is permitted, and any cap, depends on the employee's contract and local labor law; the software limit below is not a legal determination.

#Desired result

Yousef receives 1,500 early and 4,500 at month end, 6,000 in total. The advance balance is 0, it is deducted only once, and the accountant knows which entries record the funding and which record the recovery.

#Before you start

  • Yousef is eligible for the October run and October payroll is not finalized (a finalized month is refused for a new advance).
  • Max advance % in Payroll Settings (default 50) is applied to the employee's salary: 6,000 x 50% = 3,000, so 1,500 is allowed. Do not change a real organization's policy to fit an example. There can also be only one non-cancelled same-month advance per employee per month.
  • Permissions: permission to view and manage advances to record and edit; a separate disburse permission to disburse. Payroll preparation and approval have their own permissions.

#Workflow overview

Step App Owner
Record the advance (Pending Approval) SolaHR Sara
Hand over the cash or transfer Outside the apps Palm Grove
Mark it Disbursed SolaHR User with disburse right
Deduct it in the draft payroll SolaHR, automatic Payroll calculation
Review, approve, pay the remainder, mark paid SolaHR Sara, Mona
Accounting for the recovery SolaCount, automatic after the run is Paid Layla verifies
Accounting for the original funding SolaCount, manual Layla

#Exact steps

  1. Open Payroll & Compensation → Advances and click Add record. Choose Yousef Nasser, Type Same month, Total amount 1,500, Advance date 12 October 2026, First repayment payroll October 2026, add a note and save. The row shows Pending Approval. Employee-originated requests also appear in the approvals center as "Salary advance" with an Approve & disburse action; in either route there is no separate approval state in the advance record: it goes from pending directly to disbursed.
  2. After the 1,500 has really been paid, use the row's Disburse action. The status becomes Disbursed. Keep evidence; a status of Received (set when a signed slip is scanned) is also deductible, but a signed voucher is not what disburses an advance.
  3. Open Payroll & Compensation → Payroll Runs, select October 2026, and generate the draft if needed; use Recalculate draft if the draft existed before the disbursement. A Pending Approval advance is never deducted (only Disbursed or Received advances are eligible).
  4. In the employee breakdown check Advances deduction 1,500 and net 4,500. The advance row repayment badge reads In the draft payroll until the run is finalized, then Repaid.
  5. Submit for Review; Mona uses Approve Payroll and confirms.
  6. Pay Yousef the remaining 4,500, then click Confirm Payroll Paid. Generate the payslip and check Advance Repayments shows 1,500.

#App handoffs

Trigger / source Destination Type What transfers Review and posting Effect timing How to verify Check before retrying
Disburse on the advance SolaCount No handoff. Disbursing an advance does not send anything to SolaCount: SolaHR sends accounting events only for payroll runs, overtime payments and final settlements Nothing Layla records the funding manually, under her own controls Whenever she records it; HR does not post it Look in SolaCount Journal entries; there is none from the advance Do not expect one; do not duplicate
Draft payroll calculation Same payroll run Automatic inside SolaHR Advance deduction row linked to the run; the advance's remaining balance is reduced at calculation time, not at approval or payment; status Completed when the balance reaches 0 Review in the breakdown; the deduction stays editable until the run is finalized Draft only Badge In the draft payroll Recalculate if the deduction looks wrong
Run becomes Paid SolaCount Automatic (see Payroll accounting) The recovery as the line "Advances recovered" credited to Employee advances receivable Posted journal At Paid Accounting delivery (SolaCount) Status Failed: fix cause, Retry

If the funding is not recorded in SolaCount, the recovery credit leaves Employee advances receivable with a credit balance. Layla should record the funding first. A suggested manual entry on 12 October is Dr Employee advances receivable 1,500, Cr Bank 1,500 (not generated by Solavel).

#Check your result

Check Amount (AED)
Salary earned for October 6,000
Paid early on 12 October 1,500
Recovered through payroll 1,500
Remaining month-end payment (6,000 - 1,500) 4,500
Total cash to employee (1,500 + 4,500) 6,000
Advance balance after recovery 0

Journal 1, Payroll posted (31 Oct 2026): Dr Salary expense 6,000; Cr Employee advances receivable 1,500; Cr Net salaries payable 4,500 (total 6,000 each side). Journal 2, Payroll paid: Dr Net salaries payable 4,500; Cr Cash or bank 4,500. Together with the manual funding entry (Dr receivable 1,500, Cr bank 1,500), the receivable ends at 0, the bank is down 6,000 and salary expense is 6,000.

A zero balance in the draft shows the calculation, not approval or payment. Check the Advances row, the breakdown, the run status and the payslip.

#How repeated recovery is prevented

  • One deduction per advance per run. The database allows only one deduction row for the same advance in the same payroll run, and only one payroll run exists per month.
  • The balance falls when the draft is calculated. A later month's run picks up only advances that are Disbursed or Received and still have a balance above zero, so a fully recovered same-month advance is not offered to November's run, and a long-term advance can never be deducted beyond its remaining balance.
  • Recalculating does not stack. Recalculate draft first releases the run's existing advance deductions (restoring the balance) and then applies them again. The run is held under a lock while it recalculates.
  • Finalized runs are protected. An approved, locked, closed or paid run cannot be recalculated, and its deductions cannot be cleared. Change repayment month is refused if any deduction already sits in a finalized run or if the target month is finalized.
  • Cancelling a run releases its deductions, so a restarted draft recalculates cleanly.

Limits of these protections: they were checked in the code, not by running two payroll calculations at the same moment. The lock is per run and the advance record itself is not locked, so avoid recalculating two different months' drafts at the same time when a long-term advance is involved. And a payroll correction that reverses a Paid run reverses the journals only: this guide found no step that reopens the advance, so review the Advances list after any reversal.

#Common variations

  • Long term. Choose Long term and enter a Monthly installment. A 3,000 advance with a 1,000 installment takes three runs; each run deducts the smaller of the installment and the remaining balance. A month with no deduction extends the schedule rather than doubling a later one; the badge can show Behind schedule or Skipped in finalized payroll.
  • Change the repayment month. The row action Change repayment month moves it to a payroll month that is not finalized and records your reason in the audit log. It is refused if any deduction already sits in a finalized run or if the advance is completed or cancelled.
  • Partial recovery. If the organization's payroll deduction policies (deduction cap, negative-net strategy) reduce the amount recovered in a run, check the breakdown for the actual figure; how the advance balance follows in each policy was not verified here.
  • Undoing a draft. Clearing the draft deductions restores a completed advance to Disbursed (or Received) so check before disbursing again.
  • Cancel. Cancel or suspend is offered for pending, active and disbursed rows; a disbursed advance with payroll deductions cannot go back to pending.
  • Employee leaves. Final-settlement calculations read advances too; use the end-of-service workflow rather than a manual deduction (not walked through here).

#Mistakes to avoid

  • Entering the 1,500 again as a separate payroll deduction.
  • Paying 6,000 at month end.
  • Treating an uploaded signed voucher as the disbursement.
  • Disbursing before the money has left, or assuming Disburse sends a bank payment or a SolaCount entry.
  • Repeating a save or disbursement after an error without using Check current status first.
  • Using HR attendance or SolaProjects time to justify an advance: the two apps are not linked for time.

Advances, Payroll Runs, Payslips, Payroll Settings, Payroll accounting, Business Solutions & Examples.