Payroll Entry
Payroll Entry is the bulk payroll processing document in Smooth HR. It selects eligible employees for a pay period, generates draft Salary Slips in one action, and submits them together after review. For most organizations, Payroll Entry is the primary tool used every pay cycle.
Table of Contents
- Overview
- Where to find it
- Prerequisites
- Creating a Payroll Entry
- Key fields
- Generating salary slips
- Reviewing and submitting
- Accounting integration
- Partial and off-cycle payroll
- Tips
- Troubleshooting
- Related guides
Overview
| Aspect | Detail |
|---|---|
| DocType | Payroll Entry |
| Desk path | /app/payroll-entry |
| Purpose | Bulk create and submit Salary Slips for a date range |
| Typical frequency | Monthly, bi-weekly, or weekly per company policy |
| Output | Submitted Salary Slips linked to this Payroll Entry |
Payroll Entry does not define how much each employee earns — that comes from Salary Structure Assignment and Salary Structure. Payroll Entry orchestrates when slips are generated and ensures all eligible employees are processed consistently.
Where to find it
- Log in to your Smooth HR site (e.g.,
https://yoursite.smoothhrms.com). - Open Payroll from the app switcher or sidebar.
- Click Payroll Entry in the module sidebar, or search Payroll Entry in the desk search bar.
| Action | Path |
|---|---|
| List all payroll runs | /app/payroll-entry |
| Open a specific entry | /app/payroll-entry/{name} |
| Related salary slips | Filter Salary Slip by Payroll Entry link |
Prerequisites
Before creating Payroll Entry, confirm:
| Requirement | Verify at |
|---|---|
| Active Payroll Period covering your dates | /app/payroll-period |
| Salary Structure Assignment for each employee | /app/salary-structure-assignment |
| Attendance or Leave finalized for period | Attendance / Leave Application |
| Tax declarations submitted (if mid-year) | /app/employee-tax-exemption-declaration |
| No duplicate slips for same period | /app/salary-slip filtered by dates |
| Payroll Settings configured | /app/payroll-settings |
Missing structure assignments are the most common reason employees are excluded from the employee table.
Creating a Payroll Entry
Step 1: New document
- Go to Payroll Entry → Add Payroll Entry.
- Select Company — only employees in this company appear.
- Set Posting Date — accounting date for journal entries.
- Choose Currency (defaults from company).
- Select Payroll Frequency — Monthly, Fortnightly, Weekly, etc.
- Enter Start Date and End Date for the pay period (must fall within Payroll Period).
Step 2: Get employees
- Click Get Employees — Smooth HR queries active employees with valid salary assignments overlapping the period.
- Review the Employees child table:
- Employee — ID and name
- Employee Name — display name
- Department — for filtering
- Designation — optional review column
- Remove rows for employees on unpaid leave entire period, already paid, or not yet joined.
- Use filters if processing a subset (single department, location).
Step 3: Save draft
Save the Payroll Entry as Draft before generating slips — you can return to adjust the employee list.
Key fields
| Field | Description | Required |
|---|---|---|
| Company | Legal entity running payroll | Yes |
| Posting Date | GL posting date | Yes |
| Payroll Frequency | Monthly, Weekly, etc. | Yes |
| Start Date | Period start (inclusive) | Yes |
| End Date | Period end (inclusive) | Yes |
| Exchange Rate | For multi-currency (if applicable) | If foreign currency |
| Payroll Payable Account | Liability account for net pay | If accounting enabled |
| Status | Draft → Submitted | — |
| Salary Slips Created | Checkbox after slip generation | Auto |
| Salary Slips Submitted | Checkbox after submission | Auto |
Employees table:
| Column | Description |
|---|---|
| Employee | Link to Employee master |
| Department | From employee record |
| Designation | From employee record |
Generating salary slips
- With employees loaded, click Create Salary Slips.
- Smooth HR creates one Salary Slip per employee in Draft status.
- Each slip calculates:
- Payment Days from attendance/leave per Payroll Settings
- Earnings and Deductions from Salary Structure
- Income Tax from slabs and exemption declarations
- Net Pay = total earnings − total deductions
- Salary Slips Created is checked on Payroll Entry.
- Click View Salary Slips (or open Salary Slip list filtered by this entry) to review.
Tip: For large payrolls (500+ employees), generation may take several minutes. Do not refresh the browser until complete.
If generation fails for specific employees, error messages indicate the cause (missing assignment, duplicate slip, invalid dates). Fix at source and click Create Salary Slips again for remaining employees.
Reviewing and submitting
Review individual slips
Open each Salary Slip and verify:
| Check | What to look for |
|---|---|
| Payment days | Matches expected working days |
| Basic / gross | Structure amounts prorated correctly |
| TDS | Reasonable vs. declaration |
| Deductions | PF, PT, loan recoveries present |
| Net pay | No negative values (unless recovery scenario) |
Submit payroll
- Return to Payroll Entry.
- Click Submit Salary Slips — all linked draft slips submit together.
- Status changes to Submitted; slips cannot be edited without cancel.
- Emails send if Email salary slip to employee is enabled in Payroll Settings.
Cancel and re-run
If a critical error is found after submit:
- Cancel Payroll Entry (cancels linked salary slips if permitted).
- Fix root cause (attendance, structure, tax).
- Create new Payroll Entry for the same period.
Some organizations restrict cancel permissions to HR Manager only.
Accounting integration
When Create salary slip journal entry is enabled in Payroll Settings:
| Event | Accounting action |
|---|---|
| Salary Slip submit | Debit expense accounts per component; credit payroll payable |
| Payment Entry (later) | Debit payroll payable; credit bank |
Verify accounts are mapped on each Salary Component. Run General Ledger report filtered by posting date to reconcile.
Payroll Payable Account on Payroll Entry overrides default payable account if needed.
Partial and off-cycle payroll
| Scenario | Approach |
|---|---|
| Single department | Get Employees → delete other rows → generate |
| New joiner mid-month | Ensure assignment From Date ≤ join date; proration automatic |
| Final settlement | Include in regular run or separate entry; check withholding |
| Bonus only | Use Additional Salary instead of full Payroll Entry |
| Arrears | Additional Salary with retro dates; then include in next entry |
Tips
- Name your periods consistently — e.g., "January 2026" in naming convention aids audit.
- Run balance reports first — Leave Balance and Monthly Attendance Sheet before Get Employees.
- Lock data before submit — communicate cutoff to managers.
- Export Salary Register immediately after submit — snapshot for finance.
- Do not edit submitted slips — always cancel and regenerate for audit trail integrity.
- Test with one employee when onboarding new salary structures.
Troubleshooting
| Issue | What to do |
|---|---|
| Get Employees returns empty | Check company match, active employees, structure assignment dates |
| Create Salary Slips — duplicate error | Cancel existing draft/submitted slip for same employee and period |
| Payment days = 0 | Mark attendance; approve leave; verify joining/relieving dates |
| Slip amount unexpectedly low | Check LWP leave applications; verify structure proration formula |
| Submit button disabled | Ensure all slips created; resolve draft errors on individual slips |
| Journal entry missing | Payroll Settings → enable JE; map accounts on components |
| Employee received duplicate email | Check if two Payroll Entries overlap same dates |
Related guides
Last updated: May 2026