Changelog
Home
Back to All
added

[2024-07-01] Added/Improved: Endpoints for external time accounts

3 months ago by shyftplan GmbH

Endpoint: api/v2/absence_reasons

Method: POST

Change: New version of the endpoint to create absence reasons of these types:

  • "with_entitlement" (already possible with v1)
  • "without_entitlement" (already possible with v1)
  • "time_account" (new). Some additional parameters to be used in this case

Endpoint: api/v2/absence_reasons/{id}

Method: PATCH

Change: New version of the endpoint to change details of absence reasons of these types:

  • "with_entitlement" (already possible with v1)
  • "without_entitlement" (already possible with v1)
  • "time_account" (new)

Endpoint: api/v1/absence_reasons/{id}

Method: GET

Change: Improved response to show upper/lower limits and warnings for time_account types

Endpoint: api/v1/absence_reasons

Method: GET

Change: Additional field "type" to filter for absence reasons of these types:

  • "with_entitlement"
  • "without_entitlement"
  • "time_account"

Endpoint: api/v1/employment_time_accounts

Method: GET

Change: New endpoint to retrieve external time account balances and limits of employees.

Endpoint: api/v1/employment_time_accounts

Method: PATCH

Change: New endpoint to change external time account balances and limits of employees.

Endpoint: api/v1/absences

Method: POST

Change: Endpoint expanded (structured field "days_breakdown" added) to ease the creation of absences for absence reasons of type "time_account"

Endpoint: api/v1/absences

Method: PUT

Change: Endpoint expanded (structured field "days_breakdown" added) to ease the change of absences for absence reasons of type "time_account"

Endpoint: api/v2/absences/employments/{id}/absence_info

Method: GET

Change: New endpoint version to show the individual-days calculation for absences of absence reason with type "time_account"

Endpoint: api/v1/absences

Method: GET

Change: Added:

  • filtering by absence reason type in the request
  • absence_days in the response, containing details for time_account absences (empty in other absence reasons)

Endpoint: api/v1/absences/{id}

Method: GET

Change: Added absence_days in the response, containing details for time_account absences (empty in other absence reasons)

Endpoint: api/v1/absences/{id}/approve

Method: POST

Change: Additional error messages in case of conflicts with time_accounts (limits & warnings thresholds)

Endpoint: api/v2/absence_entitlements

Method: GET

Change: Added error response when absence reasons is of type time_account

Endpoint: api/v2/absence_entitlements

Method: PUT

Change: Added error response when absence reasons is of type time_account