Employer Entities
In the Payroll Bureau vertical, entities represent your employer clients — the companies whose payroll you process. The sidebar relabels "Clients" to Employers and entity cards display payroll-specific fields.
Entity Types
Payroll Bureau supports these entity types:
| Entity Type | Common Use |
|---|---|
| Pty (Ltd) | Private companies |
| Close Corporation | CC entities |
Required Fields for Payroll
For AtlasOS to auto-generate accurate payroll deadlines, each employer entity must have:
| Field | Purpose |
|---|---|
| PAYE Reference Number | Links to SARS EMP201/EMP501 deadlines |
| UIF Reference Number | Links to UIF monthly filing deadlines |
| SDL Reference Number | Skills Development Levy tracking |
| COIDA Registration | Return of Earnings tracking |
| Payroll Frequency | Monthly, Weekly, or Bi-weekly — determines run cadence |
| Tax Year End | Default: February — aligns EMP501 deadlines |
| Financial Year End | Entity financial year for reporting alignment |
Zambia-Specific Fields
| Field | Purpose |
|---|---|
| TPIN | Tax Payer Identification Number — links to ZRA PAYE |
| NAPSA Number | National Pension Scheme tracking |
| NHIMA Number | National Health Insurance tracking |
Employee Linking
Link employees to their employer via the People tab on the employer entity:
- Each employee record includes name, ID number, tax reference, and role
- Employee count drives payroll report calculations
- Smart features (automated onboarding tasks, payslip distribution) depend on accurate employee records
Service Flags
Assign service flags to employer entities to control which compliance obligations are auto-generated:
| Service Flag | Obligations Generated |
|---|---|
| PAYE | EMP201 monthly, EMP501 bi-annual |
| UIF | UIF monthly filing |
| COIDA | COIDA Annual Return of Earnings |
| Payroll Processing | Payroll run task checklists |
Related Pages
- Payroll Deadlines — Compliance obligation tracking
- Payroll Runs — Processing payroll per employer
- Secure Payslips — Employee payslip delivery