Aladtec API Changelog

Added

• GET /time-off - Updated to include "schedule_ids" property for the records in the response.
• GET /schedules - Updated to include "start_time" property for the records in the response.

Fixed

• GET /scheduled-time/ends-in-range - Fixed an issue with filtering by schedule IDs, position IDs, or time type IDs.

Added

• GET /scheduled-time/ends-in-range - Gets scheduled time that ends within a specified period of time.

Added

• GET /time-off - Added "include_notes" query parameter to include the notes for the records in the response.
• GET /extra-hours - Added "include_notes" query parameter to include the notes for the records in the response.

Added

• PATCH /time-off/types - Updates a subset of Time Off Types.
• DELETE /time-off/types - Deletes a subset of Time Off Types.

Fixed

• POST /members - Fixed an issue where duplicate schedule permissions caused member creation to fail.
• PATCH /members/{id} - Fixed an issue where duplicate schedule permissions caused member updates to fail.
• POST /members/batch - Fixed an issue where duplicate schedule permissions caused member creations to fail.
• PATCH /members/batch - Fixed an issue where duplicate schedule permissions caused member updates to fail.

Added

• POST /members/batch - Creates new members in the Member Database.
• PATCH /members/batch - Updates a subset of existing members.

Added

• PATCH /schedules/position-qualifications - Updates a subset of position qualifications.
• DELETE /schedules/position-qualifications - Deletes a subset of position qualifications.

Added

• GET /time-off/types - Retrieves all active Time Off Types.
• POST /time-off/types - Creates new Time Off Types.
• POST /schedules/position-qualifications - Creates new position qualifications.

Fixed

• GET /reports/payroll - Fixed an issue where Time Off records using the Other Time Off Type did not include the custom label in the response.
• GET /reports/payroll - Applied a deterministic sort order to members included in the response.

Fixed

• GET /reports/payroll - The example response body included a payroll_code_labels key that is not included in the actual response body.

Changed

• New RFC 3339 format for all Date/Time values
• New standard JSON structure for all HTTP response bodies
• All dynamic JSON properties have been replaced with fixed property keys.
• Array query parameters no longer use square brackets.
• limit query parameters now use the same maximum and default values.
• POST /oauth/token - New response format and access tokens expire in one hour.
• POST /members - work_group_id is no longer required
• GET /shift-labels - Both the color and label text are returned

Removed

• Unix timestamps from time records
• Member object - formatted_name property
• Event object - public property
• include_time_types query parameter
• Attachment custom attributes (which only showed whether or not an attachment had been uploaded)

Fixed

• POST /members - Fixed an issue where duplicate schedule permissions caused member creation to fail.
• PATCH /members/{id} - Fixed an issue where duplicate schedule permissions caused member updates to fail.

Fixed

• GET /reports/payroll - Fixed an issue where Time Off records using the Other Time Off Type did not include the custom label in the response.

Fixed

• GET /reports/payroll - The example response body included a payroll_code_labels key that is not included in the actual response body.

Added

• GET /reports/payroll - Runs the Payroll Report for a specified date range, list of members, and time categories.
• PUT /accrual-banks/balances - Set specific accrual bank balances to absolute values for one or more Aladtec members.

Fixed

• Updated internal infrastructure for maintainability and reliability.

Added

• GET /scheduled-time - Added time_type_ids parameter to allow optional filtering by Time Types.
• GET /extra-hours - Added time_type_ids parameter to allow optional filtering by Time Types.

Added

• GET /extra-hours - Retrieves active and pending Extra Hours records.

Fixed

• GET /accrual-banks/balances - Accrual balances were missing from the returned records.

Fixed

• POST /accrual-banks/balances/adjustments - Fixed an issue where improperly formatted JSON could return a 500 error.

Added

• GET /time-clock/paycodes - Retrieves all active Time Clock paycodes.
• GET /time-clock/kiosks - Retrieves all active Time Clock kiosks.
• POST /time-clock-time/clock-in - Clocks a member into the system.
• POST /time-clock-time/clock-out - Clocks a previously clocked in member out of the system.

Added

• GET /configuration - Retrieve Aladtec system configuration settings, including timezone, organization name, system admin, and historical edits limit.

Added

• GET /accrual-banks - Retrieve all accrual banks.
• GET /accrual-banks/balances - Retrieve specific accrual bank balances for one or more Aladtec members.
• POST /accrual-banks/balances/adjustments - Increase or decrease specific accrual bank balances for one or more Aladtec members.

