External payroll integration

This solution enables you to build your own payroll integration. Once payroll processing is completed in Tidsbanken, a JSON payload can be sent to a user-defined endpoint with customizable headers. Below is an example of the payload sent.

On your side, this can be interpreted as a signal that payroll data is ready to be fetched from the GetLonnslinje endpoint (API Documentation).

Set up

Log in as an administrator and go to this page.

Run payroll integrasjon

Please see this article if you do not know the process.

Picture

Request body

This is the body you will receive on your target URL.

{
 "TbCompanyId": 123,
 "UseIdentificator": true,
 "ExecutedByEmployee": "John.Doe",
 "Parameter": {
  "DateFrom": "2025-01-01T00:00:00",
  "DateTo": "2025-01-31T23:59:59",
  "Period": "January",
  "Year": 2025
  },
 "Filter": {
  "MainDepartments": ["2", "8", "8", "6", "9"],
  "Departments": ["1", "2", "4", "1", "5"],
  "Element1": ["9", "4", "5", "7", "5"],
  "Element2": ["9", "2", "6", "3", "5"]
 },
 "Grouping": {
  "MainDepartment": true,
  "Department": false,
  "Element1": true,
  "Element2": false,
  "Date": true,
  "Rate": false
 }
}