Chapter 51 — Salary components

A payslip is a list of lines, and a component is the definition of one line: what it is called, which side of the slip it sits on, how its amount is worked out, and how tax treats it. Define them once, assemble them into structures (Chapter 52), and every run resolves them into amounts. This chapter is the component form field by field, with the engine's actual behaviour behind each one.

What this chapter covers

• 51.1 Component types and categories
• 51.2 Calculation: fixed, % of basic, % of gross, computed by payroll
• 51.3 Taxable and mandatory
• 51.4 Tax exemption modes
• 51.5 Statutory bases: where they really come from
• 51.6 The seeded components

The concept

A good component set is small and literal. Each line answers one question an employee or an auditor will ask of the slip: what is this, how was it calculated, was it taxed. Lines that exist to make a total come out right, or that carry rules nobody can state, are the ones that fail an audit. Two habits matter: name the line as the law or the contract names it, and give it the calculation the contract actually promises, not a formula that happens to produce the same number this month.

How Operentra handles it

• Payroll › Salary Components lists the workspace's components in three groups, Earnings, Deductions and Employer Contributions, with the code, the calculation, the default value and the taxable badge; Add Component and the row's edit open one form.
• The form: name, a unique code, type, a free-text category, calculation type, default value, display order, the Is Taxable and Is Mandatory switches, and a Tax Exemption section.
• Four calculation types: a fixed amount, a percentage of Basic, a percentage of the assigned gross, or computed by payroll, which is for the lines the engine works out from the country's rules (income tax and social-security contributions, recognised by their code).
• Delete deactivates rather than erases, so history keeps its label, and is refused while an active structure includes the component; an inactive component cannot be added to a structure.
• Who: payroll.configure (Super Admin, HR Manager). The Accountant role processes and pays runs but does not define components.

Walkthrough

Northwind's list has six components: Basic Salary and Allowance as earnings; Income Tax, FICA and an inactive Other Deduction as deductions; FICA Employer as the employer contribution. Only three are on its structure (Chapter 52).

51.1 Component types and categories

Type decides the side of the slip. An Earning is paid to the employee and adds to gross. A Deduction is taken from the employee's pay. An Employer Contribution is the company's cost on top of pay and never touches net; it appears on the slip's employer side and in the run's totals. Category is a free label for grouping and reports ("Salary", "Allowance", "Statutory", "Other"); it changes nothing in the calculation. Code is the short identifier, unique in the workspace, that structures, imports and the engine refer to; the engine recognises a few by name, BASIC and TAX above all, so keep those codes exactly.

51.2 Calculation: fixed, % of basic, % of gross, computed by payroll

Fixed Amount pays the default value every month; a structure can override the value per row, and the assignment can set it per employee through the gross. % of Basic pays a percentage of the Basic line, worked on the full contracted Basic so the slip's lines stay consistent, with absence shown as its own deduction. % of Gross pays a percentage of the assigned gross; Northwind's Basic is 100% of gross, which is how a single-figure salary becomes the Basic line. Computed by payroll is for lines the engine works out itself: income tax from the fiscal year's slabs on the TAX code, and the country pack's social-security contributions on their own codes (FICA for the United States). The form does not evaluate formulas; a component of this type whose code the engine does not recognise pays its default value, which is usually zero.

Basic itself is resolved from the assignment: a Basic that is a percentage of gross takes that share of the employee's gross; a fixed Basic takes its value.

51.3 Taxable and mandatory

Is Taxable puts the line into taxable income, after any exemption in 51.4; Basic and a cash allowance are taxable in most countries, and a reimbursement is not. Is Mandatory marks the component as mandatory when it is added to a structure, where the Mandatory column shows it; it is a label for the people building structures, not a rule the engine enforces, so a structure can still be saved without a mandatory component.

51.4 Tax exemption modes

The Tax Exemption section caps the part of a taxable component that escapes tax. None taxes the whole line. % of Basic Salary exempts the line up to a percentage of Basic. Flat Amount Cap exempts it up to a fixed amount in the workspace currency. The exempt part is left out of taxable income and the rest is taxed; the line itself is paid in full either way. Use it only where the statute gives the allowance a tax-free share; where it does not, the honest setting is Taxable with no exemption.

