# 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](https://code.salaxy.com/reference/rest-api.md). 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](https://code.salaxy.com/integration/calculations.md). The same table with the Finnish labels: [Finnish labels](https://code.salaxy.com/api/row-types).

## 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.
