.hero-block-illustration {
	flex: 1 1 15%;
	position: relative;
}
.hero-block-illustration span {
	position: initial;
}
.hero-block-illustration img {
	position: absolute;
	max-width: 1000px;
	height: auto;
	width: auto;
	top: -10rem;
	cursor: pointer;
	pointer-events: none;
}
.hero-block-illustration img:is(.dark *) {
	opacity: 0.5;
}
.hero-block-illustration.left img {
	right: 0;
}
.hero-block-illustration.right img {
	left: 0;
}

.hero-block-content {
	flex: 0 1 50%;
	display: flex;
	flex-direction: column;
	align-items: center;
	justify-items: center;
}

.changelog-item .main-illustration img {
	margin: 0;
}

ul.oauth-scopes,
ul.oauth-scopes ul {
	margin: 0 !important;
}
ul.oauth-scopes strong {
	display: block;
}
ul.oauth-scopes.single-li {
	padding-left: 0.5rem;
}
ul.oauth-scopes.single-li,
ul.oauth-scopes.single-li ul,
ul.oauth-scopes.single-li li {
	display: inline;
}
ul.oauth-scopes.single-li > li {
	padding: 0 !important;
}
ul.oauth-scopes.single-li > li::before {
	display: none;
}
ul.oauth-scopes li {
	margin: 0 !important;
}
ul.oauth-scopes ul {
	display: inline-block;
}
ul.oauth-scopes ul li::before {
	display: none;
}
ul.oauth-scopes > li {
	display: block;
}
ul.oauth-scopes > li:not(:last-child)::after {
	display: block;
	content: "or";
	padding: 0 0.5rem;
	margin: 0.5rem 0;
}
ul.oauth-scopes ul li {
	display: inline-block;
	padding: 0 !important;
}
ul.oauth-scopes ul li:not(:last-child)::after {
	display: inline-block;
	content: "and";
	padding: 0 0.5rem;
}


Retrieve a single TimeEntry identified by its unique identifier.

Please refer to the [TimeEntry API reference](reference/Timmi-Timesheet-v3.yaml/components/schemas/TimeEntry) for additional information on the TimeEntry object.

Please see [this guide](../docs/Use-cases/Timmi%20Timesheet/Retrieve-time-entries.md) on how to retrieve TimeEntries the right way.

Get a TimeEntry by id

You can [read more about this resource here](/api-reference/legacy/organization/axis-sections/get-started).

The AxisSection resource

TimeEntries are the working time sequences spent by a user on any given day.

TimeEntries come in different **units** and **submission modes** that should match the timesheet configuration of a given owner on a given day.

## About units & duration

Timmi Timesheet supports up to 3 different units when it comes to entering TimeEntries. These are:
- `0: Days` In this case, the user does not enter the exact hours he/she started working, but rather the total duration spent as a fraction of a day. For example: "John worked half a day on Monday".
- `1: Hours` In this case, the user still does not enter the exact hours, but only the duration spent in hours. For example: "John worked 7h30min yesterday".
- `2: Time` In this unit, the user has to enter the actual time he/she started working, as well as the end time. For example: "John started working at 08:00 for 3 hours, thus ending at 11:00".

```csharp
enum TimeEntryUnit:
{
    Days = 0,
    Hours = 1,
    Time = 2
}
```

Whichever the unit, the TimeEntry is mainly determined by three properties:
- `(int) ownerId`: The user it belongs to.
- `(date-time) startsAt`: The date and time when the user started working. In `Days` and `Hours` units, the time part can only be `00:00:00` for "morning" (AM) or `12:00:00` for the "afternoon" (PM).
- `(duration) duration`: The total time spent by the user from the time he/she started. In all units, this property is serialized as a string compliant with the Timespan formating: `d.hh:mm:ss` where `d` is the number of days (can be omitted if equal to zero which is in most cases), `hh` the number of hours, `mm` the number of minutes, and `ss` the number of seconds.


