Release Notes

Version releases

We are constantly adding new features to Procountor API. This page has the planned changes in future releases as well as release notes for the current ones. For anyone interested, we recommend subscribing to our mailing list to get notifications about API changes as soon as they become available.

Subscribe to our mailing list

Currently available API versions

You can find the version update schedule from Procountor news and announcements site.

Release notes

Changes highlighted in red are not backwards compatible

Changes in version 26.08

Endpoints

Changes to existing endpoints

PUT /payrolls/employees/{id}/salarybase
PUT /payrolls/salaryslips/{id}

• We have added new validations to prevent users from entering both a dimension quantity and a dimension percentage for the same dimension on the same salary slip or salary base row via the API. If multiple validation errors occur, all errors are returned to the user. For example, if both quantity and percentage are provided and the total percentage exceeds 100%, both errors are included in the response.

Changes in version 26.07

Endpoints

Changes to existing endpoints

PUT /payrolls/salaryslips/{id}

• We have added Earnings period start for combination salary types. Combination salary type is for example base salary deduction row salary type which is added automatically when sick leave pay, monthly has been sent. The response contains additional salary row with earningsPeriod (start and end date) from the original one.

PUT /payrolls/employees/{id}/salarybase
PUT /payrolls/salaryslips/{id}

• We have added validations for handling salary row-based dimensions. Validations are the same as in the applications UI, for example dimensions are not possible to set for salary type which belong to salary type groups 5 (= Tax), 6 (= Deductions from net pay) and 8 (= Employer payments).

PUT /businesspartners/{id}/defaults/dimensions/{dimensionId}

• We have added that the update to Employee default dimensions also updates employee’s salary base dimensions accordingly.

Changes in version 26.06

Endpoints

Changes in existing Payroll API endpoints

We have added support for row-based dimension handling. This enables users, integrations and import channels to define dimensions directly on individual salary slip rows. The feature ensures that payroll costs are allocated accurately to accounting dimensions based on actual events, hours or percentages already at the salary slip stage, instead of applying allocations only after approval.

GET /api/payroll/salaryslips/{id}

• We have added support for fetching row-based dimensions from salary slips with the given id

PUT /api/payroll/salaryslips/{id}

• We have added support for updating row-based dimensions to salary slips with the given id

GET /payrolls/employees/{id}/salarybase

• We have added support for fetching row-based dimensions from salary base.

PUT /payrolls/employees/{id}/salarybase

• We have added support for updating row-based dimensions to salary base.

Changes in version 26.05

No changes released in this version

Changes in version 26.04

We are pleased to inform you that the migration of our OpenAPI specification from version 3.0.1 to version 3.1.0 has been successfully completed as scheduled in April.

This update applies to all API versions.

While we do not expect any breaking changes in API functionality, we recommend reviewing your integrations to ensure full compatibility with OpenAPI 3.1.0.

Endpoints

Changes in existing endpoints

GET /api/invoices

• We have added support for fetching invoices by productId.
• It is possible to search multiple values separated by comma, maximum amount of values is 200.

Changes in version 26.03

Endpoints

Changes in existing endpoints

GET /payrolls/salaryslips

• We have added support for batch GET /payrolls/salaryslips/{id} for fetching multiple resources with a single API call. It is possible to fetch up to 200 resources by specifying a comma-separated set of resource IDs.
• Recourses with a valid ID are returned. The items in the result are ordered by resource ID, duplicates are not included. When multiple resources are requested the result is provided as a list - even for 1 returned resource. When request contains more than 200 IDs, an error response 400 is returned.

GET /payrolls/employees/{id}/holidaypay

• It is now possible to fetch holiday related remaining figures (remaining holiday days, remaining holiday pay, remaining holiday bonus days, remaining additional leave days) per holiday credit year.
• The endpoint returns the same totals plus a per-year breakdown (yearlyRemainings array).

POST /payrolls/salarylists
PUT /payrolls/salaryslips/{salaryslipId}

• We have added a new validation for car benefit emission value with salary type 3010, paydays in year 2026, the emission value must be 0 or null.

Changes in version 26.02

No changes released in this version

Older release notes

Older release notes can be found from their own page.

Old release notes