# Cash Advance Voucher

<p class="doc-lead">Cash Advance Voucher records the actual disbursement of an approved <a href="#/payroll/cash-advance-request">Cash Advance Request</a> — or a standalone advance, loan, or opening balance. When approved, cash leaves the bank (DR 14 / CR cash) or posts against opening balance (CR 56). Approved vouchers with balance auto-pull into <a href="#/payroll/pay-run">Pay Run</a> as deduction category 1, deducting min(balance, paymentAmount) each period until fully recovered.</p>

<div class="doc-toc">
<p class="doc-toc-title">On this page</p>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Getting started</span>
<div class="doc-toc-links">
<a href="#/payroll/cash-advance-voucher?id=overview">Overview &amp; List View</a>
<a href="#/payroll/cash-advance-voucher?id=quick-start">Quick Start</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Form reference</span>
<div class="doc-toc-links">
<a href="#/payroll/cash-advance-voucher?id=header-fields">Header Fields</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">More</span>
<div class="doc-toc-links">
<a href="#/payroll/cash-advance-voucher?id=actions-status">Actions &amp; Status</a>
<a href="#/payroll/cash-advance-voucher?id=pay-run">Connection with Pay Run</a>
<a href="#/payroll/cash-advance-voucher?id=accounting">Accounting Postings</a>
<a href="#/payroll/cash-advance-voucher?id=example">Worked Example</a>
<a href="#/payroll/cash-advance-voucher?id=best-practices">Best Practices</a>
<a href="#/payroll/cash-advance-voucher?id=faq">FAQ</a>
<a href="#/payroll/cash-advance-voucher?id=related">Related Topics</a>
</div>
</div>
</div>

<hr class="doc-section-divider">

<h2 id="overview">Overview &amp; List View</h2>

Go to <b>Payroll → Cash Advance Voucher</b>. The list shows every disbursement with category, linked request, paid-from account, amount, balance, and status.

<img src="payroll/images/cash-adv-vou.webp" alt="Cash Advance Voucher list" loading="lazy">

<b>List columns</b>

| **Column** | **Shows** |
|------------|-----------|
| Id | System reference number. |
| Number # | Voucher or bill number. |
| Date | Disbursement date and time. |
| Category | Cash Advance or Loan. |
| Advance request Id | Linked <a href="#/payroll/cash-advance-request">Cash Advance Request</a> (if any). |
| Employee | Employee receiving the advance. |
| Monthly Deduction | Instalment per pay run (<code>paymentAmount</code>). |
| Paid from | Cash or bank account paid out. |
| Cash Advance Amount | Total disbursed amount. |
| Balance | Outstanding amount still to recover. |
| Status | Draft, Approved, Closed, or Cancelled. |

<b>Quick filter tabs</b>

| **Tab** | **Shows** |
|---------|-----------|
| Default | All except cancelled. |
| Approved | Approved vouchers with open or zero balance. |
| Draft | Saved but not yet approved. |
| Closed | Fully recovered (balance = 0). |
| Cancelled | Cancelled vouchers. |

<b>Advanced Filters</b>

Id, Category, Employee, Paid from, Advance request Id, Branch, Brand, Status, Date, and Created date.

<b>List row actions</b>

| **Action** | **Available when status is** |
|------------|------------------------------|
| Edit | Draft |
| Delete | Draft |
| View | All statuses |

<hr class="doc-section-divider">

<h2 id="quick-start">Quick Start — Create a Cash Advance Voucher</h2>

<h3>1. Navigate</h3>
Go to <b>Payroll → Cash Advance Voucher</b> and click <b>New</b>, or open an approved request and choose <b>Pay</b> from the ⋮ menu.

<img src="payroll/images/cashadvvoucher.webp" alt="Cash Advance/Loan Voucher" loading="lazy">

