Procountor API Release Notes

POST /payrolls/salarylists

As part of the Payroll API we are introducing new endpoint for creating new salary list. The endpoint creates a new salary list and the salary slips in it based on each employee’s salary base.

Working time allocation days are prefilled and calculated from Payment period start and end date, user will be able to adjust them with PUT /payrolls/salaryslips/{id} endpoint which is planned to be released in July release, when also adding salary slip rows will be possible.

Notes to salary slips are not supported in POST /payrolls/salarylistsas they are not visible in the salary list search view.

For creating a new salary list through API, it is also possible to utilize the new salary period endpoints GET /payrolls/salaryperiodsand GET /payrolls/salaryperiods/{id} which are used to fetch salary period details for salary list creation.

Details on both the required and optional fields will be available in our release notes and API reference.

workinghourreduction        

A new endpoint for returning “Working hour reduction“ data for a given employee ID:  

• Working hour reduction usage start date     
• Total remaining working hour reduction hours
• Total remaining working hour reduction days 

holidaypay        

A new endpoint for fetching total remaining holiday related days and pay for a given employee ID.

Endpoint returns:

• Holiday earning start date    

• Holiday bonus earning start date

Date

Total remaining holiday days

• Total remaining holiday pay         
• Total remaining holiday bonus days         
• Total remaining additional leave days

If the holiday calculation setting is disabled in (Management → Company info → Usage settings → Holiday calculation section), the endpoint will return status 403 Forbidden with a corresponding message.

GET /payrolls/salaryperiods

A new endpoint for returning a list of basic information about salary period lists for a given holiday credit year (query parameter holidayCreditYear must be provided always). 

The endpoint requires at least read rights for salaries.

GET /payrolls/salaryperiods/{id}

A new endpoint for returning a list of salary periods for a given salary period list ID (path parameter {id} must be provided when fetching).

For creating new salary list through API it’s possible to use this endpoint to fetch salary period details for salary list creation.        

Endpoint requires read rights for salaries.

A new endpoint GET /payments/paymentevents with invoiceId as search parameter has been created.

It is possible to search payment events for a batch of 200 invoice IDs.

GET /payments endpoint has a new search result.

It is now possible to see paidAmount and paidCurrency in GET /payments response