v1

latestOpenAPI 3.1.0Apache 2.02026-07-22160175414.0 KB
Workflow

Approve a timesheet

Approve once the timesheet referenced by its ID, and any timesheets before it pending approval belonging to the same timesheet owner.

For example, if timesheets of ownerid=123 of April 2024 (id=1), May 2024 (id=2), and June 2024 (id=3) are pending approval, and you approve the timesheet id=2 : both April 2024 and May 2024 timesheets will be approved once, and the June 2024 timesheet will be untouched.

Approbation can only be performed with a pending status, and it only performs a single approbation step for each timesheet. If a timesheet require several manual approbation steps, the endpoint must be called several times.

<Info> If you want to edit the original Transfer, send a new Transfer with the new duration. To cancel a transfer, send a Transfer with a duration of `PT0S`. To keep the same original transfer, send an empty array. </Info>
post/timmi-timesheet/api/timesheets/{id}/approve

Request body

Example request

{
  "transfers": [
    {
      "amount": {
        "iso": "PT7H30M"
      }
    }
  ]
}

Response

OK

idinteger

Unique id of the WorkflowItem.

exceptionMessagestring

Any human readable error message.

startsOnstring date

The Timesheet the WorkflowItem is related on starting date (included).

endsOnstring date

The Timesheet the WorkflowItem is related on ending date (excluded).

expectedNextActorobject

A Directory 'User'. See API reference for up-to-date attributes.

statusstring
  • "success" for a succesfull workflow operation.
  • "error" if any error was met, and therefore an excetion message is set.
  • "noAction" if the workflow operation was not performed.