Fixed

• POST /oauth/token - Updated internal infrastructure for maintainability and reliability.

Fixed

• POST /oauth/token - Fixed bug where grant type did not require a value.

Fixed

• Updated internal infrastructure for maintainability and reliability.

Fixed

• GET /time-off - Approved Time Off records did not show the correct time off type if the type was changed when approved.

Fixed

• GET /scheduled-time - Updated to return contiguous time records for the same member as separate entries when their time types do not match.

Added

• GET /open-time - Find open blocks of time within schedules.

Added

• GET /time-types - Retrieve all unique time types in the Aladtec system which can be applied to all scheduled time.

Added

• GET /members - Updated to return "schedule_ids" and "position_qualification_ids" properties.
• GET /schedules/position-qualifications - Updated to return a list of unique position qualifications.
• POST /members - Updated to support updating "schedule_ids" and "position_qualification_ids" properties.

Added

• GET /scheduled-time/notes - Retrieve Schedule Notes organized by calendar date for up to one year.

Added

• GET /schedules - Updated to include the schedule order on each schedule.
• GET /time-off - Added "statuses" query parameter with supported values "approved", "pending" or both.

Fixed

• Updated internal infrastructure for maintainability and reliability.

Fixed

• Updated internal infrastructure for maintainability and reliability.

Added

• GET /v2/members/custom-attributes - Retrieve all custom created Member Database attribute definitions.
• GET /v2/members/employee-types - Retrieve all employee types. Types can be customized per Aladtec system.
• GET /v2/work-groups - Retrieve all work groups. Work groups are used for putting members into groups if they follow the same schedule and work limit rules.
• POST /members - Updated to support creating a new member in the Member Database.
• PATCH /members/{id} - Updated to support editing an existing member using a subset of attributes.

Changed

• GET /members - Updated to return data in the new format.

Fixed

• Updated internal infrastructure for maintainability and reliability.

Added

• GET /scheduled-time - Added new "member_ids" and "position_ids" query parameters to retrieve scheduled time which allows you to filter to the desired records more precisely.

Added

• GET /scheduled-time, /time-off, /events - Added new "daily_split_time" query parameter which is the time at which scheduled shifts will be split.

Fixed

• GET /time-off /events - Updated to return the correct records when daily split time is offset from the calendar day by approximately one day.

Added

• GET /shift-labels - Retrieve Shift Labels for requested date range.

Fixed

• GET /scheduled-time, /events, /time-off - Updated to return an empty object if no scheduled time records are found.
• GET /scheduled-time/members-scheduled-now - Updated to return members who started working on the previous schedule day previously missing from the response.

Added

• Updated CORS preflight browser request support and fixed related issues.

Added

• Added CORS support to all API routes.

Fixed

• Updated internal infrastructure for maintainability and reliability.

Added

• GET /scheduled-time - Updated to return time type labels and shift extender indicators.
• GET /events - Updated to return new property "public" that indicates if an event is shown on the external event block.

Changed

• GET /members - Updated to not include attributes by default when the "include_attributes" query parameter is set to false.
• GET /members - Updated to return all members by default, both active and inactive when the "include_inactive" query parameter is not specified. The route previously returned only active members.
• GET /scheduled-time - Updated to cut scheduled time records based on daily split time.

Fixed

• POST /oauth/token - Updated the error messages for "This property should not be blank" to "This JSON property is required" when required parameters are missing.
• POST /oauth/token - Updated to longer require client_id and client_secret to prepare for future Oauth grant types.
• Updated internal infrastructure for maintainability and reliability.

Fixed

• Updated internal infrastructure for maintainability and reliability.

Added

• GET /members - Retrieve members and member's associated attributes.
• GET /members/attributes - Retrieve all accessible Member Database attribute definitions.
• GET /availability - Retrieve Member Availability for the requested date/time range.
• GET /time-off - Retrieve approved and pending Time Off ranges for the requested date/time range.
• GET /schedules - Retrieve schedule configuration defined in the Aladtec system.
• GET /scheduled-time - Retrieve scheduled time ranges for a specified period of time.
• GET /scheduled-time/members-scheduled-now - Retrieve schedule and position for each member scheduled at the time of the request.
• GET /events - Retrieve Events for requested date/time range.
• GET /time-clock-time - Retrieve Time Clock records for the requested date/time range.
• GET /time-clock-time/clocked-in-members - Retrieve members clocked in at the time of the request.