Skip to content

The Approvals hub

One place for everything waiting on a decision: variations, timesheets, leave, purchases, equipment, reports, photos and safety documents.

For owners, office staff and crewLast reviewed
On this pageOn an iPhone

Approvals gathers everything in the business waiting on a decision. What you see depends on your role: an approver gets a decision queue, everyone else gets My requests, showing what they raised and where it sits.

Tabs run across the top of the page, one for each queue you can open: Requests, Reports, Photos, Safety documents and Receipts (and Xero invoices where your business uses that queue). A number appears on a tab when something is waiting in it. A line above the page title, N waiting on you, adds them up.

On an iPhone

The ONYX1 approvals widget is available to owners, admins, dispatchers and office staff. It shows the pending count, counts by request kind, the oldest request age and up to three safe top-item labels. Each label contains only the allowlisted approval kind (for example, Variation, Purchase request or Timesheet) and, when the request belongs to a job, its job number. It never includes descriptions, customer names, addresses or phone numbers. Phase A does not put request amounts or customer detail in the widget. It is read-only; tap it to open Approvals at /approvals.

The footer says Updated h:mm am/pm in New Zealand time, for example Updated 3:30 pm. If it says the queue is stale, open ONYX1 before relying on it. A signed-out or unauthorized person sees Open ONYX1 to sign in instead of the queue.

Requests

The Requests tab lists variations, timesheets, leave, purchases and equipment requests together, with tabs to filter by type. Every row names who raised it.

If you approve requests, each row offers:

  • Approve, for everything except a timesheet, which instead offers Review and opens the full week, since a week's pay needs more than one line to decide.
  • Decline, which asks for a reason. The reason is required for variations, timesheets, leave, job purchases, general purchases and equipment requests.
  • Need detail, on a variation, purchase or general purchase request, which sends the request back to whoever raised it with your question attached, until they answer.
  • Ask, to add a note without deciding anything yet.

If you raised a request, your row shows where it stands: waiting, needs your detail (select Add detail to answer and send it back), or its final decision. If nothing is waiting on you, the page says so; if your business has timesheets nobody has submitted yet for the period that just closed, it names them here instead of saying everything is clear.

When a variation, job purchase or general purchase is declined, its in-app notification and decision email include the reason.

An email about extra work does not approve a variation or authorise work. A variation proposal needs a person with variation review permission to decide it in Approvals. See Variations and purchase orders for who can review a variation.

Approve several at once

Tick the box on each request you want to approve, or select Select all to tick every request currently on screen, then select Approve N in the bar that appears. A sheet lists what you ticked (what it is, who asked, and the amount where there is one); select Approve N again to confirm.

Each request is approved the same way as pressing Approve on its own row, so the same rules apply: a timesheet has no box, because a week's pay still needs the full Review screen; your own request has no box either, with a note explaining why. If anything changed since you ticked it, such as someone else already deciding it, that one stays in the list with its own reason and the rest still go through. Bulk approve only approves: declining, asking for more detail and marking a general purchase Not bought still need you to open the request and give a reason.

Receipts

The Receipts tab is for owners, admins, dispatchers and office staff. It lists approved job purchases that still have no receipt after at least three days. Purchases on archived jobs are excluded. The oldest comes first, 25 to a page, with Previous and Next under the list when there is more than one page. The number on the tab and Home's Needs you count use the same purchases.

Each row shows the item, job, supplier if one was entered, who raised it, the approval date, how long it has waited, the estimated cost and Open job. Select the row to open its receipt drawer. The drawer shows the item, supplier, estimate, job, who raised it and who approved it. If the purchase was approved automatically under the approval threshold, it says Automatically approved.

In the drawer, use Attach receipt, enter the receipt total, add a photo if you have one, then select Save receipt. From the job page, the person who raised an approved purchase can also attach its receipt. Owners, admins, dispatchers and office staff can attach it or select Mark as not bought. To close one that was never bought, enter an optional reason and select Close as not bought. Either action removes it from the list.

Select Open job to go to Materials & receipts on the job's Work tab. That card remains available on completed jobs unless they are archived. Home shows the same purchases under Needs you as N purchases need a receipt. On a wide screen, select Open on that row; on a phone, select the row. Either opens this tab. When only one purchase is outstanding, Home names it instead (Receipt needed, then what was bought) and goes straight to its job. When nothing is outstanding, the tab says All caught up and No purchases are waiting for a receipt.

Note

Purchases on archived jobs are excluded from the Receipts list and count. A completed job that has not been archived still has Materials & receipts, so its receipt can be added without reopening the job. The requester can add their receipt there; owners, admins, dispatchers and office staff can also attach it or close it as not bought.

General purchases

The General purchases tab is for requests that are not tied to a job or equipment. It is separate from job material purchases. The owner is the only person who can approve, decline, request more detail, or mark one Not bought.

Use the category buttons under the tab to filter Training/course, Subscription, Office, Tools and equipment, Travel, or Other. The row also shows who raised the request, who it is for, and the needed-by date.

The person who raised a request can open it from My requests. The employee it is for can also see the request, its costs, and its files. Once the owner approves it, the requester or a business role can add the receipt and actual cost. The request changes to Bought only when both are saved.

Reports to approve

Only the owner or admins see the Reports tab, and only when your workspace has the Site reports module. It works like an inbox: the queue of submitted reports is on the left and the selected report, with its answers, photos and signatures, is on the right. Approve it or send it back from the bottom of the page, and the next report opens. Names appear when crew signatures are missing. To approve anyway, enter a reason; bulk approval skips reports still waiting on signatures. An owner or admin can reopen an approved report for signatures if it has not been sent, with a reason. You can also tick several reports in the queue and approve them together; see Approve and send site reports for the buttons, bulk approve and the keyboard shortcuts.

A report can also be the client's own pre-start or permit, filed as photos or a PDF. It is marked Client document, shows its pages above the Approve button, and is approved one at a time: it is left out of bulk approval. See Approve and send site reports.

Photos to check

Business roles and site supervisors see the Photos tab: photos already saved on a job whose files carry no information about where or when they were taken, so only someone who knows the job can judge them. Select Looks right to clear one, or Remove photo to take it down; Select all on this page clears a whole page of clean photos at once.

Safety documents

Only the owner sees the Safety documents tab, and only jobs waiting on an approval decision appear here. See Job safety documents and owner approval for how to approve, request changes, or turn on the setting that puts jobs here in the first place.