Cash Receive Form Manual

1. Introduction

The Cash Receive form is used to register incoming cash transactions from clients, customers, or other income sources. The front-end view is generated using Laravel Blade at resources/views/backend/voucher/cash-receive.blade.php and processes data through the VoucherMasterController.php.

2. Architecture: Database Tables & Models

The cash receive operation heavily interacts with the following backend structures to ensure accurate double-entry accounting.

3. Understanding the Controller

The form depends on VoucherMasterController.php. Below are the key functions handling this process.

The cashReceive() Method

This method prepares all requisite data to render the Blade view.

• Fetches the Page Context: Sets page title to "Cash Receive".
• Fetches Dropdown Data: Loads active Branches, Cost Centers, Account Ledgers, and Voucher Types (filtered specifically for 'CR').
• Determines the Cash Account: Identifies default ledger inputs by mapping to the general settings' _cash_group.
• Returns View: Renders backend.voucher.cash-receive with the compacted variables.

The voucherSave() Method

Once the user clicks Save, the form makes a POST request to the voucher-save URL, routed to voucherSave(Request $request).

// Example from VoucherMasterController@voucherSave
if($_voucher_type =="CR"){
    // 1. Calculate sum of all credit amounts inserted by the user
    $_total_dr_amount = array_sum($_cr_amount);
    
    // 2. Automatically push the Debit balance
    array_push($_dr_amount, $_total_dr_amount);
    array_push($_cr_amount, 0); 
    
    // 3. Assign this debit entry to the Cash Ledger chosen in the top dropdown
    array_push($_ledger_id, $request->_defalut_ledger_id);
    array_push($_cost_center, $request->_cost_center_id ?? 1);
    array_push($_branch_id_detail, $request->_branch_id ?? 1);
    array_push($_short_narr, 'N/A');
}

4. Step-by-Step Form Details

Here is how a user interacts with cash-receive.blade.php along with the underlying code mapping.