/
Change Log

Change Log

 

With this release we mainly extended our API by introducing new endpoints to access or update different aspects of the employee master or varibale data.

14.01.2026 (Released with Version 254.3.0)

Extension and update of DATEV LODAS file import into Staff and Time

  • LODAS import with several entries using the same table name: LODAS import correctly handles multiple entries with the same table name but different structures (Satzbeschreibung)

Changes to the API variabledata-Endpoint (GET):

  • Change the endpoint to return one element instead of a list to match the expected single resource and simplify processing.

Enhance `/healthInsurances` endpoint to return only valid health insurance companies:

  • Update the /healthInsurances endpoint (GET) to return only valid health insurance companies using the same filtering as the UI. Fix the query offset and add an integration test.

Adjust API filtering options (GET Employee):

  • Expanded additionalInformation API filters: CURRENT, FORMER, FUTURE, ALL_EMPLOYEES. Ensures full alignment with mobile app filters.

NPE when creating employee via API (POST employee):

  • A NPE (NullPointerException) occurred when creating an employee because some boolean tax fields can be null. The contract will be updated to allow nullable booleans. On create, missing values default to false; on update, missing values are not overwritten.

 

02.01.2026 (Released with Version 254.2.x)

Get v2/employees call fails with 500 error code: Fixed the 500 error by replacing LEFT OUTER JOINs with INNER JOINs to exclude orphaned records. Pagination stays correct.

 

17.12.2025 (Released with Version 254.2.0)

Implemented a new API endpoint to allow partners to retrieve and search occupations.

  • GET: Retrieve a list of all available occupations.

  • Endpoint created and documented in the COMMON section of the API.

  • Supports filtering by displayName.

 

19.11.2025 (Released with Version 253.6.0 )

  • Query all subcompanies (legal entities) via Personio API

    • Added a new field Legal Entity (Gesellschaft) in the Staff and Time configuration screen.

    • Dropdown displays all legal entities from Personio.

    • Import only includes employees from the selected legal entity. Changing the legal entity updates the employee list and removes non-matching employees.

  • Update Open API Description:

    • All entries in the federal state enum are now UPPERCASE for consistency.

 

05.11.2025 (Released with Version 253.5.0 )

Update Open API Description:

  • All API requests and responses now consistently use the MIME type application/json.

  • Enum values are now consistently represented in UPPER CASE.

  • The GET endpoint establishments is updated: All establishments of an organization are now returned, even if an additional establishment shares the same operationNumber as the main one.

Implementation of a new API for managing employee children data

  • GET: Retrieve employee children

  • POST: Add employee children

  • PATCH: Update employee children

  • DELETE: Delete a single child by given ID and Delete multiple children by given IDs

Extension and update of DATEV LODAS file import into Staff and Time

  • Import of maternity leave periods from the LODAS table u_lod_psd_mutterschutz.

  • Import of mandatory medical leave from the LODAS table u_lod_psd_beschaeftigungsverbot.

  • Import of parental leave from the LODAS table u_lod_psd_mutterschutz. ---

  • Contract Type is imported from the field vertragsform#psd.

  • Occupation is read from the fields ausg_taetigkeit#psd and ausg_taetigkeit_lfdnr#psd.

  • Child information is imported from u_lod_psd_kindergeld table.

  • Forgein Address information is imported. Postal code is taken from adresse_plz_ausland#psd.

  • Vacation days claim is imported from the field urlaubsanspr_pro_jahr#psd.

 

08.10.2025 (Released with Version 253.3.0)

  • API for retrieving current health insurance information: The API has been updated to retrieve current health insurance information from the Staff and Times systems.

  • Support deletion of contact data via API: Implemented a new DELETE endpoint to allow removal of an employee’s contact data.

  • Add support for contribution group key in employee API
    Added the contributionGroupKey field to the employee creation and update endpoints GET, PACTH, POST /employee/{id}. This allows clients to assign or modify the contribution group associated with an employee during create or update operations.

  • Corrected Scope Name in OPEN API documentation

    • Fixed a typo in the permission scope:
      payroll_file_import → payroll_files_import

  • Payload Cleanup: Removed contributionGroupKeyData from the root of UpdateEmployeePayload to ensure payload consistency and avoid redundancy.

  • Updated validation rules for the social insurance update endpoint:
    The following fields are no longer validated when healthInsuranceData is not set:

    • overallContributionToHealthInsurance

    • overallContributionToLongTermCareHealthInsurance

    • basicCoverageHealthInsurance

  • The OpenAPI specification for the variabledata endpoint has been revised and updated to reflect the actual API response.

 

