Skip to content

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.kind picks 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.

CodeNameDescription
salaryPiece-work payPiece-work or contract pay as one figure. Not a generic salary: for time-based pay use monthlySalary, hourlySalary or timeRatePay.
hourlySalaryHourly salaryHours × hourly rate.
monthlySalaryMonthly salaryThe monthly salary as one figure.
timeRatePayTime-rate payTime-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.

CodeNameDescription
tesWorktimeShorteningSeparate salary component (construction)The construction sector's separate salary component: a fraction of the pay sum, default 7.7 %.
workingTimeCompensationWorking-time compensationOne row type for every working-time compensation. data.kind chooses the Incomes Register income type; without a kind, nothing is reported.
hourlySalaryWithWorkingTimeCompensationHourly salary with compensationAn 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.

CodeNameDescription
overtimeOvertime premiumThe overtime premium as a fraction of the pay sum, default 50 %.
eveningAdditionEvening work additionHours × addition per hour.
nightimeAdditionNight work additionHours × addition per hour. The code is spelt nightimeAddition.
saturdayAdditionSaturday work additionThe Saturday premium as a fraction of the pay sum, default 50 %.
sundayWorkSunday and public holiday workThe premium for work on a Sunday or public holiday.

Pay for time away, such as sick leave or training. These are salary rows; the absence itself is recorded with absencePeriod.

CodeNameDescription
paidSickLeavePaid sick leaveSalary for sick leave. data.kind is required and chooses piece-work, hourly or monthly pay; without it the calculation cannot be paid.
trainingPaid trainingSalary for time in training. data.kind is required, as on paidSickLeave.
paidSickLeaveSalarySick leave pay, piece-work (obsolete)Obsolete. Send paidSickLeave with kind paidSickLeaveSalary.
paidSickLeaveHourlySalarySick leave pay, hourly (obsolete)Obsolete. Send paidSickLeave with kind paidSickLeaveHourlySalary.
paidSickLeaveMonthlySalarySick leave pay, monthly (obsolete)Obsolete. Send paidSickLeave with kind paidSickLeaveMonthlySalary.
trainingSalaryTraining pay, piece-work (obsolete)Obsolete and not reported correctly to the Incomes Register. Send training with kind trainingSalary.
trainingHourlySalaryTraining pay, hourly (obsolete)Obsolete and not reported correctly to the Incomes Register. Send training with kind trainingHourlySalary.
trainingMonthlySalaryTraining 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.

CodeNameDescription
absencePeriodAbsence periodRecords 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.
childCareSubsidyPrivate day care subsidyThe 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.

CodeNameDescription
holidaySalaryHoliday payPay for annual leave taken.
holidayCompensationHoliday compensationCompensation for annual leave not taken, as a fraction of pay, default 11.5 %.
holidayBonusHoliday bonusThe 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.

CodeNameDescription
carBenefitCar benefitPrivate 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.
accomodationBenefitAccommodation benefitA dwelling the employer provides; you compute the value. The code is spelt accomodationBenefit.
mealBenefitMeal benefitMeals the employer arranges or subsidises. data.kind sets both the price and the income type reported.
phoneBenefitPhone benefitA phone the employer pays for, one row per phone. Defaults to 20 € a month.
bicycleBenefitBicycle benefitA company bicycle. You price it; Salaxy splits the tax-free and taxable parts.
subsidisedCommuteCommuter ticketA personal public transport ticket the employer buys. Salaxy splits the tax-free and taxable parts.
otherBenefitOther benefitAny other benefit in kind, at its fair market value.

Travel expenses ​

Tax-free reimbursements: no employer side costs and no tax withheld.

CodeNameDescription
dailyAllowanceDaily allowancePer diem for a work trip, domestic or foreign. data.kind sets the type and the price.
dailyAllowanceHalfPartial daily allowanceThe partial per diem rate, not half a per diem. Prefer dailyAllowance with a kind.
mealCompensationMeal compensationMeal compensation on a work trip.
milageOwnCarMileage, own vehicleKilometre allowance for a vehicle the worker owns, priced per kilometre. Over the API, the price you send is used.
milageDailyMileage, dailyKilometre allowance set by a collective agreement as a daily sum, priced per day.
milageOtherMileage, other basisAny other kilometre allowance.

Other expenses ​

Cost reimbursements that are not travel. Each behaves differently in withholding and in Incomes Register reporting.

CodeNameDescription
expensesExpense reimbursementReimbursement of costs against receipts. Not reported to the Incomes Register.
toolCompensationTool compensationFlat compensation for the worker's own tools. Taxable income for the worker, but no tax is withheld.
nonProfitOrgNon-profit allowancesDaily allowance or kilometre allowance paid by a non-profit organisation; data.kind chooses which. Not for household employers.
chainsawReductionChainsaw and forestry worker deductionDeducts 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.

CodeNameDescription
otherAdditionsOther additionA time-based addition agreed in a collective agreement or the employment contract that has no row type of its own.
remunerationOne-off remunerationA 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.
otherCompensationOther fee or compensationFees such as meeting, lecture or position-of-trust fees. data.kind chooses the income type. Not for household employers.
employmentTerminationEmployment terminationPayments 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.

CodeNameDescription
compensationCompensation for workA fee for work done outside an employment relationship.
boardBoard feeA fee for sitting on a board or a comparable governing body. Not for meeting fees.
irIncomeTypeOther income typeFor 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.

CodeNameDescription
unionPaymentUnion feeUnion 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.
advanceSalary advanceRecovers money paid to the worker before payday. Not reported to the Incomes Register.
prepaidExpensesPrepaid expensesNets out an expense reimbursement already paid in advance. Not reported to the Incomes Register.
otherDeductionsOther deductionAny other deduction the worker has agreed to.
deductibleOfExerciseAndCultureBenefitExercise and culture benefit, own shareThe 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.

CodeNameDescription
taxWithholdingTax withholdingOverrides the withholding from the tax card and turns the tax card lookup off. Normally you send no tax row.
taxAtSourceTax at sourceTax at source for a worker on a tax-at-source card. Salaxy creates it from the employment; you normally do not send it.
foreclosureForeclosure, paid by the employerWage garnishment the employer pays to the enforcement officer itself. data.kind chooses a fixed or a computed amount. One per calculation.
foreclosureByPalkkausForeclosure, paid by SalaxyWage 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.

CodeNameDescription
totalWorkerPaymentNet salaryThe target net pay. data.kind says what the target is, and data.rowType names the row type to produce.
totalEmployerPaymentTotal employer costThe target total cost for the employer. Always produces a piece-work pay (salary) row.

Other rows ​

Rows that are not pay.

CodeNameDescription
infoInformation lineA payslip line that moves no money; the text goes in message.
serviceService feeA service fee charged to the employer within the payroll. Send the price excluding VAT.
serviceChargeService charge (obsolete)Obsolete. Send service.
payStatsCalculated earningsA computed statistic, such as average hourly earnings, that Salaxy writes onto the employment. You normally do not send it.
totalsTotalsMarks a totals row in results. Not valid on a row you send.

Codes as of 2026-11-11, from the production OpenAPI document.

Every page is also available as Markdown: add .md to its URL — a folder page such as white-label/ is white-label/index.md. Index for LLMs: llms.txt. Questions: Support.