Submit timesheets

Submit all timesheets for an owner up to the given period, or to the last submittable timesheet.

The response contains all affected timesheets, with a feedback about each item’s status, subsequent to the submission action :

success when the timesheet is submitted successfully.
noAction if the timesheet has already been submitted.
error in case of an error.

Timesheets are created and their status are set to submitted. In some cases, timesheets may then be automatically approved, depending on the approval workflow settings.

Once submitted, all timeentries on the period for that user can no longer be modified. In order to be able to modify them, the timesheet must first be rejected through cancel, deny or invalidate operations (depends on the current timesheet status).

If you have set up account transfer authorizations in Timmi Timesheet, and need to adjust them before submitting timesheets, only the timesheet containing itself the startsAt date you set will be associated with the Transfer provided (i.e. the last timesheet).

If you need to handle account transfer authorizations, we strongly suggest to do as many requests as there are timesheets to submit for a given owner, in chronological order, so that you can provide each timesheet its corresponding Transfer.

Please see this guide on how to submit Timesheets the right way.

POST

timmi-timesheet

api

timesheets

submit

curl --request POST \
  --url https://{host}/timmi-timesheet/api/timesheets/submit \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{
  "ownerId": 90,
  "startsAt": "2024-05-06T00:00:00",
  "endsAt": "2024-05-13T00:00:00",
  "transfers": []
}'

[
  {
    "id": 123,
    "exceptionMessage": "<string>",
    "startsOn": "2023-12-25",
    "endsOn": "2023-12-25",
    "expectedNextActor": {},
    "status": "<string>"
  }
]

Headers

Authorization

string

required

API key. Value must be formatted like so: lucca application={api_key}.

Body

application/json

The body is of type object.

Response

200

application/json

The response is of type object[].

The transfer object

Approve a timesheet

curl --request POST \
  --url https://{host}/timmi-timesheet/api/timesheets/submit \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{
  "ownerId": 90,
  "startsAt": "2024-05-06T00:00:00",
  "endsAt": "2024-05-13T00:00:00",
  "transfers": []
}'

[
  {
    "id": 123,
    "exceptionMessage": "<string>",
    "startsOn": "2023-12-25",
    "endsOn": "2023-12-25",
    "expectedNextActor": {},
    "status": "<string>"
  }
]