# 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>

<p>When <b>Show Cash Advance Balance in Pay Run</b> is enabled in <a href="#/payroll/payroll-settings-config?id=payrun-view">Payroll Settings</a>, an Approved or Closed pay run also prints <b>Cash Advance Balance</b> after <b>Total Payables</b>. That figure is the current pending balance of open cash advance and loan vouchers. It is separate from the deduction line for this period. Draft pay runs do not show it.</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>

<section class="ai-index-only">

## Errors and warnings

Exact messages for Cash Advance Voucher from the ERP screen and `fs_api`. Visitors do not see this section; Vertex AI Search uses it to answer questions about on-screen errors.


### Future or back-dated date

- **Type:** Error (blocks save)
- **Action:** Save, Save And Approve
- **When:** Date is in the future and future-date transactions are off, or the user cannot enter previous dates, or the date is before the allowed cutoff.
- **Example message:** *Future date transactions are not allowed.* or *Previous date transaction entries are not allowed.* or *Transaction date cannot be before YYYY-MM-DD.*
- **Outcome:** The document is not saved.
- **Solution:** Set Date to an allowed date, then save.

### Accounts closed for the date

- **Type:** Error
- **Action:** Approve, Save And Approve, Master Update
- **When:** The document date is in a closed accounting period.
- **Example message:** *Accounts closed for the date*
- **Outcome:** Not posted, or the date is not changed.
- **Solution:** Use a date after the accounts closing date.

### Multi-level approval required

- **Type:** Error / workflow
- **Action:** Approve, Save And Approve
- **When:** An active multi-level approval template matches this document.
- **Example message:** *Multi level approval is required*
- **Outcome:** Direct approve is blocked.
- **Solution:** Use Send Request on the first stage. For Send Request, stage Approve, Reject, Send For Revise, and Cancel Request messages, see <a href="#/features/multiapproval?id=action-errors">Multi Approval — Action error messages</a>.

### Edit or delete not allowed

- **Type:** Error
- **Action:** Edit, Delete
- **When:** Status is not Draft or For Revisal, or auto bill-number is on for delete.
- **Example message:** *Edit not allowed in the current status* or *Invalid status* or *Delete prevented..*
- **Outcome:** Posted documents stay in the ledger.
- **Solution:** Cancel a posted document after unlinking related records. Delete only drafts.

### Cancel date restriction

- **Type:** Error
- **Action:** Cancel
- **When:** User cannot cancel previous-date transactions, or the date is before the cancel cutoff.
- **Example message:** *Cancelling previous date transactions are not allowed* or *Cancelling transactions before YYYY-MM-DD is not allowed.*
- **Outcome:** Not cancelled.
- **Solution:** Cancel only dates the user is allowed to cancel.

### Payment vs requested amount / invalid lines

- **Type:** Error
- **Action:** Save
- **When:** Payment exceeds the request, or multi-new lines are invalid.
- **Example message:** *The payment amount should be equal to or less than the requested amount* or *Invalid Lines.* (ERP)
- **Outcome:** Not saved.
- **Solution:** Keep payment ≤ request and complete every line.
### Cancel blocked by pay run or receipts

- **Type:** Error
- **Action:** Cancel
- **When:** A pay run or receipt voucher is still linked.
- **Example message:** *Cancel Payrun with id = … before Cancelling Voucher.*; *Cancel Receipt Vouchers before cancelling Cash Advance Voucher (Id:…)*; *Unlink cash advance voucher from receipt voucher before cancelling*
- **Outcome:** Not cancelled.
- **Solution:** Cancel the pay run / receipts first.

</section>