<h3>2. Fill in details</h3>
<ul>
<li>Set the <b>Date</b>. Link <b>Cash Request Id</b> when paying an approved request (auto-filled from <b>Pay</b>).</li>
<li>Select <b>Employee *</b> and <b>Category *</b> (Cash Advance or Loan).</li>
<li>Enter <b>Cash Advance Amount *</b> and <b>Monthly Deduction *</b> (<code>paymentAmount</code>). Monthly deduction must be ≤ amount.</li>
<li>Select <b>Paid from</b> — cash or bank account (not required when <b>Is Opening</b> is checked).</li>
<li>Optionally add <b>Voucher Number</b>, <b>Notes</b>, <b>Branch</b>, and <b>Brand</b>.</li>
</ul>

<h3>3. Save or approve</h3>
<ul>
<li><b>Save</b> — keeps status Draft.</li>
<li><b>Save And Approve</b> — approves in one step, posts disbursement journal, sets balance = amount.</li>
<li><b>Reset</b> / <b>Cancel</b> — clears or closes the form without saving.</li>
</ul>

<h3>4. Recover through pay run</h3>
Each pay run for the employee auto-pulls this voucher as a deduction (category 1). Amount deducted = min(balance, paymentAmount). Voucher closes when balance reaches zero.

<hr class="doc-section-divider">

<h2 id="header-fields">Header Fields Reference</h2>

| **Field** | **Description** |
|-----------|-----------------|
| Date * | Date and time of disbursement. |
| Cash Request Id | Linked approved <a href="#/payroll/cash-advance-request">Cash Advance Request</a>. Use the lookup button to pick an approved request. Auto-filled when created via <b>Pay</b>. |
| Employee * | Employee receiving the advance. Active HRMS employees only. |
| Is Opening | When checked, marks an opening-balance advance (no cash payment). <b>Paid from</b> is disabled; journal CR goes to account 56. |
| Category * | <b>Cash Advance</b> (0) or <b>Loan</b> (1). |
| Cash Advance Amount * | Total amount disbursed or opening balance. |
| Monthly Deduction * | Instalment deducted each pay run (<code>paymentAmount</code>). Must be ≤ Cash Advance Amount. Defaults to full amount when amount changes. |
| Voucher Number | Bill reference. Auto-generated when bill-number series is configured. |
| Paid from | Cash or bank account paid out. Required unless <b>Is Opening</b> is checked. |
| Notes | Purpose or remarks. |
| Branch | Branch associated with the employee. Defaults from context when branch access is enabled. |
| Brand | Optional brand tagging. |
| Overtime Entry ID | Shown on view when the voucher was created from an approved <a href="#/payroll/overtime-entry">Overtime Entry</a> via <b>Pay</b> — links OT payout as a cash advance for recovery through pay run. |

> Vouchers can also be created in bulk from the <a href="#/payroll/reports/cash-advance-request-report">Cash Advance Request Report</a> (multi-voucher screen with shared date and paid-from account).

<hr class="doc-section-divider">

<h2 id="actions-status">Actions &amp; Status</h2>

<img src="payroll/images/cash-adv-voudetail.webp" alt="Cash Advance Voucher detail" loading="lazy">

<h3>View toolbar actions</h3>

| **Action** | **Description** | **Available when status is** |
|------------|-----------------|------------------------------|
| Approve | Posts disbursement journal and sets balance. | Draft |
| Edit | Opens the voucher for editing. | Draft |
| Delete | Permanently removes the voucher. | Draft |
| Clone | Creates a copy of the voucher. | All (if permitted) |
| Print | Prints the voucher. | All |

<h3>More menu (⋮) actions</h3>

| **Action** | **Description** | **Available when status is** |
|------------|-----------------|------------------------------|
| Payment In | Creates a <a href="#/accounts/receipt-voucher">Receipt Voucher</a> for direct employee repayment outside pay run. | Approved |
| Cancel | Cancels the voucher and reverses its journal. | Approved, Closed |
| Master Update | Updates selected header fields. | Approved, Closed |
| Add/Update Note | Adds or edits a note. | All |

<h3>Statuses</h3>

