Skip to content

Write and send a quote or estimate

Build a quote or estimate, send it to the customer, and track it through to accepted, declined or converted.

For office staffLast reviewed
On this pageBefore you start

A quote or estimate is a priced document you send a customer before you invoice the job. Quotes and estimates share the same screens; choose which one you are writing when you start it.

Before you start

  • Only the owner, admins, dispatchers and office staff can create, edit or send quotes and estimates. Techs and contractors have no access to this money-facing area at all.
  • Emailing a quote or estimate to a customer is one step tighter: only the owner and admins can do it.

On an iPhone

Owners, admins, dispatchers and office staff can add the ONYX1 quotes widget. In phase A it shows the count of cold sent quotes and the age of the oldest one only. It does not show quote amounts, customer names or quote notes. Tap it to open Sales → Quotes at /sales?tab=quotes.

The widget is read-only and shows Updated h:mm am/pm in New Zealand time. If it is stale, open ONYX1 before relying on the count. Techs, contractors and site supervisors do not receive it.

Write a quote or estimate

  1. Open Sales and select the Quotes or Estimates tab, then select New quote or New estimate.
  2. Choose Document (Quote or Estimate). For a standalone quote, select the Customer, then type part of the name into Search customers or scroll the full list. Starting from a job locks the quote to that job's customer and links it to the job.
  3. Enter a Job summary title and, if useful, a Job description: the scope of works the customer sees. Add their own Customer reference if they gave you a PO or job number.
  4. Add each line item (on a wide screen they sit beside the other details).
  5. Choose the GST treatment, under the line items: Prices exclude GST (add 15%), Prices include GST (inclusive), or Zero-rated (no GST). Use Prices include GST when your entered prices already include GST. Use Zero-rated (no GST) only when the supply is zero-rated.
  6. Add any Notes, then select Create quote or Create estimate. The button stays at the bottom of the screen however many lines you add.

If the quote is linked to a job, the linked job number appears in the quote screen. Quotes link to jobs, not directly to leads. If you are preparing a quote for work still tracked as a lead, open the lead details and copy its number for reference.

A quote or estimate can only be edited while it is a draft. Select More, then Edit to change it, and Save changes once you have.

Select Download PDF to open the quote or estimate PDF for printing. In the released Android app, the same icon opens the device share sheet.

Find and open quotes

Open Sales and select Quotes or Estimates. At the top, Waiting on the customer shows sent quotes with no answer and their value excluding GST. When there are cold quotes, Going cold appears in amber. Accepted, last 30 days shows accepted quotes and how many are not on a job yet. Win rate, last 90 days shows accepted quotes as a share of all quotes accepted or declined in that time. Each figure with a list behind it is a shortcut to it.

The accepted and declined counts use the day the quote was answered, whether the customer answered online or someone on your team recorded the answer. Linking a job later does not change that day. A reopened quote drops out until it is accepted or declined again. For a quote from Xero, the day is when the quote last changed in Xero at the time ONYX1 picked up the answer.

The filters are All, Draft, Sent, Going cold, Accepted and Declined. When some quotes are waiting for a job, a Not on a job filter appears too. Its count follows your search, so it is hidden when your search matches none of those quotes, unless you have it selected, when it stays with a count of 0. It shows accepted quotes that no job carries yet. Owners and admins also see here the quotes that came from Xero and are waiting for a job decision. Accepted, last 30 days counts New Zealand calendar days (today and the 29 before it), and the win rate counts the 90 days that end today in the same way. Search finds a quote by its number as printed (for example QU-0145), customer, reference or title. A quote that came from Xero prints its Xero number, so search for that. Owners and admins also see Archived, with the count, once something has been archived.

Select a quote to open it beside the list: where it is in its progress (Draft, Sent, Accepted or Declined, with dates), its line items and GST, and the buttons at the bottom. The filled button is the next step: Send for a draft, Follow up for a sent quote (it reopens the email panel), Create job for an accepted quote with no job, and Convert to invoice once it has a job. Link to job attaches an existing job instead. Download PDF and More sit alongside.

More holds Convert to invoice (unless it is already the main button, and never on a declined quote), Copy customer link, Mark accepted, Reopen, Unmark as sent, Mark declined, Change customer, Open full quote and, for owner and admins, Archive. Dispatchers and office staff cannot email, so their main button is Mark as sent for a draft and Mark accepted for a sent quote. New quote stays a full page.

When you select Mark declined, you can add an optional reason before confirming.

Open full quote shows the quote the way the customer gets it. The quote number is the one title, with its status beside it, the customer and job under it, and the same buttons as the panel in a row under the title. More also holds Edit and Mark as sent for a draft, and an icon beside it lets you change or unlink the job. The quote itself is on the left and its progress (with dates) is on the right; on a phone the progress sits under the quote.

