Create a job
Set up a new job on one screen, from customer and site to schedule, crew and safety documents, then check it and create it.
On this pageBefore you start
A job starts with its customer, then the work, the schedule and crew, and any safety documents or photos.
Before you start
- Only the owner, admins, dispatchers, office staff and site supervisors can create a job.
- Add the customer first if they are not already in ONYX1. The owner, admins, dispatchers and office staff can also add a new customer or a new site from this form. Site supervisors choose from the customers and sites that already exist.
- If you are creating a field or subcontractor job and Require the pre-work safety pack on new jobs is turned on in Settings → Security, you need the SSSP and rescue plan ready to upload before you can save. See Job safety documents and owner approval.
How the screen is laid out
On a laptop or desktop, every section is on screen at once and the page fits the window. The form scrolls inside its own panel, while the Ready check, the Will be card, Create job, Save draft and Cancel stay in view on the right. On a narrower tablet every section still shows, but those cards and buttons sit below the form.
On a phone, the form is three steps and then a review. Select Next: the work, Next: crew and safety and Next: check and create to move on. The left button at the top is Cancel on the first step and ‹ Back after that. The review shows summaries under CUSTOMER AND SITE, THE WORK and CREW AND SAFETY. Select Edit beside a section to return to its step. Create job is on the review step. The Go or Enter key on your phone's keyboard never creates the job before the review: it moves to the next step, the same as Next, or does nothing while a required safety pack is incomplete.
Job type
The new job form has a Job type with four choices for owners, admins, dispatchers and office staff. Site supervisors see the first three only:
- Field job is the default. It is work on site, and it follows the company's safety settings.
- Office job, such as admin work.
- Training job, such as a first aid course.
- Subcontractor job, for work assigned to a subcontractor company.
Field and subcontractor jobs follow the company's safety settings: the pre-work safety pack and owner approval of safety documents. An office or training job needs no safety documents, whatever those settings are and whoever creates it. When you choose Office job or Training job, the form hides the safety pack and the safety document upload, and the job can be scheduled straight away without an accepted quote or estimate. An office or training job also finishes at Completed: it never moves to Ready to invoice. See Job statuses.
For a subcontractor job, choose a subcontractor and set the Subcontract scope to All of job or Part of job. The optional Worker count is a whole number from 1 to 999. The site contact is filled from the subcontractor's main contact, and you can edit it for this job. Choose an On Ropes contact as the team leader. Extra crew are optional. You can create the job in New and give it dates while the agreement is missing. It stays in New until the subcontractor has a signed agreement on the current company version, and cannot move to another working status before then. If insurance is missing or expired, or prequalification has expired, an owner or admin must record an insurance override reason before the job can leave New. The status message says, "An owner or admin must record an insurance override reason before this job can leave New." A missing, unsigned or old-version agreement has no override; its status message says, "A current signed subcontractor agreement is required before this job can leave New." See Manage subcontractors.
Business roles can change the job type and subcontractor details from the Edit tab while the job is open. Site supervisors can change a New job between Field, Office and Training from its Overview, but cannot change it to or from Subcontractor. Changes to a booked job's type are limited to owner/admin Field-to-Subcontractor or Subcontractor-to-Field changes. Agreement and insurance checks still apply before a Subcontractor job can leave New.
Public or private
Owners, admins, dispatchers and office staff see a Private job switch under Job type. Leave it off and the job is public: every technician and contractor can see it while it is open, and can join its crew by clocking in on it. Switch it on to keep the job to the people you assign, plus the owner, admins, dispatchers, office staff and site supervisors. On the web, a private job shows a lock and a Private label. See Roles and permissions.
Create the job
- Select New job at the top of the screen. On a phone it is the + button.
- Under Customer and site, select the Customer, type part of the customer's name into Search customers or scroll the full list, then select a match. The search matches any part of the name and ignores capitalisation. Select a Site, or leave No site. To add one on the spot, choose + Add a new site… (this needs a customer selected first).
- Add a Site contact name and Site contact mobile if there is someone to ask for on site.
- If you are the owner or an admin, you can enter the customer's Customer PO. Other roles do not see this field. The owner or an admin can add the PO on the job instead.
- If Site reports are turned on for your business and your role can see customer contacts, Send site reports to lists the customer's contacts. Until you select a name, the job follows the customer's own report settings. Select names to choose exactly who gets this job's reports, or select Use the customer’s settings to go back.
- Under The work, enter the Job title.
- If you are the owner, an admin, a dispatcher or office staff, From quote appears once you have chosen a customer. It lists that customer's accepted quotes and estimates that are not yet linked to a job. Choosing one links it to the job and fills in the title and Scope of works if you have left them blank. It never overwrites what you typed. If the customer has no accepted quotes or estimates, the field says No accepted quotes for this customer. and stays switched off. Site supervisors do not see From quote.
- Set the Priority (Low, Medium or High) and, if you use them, a Work category. Add a Description and a Scope of works if you want the crew to see what work is planned. The crew reads the scope of works, so write it for them.
- Under Schedule and crew, set a Start date, a Start time and, for multi-day work, a Finish date. The start time is available once you have set a start date. A finish date needs a start date and cannot be before it: the Ready check flags it, and ONYX1 refuses the save. This is the date the crew is on it, not a deadline: the dashboard, the crew's field day, the calendar and the Planner all key off it. The start time is 7:30 am unless you change it. Set a Due date if there is a deadline.
- Tick who is on the job under Crew. Once you have set a start date, the busy hint checks up to the first 62 days from that date. Anyone already booked on another job on those days shows busy with the days. This is a hint, and you can still add them.
- Choose a Team leader from the crew you ticked (the field is switched off until you tick someone). The team leader runs the site reports. Set a Follow-up date if you want a reminder to check in after the job.
- Under Photos from the site visit, add up to three photos if you have them already, for example a reference photo from the customer. ONYX1 checks each file's image bytes, not only its filename or MIME label, before adding it.
- Select Create job.
The Ready check and Will be
The Ready check lists what the job has and what it is missing, as you fill the form in. Items such as Customer needed, Job title needed, Team leader isn’t on the crew, Subcontractor needed, On Ropes contact needed, Needed: Signed subcontractor agreement, Finish date needs a start or Finish is before the start are problems. If you select Create job with a problem that prevents saving, ONYX1 shows a message and keeps everything you entered. A missing current agreement is a special case: with a start date, Needed: Signed subcontractor agreement is shown as blocked and Will be says Can’t create yet, but Create job remains enabled. Selecting it creates the job in New and keeps its dates. It stays in New until the agreement is current. Other items, such as No scope yet or No crew yet, are reminders: you can still create the job and add them later. Only a required safety pack switches Create job off until it is complete.
Will be shows the status the job will land in and a one-line summary, for example "3 crew, 10 to 12 Nov · reports follow the customer’s settings". While the Ready check lists a problem, Will be can say Can’t create yet even when the enabled Create job button can still create a subcontractor job in New. A job with a start date moves to Scheduled, except in these cases:
- The job is a field or subcontractor job, safety document approval is on, and the SSSP and rescue plan are not both added and approved. The job stays in New with its dates saved. The Ready check says SSSP still needed, Rescue plan still needed or Waiting for owner approval. If you are the owner and add both documents, they are approved as you create the job. See Job safety documents and owner approval.
- The subcontractor job has a missing or old-version agreement, or has an insurance/prequalification warning without an owner or admin override. The job stays in New with its dates saved. The agreement must be signed on the current company version; insurance warnings need an owner or admin to record an insurance override reason. The agreement has no override. See Manage subcontractors.
- Jobs can't be scheduled until the client accepts the quote is on in Settings → Security, the job is a field or subcontractor job, and it has no accepted quote or estimate. It cannot be booked until it has an accepted quote or estimate, so ONYX1 creates it in New without its start and finish dates, and the Job created notice says so. The Ready check says No accepted quote, and Will be shows "no date yet". Choose an accepted quote or estimate under From quote (owner, admin, dispatcher and office staff) before you create the job. Or create it now, then link an accepted quote or estimate and set the dates on the job.
Save a draft, and what is kept on this device
On a laptop or desktop, Save draft saves what you have entered as a draft job in Jobs, Drafts, with its own job number, such as JOB-0158. It keeps the customer, site, site contact, job title, scope, Description, the photos you added, your Follow-up date and your Start and Finish dates, which become the draft's rough dates, not a booking. The crew, safety documents and the rest are chosen when you turn the draft into a job. You must select a customer first. If Job title is empty, ONYX1 gives the draft a date title such as Draft · 8 Oct. You can edit the draft details later in Jobs, Drafts. Only the owner, admins, dispatchers and office staff can save a draft. Saving a draft does not create a job: Create job still requires a customer and job title. A phone has no Save draft button on this form.
Once the draft exists, photos successfully saved on this device are queued for upload. If your connection drops, they remain queued and upload when ONYX1 can connect again. For photo statuses, retry steps and how to turn a draft into a job, see Capture a draft job after a site visit.
Separately, ONYX1 keeps a recovery copy of the form on this device only, a moment after you stop typing, in case the page closes before you finish. On a laptop or desktop, the time it was last kept shows at the top right (Autosaved). If you leave and come back, the form shows Restored what you were typing from the time it was kept, with your entries back in place. Select Start again to clear it and begin with a blank form.
The recovery copy is cleared when you create the job, save a draft or select Cancel. A refused save does not clear it. It does not keep photos or safety documents you had added, and the safety confirmations (SSSP created? and Rescue plan in place?) come back unticked: add and confirm those again. It belongs to you, on this device, so it does not appear on another computer or phone.
Make it recurring
For any job type, tick Make this a recurring job under The work and choose how often it Repeats (Weekly, Fortnightly, Monthly, Quarterly, 6-monthly or Yearly). For a Subcontractor job, select the company and scope, set an optional worker count, choose the On Ropes contact and any extra crew. The job you are creating becomes the first occurrence; ONYX1 saves a template with the job type and subcontractor details and creates the next occurrence in New each period. See Recurring jobs to manage or generate templates directly.
The pre-work safety pack
When you create a field or subcontractor job and Require the pre-work safety pack on new jobs is on, a Pre-work safety pack (required) section appears under Safety pack and photos. You must tick SSSP created? and upload the SSSP PDF, tick Rescue plan in place? and upload the rescue plan PDF, and answer WorkSafe notification submitted? before Create job is enabled. See Job safety documents and owner approval for what happens to these documents afterwards.
On a field or subcontractor job where the pack is off but owner approval of safety documents is on, the same section offers optional SSSP and Rescue plan uploads. You can create the job without them, and it stays in New until the owner approves both. If you are the owner and add both, they are approved as you create the job.
If something goes wrong
- Enter a job title. The title is required.
- Pick a customer. The customer is required.
- Add a start date, or clear the finish date. / The finish date must be on or after the start date. A finish date needs a start, and cannot come before it.
- The team leader must be one of the assigned crew. Tick them under Crew, or choose another leader.
- The SSSP upload didn’t complete. Upload the PDF again. / The rescue-plan upload didn’t complete. Upload the PDF again. The file didn’t finish uploading before you saved. Upload it again.
- You’re offline. Connect to create this job. Creating a job needs a signal. The job was not created. Everything you entered stays in the form, including photos and safety documents you added. Select Create job again once you have a signal.
- Couldn’t load this customer’s contacts and quotes. ONYX1 could not fetch them, for example because the signal dropped, so Send site reports to and From quote are missing. Select Try again.
A missing customer or title is refused when you select Create job, with the message beside the button. On a phone the message shows on the review step: select Edit next to that part, fix it, and come back to the review. A refused save keeps everything you entered, so fix the one problem and select Create job again. The message goes away as soon as you change a field.
What happens next
When the job is created without any follow-up notices, ONYX1 takes you to the Jobs hub's List view.
Some details may need follow-up after the job exists. A Job created notice lists each thing that was left out, one per line, with the reason: for example the customer PO, the quote link, the team leader, or start and finish dates that were not saved. ONYX1 opens the job page so you can fix each one there; the notice stays until you close it. If ONYX1 cannot add a checked photo to this device's upload queue, it opens the job page with a Photo not saved or Photos not saved notice, listing each file and its reason so you can add it there. ONYX1 explains an unsupported photo type or a photo beyond the three-photo limit on the form when it checks the selection before you save. If a file is still waiting in the photo picker when you save, its reason appears in a photo notice after the job is created. If a photo is refused later, while it uploads, see Work without signal.
From the job page you can change its status, reschedule it, or reassign crew: see Job statuses and Schedule jobs and assign crew. To see it alongside every other job, open The Jobs hub and its views.
