Api Changes|Lön

Published: 9 March 2022|Last updated: 12 January 2024

Multiple registrations in Salary API

Salary API is now supporting multiple registrations per day

Salary API attendance/absence -transactions can now handle multiple registrations per day
In order to enable full support for several Absence and Attendance registrations on the same day a single registration can no longer be identified by EmployeeId, Date, and CauseCode. Instead both Attendance and Absence registrations will use a dedicated Id-field as an identifier.

The following endpoints are affected

apps.fortnox.se/apidocs#tag/AttendanceTransactionsResource

apps.fortnox.se/apidocs#tag/AbsenceTransactionsResource

Technical Details
All GET requests must accept the new Id-field in the response payload.

The GET requests for a single registration must supply only a single Id path parameter. Supplying EmployeeId, Date, and/or CauseCode will now return a list of matching registrations.

The PUT requests must supply a single Id path parameter. Supplying EmployeeId, Date, and/or CauseCode will cause an error.

The POST requests should not supply the Id field in the JSON payload. The Id will be auto generated by the application and returned in the response.

The new Id field is a string. Newly created ids will be lower case UUIDs stripped of any braces but with dashes, for example a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11. However requests may return id strings in other formats.

Example

{
	“AbsenceTransaction”: {
		“@url”: “string”,
		“id”: “497f6eca-6276-4993-bfeb-53cbbbba6f08”,
		“EmployeeId”: “string”,
		“CauseCode”: “ASK”,
		“Date”: “2019-08-24”,
		“Extent”: 0,
		“Hours”: 0,
		“HolidayEntitling”: true,
		“CostCenter”: “string”,
		“Project”: “string”
	}
}