Send it

  • Send emails it as a PDF from ONYX1, with an optional note. Only the owner and admins can do this. Dispatchers and office staff see Mark as sent instead.
  • Copy customer link gives you a link to send yourself. In a browser it is copied; in the released Android app, it opens the device share sheet. Sharing a draft also marks it Sent.
  • Mark as sent (under More for the owner and admins) is for a quote you sent some other way (posted it, read it out over the phone) and want the pipeline to reflect.

Once a quote reaches Sent, ONYX1 emails the customer automatically: "You've received quote" and the quote number, with a button to open, read and accept or decline it online, no sign-in needed. The page shows the total including GST, the lines excluding GST, your notes and, if you have set one, your phone number. Accept quote asks the customer to confirm, showing the amount and "Nothing is charged now". Decline lets the customer add an optional reason. ONYX1 saves it on the quote, shows it in the quote details, includes it in the notification to your team and keeps it in the audit log. It goes to the customer's contacts who are set to receive quotes (see Customer contacts and the client portal).

Track the answer

  • If the customer answers through their link, every business user is told, and the quote's status updates to Accepted or Declined.
  • If they answer you some other way, select Mark accepted or Mark declined yourself. When you mark it declined, you can add an optional reason. ONYX1 saves it on the quote and shows it in the quote details.
  • Reopen walks back an accepted or declined quote, returning it to Sent so it can be answered again. It does not go back to draft: the customer already has the document, so if the numbers need to change, write a new quote instead.
  • Unmark as sent takes a sent quote back to draft so you can fix it before resending. It does not un-notify the customer.

Going cold is a sent quote nobody has touched for two weeks.

Quotes from Xero

A quote that came from Xero carries a Xero badge. Only an owner or admin sees which Xero quotes are waiting for a job decision: those show Not on a job in amber (or Customer to confirm, if Xero did not say which customer it is for). They open the quote and, under More, select Confirm the customer if the customer still needs confirming, or Match to job once it is confirmed. Select Not for a job to leave the quote off a job. If Xero did not say which customer the quote is for, type part of the customer's name into Search customers or scroll the full list, then choose the customer. Create them first if they are not listed.

Change the customer on a quote

The owner, admins, dispatchers and office staff can move a quote or estimate to a different customer, whatever its status. In the quote's panel in Sales or on the full quote page, select More, then Change customer, choose the customer and select Change customer. In the latest version of the iPhone app, open the quote, tap the menu button (the circle with three dots), tap Change customer, choose the customer and confirm.

The quote moves to the new customer's client portal, and ONYX1 records who made the change. Any customer link already sent for the quote stops working, because it was sent to the old customer. A reason the old customer gave for declining is removed, so the new customer never sees it. To send the new customer a link, select Copy customer link or Send again.

Change customer isn't offered on an archived quote (restore it first) or on a Xero quote whose customer still needs confirming (an owner or admin selects Confirm the customer first). ONYX1 also refuses the change when it would make the quote disagree with what was made from it:

  • The quote is linked to a job for another customer, for example an accepted quote that became a job. Unlink the job first, or choose the job's customer.
  • The quote was converted to an invoice for another customer, and that invoice is not voided. Change the customer on the invoice instead (see Invoice a job).

For a quote that came from Xero, Change customer moves only that quote. Later quotes from the same Xero contact still go to the customer that contact belongs to. To change that, fix the contact in Xero.

Convert to an invoice

Once a quote is accepted, select Convert to invoice to create a draft invoice. In the panel, it is the main button once the quote has a job. Otherwise, it sits under More for quotes that are not declined.

From the panel you land on the new invoice in the Sales list; from the full quote page you land on the full invoice page. Conversion also marks the quote Accepted if it was not already. See Invoice a job for what happens next.

If something goes wrong

  • This quote was already accepted, so it can’t be moved back to sent. A decided quote can only be reopened, not un-sent (use Reopen, or mark it accepted/declined again if you recorded the wrong answer).
  • That quote just changed. Reload and try again. Someone else updated it at the same time.
  • Only a draft quote can be edited. Unmark it as sent first, or use Reopen if it was already decided.
  • You don’t have permission to update quotes. You need the owner, admin, dispatcher or office role.
  • This quote is linked to a job for … Unlink the job first, or choose that customer. Change customer would move the quote away from its job's customer. Unlink the job, or move the quote to that customer.
  • This quote was converted to an invoice for … Change the customer on the invoice instead. The invoice made from the quote is for another customer. Change the invoice's customer.