Income tax types
An income tax type is the recipe KAMI uses to work out withholding tax for every employee assigned to it: what counts as taxable income, what is deducted, how the year is estimated, and which tax brackets apply. Use this article to set up or edit an income tax type, choose the estimated net annual income method, and understand the Gross Income section and the tax rate tables.
Where:
- Payroll dashboard › Settings (cog icon) › Income Tax Types
- Or Settings › Payroll › Income Tax Types
You need: the Payroll settings right, with edit access to add, edit or delete a type
Before You Start
KAMI creates the standard income tax types for your country when your company is set up, for example Income Tax in the Philippines, or PPH21, PPH21 TER A/B/C and PPH26 in Indonesia. These system types cannot be deleted, but you can edit them. Most companies only need to check them, not build new ones.
Take brackets, rates and limits from your tax authority or adviser. KAMI applies what you enter; it does not know the law.
| You need | Do |
|---|---|
| Standard tax for most staff | Use the country type KAMI created |
| A different regime for a group (non-resident, contractor) | A second type, assigned to those employees |
| A tax-free allowance for an employee's family status | A non-taxable group on the employee, not a new type |
| A one-off correction for one person | A manual tax adjustment |
How to add or edit an income tax type
- On the Payroll dashboard, click the Settings cog and choose Income Tax Types.
- Pick a type from the list on the left, or click Add new income tax type.
- Click Edit (top right of Details).
- Enter a Name (unique in your company) and an optional Description.
- Choose the Estimated net annual income method (see the table below).
- In Gross Income, choose the Employer contributions that count as taxable income and set the toggles.
- In Deductions, set Operational Expenses, Pension Maintenance, Employee Contributions, the bonus settings and Include 13th month. Each is explained in Income tax deductions and bonus tax settings.
- Fill in the Tax rate table: one row per Tax Bracket, with min, max and Rate. Use Add for a row and the bin icon at the end of a row to remove it.
- Fill in the Termination tax rate table if separation pay is taxed on its own scale.
- Indonesian companies also see a Monthly tax rate table: enter the TER brackets there.
- Click Save.
How to assign the type to employees
- Open the employee's profile and go to Payroll › Tax and Payments.
- Click Edit, choose the Income tax type, and save.
- Recalculate any open payslip that should use it.
An employee with no income tax type has no tax calculated at all.
Estimated net annual income method
Tax is worked out on a yearly figure and then spread across payslips. This setting decides how the year is estimated, which changes the month-by-month shape of withholding more than anything else on the page.
| Option | How the year is estimated | Each payslip's tax |
|---|---|---|
| Annualized | This period's net income, made monthly, × the employee's taxable months | Annual tax ÷ taxable months, split across the month's payslips |
| Reconcile | Actual net income from this year's payslips so far, plus this one | Tax due on income to date, minus tax already withheld this year |
| Reconcile (Gross Up) | For Gross Up and Nett wage types: solves for the employer-borne tax | Employer-borne tax; on a Gross wage type it works like Annualized |
| Forecasted | Income to date plus a forecast of the remaining periods at the employee's basic wage | Remaining annual tax spread evenly over this and the remaining periods |
Taxable months run from the employee's Tax Start Date (or 1 January, if later) to December, or to their termination date. A September joiner has about four.
Annualized looks at each payslip on its own, so a mid-year pay change or bonus leaves the year slightly over- or under-withheld until tax is reconciled. Reconcile and Forecasted look back at what was actually withheld, so they correct themselves as the year goes on.
Gross Income section
Gross Income is the starting point for tax. Two notes at the top say what is always in it:
- Total Wages are always included (unless Wages Tax Exempt is on for the employee, on the Salary card of their profile).
- Other Payments whose type has the Regular tax type are included. Bonus, Termination and None tax types are handled separately.
| Field | What it does | Sensible default |
|---|---|---|
| Employer contributions | Employer-paid contributions you pick here are added to taxable income, as a taxable benefit | Only those your tax law treats as income; often none |
| Exclude Voluntary Contributions | Decides whether the voluntary top-up part of those employer contributions counts too | Off |
| Include prorated 13th month | Spreads tax on the expected 13th month across the year instead of taxing it all when paid | Off unless you want even withholding |
| 13th Month Wage Basis | Shown when the box above is ticked: Basic Monthly Wage, Fixed Monthly Wage or Gross Monthly Wage, the wage the expected 13th month is based on | Basic Monthly Wage |
| Include Previous Employer | Adds the Previous Employer net income and tax withheld (profile › Payroll) to this year's calculation | On if you hire mid-year |
With Exclude Voluntary Contributions off, the full employer contribution you selected counts, voluntary part included. Turning it on takes the voluntary part out.
Deductions section
Operational Expenses and Pension Maintenance each take Rate % of the period's gross income off taxable income, up to Max amount per month, for employees younger than Age limit (1000 means everyone). Indonesia's default Operational Expenses is biaya jabatan: 1000, 500,000, 5. Employee Contributions lists the employee contributions that reduce taxable income. Bonus Tax Deduction, Bonus Tax Deduction Method and Include 13th month decide how bonuses are taxed. Every field is explained in Income tax deductions and bonus tax settings.
Tax rate tables
Each row is a Tax Bracket with min, max and Rate (a percentage).
- Tax rate table is progressive: each bracket's rate applies only to the part of annual taxable income between its min and max. Income below the first bracket's min is untaxed, so a table that starts at 250,000 leaves the first 250,000 tax-free.
- Termination tax rate table is applied, the same progressive way, to Other Payments with the Termination tax type, on their own. Leave it empty and termination payments carry no termination tax.
- Monthly tax rate table (Indonesia only) is the TER table. Regular monthly payslips look up one rate from the employee's gross monthly income and apply it to the whole amount; income above the top bracket uses the top rate.
What Happens Next
- Tax is calculated when the payslip is calculated and stored on it. Editing a type does not change payslips already calculated: recalculate the ones that should change.
- A change part-way through the year affects tax from that point. Earlier payslips are not restated, though Reconcile and Forecasted will absorb the difference over the remaining periods.
- Deleting a custom type removes it from every employee assigned to it, and they then have no tax until you assign another.
Tips
- Check the method before your first year-end. Annualized and Reconcile produce noticeably different monthly figures, and December shows the difference.
- Test one employee per bracket by hand before going live. A boundary typed one row out looks right for most people.
- Hire mid-year? Turn on Include Previous Employer and record the previous employer's figures on each joiner's profile.
- Keep the number of types small. Every extra type is another set of tables to update when rates change.
- Diary statutory changes. Brackets change on known dates and nothing in KAMI reminds you.
Troubleshooting / FAQ
Q: Why is no tax being withheld for an employee? Check they have an Income tax type on their profile, and that the type has a filled-in Tax rate table.
Q: An employer contribution is being taxed as income. It is selected in Employer contributions under Gross Income. Remove it if your tax law does not treat it as income.
Q: December tax is very different from other months. A reconciling method, or year-end tax reconciliation, is correcting the year's over- or under-withholding.
Q: Can I delete the default income tax type? No. System types can be edited but not deleted.