24.09.2025 (Released with Version 253.2.0)

  • DATEV LODAS: Cost Center and Cost Unit Import
    When importing variable agreements via DATEV LODAS, the fields kostenstelle#bwd and kostentraeger#bwd can now be imported into Staff and Time (Personal & Zeiten).

  • API Update: Display of dailyRateOfSickPay (Krankentagegeld) in Onboarding Portal
    When updating an employee via API (PATCH) with dailyRateOfSickPay under healthInsuranceData, the value is now enabled and displayed in the UI of the Onboarding Portal–New Employee.

  • API Enhancement: Contract Data via GET by Employee ID
    The API now supports retrieving weeklyWorkingHours and vacationDaysClaim when calling GET contract by employeeId.

 

10.09.2025 (Released with Version 253.1.0)

  • A new deletion endpoint has been implemented. It allows:

    • Deleting employees who have not yet been processed for payroll and have not been transferred to the OnPremise system.

    • Cancelling employees for whom a clearing message has already been generated.

  • Developer Portal - Enum Overview (Auswahllisten)

    • This page provides a compact overview of the enum values used in the Developer Portal.
      The focus is on improving the OpenAPI description for the EmploymentCategory. All employment types are listed – including those used in Hybrid Payroll and those that are not. The corresponding ID numbers for each Employment Category are also documented.

 

13.08.2025 (Released with Version 252.5.0)

  • Compensation data (payment): The tax advisor or payroll accountant can import the compensation data (e.g. festbezuege) in LODAS format into Staff and Time (Personal & Zeiten) and process it further there.

 

30.07.2025 (Released with Version 252.4.0)

  • Enable Employee Data Retrieval via REST API with Pagination and Filtering: Enable API partners to retrieve all employee data via a REST API call with pagination and filtering options, so they can onboard data from Staff and Times more easily.

    • Add query params for ‘pagination’

    • sort the result by ‘personnel number’ & ‘displayname’

    • filtering the employees- Activity-Level

      • Active (Default), Former, Future, All

 

16.07.2025 (Released with Version 252.3.0)

Update to OpenAPI Description

  • The following API endpoints have been revised and modernized. The OpenAPI documentation has been updated, Required fields are now clearly marked, and example values have been added for each field. Example values are now available – including for the following fields: hourlyWage,vacationDaysClaim, weeklyWorkingHour, nationalityI, dateOfBirth

Import Variabel Data with Datev Lodas Format

  • During the LODAS import, the hours are assigned to the hours field and the hourly wage to the hourly wage field.

  • If no hourly wage is provided, the amount from the variable record must be calculated using the employee’s standard hourly wage from the master data.

Employee

  • The endpoints for employees now use API version 2 (v2). GET (by ID), POST, and PATCH replace the previous v1 endpoints.

  • New: Support for partial updates via PATCH, allowing targeted changes to individual fields without needing to send the full master data.

  • Create Employee (POST):

    • The version field is no longer included in the request payload.

    • The id field is now optional.

    • The endpoint's response status code has been updated from 200 OK to 201 Created to better reflect resource creation.

Social Insurance

  • PUT has been replaced by PATCH to allow targeted partial updates.

  • Property change in the PATCH call: countryOfBirthId → changed to countryOfBirthIsoCode.

  • GET (by ID), PATCH, and GET (all) have been revised and adapted to the new structure.

Master Data

  • GET (all), GET (by ID), and PATCH have been revised and modernized.

  • Structural change: dateOfBirth is now directly under masterData – no longer under masterData.additionalData.

Compensation

  • GET (for all compensations of an employee), PUT (updates), and GET (all compensations) have been revised and modernized.

Capital Building

  • GET (all) has been revised and modernized.

Tax Details

  • GET (all tax details), GET (tax details by ID), and PATCH (updates to employee tax details) have been revised and modernized.

  • The update endpoint has been changed from PUT to PATCH.

Address – Endpoint Changes

  • GET (all addresses), GET (address by ID), and PATCH have been revised and modernized.

  • In the PATCH call, countryId has been replaced with countryIsoCode.

  • These properties have changed across all three endpoints:

    • addressData instead of address

    • Address (singular) instead of addresses (plural)

Contact

  • GET (all contacts), POST (create contacts), PATCH (update contacts), and GET (contacts by ID) have been revised and modernized.

Contract

  • GET (contract data of all employees), GET (contract data of an employee by ID), and PATCH (updates to an employee’s contract data) have been revised and modernized.

  • The update endpoint has been changed from PUT to PATCH.

 

