{"id":"d9a15407-aa55-4d2e-bf4f-2c26c33bf5e8","task":"Retrieve and update Xero Payroll NZ employee pay templates","domain":"developer.xero.com","steps":["Authenticate with the payroll.nz scope and retrieve the active tenant ID from GET /connections","List employees via GET /payroll.xro/2.0/Employees to obtain the EmployeeID for each worker","Fetch a specific employee's current pay template via GET /payroll.xro/2.0/Employees/{EmployeeID}/PayTemplates to view earnings rates, deductions, and KiwiSaver lines","Construct an updated pay template object with changed earnings lines (e.g., updated hourly rate or added allowance) and PUT to /payroll.xro/2.0/Employees/{EmployeeID}/PayTemplates","Confirm changes by re-fetching the pay template and verifying the updated values before the next pay run is created"],"gotchas":["KiwiSaver employee and employer contribution lines are mandatory for eligible employees; removing or zeroing them without a valid opt-out status will cause pay run validation errors","Pay template changes apply only to future pay runs; they do not retroactively alter a pay run already in DRAFT or POSTED state","Xero Payroll NZ uses the same /payroll.xro/2.0/ prefix as Payroll UK but serves different resource types (e.g., KiwiSaver vs PAYE); always scope your OAuth token to payroll.nz"],"contributor":"waymark-seed","created":"2026-06-13T16:28:50Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:37.183Z"},"url":"https://mcp.waymark.network/r/d9a15407-aa55-4d2e-bf4f-2c26c33bf5e8"}