Saltar al contenido

timeEntries

Módulo Crew · 4 operaciones

List time entry rows

GET/time-entries

A time entry. Entries cannot overlap for one person; forgotten clock-outs close at 16 hours and are flagged. Returns a cursor page of time entry rows the caller may see. The default order is `clock_in` ascending. Supports sparse fieldsets and the filter grammar.

Get a time entry

GET/time-entries/{id}

A time entry. Entries cannot overlap for one person; forgotten clock-outs close at 16 hours and are flagged. Returns one time entry with its `ETag`. A time entry the caller may not see returns 404.

Clock in

POST/time-entries/clock-in

Opens a time entry inside the shift geofence. Protects against double clock-in across devices; an overlapping entry is refused. Compass replays queued punches with the same Idempotency-Key. Requires `Idempotency-Key`; a replay returns the original response. A rule that refuses the request returns 422 with `refusal` and `reason`.

Clock out

POST/time-entries/{id}/clock-out

Closes the open time entry. Forgotten clock-outs close automatically at 16 hours and are flagged. Requires `Idempotency-Key`; a replay returns the original response. A rule that refuses the request returns 422 with `refusal` and `reason`.