Payroll and costing settings
Set overhead and default rates for job costing, labour on-costs, leave entitlement, public holidays and iPayroll export codes.
On this pageCosting defaults
Settings → Payroll & costing sets the rates job costing and profitability run on, and the codes ONYX1's payroll export uses. Only the owner and admins can open it.
Costing defaults
- Overhead per hour ($/hr): your fixed monthly overhead (rent, insurance, admin, vehicles), spread across every labour hour worked on a job.
- Default cost rate ($/hr) and Default charge rate ($/hr): used for any worker who doesn't have their own cost or charge rate set on their Team profile. A worker's own rate always wins over these defaults.
Select Save costing defaults once you've set them.
Job overrun thresholds (owner only)
Under the costing defaults, the owner sees Job overrun thresholds. These set how far labour hours can run ahead of a job's progress before the job is flagged. The defaults are 10 points for orange and 20 points for red. See Job health: labour against progress.
- Orange from (points): a whole number from 1 to 99.
- Red from (points): a whole number from 2 to 100. It must be higher than the orange figure.
Select Save thresholds. If the figures are not whole numbers in range, or red is not above orange, ONYX1 says "Use whole points from 1 to 100, with red above orange." Admins do not see this section. The flags on the Job Health page and the job's Money tab use the new figures straight away. Alerts follow at the next daily check.
Job cost terms
On a job, Cost so far is the cost recorded so far. It includes labour, materials, overhead and expenses. Labour counts only from approved timesheets, and so does the overhead worked out from labour hours. Submitted, draft or otherwise unapproved hours are not included in Cost so far.
Invoiced (ex GST) is the sum of linked invoices that are sent or paid. Draft and void invoices do not count. If an invoice came from Xero, ONYX1 uses the Xero amount. If it was created in ONYX1 and pushed to Xero, ONYX1 uses the amount entered in ONYX1.
Invoiced and Cost so far are worked out from the job's invoices and costs each time you open the job, so a change shows straight away. Marking an invoice sent adds it, voiding it removes it, and a status change that arrives from Xero counts the same way. Moving an invoice between sent and paid does not change Invoiced, because both count. That includes removing a payment that had paid an invoice in full, which puts the invoice back to sent.
An archived job is read-only for ordinary work. An invoice already on it can still be marked paid, but it cannot be voided or moved off it until an owner or admin restores the job. An owner or admin can make a one-time match of an unlinked Xero invoice to an archived job when both have the same customer. To link a quote or locally raised invoice, restore the job first.
Owners see Profit and a margin percentage once the job has an invoice. Profit is Invoiced minus Cost so far. Before the first invoice, the job shows Not invoiced yet instead of Invoiced and Profit. Owners, admins, dispatchers and office staff see Invoiced and Cost so far; field roles do not see job money.
If no overhead rate is set, Overhead shows as zero, so costs leave out office, vehicles and software. The owner's Profitability card on the job's money page then says No overhead rate set. with a link, Set an overhead rate, to this page. The missing rate does not stop profit from being calculated.
Labour on-costs
Labour burden, such as KiwiSaver, ACC and leave, is spread across staff cost rates as a blended percentage. Until you itemise anything, ONYX1 uses a default breakdown: annual leave, sick leave, ACC, PPE, fuel and parking, KiwiSaver and public holidays, adding up to roughly a quarter on top of pay.
Add your own on-costs by entering a name and a rate percentage and selecting Add on-cost. As soon as you add even one, your itemised total replaces the whole default for every worker without their own cost rate, so add every on-cost that should apply, not just the one you want to change.
Leave entitlement
Set the Annual leave (days per year) every worker's leave balance starts from. It defaults to 20, the New Zealand statutory four weeks; raise it if your business gives more.
Public holidays
Choose the Holiday region your team follows and publish company holidays such as a Christmas shutdown. See Public holidays and company holidays.
Timesheet pay
ONYX1 sends your payroll categorised hours, ordinary, overtime and penal, so your payroll system can compute the actual pay; ONYX1 doesn't calculate or pay wages itself. Set:
- Overtime threshold (hours / week): worked hours past this each week become overtime (default 40).
- Overtime multiplier: how overtime hours are weighted, such as 1.5 for time-and-a-half.
- Penal multiplier: how penal hours (public holiday or weekend work) are weighted, such as 2.0 for double time. In New Zealand, time on a public holiday is marked penal automatically for staff who submit timesheets; a worker can untick it on their draft week.
Each person can see their own hourly pay rate on My account, read only. Apart from them, only the owner and admins can see it.
iPayroll export
Set the Ordinary-time element, Overtime element and Penal element IDs your iPayroll account uses (they default to T1, T1.5 and T2). Export an actual pay run with Export for payroll in Timesheets, not from here; set each worker's iPayroll ID on their Team profile.
Holiday days off
Two optional element IDs, Public holiday not worked and Company holiday, add paid days off to the iPayroll CSV. Both are blank to start. A blank code leaves its holiday days out of the CSV, so with both blank the CSV is exactly as before. Enter the element ID from your iPayroll account to switch one on.
- Public holiday not worked: a weekday public holiday in your region where the person recorded no approved time. Approved work on a public holiday stays in the ordinary, overtime and penal totals as before; for eligible New Zealand staff, a shift started on a public holiday is marked penal by default, and the worker can untick it while their timesheet is still a draft.
- Company holiday: each approved company holiday leave day, counted the same way as on the leave request.
Each day goes in as hours: the person's usual daily hours when their part-time hours are set per day, otherwise 8 hours. Holiday days are included only for staff who submit timesheets (not contractors or timesheet-exempt staff) and have an approved timesheet period that starts within the pay run dates. A person with no iPayroll ID still gets their holiday days, on their row with a blank ID. A holiday before their employment start date or after their end date is left out. They are listed only for pay runs of 366 days or less (counting both dates); a longer pay run still exports worked hours.
A Direct API push straight to iPayroll is not enabled yet: use the CSV export in Timesheets, which contains the approved ordinary, overtime and penal hours.
If something goes wrong
- Settings → Payroll & costing is missing: only the owner and admins can open it.
- A job's cost looks wrong: check the worker's own cost rate on their Team profile first; it always overrides the defaults here.
- The iPayroll file doesn't match what you expect: check the element IDs here match what your iPayroll account uses, and that each worker's iPayroll ID is set on their Team profile. A row with a blank ID is a person with approved hours or holiday days and no iPayroll ID: iPayroll can't match it until you add the ID.