51.5 Statutory bases: where they really come from

Every statutory amount has a base, and in Operentra the base is set by the rule, not by a flag on the component. A provident-fund line is a percentage of Basic, so Basic is its base. The country pack's social-security contributions use the base the pack states for each one: Basic, Basic plus housing, or the pay earned that month, which is why they fall when absence docks pay and do not when a lateness penalty does. Gratuity follows the country's end-of-service rule (Chapter 62). Overtime is recorded and approved in attendance (Chapter 39) and is not priced by the engine. An earlier form carried four "base" switches per component that nothing read; they are gone, and the bases are the rules above.

51.6 The seeded components

A new workspace starts with Basic Salary (fixed, taxable, mandatory, category Salary), Allowance (fixed at 0, taxable with no exemption, category Allowance, paying nothing until a structure gives it an amount), Income Tax (a deduction computed by payroll on the TAX code), and Other Deduction, inactive, which exists so that salary-history imports (Chapter 64) can carry an old slip's unmapped deduction. The country pack adds its own statutory lines: a US workspace gets FICA as a deduction and FICA Employer as an employer contribution, both computed by payroll, and other countries get theirs. A pack that knows its country's allowances seeds them in place of the plain Allowance: a UAE workspace gets Housing, Transport and Other Allowance. A Medical Allowance with a tax-free share is one country's statute, and only a workspace in that country gets it.

Northwind's Allowance is the plain one, taxable with no exemption; nothing on its payslips uses it, because the structure does not include it.

What happens next

• Structures (Chapter 52) pick components and set per-row calculation and values; assignments turn them into amounts.
• The run (Chapters 54 and 55) resolves every line, taxes the taxable ones after exemptions, and computes the statutory lines by code.

What the employee sees

The component names and amounts as lines on their payslip, grouped as earnings, deductions and the employer's contributions, with the taxable income the tax line was computed on.

Common mistakes

1. A formula in a component. The engine does not evaluate it; use a percentage type, or a computed line the engine knows by code.
2. Renaming the TAX or BASIC code. The engine finds them by code; a renamed one silently stops working.
3. An allowance marked non-taxable by habit. Where the statute taxes it, the slip under-withholds and the employee pays later.
4. A percentage of gross on an allowance that should follow Basic. Gross includes the allowance itself; the arithmetic is circular in spirit even if the engine computes it.
5. Expecting Delete to erase. It deactivates, so slips keep their lines, and it is refused while an active structure includes the component.
6. Expecting Is Mandatory to force inclusion. It labels the row in a structure; the structure's builder still chooses.
7. An employer contribution entered as a deduction. It would come out of the employee's pay.
8. Using Other Deduction for live payroll. It is inactive on purpose, for imported history only.

Practice

Use your own trial workspace, not a customer's.

1. Open Payroll › Salary Components and read the three groups; open Basic Salary's form and read every field.
2. Add "Phone Allowance" as a fixed, taxable earning, category Allowance, with a default of 50, and read it in the list.
3. Edit Allowance and set a flat-cap exemption of 100, then set it back to None.
4. Try to delete Basic Salary and read the refusal; delete Phone Allowance and confirm it leaves the structure picker.
5. Open Income Tax's form and read the note under Computed by payroll.

Quiz

1. What are the three component types and which never reaches net?

Earning, Deduction and Employer Contribution; the employer contribution is the company's cost and never reduces the employee's pay.

2. What does Computed by payroll mean?

The engine works the line out from the country's rules by its code: income tax on TAX, social-security contributions on the pack's codes. Formulas are not evaluated, and an unrecognised code pays its default value.

3. How does a tax exemption work?

The exempt part of the line, up to a share of Basic or a flat cap, is left out of taxable income; the line is still paid in full.

4. Where does the base of a statutory contribution come from?

From the rule: a provident-fund line is a percentage of Basic, the pack's social-security contributions use the base the pack states, gratuity follows the country's end-of-service rule.

5. When is deleting a component refused?

While an active structure includes it; otherwise Delete deactivates the component, which keeps history and removes it from the pickers.