| **Status** | **Description** |
|------------|-----------------|
| Draft | Saved but not approved. No cash movement. |
| Approved | Cash disbursed (or opening posted). Balance tracks amount owed. |
| Closed | Fully recovered — balance is zero. |
| Cancelled | Cancelled and journal reversed. |

<hr class="doc-section-divider">

<h2 id="pay-run">Connection with Pay Run</h2>

Approved Cash Advance Vouchers with balance &gt; 0 auto-pull into the employee's <a href="#/payroll/pay-run">Pay Run</a> <b>Deductions</b> section.

| **Setting** | **Value** |
|-------------|-----------|
| Deduction category | Cash Advance (1) |
| Auto-pulled amount | <b>min(balance, paymentAmount)</b> |
| When settled | Pay run approve reduces balance; voucher closes when balance = 0 |

<p>Multiple open vouchers for the same employee each pull separately. Pay run import distributes manual deduction columns across pending vouchers (oldest first).</p>

<b>Alternate recovery — Receipt Voucher</b>

Use <b>Payment In</b> on an approved voucher to create a <a href="#/accounts/receipt-voucher">Receipt Voucher</a>. Employee pays cash or cheque directly to the company. Balance decreases without waiting for the next pay run. Useful for early settlement or partial repayment.

<hr class="doc-section-divider">

<h2 id="accounting">Accounting Postings</h2>

<h3>On voucher approve — normal disbursement</h3>

<ul>
<li><b>DR</b> account 14 — Short-Term Loans / Employee Receivable</li>
<li><b>CR</b> Paid from — cash or bank account selected on the voucher</li>
</ul>

<h3>On voucher approve — opening balance (<b>Is Opening</b>)</h3>

Used when migrating existing employee advance balances at go-live:

<ul>
<li><b>DR</b> account 14 — Short-Term Loans / Employee Receivable</li>
<li><b>CR</b> account 56 — Opening Balance / Equity adjustment account</li>
</ul>

<p>No cash leaves the company. Recovery still happens through pay run deductions.</p>

<h3>On pay run approve (repayment deduction)</h3>

<ul>
<li><b>DR</b> account 57 — Salary Payable (employee sub-ledger)</li>
<li><b>CR</b> account 14 — Short-Term Loans / Employee Receivable</li>
</ul>

<h3>On receipt voucher (direct repayment)</h3>

When employee repays outside payroll via <b>Payment In</b>:

<ul>
<li><b>DR</b> cash or bank account</li>
<li><b>CR</b> account 14 — reduces voucher balance</li>
</ul>

<b>Cancel</b> on voucher or pay run reverses the respective journals and restores balance.

<hr class="doc-section-divider">

<h2 id="example">Worked Example — Loan with Monthly Instalments</h2>

<p><b>Scenario:</b> Employee Kumar receives a ₹24,000 personal loan, repayable at ₹4,000 per month over six pay runs.</p>

<b>Step 1 — Request and approve</b>
<ul>
<li><a href="#/payroll/cash-advance-request">Cash Advance Request</a>: Category Loan, Amount ₹24,000, Monthly deduction ₹4,000</li>
</ul>

<b>Step 2 — Voucher</b>
<ul>
<li>Created via <b>Pay</b> on the approved request</li>
<li>Paid from: Main Bank Account</li>
<li>Approve voucher</li>
</ul>
Journal: <b>DR 14 ₹24,000 / CR Main Bank ₹24,000</b>. Balance = ₹24,000.

<b>Step 3 — Pay runs (months 1–6)</b>

| **Month** | **Balance before** | **Deduction (min)** | **Balance after** |
|-----------|-------------------|---------------------|-------------------|
| 1 | ₹24,000 | ₹4,000 | ₹20,000 |
| 2 | ₹20,000 | ₹4,000 | ₹16,000 |
| 3 | ₹16,000 | ₹4,000 | ₹12,000 |
| 4 | ₹12,000 | ₹4,000 | ₹8,000 |
| 5 | ₹8,000 | ₹4,000 | ₹4,000 |
| 6 | ₹4,000 | ₹4,000 | ₹0 → Closed |

