Timesheets
Timesheet lifecycle, statuses, entries, review, approval, and calculations.
Timesheets
Timesheets are the central workflow object. Each timesheet is a weekly envelope owned by a user and project. Each entry records a day or work segment.
Status lifecycle
TimesheetStatus values:
| Status | Meaning |
|---|---|
draft | Editable by electrician owner. Not recalculated into allowance/award output by the subscribers. |
submitted | Sent for supervisor review. Eligible for allowance and award recalculation. |
accepted | Accepted by supervisor. Eligible for payroll/client approval and recalculation. |
approved | Approved by payroll or client admin. Eligible for invoice/Xero flows and recalculation. |
rejected | Returned for correction. Electrician owner can edit. |
TimeEntryStatus values are draft, submitted, approved, and rejected.
Entry payload
Entries hold the operational detail:
datestartTimeendTimejobCodecostCodevehicleTypeshiftWorkdescriptionmaterialInStockallowancesmaterialsworkConditions
The browser portal and API v2 normalize these into TimeEntry records. Mobile API docs describe the V2 entries[] shape and require cost codes to match the selected project client cost-code list.
Calculation dependency
Timesheets have three separate calculation-related children:
TimesheetAllowanceLinefor allowance matrix results.TimesheetCalculationfor award preview/application snapshots.TimesheetRiskAssessmentfor risk scoring output.
This means a submitted timesheet is not only an input record. It is also the root for derived payroll, invoice, allowance, risk, and audit data.
Review and approval surfaces
| Surface | Responsibilities |
|---|---|
| Electrician portal/API | Create/update draft/rejected timesheets, submit work. |
| Supervisor portal/API | Review submitted work, accept/reject, sign approval sheets, edit allowed code fields. |
| Payroll portal | Review accepted work, approve/reject, view award calculation, pay summary, reports. |
| Client portal/Admin client management | Client-scoped timesheet creation/edit/review and approvals where allowed. |
| Finance portal | Review finance-scoped timesheets and invoice-related cost-code adjustments. |
Locking and audit
TimesheetEditPolicy prevents broad edits after submission/approval except for role-specific code/signature/location/status fields. TimesheetChangeLogger records field-level old/new values, labels, role, actor, and timestamp.