Job statuses
What each of the eight job statuses means, who can set which one, and how a job moves between them.
On this pageThe eight statuses
A job moves through eight statuses. New, Scheduled, On site, Pending and Incomplete are working states. Completed marks finished work. Ready to invoice and Invoiced are billing states with their own rules. Paid is an invoice milestone shown on the lifecycle, not a ninth job status.
The eight statuses
- New: created and not yet Scheduled. A safety-held job or a subcontractor job with an agreement or insurance hold can keep dates while it stays in New.
- Scheduled: has a booked start date.
- On site: the crew is on it.
- Pending: waiting on something, for example parts. (Internally called
awaiting_parts.) - Incomplete: started but not finished.
- Completed: the work is done.
- Ready to invoice: cleared for billing.
- Invoiced: an invoice has been raised against it.
Moving between them
The owner, admins, dispatchers, office staff and site supervisors can move an open job between the working states. Technicians and contractors cannot change a job's status directly.
Completed is finished. On a field or subcontractor job, eligible office users can move it forward to Ready to invoice. The job's schedule, crew, team leader, projected start and report-start controls are read-only while it is finished.
Office and training jobs finish at Completed. They are not billed through the status buttons: ONYX1 does not offer Ready to invoice for them, on the web or in the iPhone app, and refuses that status change if it is tried another way. Sending an invoice for one still marks it Invoiced, as for any job. If an office or training job is already in Ready to invoice, open More, select Reopen job to put it back on On site, then select Completed.
Ready to invoice and Invoiced are different:
- A field or subcontractor job can only reach Ready to invoice from Completed, and only the owner, admins, dispatchers and office staff can move it there. Site supervisors cannot, even though they can move a job through every other status.
- If the job requires the customer's sign-off and none has been captured yet, moving it to Ready to invoice is blocked until the sign-off is recorded.
- Invoiced is normally reached by raising an invoice against a Ready to invoice job, which ONYX1 does automatically. A job that already has an invoice can be marked invoiced by hand instead (see below).
- To make a finished job editable again, open More in the job header. Reopen job moves a Completed or Ready to invoice job to On site. Reopen to Ready to invoice is available for an Invoiced job only when it has no live invoice. The invoice must have been voided, and the job needs invoicing again.
- A job cannot move to Scheduled without a booked start date: ONYX1 shows Book a start date before moving this job to Scheduled.
- A subcontractor job can keep its dates while it stays in New. A missing or old-version agreement keeps it in New until the agreement is signed on the current company version; the status message says, "A current signed subcontractor agreement is required before this job can leave New." Missing or expired insurance, or expired prequalification, keeps it in New until an owner or admin records an insurance override reason; its status message says, "An owner or admin must record an insurance override reason before this job can leave New." The agreement requirement has no override. See Manage subcontractors.
Sometimes a job reaches Ready to invoice when it already has an invoice, for example because it was reopened and finished again. You do not need to raise a second invoice. When the job has at least one sent or paid invoice, the owner, admins, dispatchers and office staff see Mark as invoiced beside Raise invoice in the job header. Selecting it moves the job to Invoiced using the existing invoice. It does not appear when the job's only invoices are drafts or voided. For a draft, select Mark as sent on the invoice instead, which moves the job to Invoiced by itself.
Clocking in on a Scheduled, Pending or Incomplete job moves it to On site automatically. It moves back to whatever it was before once the crew lead files that job's End-of-Day report for the day, unless someone has since changed it by hand. It also stays On site if its schedule date has been cleared since, or if it needs an owner's safety-document approval that hasn't happened yet.
For an unarchived On site job that was clocked in by mistake and should still be Scheduled, select Move back to Scheduled in the job page's status controls. The job needs a booked start date and any required owner safety-document approval must be clear. Owners, admins, dispatchers and office staff can see the status change in History. It does not change or delete time entries; make any available time-entry edits separately in Your timesheet.
On the job page
The job header shows one inline lifecycle track: Quoted, Scheduled, On site, Completed, Invoiced and Paid. On the web, an office or training job's track ends at Completed unless it is already in Ready to invoice or Invoiced. On site includes the current progress percentage. Pending and Incomplete remain real job statuses, while the track keeps them at the On site point. The primary next move is shown beside the header when your role has one to make; it's left out rather than shown as unavailable. On a Ready to invoice job, office roles see Raise invoice there instead (and Mark as invoiced when the job already has a sent or paid invoice), and finished-job recovery is under More. Work contains the Schedule and crew summary instead of a second lifecycle control.
To see every job by status at a glance, open The Jobs hub and its views.
