Payroll Social Security Policies
The Payroll Social Security Policies page defines employee/employer contribution rules and effective rates.
Social Security Policies Index Page

Available Filters
| Filter | Description |
|---|---|
| Branch | Filters by branch. |
| Calculation Mode | Filters by calculation mode. |
| Base Source | Filters by source used for social-security base. |
| Active | Shows active/inactive policies. |
| From | Start date of created-at range. |
| To | End date of created-at range. |
Table Columns
- Name
- Branch
- Calculation Mode
- Base Source
- Active
- Effective From
- Created At
- Updated At
Header Actions
- Create Payroll Social Security Policy
Row Actions
- Edit
- Delete
Bulk Actions
- Delete
Create/Edit Social Security Policy Page

Policy Information
| Option | Purpose |
|---|---|
| Name | Multi-language policy name. |
| Branch | Branch where policy applies. |
| Effective From | Policy start date. |
| Effective To | Optional policy end date. |
Configuration
| Option | Purpose |
|---|---|
| Calculation Mode | Contribution mode (currently Monthly). |
| Base Source | Base source: Taxable Earnings, Basic Salary, Gross Earnings. |
| Salary Ceiling | Optional cap for contribution base. |
| Active | Enables/disables the policy. |
Rates Table
| Option | Purpose |
|---|---|
| Code | Rate identifier. |
| Employee Rate % | Employee contribution rate. |
| Employer Rate % | Employer contribution rate. |
| Ceiling Override | Optional rate-level ceiling, within policy salary ceiling. |
| Reorder / Add / Delete | Manage rate rows. |
Validation Rules (Important)
- At least one rate row is required.
- Rate IDs and codes must be unique in the submitted list.
- If Ceiling Override is used, policy Salary Ceiling is required.
- Ceiling Override cannot exceed policy Salary Ceiling.
- Effective periods cannot overlap another policy in the same branch/mode.
