Appearance
Wage types (row types)
A row type is the wage type of one row in a salary calculation: it says what is paid, deducted or reimbursed. It decides how the row is taxed, which side costs apply and how it is reported to the Incomes Register. Pick the right one; Salaxy calculates the rest.
Where it goes
Each row of a calculation carries its row type in rows[].rowType. The field is the CalculationRowType enum in the REST API reference. The same codes come back on the result rows, result.rows[].rowType.
json
{
"rows": [
{ "rowType": "monthlySalary", "count": 1, "price": 3200 },
{ "rowType": "remuneration", "count": 1, "price": 500, "message": "Bonus", "data": { "kind": "bonusPay" } }
]
}- Send the string, never a number. A row type is a camelCase string on the wire, for example
"tesWorktimeShortening". data.kindpicks a variant where a row type has several, and on some row types it decides the income type reported. The descriptions below say where a kind is required.- Obsolete codes still parse, so old calculations keep working. Send the replacement named in the description.
- Some codes are misspelt —
accomodationBenefit,nightimeAddition,milageOwnCar. Send them exactly as listed.
How rows fit into a calculation, with a full example: Salary calculations. The same table with the Finnish labels: Finnish labels.
Base salary
The rows a calculation starts with. Plain count × price rows: the amount comes from the collective agreement or the employment contract, which Salaxy does not validate.
| Code | Name | Description |
|---|---|---|
salary | Piece-work pay | Piece-work or contract pay as one figure. Not a generic salary: for time-based pay use monthlySalary, hourlySalary or timeRatePay. |
hourlySalary | Hourly salary | Hours × hourly rate. |
monthlySalary | Monthly salary | The monthly salary as one figure. |
timeRatePay | Time-rate pay | Time-based pay counted in hours, days, weeks or months; data.kind gives the variant. |
Working-time compensations
Compensations set by a collective agreement. Salaxy does not know the agreement and does not check the rates.
| Code | Name | Description |
|---|---|---|
tesWorktimeShortening | Separate salary component (construction) | The construction sector's separate salary component: a fraction of the pay sum, default 7.7 %. |
workingTimeCompensation | Working-time compensation | One row type for every working-time compensation. data.kind chooses the Incomes Register income type; without a kind, nothing is reported. |
hourlySalaryWithWorkingTimeCompensation | Hourly salary with compensation | An hourly salary and its compensation, a percentage of the hourly rate, on one row. Send one row per kind of compensation. |
Shift and overtime additions
The premium only, not the pay for the hours: pay the hours on a base salary row. Nothing is computed for you; you send both count and price.
| Code | Name | Description |
|---|---|---|
overtime | Overtime premium | The overtime premium as a fraction of the pay sum, default 50 %. |
eveningAddition | Evening work addition | Hours × addition per hour. |
nightimeAddition | Night work addition | Hours × addition per hour. The code is spelt nightimeAddition. |
saturdayAddition | Saturday work addition | The Saturday premium as a fraction of the pay sum, default 50 %. |
sundayWork | Sunday and public holiday work | The premium for work on a Sunday or public holiday. |
Paid absence
Pay for time away, such as sick leave or training. These are salary rows; the absence itself is recorded with absencePeriod.
| Code | Name | Description |
|---|---|---|
paidSickLeave | Paid sick leave | Salary for sick leave. data.kind is required and chooses piece-work, hourly or monthly pay; without it the calculation cannot be paid. |
training | Paid training | Salary for time in training. data.kind is required, as on paidSickLeave. |
paidSickLeaveSalary | Sick leave pay, piece-work (obsolete) | Obsolete. Send paidSickLeave with kind paidSickLeaveSalary. |
paidSickLeaveHourlySalary | Sick leave pay, hourly (obsolete) | Obsolete. Send paidSickLeave with kind paidSickLeaveHourlySalary. |
paidSickLeaveMonthlySalary | Sick leave pay, monthly (obsolete) | Obsolete. Send paidSickLeave with kind paidSickLeaveMonthlySalary. |
trainingSalary | Training pay, piece-work (obsolete) | Obsolete and not reported correctly to the Incomes Register. Send training with kind trainingSalary. |
trainingHourlySalary | Training pay, hourly (obsolete) | Obsolete and not reported correctly to the Incomes Register. Send training with kind trainingHourlySalary. |
trainingMonthlySalary | Training pay, monthly (obsolete) | Obsolete and not reported correctly to the Incomes Register. Send training with kind trainingMonthlySalary. |
Absences
Unpaid absence and the private day care subsidy. Paid absence is a salary row; see Paid absence.
| Code | Name | Description |
|---|---|---|
absencePeriod | Absence period | Records an absence over a period. Salaxy generates the deduction and any paid-absence rows from it: send one absencePeriod, not a deduction of your own. |
childCareSubsidy | Private day care subsidy | The private day care subsidy towards a household employee's salary. Moves no money. Household employers only. |
Holiday pay
The money side of annual leave: pay for leave taken, compensation for leave not taken, and the holiday bonus.
| Code | Name | Description |
|---|---|---|
holidaySalary | Holiday pay | Pay for annual leave taken. |
holidayCompensation | Holiday compensation | Compensation for annual leave not taken, as a fraction of pay, default 11.5 %. |
holidayBonus | Holiday bonus | The holiday bonus. It comes from a collective agreement or the employment contract, not from law, so Salaxy sets no default rate. |
Benefits in kind
Taxable non-cash benefits. Where no kind prices the row, you compute the taxable value and send it as price.
| Code | Name | Description |
|---|---|---|
carBenefit | Car benefit | Private use of an employer's car. Compute the taxable value with the Tax Administration's car benefit calculator and send it as price; Salaxy does not compute it. |
accomodationBenefit | Accommodation benefit | A dwelling the employer provides; you compute the value. The code is spelt accomodationBenefit. |
mealBenefit | Meal benefit | Meals the employer arranges or subsidises. data.kind sets both the price and the income type reported. |
phoneBenefit | Phone benefit | A phone the employer pays for, one row per phone. Defaults to 20 € a month. |
bicycleBenefit | Bicycle benefit | A company bicycle. You price it; Salaxy splits the tax-free and taxable parts. |
subsidisedCommute | Commuter ticket | A personal public transport ticket the employer buys. Salaxy splits the tax-free and taxable parts. |
otherBenefit | Other benefit | Any other benefit in kind, at its fair market value. |
Travel expenses
Tax-free reimbursements: no employer side costs and no tax withheld.
| Code | Name | Description |
|---|---|---|
dailyAllowance | Daily allowance | Per diem for a work trip, domestic or foreign. data.kind sets the type and the price. |
dailyAllowanceHalf | Partial daily allowance | The partial per diem rate, not half a per diem. Prefer dailyAllowance with a kind. |
mealCompensation | Meal compensation | Meal compensation on a work trip. |
milageOwnCar | Mileage, own vehicle | Kilometre allowance for a vehicle the worker owns, priced per kilometre. Over the API, the price you send is used. |
milageDaily | Mileage, daily | Kilometre allowance set by a collective agreement as a daily sum, priced per day. |
milageOther | Mileage, other basis | Any other kilometre allowance. |
Other expenses
Cost reimbursements that are not travel. Each behaves differently in withholding and in Incomes Register reporting.
| Code | Name | Description |
|---|---|---|
expenses | Expense reimbursement | Reimbursement of costs against receipts. Not reported to the Incomes Register. |
toolCompensation | Tool compensation | Flat compensation for the worker's own tools. Taxable income for the worker, but no tax is withheld. |
nonProfitOrg | Non-profit allowances | Daily allowance or kilometre allowance paid by a non-profit organisation; data.kind chooses which. Not for household employers. |
chainsawReduction | Chainsaw and forestry worker deduction | Deducts the worker's chainsaw or forestry work costs before tax is withheld, instead of reimbursing them. |
Other additions and termination
Additions the other families do not cover. On all but otherAdditions, data.kind is the row: it decides the income type, withholding and contributions.
| Code | Name | Description |
|---|---|---|
otherAdditions | Other addition | A time-based addition agreed in a collective agreement or the employment contract that has no row type of its own. |
remuneration | One-off remuneration | A one-off performance payment such as a bonus, commission or initiative fee. data.kind chooses the income type; without it the row is worth nothing. |
otherCompensation | Other fee or compensation | Fees such as meeting, lecture or position-of-trust fees. data.kind chooses the income type. Not for household employers. |
employmentTermination | Employment termination | Payments that fall due when employment ends, such as notice-period compensation. data.kind chooses the income type. |
Special salaries
Payments that are neither wages nor wage additions: what the payment is comes from the Incomes Register income type. Not for household employers.
| Code | Name | Description |
|---|---|---|
compensation | Compensation for work | A fee for work done outside an employment relationship. |
board | Board fee | A fee for sitting on a board or a comparable governing body. Not for meeting fees. |
irIncomeType | Other income type | For an Incomes Register income type that no other row type reports; data.kind sets the income type. Loses the pricing and validation of a named row type. |
Voluntary deductions
Deductions from net pay by agreement, not by law. Send positive amounts.
| Code | Name | Description |
|---|---|---|
unionPayment | Union fee | Union membership fee taken from pay. For a percentage fee, count is the fraction and price the taxable salary. Add the IBAN and reference number to have the fee paid to the union. |
advance | Salary advance | Recovers money paid to the worker before payday. Not reported to the Incomes Register. |
prepaidExpenses | Prepaid expenses | Nets out an expense reimbursement already paid in advance. Not reported to the Incomes Register. |
otherDeductions | Other deduction | Any other deduction the worker has agreed to. |
deductibleOfExerciseAndCultureBenefit | Exercise and culture benefit, own share | The worker's own share of an employer-provided exercise and culture benefit. |
Tax and foreclosure
Withholdings required by law. Normally Salaxy, not the caller, owns these numbers.
| Code | Name | Description |
|---|---|---|
taxWithholding | Tax withholding | Overrides the withholding from the tax card and turns the tax card lookup off. Normally you send no tax row. |
taxAtSource | Tax at source | Tax at source for a worker on a tax-at-source card. Salaxy creates it from the employment; you normally do not send it. |
foreclosure | Foreclosure, paid by the employer | Wage garnishment the employer pays to the enforcement officer itself. data.kind chooses a fixed or a computed amount. One per calculation. |
foreclosureByPalkkaus | Foreclosure, paid by Salaxy | Wage garnishment Salaxy pays to the enforcement officer out of the payment it collects. Not offered for selection. |
Reverse calculation
Input-only rows: send one instead of a gross salary row, and Salaxy solves the gross pay. They are never reported to the Incomes Register.
| Code | Name | Description |
|---|---|---|
totalWorkerPayment | Net salary | The target net pay. data.kind says what the target is, and data.rowType names the row type to produce. |
totalEmployerPayment | Total employer cost | The target total cost for the employer. Always produces a piece-work pay (salary) row. |
Other rows
Rows that are not pay.
| Code | Name | Description |
|---|---|---|
info | Information line | A payslip line that moves no money; the text goes in message. |
service | Service fee | A service fee charged to the employer within the payroll. Send the price excluding VAT. |
serviceCharge | Service charge (obsolete) | Obsolete. Send service. |
payStats | Calculated earnings | A computed statistic, such as average hourly earnings, that Salaxy writes onto the employment. You normally do not send it. |
totals | Totals | Marks a totals row in results. Not valid on a row you send. |
Codes as of 2026-11-11, from the production OpenAPI document.

