Employee payroll settings
The Payroll tab on an employee's profile holds everything payroll needs to know about that person: their salary and how it converts to daily and hourly rates, which payroll they are in, recurring allowances and deductions, contribution overrides, tax and payment method, and earnings from a previous employer this year. Set it up when someone joins, and update it on any salary or contract change.
Where: the employee's profile › Payroll tab
You need:
- The Payroll right
- Read access to the employee's payroll information to see the tab, and write access to edit it. Without write access, Save becomes Request and the change goes for approval.
Before You Start
Have the contract to hand. Basic Wage, Wage Period and Wage Type all come from it. Know whether the agreed figure is gross or take-home: for Nett and Gross Up, enter the take-home figure.
Two things that affect pay are set on other tabs:
- Expected working hours, which turns the daily rate into an hourly one, is on the profile's Attendance tab. See Attendance settings on an employee profile.
- Bank details are on the Personal tab.
The tab has five cards, each with its own Edit: Salary, Other payments, Contributions, Tax & Payments and Previous Employer. Use the Jump to chips to reach them.
How to set up an employee's pay
- Open the employee's profile and select the Payroll tab.
- On Salary, click Edit. Enter Basic Wage, Wage Period and Wage Type, then Monthly Wage Basis, Work Days per Week and Batch Cycle.
- Under Career Progression, enter the Effective Date and a Remark, then click Save.
- On Other payments, click Add Payment for each recurring allowance or deduction.
- On Contributions, check each contribution is Active, and add any override.
- On Tax & Payments, set Payment Method, Tax start date and Income tax type, and Tax Code or Non taxable group where your country uses them.
- On Previous Employer, enter their earnings elsewhere this tax year, if any.
- Calculate their first payslip and check the daily rate: Basic Wage ÷ the monthly wage days you expect.
Salary card
| Field | What it does | Default |
|---|---|---|
| Basic Wage | The rate per wage period. A wage of 0 stops a payslip being calculated | 0 |
| Minimum Wage | The branch's minimum wage, shown for reference | From branch |
| Work Days per Week | Days worked per week, 5 or 6. Used by the EEMR basis and for proration | 5 |
| Wage Type | Gross: the wage is before tax. Nett: KAMI calculates the tax and the employee keeps the wage you entered. Gross Up: as Nett, with the tax shown as a Period Tax Gross Up line. Both cover tax only; contributions are grossed up only by Contribution Gross Up | Gross |
| Wage Period | Monthly, Daily or Hourly — what the Basic Wage is per | Monthly |
| Monthly Wage Basis | The divisor between a monthly and a daily rate: EEMR, Fixed Monthly Days or Calendar Days | Fixed Monthly Days |
| Fixed monthly days | The divisor when the basis is Fixed Monthly Days | 21 |
| Batch Cycle | The payroll they are included in automatically | None |
| Currency | Their payslip currency, if different from the batch cycle's. Nothing is converted | None |
| Minimum Wage Employee | Sets Basic Wage to the branch minimum automatically, and keeps it updated | Off |
| Contribution Gross Up | The employer pays the employee's share of contributions on their behalf | Off |
| Wages Tax Exempt | Leaves wages out of taxable income. Taxable allowances are still taxed | Off |
| Wage pause period | Stops the monthly salary for payrolls that fall entirely inside the dates. Partial overlaps are paid normally | Not paused |
| Effective Date, Remarks | Recorded in Career Progression. A wage change dated inside a pay period can split it — see Payment settings | — |
See How wages are calculated for what each basis does to the daily rate.
Other payments card
Recurring payments that are not the base wage — allowances, commissions, deductions, insurance premiums.
| Column | What it does |
|---|---|
| Payment Name | The line name on the payslip. Each name once per employee |
| Expiry Date | Last date it is paid. Blank = no end |
| Payment Type | Decides tax, contribution and wage basis treatment, for example Fixed Allowances or Non-Taxable |
| Amount | The amount per payslip it applies to |
| Payroll period | None pays it in every period; 1–4 only in that period of the month, for example 2 for the second half of a semi-monthly month |
Amounts are prorated for joiners and leavers when the payment type is prorated in your country. See Other payments: allowances, bonuses and deductions.
Contributions card
Contributions are set up in Contribution types. Here you switch them on or off for this person and override the basis. Each has an Employee and an Employer row.
| Column | What it does |
|---|---|
| Active | Whether this side is deducted or paid. On by default |
| Contribution wage basis | A fixed wage to calculate the contribution on, instead of their actual wage |
| OVERRIDE BASIS | Whether that override is Per payroll cycle (used as entered) or Per month (split across the month's payslips) |
| Voluntary %, Voluntary amount | An extra voluntary contribution, as a percentage or a fixed amount |
Tax & Payments card
| Field | What it does |
|---|---|
| Payment Method | Electronic, Cash, Cheque, Maya or Xendit. Decides which payment file or method includes them |
| Tax start date | Start of their taxable employment. A payslip cannot be calculated without it or a hire date |
| Tax Code | Indonesia: the PPh 21 code, such as Pegawai Tetap. Elsewhere: free text |
| Income tax type | Which tax rules apply. Required — without it no payslip is calculated. See Income tax types |
| Non taxable group | Their tax-exempt status, such as TK/0 or K/1. In Indonesia it also sets the TER category automatically. See Non-taxable groups |
| Other Income Tax Types | US only. Extra state or local taxes |
| Form W-4 | US only. The federal withholding certificate. A US payslip needs it, with a Social Security number |
Previous Employer card
Fill this in only if they worked elsewhere earlier in the same tax year: Employer Name, Tin, Address, Zip code, Period of Employment, Net income in year of separation and Tax withheld in year of separation. When Include Previous Employer is on in your tax settings and the period ends in the payroll's year, the income is added to their annual taxable income and the tax withheld is credited, so year-end tax is right.
What Happens Next
- Each payslip keeps a snapshot of the profile from when the payroll was created. After editing a profile, calculate with Refresh Payslip Profile (and Refresh Other Payments for recurring payments) or the old values are used.
- Someone with no Batch Cycle is not in a regular payroll unless a filter-based cycle picks them up.
- Changes made through Request apply only once approved.
Tips
- Check the first payslip by hand. Basic Wage ÷ monthly wage days should equal the daily rate shown.
- Use the same Monthly Wage Basis for people in the same role, or identical salaries produce different daily rates.
- Always add an Effective Date on salary changes, so history and mid-period splits are right.
- Review this tab on every promotion or contract change.
Troubleshooting / FAQ
Q: They are missing from the payroll. Check Batch Cycle, that Basic Wage is not 0, and that Income tax type and Tax start date are set.
Q: I changed their salary but the payslip did not change. Recalculate with Refresh Payslip Profile switched on.
Q: Their take-home is not what we agreed. Check Wage Type. On Gross, the wage is before tax.
Q: Their daily rate is not what we expect. Check Monthly Wage Basis, Fixed monthly days and Work Days per Week.
Q: The Edit button says Request. You do not have direct write access to this employee's payroll details, so the change needs approval.