Expenses in Payslips
Reimburse employee expenses directly through payroll
The Expenses in Payslips module integrates expense management with payroll, allowing employee expenses to be reimbursed directly through their regular payslip instead of requiring separate expense payments. This streamlines the reimbursement process and reduces payment processing overhead.
The module automatically links approved expenses to draft payslips, creates input lines with total expense amounts, and automatically reconciles expense and payslip accounting entries.
Key Features
Key points
• Report in Payslip: Mark approved expenses for payslip reimbursement
• Automatic Linking: Expenses automatically added to draft payslips
• Smart Button: View all expenses linked to a payslip
• Input Line Generation: Expense totals automatically added to payslip calculations
• Automatic Reconciliation: Expense and payslip accounting entries reconciled automatically
• Validation: Ensures proper salary rule and account configuration
• Payment Warning: Alerts when attempting to pay expenses already in payslips
User Roles & Permissions
Role Permissions
| Role | Permissions |
|---|---|
| Employee | Submit expenses, view own expenses and payslips |
| Manager | Approve expenses, view team expenses |
| HR Officer | Process payroll, link expenses to payslips |
| Payroll Manager | Full payroll access, configure expense rules |
| Accountant | Post expense moves, reconcile payments, configure accounts |
Reporting Expenses in Payslips
Prerequisites: Expense must be Approved or Posted, payment mode must be Paid by Employee (own_account), EXPENSES salary rule must be configured in payroll structure.
Marking expenses for payslip reimbursement:
Key points
• From Expense List: Select multiple approved/posted expenses and use Action → Report in Next Payslip
Steps
1. From Expense Form: Navigate to Expenses → My Expenses or Expenses → All Expenses
2. Open an approved/posted expense
3. Click Report in Next Payslip button
4. System validates configuration and marks expense
5. Expense will be included in next draft payslip
Viewing Expenses on Payslips
Key points
• Expense information displayed: Total amount, expense category, date, description, receipt, status
Steps
1. Navigate to Payroll → Payslips
2. Open any payslip
3. Look for the Expenses smart button at the top
4. The button shows the count of linked expenses (e.g., "3 Expenses")
5. Click the Expenses smart button to open the list
Removing Expenses from Payslips
Expenses can only be removed from draft payslips (not yet validated) or cancelled payslips. Expenses CANNOT be removed from validated payslips, paid payslips, or payslips with posted accounting entries.
Steps
1. Open the expense
2. Click Remove from Payslip button
3. System unlinks expense from payslip
4. Expense can be added to another payslip
Payslip Processing with Expenses
Automatic expense linking: When a draft payslip is created, the system searches for eligible expenses (same employee, approved or posted state, paid by employee, flagged for payslip reimbursement, not already linked to another payslip) and automatically links them to the payslip.
Key points
• Payslip computation: Payslip computed with regular salary components, EXPENSES input line added with total expense amount, EXPENSES salary rule processes the amount, net pay includes expense reimbursement
• Payslip validation: Before validating, system checks EXPENSES rule exists, validates rule has proper debit account configured, ensures account is type "Payable"
• Payslip cancellation: When a payslip is cancelled, expenses automatically unlinked and remain flagged for next payslip
Automatic Reconciliation
When a payslip with expenses is validated:
Steps
1. Payslip Move Posted: Payslip accounting entry created, includes line for expense reimbursement (debit payable account)
2. Expense Moves Posted: System posts expense moves if not already posted, each expense has payable account line (credit)
3. Matching Numbers Assigned: System assigns matching numbers to pair lines, format: {index}-{payslip_move_id}-{expense_move_id}
4. Automatic Reconciliation: System attempts to reconcile matched lines, if same account: direct reconciliation, if different accounts: creates transfer entry
5. Expense Marked Paid: Expense state changes to "Paid", expense report marked as paid
Configuration Requirements
Salary rule configuration:
Steps
1. Creating EXPENSES rule: Navigate to Payroll → Configuration → Salary Rules
2. Click New
3. Set Code to "EXPENSES"
4. Configure Debit Account (payable type)
5. Add to relevant salary structures
| Fields | Trường dữ liệu | Description |
|---|---|---|
| Code | Code | EXPENSES (exact match required) |
| Name | Name | Any (e.g., "Expense Reimbursement") |
| Category | Category | Reimbursement or similar |
| Debit Account | Debit Account | Must be configured, type must be "Payable" |
Troubleshooting
Key points
• "Report in Next Payslip" Button Not Visible: Expense not approved/posted, payment mode not "Paid by Employee", user lacks required permissions
• Error "Expense reimbursement rule needs to be configured": No EXPENSES salary rule in payroll structure. Create rule with code "EXPENSES" and configure debit account
• Error "No debit account for EXPENSES rules": EXPENSES rule exists but no debit account configured. Set Debit Account field
• Cannot Remove Expense from Payslip: Payslip is validated or has posted accounting entry. Expenses can only be removed from draft/cancelled payslips
• Expense Not Automatically Added to Payslip: Expense not flagged for payslip reimbursement, expense already linked elsewhere, payslip structure missing EXPENSES rule
• Automatic Reconciliation Failed: More than 2 accounts involved, expense move edited after posting. Use matching numbers to manually reconcile
Best Practices
Key points
• For Employees: Submit promptly, complete information, check status, review payslip
• For Managers: Timely approval before payroll cutoff, verify amounts, flag issues, communicate deadlines
• For HR Officers: Set payroll cutoff, review before processing, validate configuration, monitor errors, communicate
• For Accountants: Account setup, monitor reconciliation, manual reconciliation using matching numbers, audit trail, month-end verification
• Timing Considerations: Set expense submission deadline 3-5 days before payroll processing, review linked expenses before validation, ensure all expense-payslip reconciliations complete