# Loan
maintain complete loan transaction history.
This module supports filtering, exporting, resigned employee visibility, and role-based access control.
### Loan Types :
**1. LTA (Long Term Allowance / Company Loan)**
**LTA** refers to **Long Term Allowance**, commonly used for **company-provided long-term loans** to employees.\
All loans provided directly by the company are recorded under the **LTA / Company** section.
**2. Bank Loan :**
Bank loans are loans taken by employees from a bank where the **EMI is deducted from the employee’s salary**.\
These loans are managed under the **Bank** section for payroll deduction tracking.
***Common Action Buttons :***
**Filters:**
Allows filtering loan records using the following parameters:
#### Available Filters
* **Date** – Filter records based on the selected date range.
* **Employee** – View records for a specific employee.
* **Company** – Filter data by company.
* **Department** – Narrow results by department.
* **Location** – Filter records by work location.
* **Group** – View records by assigned group.
* **Category** – Filter entries by category type.
* **Has Contractor** – Show records related to contractors.
* **Loan Status** – Filter loans by status:\
**Complete**\
**Not Completed**
* **Clear Button** – Resets all applied filters and shows the default listing.
#### Resigned Toggle:
When enabled, loan entries of **resigned employees** become visible in the report.
#### Export:
Downloads loan data in report format for record-keeping and analysis.
#### Add Loan:
Used to create a new loan entry for an employee.
### Add Loan – Dialog Fields:
When clicking **Add Loan**, a dialog box opens with the following fields:
* **Loan Type (Bank / Company)** – Select whether the loan is taken from a bank or provided by the company.
* **Employee Name** – Select the employee to whom the loan is issued.
* **Opening Date** – Date on which the loan starts or is recorded.
* **Opening Balance** – Initial loan amount at the time of entry.
* **Installment Amount** – Amount to be deducted or paid per installment.
* **Rate of Interest** – Applicable interest rate on the loan.
* **Mode of Payment** – Method used for loan repayment (Salary deduction, Cash, Net Banking, etc.).
* **Return Start Date** – Date from which loan repayment begins.
* **Reason** – Reason for providing or taking the loan.
* **Add Button** – Saves the loan details and adds the record to the system.
### LTA / Company Loan Section:
#### Loan List Columns:
* **Date** – Date on which the loan record is created or updated.
* **Employee ID** – Unique identification number of the employee.
* **Employee Name** – Name of the employee who has taken the loan.
* **Loan Amount** – Total loan amount issued to the employee.
* **Installment Amount** – Fixed amount to be paid in each installment.
* **Remaining Amount** – Outstanding loan balance yet to be paid.
* **Status (Active / Pause)** –
**Active**: Loan repayment is currently ongoing.\
**Pause**: Loan repayment is temporarily stopped.
* **Action Buttons** –
* **View**: See complete loan details.
* **Edit**: Modify loan information.
* **Delete**: Remove the loan record from the system.
#### View Loan (Company / LTA)
Clicking **View** opens the detailed loan ledger.
**Summary Section:**
* **Opening Balance** – Loan balance at the beginning of the selected period.
* **Total Debit** – Total amount deducted or paid toward the loan.
* **Total Credit** – Total amount added or credited to the loan account.
* **Total Outstanding** – Remaining loan amount yet to be paid.
#### Transaction Table – Column Details
* **Date** – Date of the loan transaction.
* **Mode of Payment** – Method used for the transaction (Salary, Cash, Net Banking, etc.).
* **Type (Debit / Credit)** –
**Debit**: Amount paid or deducted from the loan balance.
**Credit**: Amount added to the loan balance.
* **Amount (₹)** – Transaction amount in rupees.
* **Action** –
**Edit**: Modify the transaction details.
**Delete**: Remove the transaction entry.
**Top Actions (Inside View)**
* Filter
* Export
* Add Transaction
#### Add Transaction:
Used to adjust or record additional loan transactions.
**Fields**
* **Date** – Select the date of the transaction.
* **Type (Debit / Credit)** –
**Debit**: Amount deducted or paid toward the balance.
**Credit**: Amount added to the balance.
* **Amount** – Enter the transaction amount.
* **Mode of Payment** – Select the payment method (Salary, Bonus, Cash, Net Banking, etc.).
* **Remark** – Add a short note or explanation for the transaction.
* **Add Button** – Saves the transaction and adds it to the record.
### Bank Loan Section:
**Bank Loan Report Columns:**
* **Serial Number** – Auto-generated sequence number for easy reference.
* **Date** – Date when the loan record was created or last updated.
* **Employee ID** – Unique identification number of the employee.
* **Employee Name** – Name of the employee who has taken the loan.
* **Loan Amount** – Total loan amount issued to the employee.
* **Installment Amount** – Fixed amount to be paid in each installment.
* **Remaining Amount** – Outstanding loan balance yet to be paid.
* **Status (Active / Paused)** –
**Active**: Loan repayment is currently ongoing.
**Paused**: Loan repayment is temporarily stopped.
* **Action Buttons** –
**View**: View complete loan details.
**Edit**: Modify loan information.
**Delete**: Remove the loan record.
#### Add Bank Loan:
Fields include:
* **Loan Type (Bank / Company)** – Select whether the loan is taken from a bank or provided by the company.
* **Employee Name** – Select the employee to whom the loan is assigned.
* **Opening Date** – Date on which the loan is recorded or starts.
* **Opening Balance** – Initial loan amount at the time of entry.
* **Installment Amount** – Amount to be deducted in each repayment cycle.
* **Rate of Interest** – Applicable interest rate on the loan, if any.
* **Mode of Salary Deduction** – Method through which the installment will be deducted from salary.
* **Repayment Start Date** – Date from which loan repayment begins.
* **Reason** – Reason for providing or taking the loan.
* **Add Button** – Saves the loan details and adds the record to the system.
### Edit & Delete Actions:
#### Edit:
Allows modification of loan details such as:
* **Amount** – Total loan amount that can be edited if required.
* **Installment** – Installment amount that can be modified.
* **Interest** – Applicable interest value or rate, editable as per policy.
* **Repayment Dates** – Dates on which loan repayments are scheduled; these can be updated if needed.
* **Other Editable Fields** – Additional loan-related details that are allowed to be edited based on permissions.
#### Delete:
Permanently deletes the loan or transaction entry from the system.
### Loan Request Notification & Approval Workflow
#### Loan Request Notifications:
Whenever an employee submits a **Loan Request**, a **notification is sent to the Superadmin’s Inbox**.
From the **Inbox section**, the Superadmin can:
* View all loan request details
* Take action on the request (Approve or Decline)
#### Details Visible in the Notification:
On opening the loan request notification, the Superadmin can view:
* Loan Type (Company / Bank)
* Reason for Loan
* Requested Amount
* Date of Application
#### Approve or Decline Loan Request
**Approve Loan Request:**
If the Superadmin **approves** the loan request, the system asks to confirm or define the following details:
* Mode of Payment (Salary / Cash / Net Banking,etc.)
* Payment Date
After approval:
* The **loan status changes from *****Pending***** to *****Approved***
* The loan entry becomes active in the **Loans module**
* Installments are processed as per configuration
**Decline Loan Request:**
If the Superadmin clicks **Decline**:
* The loan request status changes from pending to declined
* The declined request remains visible for audit/reference purposes
#### Loan Request Status Flow Pending → Approved
The updated loan status is reflected immediately in the **employee’s loan records**.
### Loan for Employee:
The **Loans module** allows employees to view their loan information and transaction history based on the permissions assigned to them.
### Loan Details (Employee View):
Employees can view the following loan information in their account:
* **Opening Date**\
Date on which the loan was initiated.
* **Installment Amount**\
Monthly installment amount deducted (in INR).
* **Rate of Interest (%)**\
Interest rate applied to the loan.
* **Return Start Date**\
Date from which loan repayment starts.
* **Mode of Payment**\
Repayment mode (Salary).
* **Reason**\
Purpose of the loan (for example: Personal Loan).
* **Opening Balance**\
Total loan amount at the time of creation.
* **Total Debits**\
Total loan amount credited to the employee.
* **Total Credits**\
Total amount repaid by the employee.
* **Total Outstanding**\
Remaining loan amount yet to be paid.
### Loan Transaction History:
Employees can view a detailed transaction history for the loan, including:
* Transaction ID
* Date
* Mode of Payment (Salary / Cash / Bonus,etc.)
* Type (Debit or Credit)
* Transaction Amount (INR)
This data is **view-only** for employees.
### Available Actions:
#### Export:
* Employees can download their loan details and transaction history.
#### Apply Loan:
* Employees can apply for a new loan request directly from their account.
**Apply Loan:**
**Apply Loan Process:**
1. Click on **Apply Loan**
2. A dialog box opens asking for:
* Loan Amount
* Needed By (date selection)
* Reason
3. Click **Apply** to submit the request
After submission:
* The loan request status remains **Pending**
* Notification is sent to the **Superadmin**
* Approval or rejection is handled by the Superadmin
### Access & Permissions
#### Role-Based Access Control:
* **Superadmin**
Has access to **all loan-related data**
Can view, create, edit, delete, export, and manage transactions
#### Permission Path:
**Settings → Employee → Edit Employee → Permissions Tab → Payroll Section**\
\
\
\
Under the **Payroll** section, **Loan permission toggles** are available. Using these toggles, the Superadmin can control whether an employee can:
* View (My All)
* View (My Team)
* View (My Self)
* Create
* Edit
* Delete
Superadmin can enable or disable permissions for other roles and must click **Save** to apply changes.