Each pay run journal: <b>DR 57 / CR 14</b> for the deducted amount.

<p><b>OT-linked variant:</b> When overtime is paid as recoverable advance, create the voucher from an approved <a href="#/payroll/overtime-entry">Overtime Entry</a> via <b>Pay</b>. Amount and monthly deduction default from the OT balance. Recovery follows the same pay-run deduction path.</p>

<hr class="doc-section-divider">

<h2 id="best-practices">Best Practices</h2>

<ul>
<li>Always link vouchers to an approved <a href="#/payroll/cash-advance-request">Cash Advance Request</a> when one exists — this preserves the approval trail.</li>
<li>Set <b>Monthly Deduction</b> at or below expected net pay so deductions do not exceed take-home salary.</li>
<li>Use <b>Is Opening</b> only for migrated balances at implementation — not for new cash payments.</li>
<li>Review auto-pulled deduction lines on each pay run before approving.</li>
<li>Use <b>Payment In</b> (Receipt Voucher) when an employee wants to settle early or make a partial cash repayment.</li>
<li>For bulk festival advances, create vouchers from the <a href="#/payroll/reports/cash-advance-request-report">Cash Advance Request Report</a> multi-voucher screen.</li>
</ul>

<hr class="doc-section-divider">

<h2 id="faq">FAQ</h2>

<b>Can I create a voucher without a request?</b><br>
Yes. Enter employee, category, amount, and paid-from directly on a new voucher. Linking a request is recommended for audit control.

<b>Why is Paid from disabled?</b><br>
<b>Is Opening</b> is checked — the voucher posts against account 56 instead of a cash account.

<b>How is the pay run deduction amount calculated?</b><br>
min(balance, paymentAmount). On the last instalment, balance may be less than paymentAmount — the system deducts the remaining balance only.

<b>Can one request have multiple vouchers?</b><br>
Typically one voucher per approved request. Partial disbursements require separate business process or manual voucher entry.

<b>What is the Overtime Entry ID on the voucher view?</b><br>
The voucher was created from an approved overtime entry's <b>Pay</b> action. OT amount is advanced to the employee and recovered through pay run like any cash advance.

<b>Does cancelling a pay run restore voucher balance?</b><br>
Yes. Pay run cancel reverses deduction journals and restores the voucher balance for future recovery.

<b>What is Is Opening on a cash advance voucher?</b><br>
Opening balance advances post against employee advance account (56) instead of a cash/bank Paid from account — used for migrated balances.

<b>Can I recover more than one voucher on a pay run?</b><br>
Yes. Pay run auto-pulls all open vouchers for the employee — each appears as a separate deduction line under category 1.

<b>Why is voucher status Partially Paid?</b><br>
Some balance was recovered on an approved pay run or receipt voucher — remaining balance is still deductible on future runs.

<b>Does approving a voucher pay the employee immediately?</b><br>
Yes when Paid from is a cash/bank account — the payment voucher or cash posting disburses funds. Recovery happens later on pay run.

<hr class="doc-section-divider">

<h2 id="related">Related Topics</h2>

<ul>
<li><a href="#/payroll/pay-run-dashboard">Pay Run Dashboard</a> — Pending Advance Vouchers opens this list with status Approved.</li>
<li><a href="#/payroll/cash-advance-request">Cash Advance Request</a> — pre-approval step before disbursement.</li>
<li><a href="#/payroll/pay-run">Pay Run</a> — deducts voucher balance each period (category 1).</li>
<li><a href="#/payroll/overtime-entry">Overtime Entry</a> — OT payout can convert to a recoverable cash advance voucher.</li>
<li><a href="#/payroll/reports/cash-advance-voucher-report">Cash Advance Voucher Report</a> — track disbursed amounts and balances.</li>
<li><a href="#/accounts/receipt-voucher">Receipt Voucher</a> — direct repayment via Payment In.</li>
<li><a href="#/payroll/deduction-on-expense">Deduction on Expense</a> — recover company-paid costs (category 2).</li>
</ul>
