# HR & Payroll

<p class="doc-lead">Submit employee expense claims and cash advance requests, and record bulk attendance from the <b>More</b> tab. Draft documents can be edited or deleted in the app; approval is handled on the web.</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">Expense Claim</span>
<div class="doc-toc-links">
<a href="#/field-sale-app/hr-and-payroll?id=expense-claim-overview">Overview</a>
<a href="#/field-sale-app/hr-and-payroll?id=expense-claim-list">List</a>
<a href="#/field-sale-app/hr-and-payroll?id=expense-claim-create">Create</a>
<a href="#/field-sale-app/hr-and-payroll?id=expense-claim-view">View</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Cash Advance Request</span>
<div class="doc-toc-links">
<a href="#/field-sale-app/hr-and-payroll?id=cash-advance-overview">Overview</a>
<a href="#/field-sale-app/hr-and-payroll?id=cash-advance-list">List</a>
<a href="#/field-sale-app/hr-and-payroll?id=cash-advance-create">Create</a>
<a href="#/field-sale-app/hr-and-payroll?id=cash-advance-view">View</a>
<a href="#/field-sale-app/hr-and-payroll?id=bulk-cash-advance">Bulk create</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Attendance</span>
<div class="doc-toc-links">
<a href="#/field-sale-app/hr-and-payroll/attendance">Attendance Entry</a>
<a href="#/field-sale-app/hr-and-payroll/attendance?id=bulk-add">Bulk add employees</a>
</div>
</div>
</div>

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

<h2 id="expense-claim-overview">Expense Claim — overview</h2>

Open **More** → **Expense Claim** to view and submit expense claims for the logged-in user’s default **Employee**.

The list shows claims for that employee only. The app supports create, view, edit, and delete on **Draft** claims. There is no **Approve** action on mobile — use the web payroll module to approve or reject claims.

> Screenshot pending for expense claim list and create screens.

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

<h2 id="expense-claim-list">Expense Claim — list</h2>

Each row shows:

- **EXP [id]** with document status badge
- Expense claim category name
- Amount
- Date and relative time (for example **2 hours ago**)
- Secondary status (when configured)

Pull down to refresh; scroll to load more (20 per page).

Tap a row to open the claim view. **CREATE NEW** appears at the bottom when **Expense Claim — New** access is granted.

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

<h2 id="expense-claim-create">Expense Claim — create</h2>

**More** → **Expense Claim** → **CREATE NEW**.

| Field | Required | Notes |
|-------|----------|-------|
| **Expense Claim Category** | Yes | Pick from active categories |
| **Amount** | Yes | Claim amount |
| **Notes** | No | Free-text notes |

The employee is taken from the user’s default **Employee** in settings. If no default employee is configured, the app shows an alert and the claim cannot be saved.

The claim date is set automatically when saved. Tap **CREATE EXPENSE CLAIM** to save as **Draft**, then open the view screen.

On a draft, **Edit** reopens the same form with an **UPDATE** footer button.

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

<h2 id="expense-claim-view">Expense Claim — view</h2>

| Field | Description |
|-------|-------------|
| Status | Document status and secondary status (when set) |
| **Date** / **Time** | Claim date |
| **Category** | Expense claim category |
| **Amount** | Claim amount |
| **Notes** | Notes when entered |

<h3>Attachments</h3>

The **Attachments** section lists files linked to the claim. Tap **Add Attachment** to upload from the device. Existing attachments can be opened or deleted.

<h3>Actions and status</h3>

| Action | Status | Access required |
|--------|--------|-----------------|
| **Edit** | Draft | Expense Claim — Edit |
| **Delete** | Draft | Expense Claim — Delete |

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

<h2 id="cash-advance-overview">Cash Advance Request — overview</h2>

Open **More** → **Cash Advance Request** to browse and submit employee cash advance or loan requests.

Unlike expense claims, the cash advance list can show requests for all employees (filtered by status and optionally by employee when **Allow Employee Editing?** is enabled in user settings).

The app supports create, view, edit, and delete on **Draft** requests. Approval is done on the web — there is no **Approve** footer on mobile.

> Screenshot pending for cash advance list and bulk create screens.

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

<h2 id="cash-advance-list">Cash Advance Request — list</h2>

<h3>Filters</h3>

- **Select Status** — **All**, **Draft**, **Approved**, **Closed**, or **Cancelled**
- **Employee** selector — shown when **Allow Employee Editing?** is enabled; filters the list to one employee

<h3>List item</h3>

Each row shows:

- **CAR [id]** with status badge
- Employee name and category (**Cash Advance** or **Loan**)
- Amount
- Date and relative time
- Secondary status (when configured)

