SaaS.de Customer REST API (2.0)

Returns the working-time account (target/actual/balance) of a single employee for a month, including that month's individual bookings. For the current month the totals are recalculated on each call.

Returns the target (soll) and actual (ist) minutes per day for a date range. With an email only that employee is returned; otherwise all time-tracked employees of the company (identified by the company key) are returned.

Returns a per-employee presence and absence overview for the current day. With an email only that employee is returned; otherwise the set of employees depends on the modules and supervisor scope of the key owner. Detail fields (current booking, platform, device) are only filled for the key owner or their supervisors. Send at least an empty JSON object {}.

Returns, per employee, whether they are present on the given day and any absences (leave or public holidays) for that day. With an email only that employee is returned; otherwise all time-tracked employees of the company are returned.

Records a time booking for a single employee.

• come — clock in (optionally on a project/service)
• go — clock out
• stop — clock out and immediately clock back in (break / context switch)

Returns true on success, false otherwise — e.g. an invalid company key, an unresolvable employee, a come on a project without the project-management module, a plain come without the time-tracking module, or a go/stop that is not currently possible (such as clocking out when not clocked in). The request body is optional.

Returns the working-time account of a single employee for a month.

Returns the current time account of every employee in a department, keyed by the employee's login account (e-mail). Employees without a login account are omitted.

Returns one monthly time summary per active employee in the department for the requested month. The array is empty when the month is in the future or no employee qualifies.

Adjusts an employee's extra-leave balance and records the change in the leave history. A positive value pays leave in, a negative value pays it out.

Returns true on success, false otherwise — e.g. an invalid company key, an unknown account, an employee of another company, a missing leave-management module, or an unknown action. action must be present in the body.

Books an absence (outside the regular leave workflow) for an employee. abscenceReasonUuid and employeeUuid are required. Depending on the absence type a substitute (replacementUuid) may be mandatory.

Returns the leave records of all leave-managed employees that overlap the given month.

Note: month is 0-based (0 = January … 11 = December).

Returns a yearly leave overview for all leave-managed employees, plus a legend that resolves each leave-type id to its localized names.

Returns every leave type configured for the company (vacation, sick leave, …). Requires the Leave management module. Credentials (email + api-key) are sent in the request body.

Returns a list of single-entry objects mapping each employee's full name to the name of their main department.

Returns master data for every employee of the company. Employees without a login account are omitted.

Returns all non-removed projects of the company. Requires the Project management module and the manager role. Credentials are sent in the request body.

Creates a new project for the company. Requires the Project management module and the manager role. Optionally nest it under an existing parent via parentId (the parent's UUID; omit or "0" for a top-level project).

Deletes the project identified by its UUID. Requires the Project management module and the manager role. The project must belong to the caller's company; an unknown or foreign UUID is rejected with 403 body 3. Credentials are sent in the request body.

Returns the UUIDs of all non-removed projects of the company whose name matches name exactly. Several equally named projects yield several UUIDs. Requires the Project management module and the manager role.

Returns the time bookings of the given project (and its sub-projects) within a date range. The range may span at most one month (31 days) and startDate must not be after endDate — otherwise the request is rejected with 403 body 4. Requires the Project management module and the manager role.

Returns all shifts of a workspace (Arbeitsbereich) for the given ISO calendar week, together with the employees assigned to each shift. Authenticated with the workspace API key in the path — not a company or employee key.

Creates a single shift in a workspace (Arbeitsbereich) and optionally assigns employees to it. Authenticated with the workspace API key, sent in the JSON body as workspace (not the URL). Only employees of the workspace's own company are assigned; unknown or foreign employee UUIDs are ignored.

Times are given as minutes after midnight. If endTime is not greater than startTime, the shift is treated as an overnight shift and ends on the following day.