Some examples :
```js
// TIME UNIT
// Case: "John (id: 416) worked between 09:45 and 12:15 on January, 1st 2021."
var timeEntry = {
  "ownerId": 416,
  "startsAt": "2021-01-01 09:45:00",
  "duration: "02:30:00",
  "unit": 2
};

// HOURS UNIT
// Case: "John (id: 416) spent 4h45min working on January, 1st 2021 in the morning"
var timeEntry = {
  "ownerId": 416,
  "startsAt": "2021-01-01 00:00:00",
  "duration: "04:45:00",
  "unit": 1
}

// DAYS UNIT
// Case: "John (id: 416) worked on the afternoon of January, 1st 2021"
var timeEntry = {
  "ownerId": 416,
  "startsAt": "2021-01-01 12:00:00",
  "duration: "12:00:00",
  "unit": 0
}
```

## About submission modes

There are 2 submission modes in Timmi Timesheet:
- **Attendance**: the user is expected to enter the sequences of work without much detail.
- **Activities**: the user is expected to enter the time spent on each task / project / whatever.

Therefore, TimeEntries in activities mode have a supplementary property: the set of task / project / cost center / ... the user worked on. These analytical items are called AxisSections. [More info here](reference/Timmi-Timesheet-v3.yaml/components/schemas/AxisSection).

The TimeEntry is NOT determined by the `axisSection[]` it is associated with as a user can change the `axisSection[]`.


```json
{
  "ownerId": 416,
  "startsAt": "2021-01-01 00:00:00",
  "duration: "04:45:00",
  "unit": 1,
  "axisSections": [
    {
      "name": "R&D",
      "axis": {
        "name": "Cost centers"
      }
    },
    {
      "name": "My awesome project",
      "axis": {
        "name": "Projects"
      }
    },
    {
      "name": "Testing",
      "axis": {
        "name": "Tasks"
      }
    }
  ]
}
```

## About time types
Each time-entry can reference a time type via its `timeTypeId` property.

Time types are a configured working time classification. It is generally used as a way of discriminating different types of working hours regarding compensation:
- Attendance
- Travels
- etc...

Time types can only be used on users that belong to a specific regulation (ie time and attendance policy) mode: `timeTrackingMode: typed`. Whenever it is not the case, the `timeTypeId` property should be left `null`.

## Validation rules

#### Locked timeentries after timesheet submission
A TimeEntry cannot be modified if its `startsAt` date belongs to an already submitted or approved timesheet.

