---
title: "Tax and declaration data onboarding fields"
id: "tax-and-declaration-data-onboarding-fields"
project: "EHR User Guide"
url: "https://help.cloud5.com.au/articles/ehr-user-guide/tax-and-declaration-data-onboarding-fields"
updated: 2026-10-19T00:52:56Z
---

# Tax and declaration data onboarding fields

Here are the tax and declaration data fields available for onboarding.

* The fields are subject to validation. Errors can result in dependant sets of data (such as payment instructions and LSL data) also being rejected.
* Only a single entry per new employee is allowed.
* The declaration lodged date is set to the current date as the date processed.

| **Employee tax and declaration data field description** | **Field length** | **Req?** | **EmpowerHR tag**<br><br>TaxAndDeclaration. | **Notes** |
| --- | --- | --- | --- | --- |
| Effective Date<br>(employee commencement date) | 9 | y | TaxDetailsEffectiveFrom | Format: ddmmyy |
| Payroll Code | 9 | y | PayrollCode | Must be a valid code |
| Payer ABN Number | 11 | y | AbnNumber |  |
| Payer ABN Branch | 3 | n | AbnBranch |  |
| Pay Method Code | 1 | y | PayMethod | Must be a valid code |
| Payment Location | 4 | y | PayLocation | Must be a valid code |
| Tax File Number | 9 | y | TaxFileNumber | Must be 9 numeric characters |
| Declaration Date signed | 9 | y | DateDeclarationFormSigned | Format: ddmmyy |
| Previous Surname | 30 | n | PreviousName.Surname |  |
| Previous Given Name 1 | 30 | n | PreviousName.FirstGiven |  |
| Previous Given name 2 | 30 | n | PreviousName.SecondGiven |  |
| Basis of Employment | 1 | y | BasisOfPayment | Must be one of the following:<br><ul><li><b><span style="font-size: 10pt;">f</span></b></li><li><b><span style="font-size: 10pt;">p</span></b></li><li><b><span style="font-size: 10pt;">c</span></b></li><li><b><span style="font-size: 10pt;">l</span></b></li><li><b><span style="font-size: 10pt;">s</span></b></li></ul> |
| Rebate claimed includes FTAC1 | 1 | y | FamilyTaxOrSeniorTax | Must be:<br><ul><li><span style="font-size: 10pt;"><b>y </b>(yes) <i>or</i></span></li><li><span style="font-size: 10pt;"><b>n </b>(no)</span></li></ul> |
| Savings rebate claim indicator | 1 | y | ZoneOrDependantOrSpecial | Must be:<br><ul><li><span style="font-size: 10pt;"><b>y&#160;</b>(yes)&#160;<i>or</i></span></li><li><span style="font-size: 10pt;"><b>n&#160;</b>(no)</span></li></ul> |
| Tax Offset Annuity or Super | 1 | y | TaxOffsetAnnuityOrSuper | No longer applicable |
| Payee Signature Present Indicator | 1 | y | PayeeSignaturePresent | Must be:<br><ul><li><span style="font-size: 10pt;"><b>y&#160;</b>(yes)&#160;<i>or</i></span></li><li><span style="font-size: 10pt;"><b>n&#160;</b>(no)</span></li></ul> |
| Tax Scale Code | 1 | y | TaxScale | Must be a valid code |
| STSL Flag | 1 | y | GenerateSTSL | Must be:<br><ul><li><span style="font-size: 10pt;"><b>y&#160;</b>(yes)&#160;<i>or</i></span></li><li><span style="font-size: 10pt;"><b>n&#160;</b>(no)</span></li></ul> |
| Flat Tax Rate % | 10 | y | FlatTaxRate | Enter tax rate % *or* else enter **0.00** |
| School Christmas Leave in Advance | 1 | y | SchoolChristmasLeaveInAdvance | Must be:<br><ul><li><span style="font-size: 10pt;"><b>y&#160;</b>(yes)&#160;<i>or</i></span></li><li><span style="font-size: 10pt;"><b>n&#160;</b>(no)</span></li></ul> |
| Medicare Claim | 1 | n | MedicareClaimed | Must be:<br><ul><li><span style="font-size: 10pt;"><b>y&#160;</b>(yes)&#160;<i>or</i></span></li><li><span style="font-size: 10pt;"><b>n&#160;</b>(no)</span></li></ul> |
| Number of Medicare Dependants | 3 | n | MedicareDependants | Only enter if Medicare is claimed. Must be numeric characters. |
| Tax Rebate Code | 4 | n | TaxRebateCode | Must be valid code |
| Zone Code | 2 | n | TaxZoneCode |  |
| Dependant / Zone Rebate | 10 | n | DependantOrZoneRebate | If entered, this must be numeric characters |
| % Variation | 10 | n | PercentageVariation |  |
| Tax Variation From Date | 9 | n | FromDate | Format: ddmmyy |
| Tax Variation Upto Date | 9 | n | UptoDate | Format: ddmmyy |
| NZ IRD number | 9 | y | IrdTaxFileNumber | No longer applicable |
| NZ student loan | 1 | y | StandardStudentLoanCalc | No longer applicable |
| NZ student loan rate | 8 | y | StudentLoanFlatPercent | No longer applicable |
| NZ extra pay rate | 8 | y | EmolumentRate | No longer applicable |
| NZ non resident flag | 1 | y | NonResident | No longer applicable |
| Withholding rate | 8 | n | VoluntaryWithholdingRate | No longer applicable |
| KiwiSaver Status Flag | 2 | y | KiwiSaverStatus | No longer applicable<br><ul></ul> |
| STP Tax Treatment Code | 10 | n | StpTaxTreatmentCode |  |
| STP Income Stream | 10 | n | StpIncomeStream | If supplied, this must be a valid value |
| STP Income Stream Country Code | 10 | n | StpIncomeStreamCountryCode | If supplied, this must be a valid value |

| Next topic<br><br>[Overtime code fields](/articles/ehr-user-guide/overtime-code-fields) |
| --- |

© 2023 Fusion5. All rights reserved.