Skip to content

Approve and send site reports

Review a submitted site report, approve or send it back, and see how the nightly send works.

For ownersLast reviewed
On this pageFind reports waiting on you

A submitted report from a kind that requires approval waits for the owner or an admin to decide before it can be sent. Pre-Start, Permit to work and End of Day reports usually need this; whether a kind needs it is set on its template.

Find reports waiting on you

Open Approvals and select the Reports tab. It works like an inbox. The queue is on the left, oldest first, and the report you have selected is on the right, so you can decide a report without leaving the page. The number beside Reports to approve counts every report waiting. When there is more than one page, use Previous and Next below the queue to browse it. On a computer, you can also select a page number.

  • The type buttons above the queue (Pre-Start, Permit to Work, End of Day and so on) filter the page currently shown, and their counts cover that page. Select All and browse the pages to find every report of a kind. The sort button reverses the order within the current page; pages themselves are ordered oldest first.
  • Each row shows the report kind, the job, the team leader and when it was filed, how many of the crew who were on site when it was handed in have signed, for example 2 of 3 (when the form asks for crew signatures), and how long it has been waiting. If anyone is still to sign, their names appear below the job title.
  • The selected report shows the job, the site address, the team leader, who has signed, whether the customer will be emailed once it is approved, every answer, the photos and the signatures. Select a photo to enlarge it. On a computer, PDF opens the report as a PDF.
  • Open full job is the only link that takes you away from the page. Use it when you want the whole job.

On a phone, the queue is the page and there is no PDF button. Select a report to open it full screen, use the up and down arrows to move to the previous or next report, and use Reports to go back. Approve and Send back stay pinned at the bottom.

Approve or send back

Use the buttons at the bottom of the selected report:

  • Select Approve to accept the report when everyone on the report-day on-site signature roster has signed. The roster counts active crew who clocked in on that job on the report day, including someone who clocked in after the report was handed in. If anyone on site is still to sign, enter a reason and select Approve anyway to record the override. Active people assigned for that day who did not clock in appear separately as Also assigned, not on site; they do not block approval. Outside people on the day, such as contractors from other companies, count the same way and are named with their company, for example "John Smith (Acme, outside contractor)". See Outside people on site. The business report review area shows the names and reason. No more signatures can be added while the report is approved. To wait for the crew, select Send back with the quick reason Crew still to sign.
  • Select Send back to return the report to the team leader for correction. Enter a reason, which they'll see, then select Send back to the team leader's first name. The reason is required. The quick reasons (A photo is missing, Crew still to sign, More detail needed and Wrong job or date) add a sentence for you.

After you decide, the next report opens by itself, and a line under the queue says what you did.

You can't approve your own report: if you filed it, the report says so and someone else on the owner or admin roster needs to decide it. A report whose kind doesn't need approval doesn't appear in the queue.

Approve a client's own document

Some reports are the client's own pre-start or permit, filed as photos or a PDF. They are marked Client document, with the client's reference when there is one. They always need a manager's approval, whatever the template says.

Select one in the queue and its pages (or the PDF) appear above the buttons, with the version, who filed it, any note and the earlier versions. Read the pages, then select Approve or Send back. ONYX1 approves the version you are looking at. If the person who filed it replaces the file while you have it open, the approval is refused with "The document was replaced. Open it again to see the new pages." Open it again and approve the new version.

  • There is no crew signature step: the sign-offs are on the client's own form.
  • A client document is never ticked for Approve several at once; the box is greyed out with "Open this client document to review its pages before approving." You also cannot approve one from a notification, the job card or the report viewer: those link you to Approvals instead.
  • You cannot approve a document you filed, or one you uploaded any version of.
  • On iPhone, approving a client document is in the next app update. On an older version of the app, open it on the web.

Approve several at once

Tick the box beside each report you want to approve, or select Select all to tick every report currently showing, then select Approve N in the bar that appears. A sheet lists what you ticked (the kind, the job and the team leader); select Approve N again to confirm.

Each report is approved the same way as pressing Approve on its own panel. A report with anyone still to sign has no box: bulk approve never uses Approve anyway on your behalf. Wait for the signatures or open the report and enter a reason to approve it anyway. A report you filed has no box either. 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: Send back still needs you to open the report and give a reason.

Keyboard shortcuts

On a computer, these work while you are not typing in a box:

  • J moves to the next report and K to the previous one.
  • A approves the report you have selected. It does nothing until you select one, so the report that is open when the page loads is never approved by accident. If anyone is still to sign, use the reason field and Approve anyway button instead. After you decide a report, the next one that opens counts as selected.
  • S opens Send back.

You can also decide a report from Site reports: select it in the list and a report waiting on approval shows the same signature names, Approve or Approve anyway, and Send back controls beside its PDF.

Reopen an approved report

An owner or admin can reopen an approved report for signatures if it has not been sent. Select Reopen for signatures and enter a reason. The approval is cleared, the report returns to the submitted queue, and the team leader is notified. Crew members who still need to sign receive an in-app and push notification with a link to the job. Existing signatures stay on the report. Once everyone has signed, approve it again. A report that has been sent cannot be reopened.

An approved client document that has not been sent can be reopened the same way. The reason goes to the person who filed it, the report returns to submitted, and they add a new version for you to approve.

Review from an email

The "ready to review" email's Review it link opens the report in ONYX1's own PDF viewer, with the same Approve and Send back controls, so you can decide it without hunting for the job.

The nightly send

Each evening, ONYX1 emails that day's reports to the customer where the template has that switched on, and marks them sent. A report that needs approval isn't sent until it's approved; other kinds go out once submitted. See site report templates for the settings that decide this per kind.

If something goes wrong

  • Nothing to approve. No submitted report that requires approval is waiting for a decision. Reports whose templates do not require approval do not appear in this queue.
  • Approve and Send back are missing. You filed the report yourself, it has already been decided, or its kind doesn't need approval. In Approvals → Reports the report says which; on Site reports the buttons are simply not shown.