Pull down to refresh; scroll to load more (20 per page).

<h3>Footer buttons</h3>

| Button | When shown | Opens |
|--------|------------|-------|
| **CREATE NEW** | Cash Advance Request — New | Single request create |
| **BULK CREATE** | New access + **Allow Employee Editing?** | Bulk cash advance wizard |

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

<h2 id="cash-advance-create">Cash Advance Request — create</h2>

**More** → **Cash Advance Request** → **CREATE NEW**.

| Field | Required | Notes |
|-------|----------|-------|
| **Employee** | Yes | Shown only when **Allow Employee Editing?** is enabled; otherwise default **Employee** is used |
| **Date** | Yes | Request date |
| **Amount** | Yes | Requested amount |
| **Notes** | No | Free-text notes |

Tap **CREATE CASH ADVANCE** to save as **Draft**.

The **Category** field (**Cash Advance** vs **Loan**) is shown on the view screen after save — it is not selectable on the mobile create form (set by the back office / defaults).

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

<h2 id="cash-advance-view">Cash Advance Request — view</h2>

| Field | Description |
|-------|-------------|
| Status | Document status and secondary status (when set) |
| **Date** | Request date |
| **Employee** | Employee name |
| **Amount** | Requested amount |
| **Category** | **Cash Advance** or **Loan** |
| **Notes** | Notes when entered |

<h3>Actions and status</h3>

| Action | Status | Access required |
|--------|--------|-----------------|
| **Edit** | Draft | Cash Advance Request — Edit |
| **Delete** | Draft | Cash Advance Request — Delete |
| **Create New Cash Advance** | Any | Cash Advance Request — New (shortcut to create another) |

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

<h2 id="bulk-cash-advance">Bulk Cash Advance Request</h2>

Available from the cash advance list when **Allow Employee Editing?** is enabled and the user has **Cash Advance Request — New** access.

Use this flow to raise cash advance requests for multiple employees in one batch (for example after a field tour or team payout).

<h3>Step 1 — Select employees</h3>

| Control | Purpose |
|---------|---------|
| **Date** | Shared request date for all lines |
| **Notes** | Shared notes copied to each request |
| **Search employees…** | Filter by name, phone, or employee code |
| **Select All** / **Deselect All** | Toggle all employees in the current filter |
| **Department** | Optional filter when **Department — List** access is granted |
| Per-row checkbox + **Amount** | Select employee and enter individual amount |

Tap **REVIEW BULK CASH ADVANCE** when at least one employee is selected and every selected row has a valid amount.

<h3>Step 2 — Review and confirm</h3>

The **Review Bulk Cash Advance** screen lists each selected employee with amount and shows the total. Tap **CONFIRM** to create all draft requests in one batch. On success the app returns to the cash advance list.

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

<h2 id="access">Access summary</h2>

| Feature | List | New | View | Edit | Delete |
|---------|------|-----|------|------|--------|
| Expense Claim | Expense Claim — List | Expense Claim — New | Expense Claim — View | Expense Claim — Edit | Expense Claim — Delete |
| Cash Advance Request | Cash Advance Request — List | Cash Advance Request — New | Cash Advance Request — View | Cash Advance Request — Edit | Cash Advance Request — Delete |

Bulk create additionally requires **Allow Employee Editing?** in user settings. Department filter on bulk create requires **Department — List**.

For **Attendance Entry** on the More tab, see [Attendance](field-sale-app/hr-and-payroll/attendance.md).

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

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

<p><b>Can I approve expense claims from the app?</b><br>
The app creates and edits draft expense claims and cash advance requests. Approval workflow runs on the web HRMS unless mobile approve actions are granted on your role.</p>

<p><b>What is bulk cash advance?</b><br>
Create draft cash advance requests for multiple employees in one batch when <b>Allow Employee Editing?</b> is enabled in user settings and list permissions are granted.</p>

<p><b>Why is Department filter missing on bulk create?</b><br>
Grant Department — List on the Field Sale App role to filter employees by department on the bulk cash advance screen.</p>

<p><b>Do HR documents sync immediately?</b><br>
Yes after save and successful sync. Open the web HRMS module to track approval status on submitted requests.</p>

<p><b>Where is attendance documented?</b><br>
See <a href="#/field-sale-app/hr-and-payroll/attendance">Attendance</a> for multi-select bulk attendance entry on the More tab — select many employees, apply shared status and overtime, then edit exceptions individually.</p>

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

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

- [Attendance](field-sale-app/hr-and-payroll/attendance.md)
- [Transactions — More tab](field-sale-app/transactions.md?id=more-tab)
- [Settings — user defaults](field-sale-app/settings.md)