02.07.2025 (Released with Version 252.2.0)

  • Re-Work Master Data endpoint

    • The GET (all), GET (by ID), and PATCH endpoints have been revised and modernized.

    • The field ‘dateOfBirth’ is now located directly under ‘masterData’ – it is no longer under ‘masterData.additionalData’.

18.06.2025 (Released with Version 252.1)

  • Component: DATEV LODAS – Master Data Import

    • Change Type: Field Requirement Update

    • The Person Group Key (Personengruppenschlüssel) is no longer a mandatory field when creating a new employee via the master data import interface.

 

04.06.2025 (Released with Version 251.7.0)

  • Implement endpoints to update existing contact data and add new contact data for an employee. It should support updating or adding one or multiple contact entries per employee.

  • Re-Work the update (PUT) endpoint for the variable data: It is now possible to update one or multiple variable data entries for one or more employees in a single API call. The update is now possible for only the changed fields. When a variable data entry is created using ‘hours’, the response now includes the calculated 'industrialMinutes'.

  • Re-Work the master data endpoint: The endpoint now supports both reading (GET) and updating (PATCH) master data. The main object has been renamed from'employee'to 'masterdata'. The sub-object 'additionalNameInfo' is now called 'additionalData'. The field 'personalNumber' has been renamed to 'personnelNumber' and is no longer mandatory during updates. The field 'martialStatus' has been renamed to 'married'. Updates can be performed without providing all fields. If the IBAN is not from a German bank, the BIC field becomes mandatory. Any non-existent fields in the payload (e.g., bankname) are ignored.

 

07.05.2025 (Released with Version 251.5.0)

  • Implement considering the master data start date from LODAS file import

  • Re-Work the contracts data endpoint, now called 'contract' instead of 'contracts'. You can retrieve data for all employees or a single employee (GET), or update contract data for a single employee (PUT). The entry date cannot be changed, but individual fields can be updated. Additionally, new fields such as vacationDaysOverallEntitlement and weeklyWorkingHours are added.

  • Implement option to update address data for employee (PUT). The endpoint is now called 'address' instead of 'addresses'. Additionally, we have introduced the 'countryId'.

     

23.04.2025  (Released with Version 251.4.0 )

  • Re-Work the compensation resource for reading, updating and creating recurring compensations of an employee (GET, PUT, POST)

  • Re-work social insurance endpoint: Get social insurance data of all employees or for a single employee (GET) or update social insurance data of a single employee (PUT) 

  • Re-Work tax data: Get tax data of all employees or for a single employee (GET) or update tax data of a single employee (PUT)

 

09.04.2025 (Released with Version 251.3.0)

  • Import data from clocko:do (external time tracking) to the payroll accounting

  • Import Variable data from LODAS Lodas

  • Add, retrieve, or update capital-building contracts for a specific employee (GET, PUT, POST)

  • Update address data for a specific employee (PUT)

 

26.02.2025 (Released with Version 244.7.0)

  • GET a list of wage types (GET): API endpoint to receive a list of all available wage types (e.g. to map them for sending variable data)

 

12.03.2025 (Released with Version 251.1.0)

New Endpoints:

  • LODAS file import: This API endpoint allows the import of master data, variable data, fixed compensations, and absences using a DATEV LODAS file (POST).

  • Retrieval of establishments: A GET Endpoint for Establishments has been released, allowing users to programmatically retrieve details about the structure of establishments via the API. This endpoint allows users to either retrieve all establishments or to get a specific establishment using a parameter (GET).

  • Get common master data: This endpoint returns the common master data like our known prefixes, affixes, countries and nationalities. These data can be used, for example, when creating new employees (GET).

  • Get contract data of all employees or for a single employee (GET) and update contract data of a single employee (PUT) 

  • Get contact data of employees: Two new endpoints have been introduced to retrieve contact data: one for individual employees and one for all employees (GET).

  • Get address data of employees: Two new endpoints have now been introduced to retrieve address data: one for retrieving the address of a single employee and one for retrieving the addresses of all employees (GET).

  • Get tax details for either a single employee or all employees (GET) and update tax details for a single employe (PUT)  

  • Get social insurance details for either a single employee or all employees (GET) or update social insurance details for a single employe (PUT).

Changed Endpoints:

  • Adjustments to endpoints for eAU minimal data (Retrieval of data for all employees or for a single employee (GET): Our endpoints that deliver only the required information for the eAU process for time tracking applications have been adjusted to only return the data required for the eAU.

  • Deleted Endpoints: No API was deleted.