Pays Tool
Overview
Section titled “Overview”The Pays tool gives employees visibility into their pay information from Xero Payroll AU. It shows a summary of annual salary, year-to-date earnings, and next pay date, plus a list of historical payslips with full detail drill-down.
Features
Section titled “Features”- Annual Salary — Current salary from Xero employee pay template
- Earnings YTD — Gross earnings summed for the current Australian financial year (Jul 1 – Jun 30)
- Next Pay Day — Payment date from the next draft pay run
- Payslip list — Historical payslips with gross, tax, super, and net pay
- Payslip detail — Breakdown of earnings lines, deductions, tax, superannuation, and leave accruals
Permissions
Section titled “Permissions”| Level | View | Update | Manage |
|---|---|---|---|
| Executive | Own data | Refresh | Yes |
| Head | Own data | No | No |
| Manager | Own data | No | No |
| Lead | Own data | No | No |
| Employee | Own data | No | No |
All users can only see their own pay data. The tool requires a Xero employee mapping in Settings > Connections > User Mappings.
Caching
Section titled “Caching”Pay data is cached for 4 hours to avoid excessive Xero API calls. Stale data is served if Xero is unavailable. Users can force a refresh using the Refresh button.
Components
Section titled “Components”| Component | Purpose |
|---|---|
pays-page.tsx | Main page: summary cards and payslip table |
payslip-detail-sheet.tsx | Slide-out sheet with full payslip breakdown |
Data Model
Section titled “Data Model”| Table | Purpose |
|---|---|
pay_summaries | Cached salary, YTD earnings, next pay date (4hr TTL) |
payslips | Cached payslip summaries + raw detail JSON |