Copy page

Personnel tickets

Fetch tax savings reports

Overview

This guide explains how to fetch reports of tax savings for employees in the personnel ticket system. Reports of taxable amounts for the previous month are automatically calculated on the first day of each month. The monthly tax reports must be retrieved and reported to the tax authorities by the employer.

Fetching a tax savings report

To fetch a report of tax savings, use

It fetches a tax savings report for a given company, month and year.

It accepts the following query parameters:

Param Name	Required	Type	Description	Default
companyId	Yes	integer	Internal company ID in the personnel ticket system. This is different from your organisations ID in Enturs organisation registry.
year	No	integer	Year from 2021	Current year
month	No	string	Month (1–12)	Current month

---

Responses

• 200 OK

Example CSV response

Code
companyId,employeeNo,ssn,saving,fromDate,toDate,employeeStatus
3,1234,14104512345,230.00,2020-02-01,2020-02-29,P
3,1233,23047854321,1102.00,2020-02-01,2020-02-29,A

• 404 Not Found - No report exists for the given parameters

---

Field descriptions

Field	Format	Meaning	Comment
companyId	int	Internal company ID in the personnel ticket system. This is different from your organisations ID in Enturs organisation registry.	Useful for clients with multiple companies
employeeNo	string	Employee number provided by company	May be reused; can be negative or 0 for pensioners
ssn	string (11 digits)	Social security number
saving	string (xxxxx.xx)	Savings for the given month	Refunds are included, so may be a negative number
fromDate	ISO string (yyyy-MM-dd)	First date in report (inclusive)
toDate	ISO string (yyyy-MM-dd)	Last date in report (inclusive)
employeeStatus	"P", "A", or "E"	Pensioner, Active employee or Bereaved (Etterlatt)	The value is based on termination code