Bonuses and deductions - KayanOS Documentation

Bonuses and deductions are separate adjustment records. Each record identifies a member, a date, and an amount. It can optionally link to a salary slip for the same member. Use the records to preserve a clear operational link between an adjustment and the person/period it concerns. The supplied source does not require a reason, reviewer, policy citation, or “effective period” field. If your organization needs those controls, configure approved additional fields and apply its own review process instead of assuming they are built into the basic record.

When to use it

Use a bonus when the organization has approved a positive adjustment for a member. Use a deduction when the organization has approved a negative adjustment for a member. Select a related salary slip only when it is the correct slip for that same member. Do not use an adjustment record to change a salary scale, rewrite a member’s assignment salary, or represent a payment transaction. It is an operational adjustment record, not proof of payment or legal authorization.

Configuration

Field	Bonus and deduction behavior	Review guidance
Member	Required	Select the person first. It is the anchor for the record and the optional salary-slip filter.
Date	Required	Use the organization-approved operational date for the adjustment record.
Amount	Required	Enter the reviewed amount using the organization’s approved currency/context.
Salary slip	Optional	The selectable slips are filtered to the chosen member. Link one only when the adjustment belongs to that slip.

Salary-slip details can display bonuses and deductions as part of the slip’s review values. Whether and how the organization approves, calculates, or pays an adjustment remains outside this basic record’s guaranteed behavior.

Workflow

Open the appropriate Bonuses or Deductions area available to your capability.
Search for and select the correct member.
Enter the date and reviewed amount.
If the adjustment belongs to a salary slip, choose only a slip belonging to that member.
Save the record and re-open it to verify member, date, amount, and optional slip relation.
Use the organization’s approved review process before relying on the record in a salary-slip or payroll review.

Keep a correction trace. If the wrong member or salary slip was selected, correct the record using the organization’s approved process rather than creating a confusing duplicate with opposite values.

Worked example

The Directorate records an approved service-recognition adjustment for Rania’s September salary-slip review.

Member: Rania Haddad Date: 25 September Adjustment: bonus Amount: a non-sensitive reviewed demonstration amount Optional salary slip: Rania’s September salary slip

The payroll reviewer confirms the selected slip belongs to Rania before linking it. The record helps the reviewer trace the adjustment to the intended member and period. It does not prove that money has been transferred, that a policy condition has been met, or that the amount is legally required. For a deduction, use the same sequence: select the member, date, amount, and optional matching slip. Do not select another member’s slip merely because it has the same month.

Testing

Use a temporary member and temporary salary slip with no live payment data.

Create a temporary bonus with member, date, and amount.
Confirm that only the temporary member’s salary slip is available for the optional relation.
Create a temporary deduction using the same member and verify the fields separately.
Review the temporary salary-slip detail where available.
Remove or retire the test records according to approved cleanup practice.

Do not test by inserting offsetting adjustments in a live payroll period. That can obscure audit review even if the net value appears unchanged.

Troubleshooting

Situation	Check	Resolution
The intended salary slip is not selectable	Selected member and slip’s member relationship	Select the correct member first, then confirm the slip belongs to that person.
The wrong member was selected	Member and optional slip	Correct both relationships through the approved process; do not leave a misleading link.
A reviewer expects a reason field	Organization configuration	Use an approved additional field/process if a reason is required; do not invent it in an unrelated field.
The amount is visible but payment is not confirmed	Scope of the record	Check the organization’s separate payment/financial procedure. The adjustment record does not prove disbursement.
A user cannot edit the adjustment	Entity capability and scope	Request the smallest needed capability and avoid broad compensation access.

Permissions and data-quality limits

Bonuses, deductions, salary slips, and payroll can each have different capabilities and scopes. Limit access to people who need it for approved compensation work. This guide describes record relationships supported by KayanOS. It does not state an employment policy, payroll formula, tax treatment, benefits rule, disciplinary process, legal conclusion, or payment authorization. Illustrative KayanOS payroll adjustment for a representative employee.

Illustrative KayanOS payroll adjustment for a representative employee.

Review period records in Payroll and salary slips.
Configure role context in Salary scale.
Maintain workforce identity separately in Workforce members.

​When to use it

​Configuration

​Workflow

​Worked example

​Testing

​Troubleshooting

​Permissions and data-quality limits

​Related guides