#### StartsAt and timezones
The `startsAt` date-time property must be considered a [floating](https://www.w3.org/International/wiki/FloatingTime) date-time. As such, no UTC offset should be sent when creating or editing a TimeEntry.

#### Max duration
A TimeEntry cannot have a duration longer than 24h00 (ie one full day). 

#### Cut at midnight
A TimeEntry cannot overlap 2 different days (example `startsAt = 18:00:00` and `duration = 10:00:00`). It should be two distinct TimeEntries cut at `00:00:00`.

#### Mandatory axisSection on activity timesheets
A TimeEntry must have axisSection if the corresponding timesheet is in activity mode, and vice-versa.

#### Inactive axisSection
A TimeEntry cannot be modified if one of its axisSection is no longer active (`active=false`).

#### Incompatible axisSections
A TimeEntry cannot have nested axisSections that does not meet a correct parent-child tree structure.

## Fields

Conception

Animal Logic

Projet Rose  : KPI - tableau de bord

Art Direction

This is a comment

Hélène Girard

90 - avril 2024 - Submitted

Date and time when TimeEntry was deleted (Central European Time). When null, implies that the TimeEntry still has not been deleted (and maybe never will).

Identifier of the user who initially created this TimeEntry.

Represent the activities that TimeEntry should be associated with. When not in activity mode, send an empty array, or do not serialize this property.

A comment to add additional information about the given TimeEntry. It will be visible on Timmi Timesheet user interface.

Identifier of the user who initially created this comment

Date and time when the comment was first created. (Central European Time)

Date and time when TimeEntry was first created. (Central European Time)

Attribute used to identify last modification source :
- 0: Automatic fallback on theoretical TimeEntries from workcycles.
- 1: Entered with Timmi Timesheet quick-fill tools.
- 2: Manually created or edited (default).
- 3: Imported from external sources. Is read-only on Timmi Timesheet user interfaces only if Timesheet regulation is in following modes : attendance schedule with clock-in clock-out, and activity schedule.
- 4: Entered with Timmi Timesheet clock-in clock-out tool. 

Duration of the TimeEntry in the "c" format of a C# timespan In other words : d.hh:mm:ss.
Max: "1.00:00:00" (ie 24 hours).

Automatically set as startsAs + duration when editing a timeentry.

Used to store the original workcycle at the time of TimeEntry modification. In 99.999% of use cases, you will want the 0 : Actual TimeEntry.
- 0: Actual TimeEntry.
- 1: Theoretical workcycle.

Date and time when TimeEntry was last modified. (Central European Time). The TimeEntry is modified by any change made to the TimeEntry, including when corresponding timesheet is sent for approbation (status=1) and when the timesheet is completely approved (status=2).

The unique identifier of the user who last updated the TimeEntry.

The timeEntry start date and time. Please do NOT send any offset/timezone information ("Z", "+01:00", etc...).

Optional reference of a configured Time Type. To use only if the timesheet is set up to use Time Types. Null otherwise.

The reference to the timeshet this timeentry is associated with when the timesheet is at least sent for approval. Is null if the timesheet is still pending submission.

Unit in which the TimeEntry has been entered. 
- 0: Days (eg "1/2 day")
- 1: Hours (eg "8h15min")
- 2: Time (eg "23:45:00") 

The TimeEntry resource

Unique identifier of the legal establishment this user currently has a work contract with.

Timesheet User

The URL of your dedicated Lucca account: `{account}.{env}.{region}`.

Account reflects your company name. Env indicates the environment. Region depends on your server location.

**Please, use your test or sandbox environments (and not your production env.) for testing purposes.**

Environments:
- `ilucca`: production environment for customers.
- `ilucca`: test environment for customers.
- `ilucca-demo`: demo environment for prospects.

Regions:
- `.ch` for Swiss located accounts.
- `.net` for the others.

Regarding sandboxes, the pattern differs: `https://{account}-{sandboxName}.sandbox.{server}.luccasoftware.com`, where:
- `{sandboxName}` is automatically generated upon creation.
- `{server}` may be "eu1", "eu2" or "ch1".

Lucca API

Introduction

Learn how to authenticate on a Legacy API.

Authentication

Behavioral and structural differences between v3 and v4 API generations.

v3 VS v4

Limits

Changelog

Legacy API Changelog

The file resource

Upload a file

Using Files

The axis resource

List Axes

The axis-section resource

List all AxisSections satisfying query filters.

List AxisSections

Create a new AxisSection

Retrieve a single AxisSection by its unique identifier.

Get an AxisSection by id

Partial or complete update to an existing AxisSection.

Update an AxisSection by id

Delete an AxisSection by id

The department resource

List all Departments satisfying query filters.

List Departments

List all departments as a tree.
Remark: first node is always empty and represents the starting point 
of the tree as multiple departments might be set to the highest level. 

List Departements as a tree

Retrieve a single Department by its unique identifier.

Get Departement by id

The legal-unit resource

Retrieve a paginated list of legal-units.

List legal-units

The establishment resource

List establishments

The user resource

Retrieve a list of Users.

By default, former employees are excluded from the response. In order to retrieve them, you may add the `?dtContractEnd=notequal,null` query parameter to your request.


List Users

Create a new User

Retrieve a single User identified by its unique identifier.

Get a User by Id

Update fields of a single User identified by its unique id.

Update a User by id

Users Examples

The UserProperties API can be used to retrieve information on the structure of all the properties that can be attached to a user. This API is read-only: only the HTTP `GET` request method is therefore available on this API.

Using the user-properties API

Extended Data

Using employees' work-contracts

Delegation

The expense-temp-item resource

Retrieve a list of `ExpenseTempItems`.

The `purchasedOn` query parameter can operate comparisons with a given date-time value:
- `?purchasedOn=2021-01-01`: strict equality.
- `?purchasedOn=since,2021-01-01`: greater than or equal.
- `?purchasedOn=until,2021-01-01`: lower than or equal.
- `?purchasedOn=between,2021-01-01,2021-01-31`: comprised between two dates.

List ExpenseTempItems

Create a new temporary expense

Retrieve an temporary expense item by its identifier.

Get an ExpenseTempItem by id

Update a temporary expense item by its identifier.

Update an ExpenseTempItem by id

The expense-claim resource

When a user wants to declare his expenses, he creates an `ExpenseClaim`.

An `ExpenseClaim` is created by regrouping one or more `ExpenseTempItems` and converting them into ExpenseClaimItems.

Once created, an `ExpenseClaim` has to be approved by his manager.

Multiple `ExpenseClaims` can be created through a single request.

Create a new ExpenseClaim

Retrieve a list of `ExpenseClaims`.

The `declaredOn` query parameter can operate comparisons with a given date-time value:
- `?declaredOn=2021-01-01`: strict equality.
- `?declaredOn=since,2021-01-01`: greater than or equal.
- `?declaredOn=until,2021-01-01`: lower than or equal.
- `?declaredOn=between,2021-01-01,2021-01-31`: comprised between two dates.

List ExpenseClaims

The expense-claim-item resource

Retrieve a list of `expenseClaimItems`.

The `purchasedOn` query parameter can operate comparisons with a given date-time value:
- `?purchasedOn=2021-01-01`: strict equality.
- `?purchasedOn=since,2021-01-01`: greater than or equal.
- `?purchasedOn=until,2021-01-01`: lower than or equal.
- `?purchasedOn=between,2021-01-01,2021-01-31`: comprised between two dates.

List ExpenseClaimItems

Retrieve an expense claim item by its identifier.

Get an ExpenseClaimItem by id

The leave resource

The leave-account resource

Retrieve a list of approved leaves for one or several users on a given period.

The `leavePeriod.ownerId` query parameter is required ans is used to:
  - retrieve Leaves of a specific user: `?leavePeriod.ownerId=5`
  - retrieve Leaves of several users: `?leavePeriod.ownerId=5,6`
  - retrieve Leaves of a specific group of users: `?leavePeriod.owner.departmentId=3`

The `date` query parameter can operate comparisons with a given date-time value:
  - `?date=2021-01-01`: strict equality.
  - `?date=since,2021-01-01`: greater than or equal.
  - `?date=until,2021-01-01`: lower than or equal.
  - `?date=between,2021-01-01,2021-01-31`: comprised between two dates.

List leaves

Retrieve a single Leave by its unique identifier.

Get a leave by id

Cancel a single Leave by its unique identifier.

Cancellation of a leave

The leave-request resource

The leave-period resource

List leave requests

Retrieve a single Leave Request by its unique identifier.

Get a leave request by id

The leave-request-approval resource

Approve or deny a single Leave Request by its unique identifier

Only the Leave Requests pending approval can be approved or denied.

A comment is required to deny a Leave Request.


Approve or deny a leave request

The cancellation-request resource

Request to cancel a single Leave Request by its unique identifier

Request to cancel a leave request

The SickLeaveCertificate resource

Retrieve a paginated list of SickLeaveCertificate objects, which contain further information about certain types of leaves.

In France, some leave types require extra details in order to comply with legal expectations: sick leaves, maternity, paternity, etc...

List SickLeaveCertificates

Get a SickLeaveCertificate

**Supported file formats:**
- CSV
  - "UTF-8" encoding
  - separator “;”
- XSLX

**Columns to fill in:**

| Column name                                     | Description                                              |
| :---------------------------------------------- | :------------------------------------------------------- |
| `LegalEntityCode`                               | Employee legal entity code.                              |
| `EmployeeNumber`                                | Employee payroll number.                                 |
| `LastName`                                      | Last name.                                               |
| `FirstName`                                     | First name.                                              |
| Account number or name (one column per account) | Value to import for the account defined in the header.   |

*Remark:
A template file can be downloaded from the import page (Credit / Debit> A group of collaborators> File import).*

In the event of a malformed (or unrecognized) file, no data will be imported; the problems detected will be specified in the `globalErrors` field.

If successful, the number of imported lines is indicated by the “successLinesCount” field; the lines in error are detailed in the `lineErrors` field.


*Remarks:
Any import made by the API is of course available in the import history.
A simulation returns the same level of information, but does not trigger an import*

**List of errors handled**

Here is the list of fatal errors, which can be returned in the `globalErrors`:
- Unauthorized
- FileEmpty,
- FileExtensionNotSupported,
- ColumnsFormatNotSupported,
- AccountColumnMissing,
- ColumnNamesDistinct,
- LineErrorForbiddenInStrictMode,

The list of line processing errors, which can be restored in the `lineErrors`:
- AccountNotFound,
- AccountsNotFound,
- AccountColumnsProcessing,
- LegalEntityCodesNotFound,
- MissingValuesForAccount,
- AccountNotAvailableForUser,
- LegalEntityCodeRequired,
- EmployeeNumberRequired,
- LoginRequired,
- LoginNotFound,
- AccountNumberRequired,
- LegalEntityNotFound,
- EmployeeNumberNotExist,
- EmployeeNumberNotInLegalEntity,
- FistNameAndLastNameNotMatching,
- FistNameNotMatching,
- LastLameNotMatching,
- FistNameAndLastNameNotMatchingEmployeeNumber,
- FistNameNotMatchingEmployeeNumber,
- LastLameNotMatchingEmployeeNumber,
- FistNameAndLastNameNotMatchingLogin,
- FistNameNotMatchingLogin,
- LastLameNotMatchingLogin,
- DuplicatedLine,
- AmbiguousLegalEntity,
- ColumnNotExists,
- LegalEntityNameNotAvailable,
- AccountNameNotUnique

The list of import generation errors:
- UnableToCreditAccount


Import entitlements

**Supported file formats:**
- CSV
  - "UTF-8" encoding
  - separator “;”
- XSLX

**Columns to fill in:**

| Column name                                     | Description                                              |
| :---------------------------------------------- | :------------------------------------------------------- |
| `LegalEntityCode`                               | Employee legal entity code.                              |
| `EmployeeNumber`                                | Employee payroll number.                                 |
| `LastName`                                      | Last name.                                               |
| `FirstName`                                     | First name.                                              |
| Account number or name (one column per account) | Value to import for the account defined in the header.   |


*Remark:
A template file can be downloaded from the import page (Credit / Debit> A group of collaborators> File import).*

In the event of a malformed (or unrecognized) file, no data will be imported; the problems detected will be specified in the `globalErrors` field.

If successful, the number of imported lines is indicated by the “successLinesCount” field; the lines in error are detailed in the `lineErrors` field.


*Remarks:
Any import made by the API is of course available in the import history.
A simulation returns the same level of information, but does not trigger an import*

**List of errors handled**

Here is the list of fatal errors, which can be returned in the `globalErrors`:
- Unauthorized
- FileEmpty,
- FileExtensionNotSupported,
- ColumnsFormatNotSupported,
- AccountColumnMissing,
- ColumnNamesDistinct,
- LineErrorForbiddenInStrictMode,

The list of line processing errors, which can be restored in the `lineErrors`:
- AccountNotFound,
- AccountsNotFound,
- AccountColumnsProcessing,
- LegalEntityCodesNotFound,
- MissingValuesForAccount,
- AccountNotAvailableForUser,
- LegalEntityCodeRequired,
- EmployeeNumberRequired,
- LoginRequired,
- LoginNotFound,
- AccountNumberRequired,
- LegalEntityNotFound,
- EmployeeNumberNotExist,
- EmployeeNumberNotInLegalEntity,
- FistNameAndLastNameNotMatching,
- FistNameNotMatching,
- LastLameNotMatching,
- FistNameAndLastNameNotMatchingEmployeeNumber,
- FistNameNotMatchingEmployeeNumber,
- LastLameNotMatchingEmployeeNumber,
- FistNameAndLastNameNotMatchingLogin,
- FistNameNotMatchingLogin,
- LastLameNotMatchingLogin,
- DuplicatedLine,
- AmbiguousLegalEntity,
- ColumnNotExists,
- LegalEntityNameNotAvailable,
- AccountNameNotUnique

The list of import generation errors:
- UnableToCreditAccount


Replace entitlements

Create absences in batch from a CSV file.

**Important notice: Absence imports cannot be cancelled.** 

In case of a mistake absences must be deleted manually through the interface or using the API (see Use cases). **Use import with care!**

**File format**

Content-Type: CSV. Column divider is semicolon ";". Line breaks between rows.

Encoding: UTF-8

All the following fields must be present with the field name in the header:

- legalEntity: Name of the establishment the employee belongs to.
- employeeNumber: Employee number.
- lastName: Family (last) name of the employee.
- firstName: Given (first) name of the employee.
- accountId: Identifier of the absence account in Timmi Absences (can be found in the leave accounts admin page).
- startDate: Start date of the absence, formatted as `DD/MM/YYYY`.
- flagStartDate: `"AM"` if the absence starts in the morning or `"PM"` if the absence starts in the afternoon.
- endDate: End date of the absence, formatted as `DD/MM/YYYY`.
- flagEndDate: `"AM"` if the absence ends at noon or `"PM"` if the absence ends in the afternoon.
- isApproved: `true` or `false`. Dictates whether the absence request should be created and already approved. 
  Required if the type of the absence requires approval, optional otherwise.

**History**
Import history is available in the import module. It includes imports made via the API.


Import leaves

Retrieve the progress of Import leaves API request.

Get import leaves progress

Syncing leaves

The user-location resource

List userLocations

Get specific userLocation

The work-location resource

List workLocations

Retrieve specific workLocation

The client resource

List clients from an organization.

## Search

The search query parameter takes a list of words and enables you to only return clients whose code or name contains all those words.

```http
GET /api/v4/clients?organizationId=1&search=goo,compa&fields.root=count HTP/1.1

{
  "count": 2,
  "items": [
    {
      "id": 1,
      "name": "Google",
      "code": "World company"
    },
    {
      "id": 1,
      "name": "Google company",
      "code": "Alphabet Group"
  ]
}
```

List Clients

Create a new Client

Retrieve a single client identified by its unique identifier.

Get a Client by id

Update fields of a single client identified by its unique id.

Update a Client by id

Delete a single client. Deletion is irrevocable.

Delete a Client by id

The project resource

List projects from an organization. Only returns a subset of a [Project](reference/Timmi-Project.yaml/components/schemas/Project) fields.

## Search

The search query parameter takes a list of words and enables you to only return projects whose code or name (or those of their clients) contains all those words.

```http
GET /api/v4/projects?organizationId=1&search=pro,avat&fields.root=count HTP/1.1

{
  "count": 2,
  "items": [
    {
      "id": 1,
      "name": "Project",
      "code": "Avatar",
      "client": {
        "name": "James Cameron",
        "code": "CAMERON"
      }
    },
    {
      "id": 2,
      "name": "Avatar Project",
      "code": "Awesomeness",
      "client": {
        "name": "Advent",
        "code": "ADVENT"
      }
  ],
  {
    "id": 3,
    "name": "Test",
    "code": "Test",
    "client": {
      "name": "Avatar",
      "code": "project"
    }
  }
}
```

List Projects

Create a new Project

Retrieve a project by its unique identifier.

Get Project by id

Update a Project by id

Only projects at "draft" status can be deleted.

Delete a Project by id

The project-service resource

List all services from a project identified by its unique id.

List a Project's Services

Create a new Project Service on a project.

Create a new Project Service

The organization resource

List organizations.

Conforms to the API v3 constraints (?fields, ?paging, etc...).

List Organizations

The project-financials resource

Retrieve all financial metrics on projects.

Response contains the sum of all included projects (paginated). The `items` node contains the financial metrics for each project.

List financials by project

The user-date resource

Retrieve a list of UserDates.

### Performance
In order to keep satisfactory response times and performance, please filter the request on a limited set of OwnerId[] and reduce the period  `date=between,{start},{end}`.

As a rule of thumb, do not request for more than ~10 owners over a whole month.

### Format
The `date` query parameter should match the form `?date=between,{start},{includedEnd}`.

List UserDates.

The workcycle-exception resource

Retrieve a paginated list of WorkCycleExceptions that satisfy the 
given query filters.


List WorkCycleExceptions.

**⚠️ Note**:
An employee can only have a single `WorkCycleException` on any given
half-day (indicated by the `startsAt` date and the `isAm` boolean).
As a result, creating a new `WorkCycleException` via a POST request 
may result in the update of the existing one.


Create (or update) a WorkCycleException.

Retrieve a single WorkCycleException by its ID.


Retrieve a WorkCycleException.

**❗Note**: The `WorkCycleException`, once deleted, stays available in the API.
In order to filter out the deleted `WorkCycleException`, you may use the `deletedAt`
query parameter:
```http
GET /api/v3/workcycleexceptions?deletedAt=null HTTP/1.1
Host: example.ilucca.net
Authorization: lucca application=XXXX
```


Delete a WorkCycleException.

The working-time-arrangement resource

<Warning>
**This is a beta feature.** 
You may not benefit from this feature. Working-time-arrangements are the
replacement for the workcycles. If this feature has not been deployed on
your environment, please contact our support.
</Warning>

List of Working Time Arrangements.

List Working Time Arrangements.

<Warning>
**This is a beta feature.** 
You may not benefit from this feature. Working-time-arrangements are the
replacement for the workcycles. If this feature has not been deployed on
your environment, please contact our support.
</Warning>

Get a Working Time Arrangement by id

Get a Working Time Arrangement by id.

The collective-schedule resource

<Warning>
**This is a beta feature.** 
You may not benefit from this feature. Working-time-arrangements are the
replacement for the workcycles. If this feature has not been deployed on
your environment, please contact our support.
</Warning>

Get the list of Collective Schedules from a Working Time Arrangement by id

List Collective Schedules from a Working Time Arrangement

<Warning>
**This is a beta feature.** 
You may not benefit from this feature. Working-time-arrangements are the
replacement for the workcycles. If this feature has not been deployed on
your environment, please contact our support.
</Warning>

Get a Collective Schedule of a Working Time Arrangement by id

Get a Collective Schedule from a Working Time Arrangement by id.

The time-entry resource

List all TimeEntries satisfying query filters.

For technical purposes, a TimeEntry of duration 00:00:00 will be returned for any day if :
- The day belongs to a Timesheet that is at least submitted,
- And the day has 00:00:00 total working time (a public holiday, a full-day absence, a working day without any work)

Please refer to the [TimeEntry API reference](reference/Timmi-Timesheet-v3.yaml/components/schemas/TimeEntry) for additional information on the TimeEntry object.

Please see [this guide](../docs/Use-cases/Timmi%20Timesheet/Retrieve-time-entries.md) on how to retrieve TimeEntries the right way.

List multiple TimeEntries

Create one or multiple TimeEntries. 

A single request can create TimeEntries for several different owners.

Please refer to the [TimeEntry API reference](reference/Timmi-Timesheet-v3.yaml/components/schemas/TimeEntry) for additional information on the TimeEntry object, and any validation error that you might encounter when using this API.

There are different ways to update TimeEntries. Please see [this guide](../docs/Use-cases/Timmi%20Timesheet/Update-time-entries.md) on how to update TimeEntries the right way depending on your use case.

Create new TimeEntries

Update one or several TimeEntries. 

The "id" field must be sent and correspond to an existing TimeEntry. 

A single request can edit TimeEntries for several different owners.

Please refer to the [TimeEntry API reference](reference/Timmi-Timesheet-v3.yaml/components/schemas/TimeEntry) for additional information on the TimeEntry object, and any validation error that you might encounter when using this API.

There are different ways to update TimeEntries. Please see [this guide](../docs/Use-cases/Timmi%20Timesheet/Update-time-entries.md) on how to update TimeEntries the right way depending on your use case.

Update multiple TimeEntries

Delete one or several TimeEntries. Deletion is irrevocable.

The "id" field of each TimeEntry must be sent and correspond to existing TimeEntries.

A single request can delete TimeEntries for several different owners.

It actually doest not delete entirely the object, but rather sets the "archivedAt" field to the current DateTime.

Please refer to the [TimeEntry API reference](reference/Timmi-Timesheet-v3.yaml/components/schemas/TimeEntry) for additional information on the TimeEntry object, and any validation error that you might encounter when using this API.

There are different ways to update TimeEntries. Please see [this guide](../docs/Use-cases/Timmi%20Timesheet/Update-time-entries.md) on how to update TimeEntries the right way depending on your use case.

Delete multiple TimeEntries

Update fields of a single TimeEntry identified by its unique id.

The "id" field must be sent and correspond to an existing TimeEntry. 

Please refer to the [TimeEntry API reference](reference/Timmi-Timesheet-v3.yaml/components/schemas/TimeEntry) for additional information on the TimeEntry object, and any validation error that you might encounter when using this API.

There are different ways to update TimeEntries. Please see [this guide](../docs/Use-cases/Timmi%20Timesheet/Update-time-entries.md) on how to update TimeEntries the right way depending on your use case.

Documentation

Files

Organization Structure API

Core HR API

Cleemy Expenses API

Cleemy Invoices API

Timmi Absences API

Timmi Office API

Timmi Project API

Timmi Settings API

Timmi Timesheet API

Pagga Mealvouchers API

Pagga Remuneration API

Poplee Training API

Get a TimeEntry by id

Headers

Path Parameters

Response