Customers and sites
Add and manage your customers, see who owes you, keep their logo and sites, and import your existing list from Xero.
On this pageBefore you start
Your customer list is the book of who you do work for, and each customer can have one or more sites, the addresses you work at.
Before you start
Only the owner, admins, dispatchers and office staff can add, edit or import customers, and add their sites. Only the owner and admins can archive them. Techs and contractors do not see the customer list at all; the job cards they work from already carry the customer that matters.
The customer list
Open Customers. Each row shows the customer's logo or initials, their name and contact, how many open jobs they have, what they owe you and the date of their last job. The last job is the latest one that has started; a job booked for a later day doesn't count yet. Money owed is shown incl GST, and an overdue amount appears under it. Site supervisors see the list and open jobs but no money. On a phone, each row shows the name, contact and money owed; open jobs and last job show on a larger screen.
Use the chips above the list to narrow it: All, Owe you, Open jobs, On the portal (owners and admins) and Archived (owners and admins, once a customer has been archived). The number beside each chip is how many customers it holds. Search by name, contact, email or phone.
Select a customer and they open in a panel beside the list, with the list staying where it is and the customer's row marked. Close the panel with the cross or the Esc key. On a phone, the customer opens as its own screen with a back button. Select Open full customer to leave the list for that customer's own page.
Add a customer
- Open Customers and select New customer.
- Enter the Business / customer name (required), and any of Contact person, Email, Phone, Website and Address.
- Select Add customer.
If you enter a work email address, ONYX1 offers its domain as the customer's website, unless it is a free mail address such as Gmail. If the email already has a working ONYX1 client login, ONYX1 shows "Already an ONYX1 client" so you know you can just give them portal access instead of inviting them from scratch. See Customer contacts and the client portal.
Import from Xero
Select Import on the Customers list. Export your contacts from Xero as a CSV, then choose the file. ONYX1 shows you a preview and skips any customer already in your list. Select Confirm import to finish.
ONYX1 reads these columns from the file. Capitals don't matter, and Xero's * in front of a column name is fine.
ContactName(required): the business or customer nameFirstNameandLastName: the contact personEmailAddressPhoneNumber, orMobileNumberwhen there's no phone number
Check before importing
Under the preview, a Check before importing list shows anything in the file that won't import cleanly, with the spreadsheet row numbers. It can say that:
- some columns are not imported, and names them
- some rows have no name and will be skipped
- some rows have an email address that looks wrong; they import, but emails to them will fail
- some rows repeat a name from earlier in the file and will be skipped
- some rows match customers you already have and will be skipped
- the file has more than 5,000 rows, and only the first 5,000 will be imported; split the file and import the rest after
If the file has no ContactName column, ONYX1 shows no preview and says it found no customers.
Nothing is imported until you select Confirm import. The iPhone and iPad app shows the same list in its import preview from its next update.
Manage a customer
In the customer's panel you can edit their details, start a New job or New quote, see their open jobs, quotes and invoices, work with their contacts and portal access, and add or rename sites. Quotes are shown ex GST and invoices incl GST. Owners and admins also see two switches for this customer, Payment reminders and Purchase order required. The full customer page keeps every job, quote and invoice.
Only the owner and admins can archive or restore a customer, from the panel or by ticking customers in the list. Archiving hides them from the active list but keeps every job, invoice and export intact, and is reversible from the Archived chip.
Can I delete a customer?
No. ONYX1 has no way to delete a customer permanently. The owner and admins archive a customer instead: select Archive in the customer's panel, or tick customers in the list and select Archive selected. Archiving only hides the customer from your active list. Their jobs, quotes, invoices, sites and contacts are all kept, so your records and exports stay complete. To bring a customer back, open the Archived chip and select Restore.
Archiving doesn't remove portal access. Anyone you gave access to the client portal can still sign in and see your work for that customer. To stop that, select Revoke on each contact's row under Contacts, which works on an archived customer too. See Give portal access.
If a person wants their own client portal login closed, they can ask ONYX1 directly: see Delete your ONYX1 account and data.
Logos
A logo makes a customer easy to spot in your list. Open the customer and choose:
- Upload logo: a PNG, JPG or WebP up to 2 MB. ONYX1 crops it square and stores it at 256 pixels.
- Use website icon: ONYX1 fetches the icon from the customer's Website once, when you select this, and keeps a copy. It needs a website on the customer. If the site has no usable icon, you will be asked to upload a logo instead. Nobody's browser ever loads an image from the customer's site.
- Remove logo.
Without a logo, the customer shows their initials on one of four soft blue-grey tints, always the same one for the same name. Anyone who can edit customers can set or change a provider logo unless an active portal login has set a logo for that customer record. In Account → Your logo, a customer can upload or remove a logo shared across the records linked to that login. Staff cannot change or remove it while the link is active. If you revoke the link, the logo stays on that customer record and your staff can change or remove it. Customer logos do not appear on a quote or invoice.
Open a customer's portfolio
On a customer's page, the Portfolio card shows how many case files, site reports, photos and safety documents the customer has. Select Open portfolio to find and download any of them. See Find a customer's files in the portfolio.
Techs and contractors don't see this page; see Find a customer's files in the portfolio for how they open it.
Sites
Under Sites on the customer's panel or page, select Add site to open the form. Enter a Site label (for example "Main tower") and an Address, picked from the autocomplete so it plots correctly on the map, then select + Add site to save it. A job linked to one of these sites plots there. A job with no site of its own instead falls back to the customer's own Address field, from Add a customer.
The site label and address are shown to this customer in their portal, along with its active-job count and latest activity date.
Site notes are kept with the site and shown on jobs there to people who can read them. ONYX1 Office can add a note with its source label and role. Staff cannot edit or remove an automated Office note. Customers do not see site notes; see Work on a job for access and note details.
The owner, admins, dispatchers and office staff can rename a site: select Rename site under it, change the Site name and select Save.
Adding a site to a customer does not put it on that customer's existing jobs. To set a job's site, open the job and select Set site in Job details, then choose one of that customer's sites. See Set a site on the job. You can also add a new site from this flow, and ONYX1 sets it on the job. To clear a site, select Change site, then Remove site. The controls are hidden on Completed, Ready to invoice, Invoiced and archived jobs. Moving a job to another customer clears its site. A job created from a quote or invoice inherits a site only when the customer has exactly one.
If something goes wrong
- No customers found. Make sure it’s a Xero contacts CSV with a ContactName column. The file you chose is not the export ONYX1 expects.
- You don’t have permission to add customers. You need the owner, admin, dispatcher or office role.
- Use a PNG, JPG or WebP image. The logo must be one of those three types. SVG and GIF files are not accepted.
- That image is too big. Use one under 2 MB. Choose a smaller file.
- Add a valid website address for this customer first. Use website icon needs a public website name, such as example.co.nz, saved on the customer.
- That doesn’t look like a website address. The Website on a customer must be a public website name, such as example.co.nz.
- Couldn’t find an icon on that site. Upload a logo instead. The site has no icon ONYX1 can use.
- Too many attempts. Wait a few minutes and try again. Fetching website icons is limited so it can't be misused.
