localId string — REQUIREDPossible values: 1 ≤ length An integrator generated unique identifier for this item. |
studentIdentificationCode string — REQUIREDPossible values: 1 ≤ length ≤ 10 Student Identification Code A code which uniquely identifies the learner within each TEO. The student ID must remain constant for the learner throughout their enrolment history at your organisation. Length: 10 Type: Character Type of enrolment: B, C, D Guidance: This number must be the unique value generated by each TEO. This field is mandatory. |
gender string — REQUIREDPossible values: 1 ≤ length Gender A code to identify the gender of a learner. Type: Character Type of enrolment: B, C, D Guidance: Select a value from the list below. M: Male F: Female D: Another gender This field is mandatory. |
dateOfBirth date-time — REQUIREDDate of Birth The day, month, and year of birth of the learner. Type: Date Type of enrolment: B, C, D Guidance: DD/MM/YYYY. This field is mandatory. |
totalFeeForDomesticStudent doubleTotal Fee for Domestic Student The total fee for an individual learner is a sum of the following components that a domestic learner is charged for the whole year.
-
Tuition fees
-
Compulsory course cost fees, and
-
Student services fees (and any other compulsory fees).
Note: The tuition fee charged to an international fee-paying learner must be reported to the Tuition Fee Paid by International Fee Paying Student field. Type: Numeric (8,2) Type of enrolment: B, C, D Guidance: Enter the dollar value with two decimal places, including GST. The value should be updated if it changes, such as when courses are added or withdrawn. |
nameIdCode string — REQUIREDPossible values: 1 ≤ length ≤ 5 Name ID Code The first four characters of a learner’s surname plus initial of first legal name. If the learner does not have a first name, use the first five characters for the surname. Length: 5 Type: Character Type of enrolment: B, C, D Guidance: The value is generated by your organisation from the learner’s name. The NAMEID Code is generated from the first four characters of the surname and the first initial of forename 1. Characters must be capitalised. If the surname is less than 4 characters, then blanks must be inserted before forename initial. The initial must be in the fifth position. E.g., › LEE A for Andrew Lee › VAN M for Michael van der Hum › DE WP for Peter de Wittering › KHSID for Khsithesh Devi › O’COB for Brian O’Connor Note: The NAMEID Code must match the equivalent NAMEID Code from the main name or an alternative name on the National Student Number (NSN). This field is mandatory. |
mainActivityAt1OctoberInYearPriorToFormalEnrolment stringPossible values: length ≤ 2 Main Activity at 1 October in Year Prior to Formal Enrolment The main activity or occupation for the learner on 1 October of the year prior to enrolling as a Type D student at your organisation. This field is not required to be changed upon re-enrolment if the duration between the end of the previous enrolment and the re-enrolment is 12 months or less. If a learner returns to the same TEO after not being enrolled for a period of more than 12 months, this field should be updated to reflect the learner’s most recent main activity on 1 October of the year before. If the learner enrolled for the first time between 1 October and 31 December of the current year, then report the main activity on 1 October of the current year. Length: 2 Type: Character Type of enrolment: D Guidance: Select a value from the list below. 1: Secondary school student 2: Non-employed or beneficiary (excluding retired) 3: Wage or salary worker 4: Self-employed 5: University student 6: Polytechnic student 7: College of Education student 8: House person or retired 9: Overseas (irrespective of occupation) 11: Private Training Establishment student 12: Wānanga student Note: The classification of ’99 – other’ has been removed and may only be used historically. |
firstYearOfTertiaryEducation int32First Year of Tertiary Education The year in which a learner first enrolled in any “quality assured” qualification: › at a TEO in New Zealand or overseas, or › in the Foundation Year at the University of the South Pacific, or › at a registered Private Training Establishment. Enrolment in STAR, community, or other non-formal education does not count for first year purposes. Type: Integer Type of enrolment: D Guidance: Enter the year in the format YYYY - e.g., 2023. This field is mandatory if the learner is a New Zealand or Australian citizen or resident. |
disabilityServicesAccessedIndicator int32 — REQUIREDDisability Services Accessed Indicator A code to indicate whether a student has accessed disability services Type: Integer Type of enrolment: D Guidance: Select a value from the list below. 1: Disability services accessed. 2: Disability services not accessed. This field is mandatory. |
lastSecondarySchoolAttended int32Last Secondary School Attended A code to identify the last secondary school attended by the learner. Type: Integer Type of enrolment: D Guidance: Select a value from the secondary school codes classification. The Secondary School Codes are available at the Education Counts website - Secondary School Codes. They are also listed in the DXP Data Classifications Appendices. |
lastYearAtSecondarySchool int32Last Year at Secondary School The year in which the learner finished their secondary school education. Type: Integer Type of enrolment: D Guidance: Enter the year in the format YYYY - e.g., 2023. |
highestSecondarySchoolQualification string — REQUIREDPossible values: 1 ≤ length ≤ 2 Highest Secondary School Qualification A code to show the highest secondary school qualification attained by the learner. Length: 2 Type: Character Type of enrolment: D Guidance: Select a value from the list below. 0: No formal secondary school qualification 11: 14 or more credits at any level 12: NCEA Level 1 or School Certificate 13: NCEA Level 2 or 6th Form Certificate 14: University Entrance 15: NCEA Level 3 or Bursary or Scholarship 9: Overseas qualification (incl. International Baccalaureate & Cambridge Exams) 98: Other 99: Not known This field is mandatory. |
countryOfCitizenship string — REQUIREDPossible values: 1 ≤ length ≤ 3 Country of Citizenship The country of citizenship of a learner. Length: 3 Type: Character Type of enrolment: B, C, D Guidance: Select a value country of citizenship classification. Refer to the DXP Data Classifications Appendices. Note: 999 is valid for Type B and C students This field is mandatory. |
expectationToCompleteAQualificationThisYear booleanExpectation to Complete a Qualification this year Identifies whether the learner expects to be eligible for the award of a qualification in this academic year. Length: 1 Type: Character Type of enrolment: D Guidance: Select a value from the list below. Y: Yes, the student expects to be eligible for the award of a qualification this academic year or next if their current enrolment spans the end of an academic year. N: No, the student doesn’t expect to be eligible for the award of a qualification this academic year or next if their current enrolment spans the end of an academic year. This field is mandatory. |
iwiAffiliation string[]Iwi Affiliation A code to indicate the iwi affiliation of a learner. If a learner has more than one affiliation, then up to six Iwi can be recorded. Type: Integer Type of enrolment: B, C, D Guidance: Select a value or values from the Statistics NZ Iwi and iwi-related groups statistical classification V2.1.0. Separate each iwi reported with a semicolon (;). Where the ethnic group is “211” a value must be submitted for type C & D learners. A value is voluntary for type B. The Iwi classification is available at NZ Statistics - Iwi and iwi-related groups statistical classificationV2.1.0. They are also listed in the DXP Data Classifications Appendices. API: Length: 10 Type: String Array |
nationalStudentNumber int32 — REQUIREDNational Student Number A number which uniquely identifies the learner. The NSN must remain constant for the learner throughout their enrolment at your or any other organisation. The NSN reported in the Learner file must match the NSN used for other collections (e.g., Course Enrolment). The NSN is part of the NSI database system maintained by the Ministry of Education. Type: Integer Type of enrolment: B, C, D Guidance: This number must be the value generated by the National Student Index (NSI) for the learner. This field is mandatory. |
tuitionFeePaidByInternationalFeePayingStudent doubleTuition Fee Paid by International Fee Paying Student The tuition fee charged to an international learner. For the purposes of the Export Education Levy and the Code of Practice for the Pastoral Care of International Students; ‘international student’ is defined as any learner that is not a ‘domestic student’. For a definition of ‘domestic student’ refer to the Fund Finder on the TEC website for more information. Type: Numeric (8,2) Type of enrolment: B, C, D Guidance: Enter the New Zealand dollar value with two decimal places, excluding GST. Applies to All ‘onshore’ international fee-paying learner with learner types B, C or D determined by: › Intramural or Extramural Attendance is 1 or 2 and › Source of Funding is 02 The fee should always exceed the tuition fee charged to a domestic learner. The foreign tuition fee in addition to all the normal domestic tuition costs must also include: › the costs of sale such as agents’ fees and marketing › the cost of the Export Education Levy. Additional compulsory course costs are not included in the tuition fee. Tuition fee must be reported on either the Learner File or the Course Register File, but not on both. |
maximaExemptFee double — REQUIREDMaxima Exempt Fee Student services fee: The maxima exempt fees are compulsory fees for the provision of student services only. Type: Numeric (8,2) Type of enrolment: B, D Guidance: Enter the dollar value with two decimal places, including GST. The value reported should represent the total amount charged in students services fees to a learner. This field is mandatory. |
ethnicity int32[]Ethnicity A code to indicate the ethnicity of a learner. Up to six ethnic codes can be entered in this field. The codes identify the ethnic group or groups to which a learner belongs. Type: Integer Type of enrolment: B, C, D Guidance: Select a value or values from the Statistics NZ Ethnicity New Zealand Standard Classification 2005V2.1.0. Note: At least one value must be reported. The Ethnicity classification is available at NZ Statistics – Ethnicity New Zealand Standard Classification 2005V2.1.0. They are also listed in the DXP Data Classifications Appendices. Separate each ethnicity reported with a semicolon (;) This field is mandatory for type C & D learners. A value is voluntary for type B learners. API: Type: Integer Array |
permanentPostCode string — REQUIREDPossible values: 1 ≤ length Permanent Post Code The learners’ main location during the 12 months prior to first enrolling at the TEO. This information would only be updated where the TEO has not had an enrolment at any stage in the last 2 academic years or longer. Type: Integer Type of enrolment: B, C, D Guidance: Select a value from the NZ Post Codes classification or use one of the following values: 0: Overseas -1: Not yet known Refer to the DXP Data Classifications Appendices or NZ Posts Address or Postcode Finder. This field is mandatory. |
termPostCode string — REQUIREDPossible values: 1 ≤ length Term Post Code The learner’s current residential location while receiving the learning. The information would be updated when the details change. Type: Integer Type of enrolment: B, C, D Guidance: Select a value from the NZ Post Codes classification or use one of the following values: 0: Overseas -1: Not yet known Refer to the DXP Data Classifications Appendices or NZ Posts Address or Postcode Finder. This field is mandatory. |
disabilityStatus int32 — REQUIREDDisability Status Indicates the disability status of a learner. This is not required for Trade Academy and Type B learners. This field is optional for enrolments prior to the April 2025 SDR. After the April SDR this field is compulsory for new enrolments or where a learner changes qualification. Type: Integer Type of enrolment: C, D Guidance: Select a value from the list below. 1: Yes 2: No 3: Prefer not to say 9: (Not stated) Valid for enrolments prior to the April 2025 SDR |
disabilitySupportNeeds int32[]Disability Support Needs Available options to indicate the support a learner requires where they have answered Yes to the Disability Status. Type: Integer Type of enrolment: C, D Guidance: Select a value from the list below. 1: Access to assistive technology (e.g., for reading, writing, communication). 2: Accessible format resources for course content. 3: Mobility and transport (e.g., navigator support to help movement around campus, mobility carparks, personal emergency evacuation plan). 4: New Zealand Sign Language Interpreter. 5: Support with reading, writing, and communicating in learning sessions, exams, and assessments. 6: Other learning or disability support. 7: No, I do not need support at this time. If the Disability Status is Yes, then at least one value must be supplied. Multiple values can be entered, with each separated with a semicolon (;). API: Type: Integer Array |
irdNumber stringPossible values: length ≤ 11 IRD Number IRD number of the learner. The IRD number enables data matching to support the learner in claiming their Fees Free entitlement. Learners will apply for their Fees Free entitlement via myIR. To match the learner’s data (such as course fees) provided by TEC, Inland Revenue will use the learner’s IRD number. (They will also use NSN and date of birth). While this field is not mandatory, TEOs are encouraged to provide the learner’s IRD number upon enrolment. If a learner is eligible and their TEO has not reported an IRD number, they will be required to provide additional information via myIR to enable accurate matching. This may require the learner to request additional information from their TEO to confirm their identity with Inland Revenue. There will be cases where a learner does not have an IRD number at the time of enrolment, you can provide the IRD number in a subsequent SDR submission. There is also an alternative to provide the IRD number on the Qualification Completion file when submitting the learner’s qualification completion details. Type: String Length: 11 Type of enrolment: D Guidance: IRD numbers are either eight or nine digits with dashes e.g., 123-456-789. Please enter leading zero in the first box if your IRD number is only 8 digits. Only provide an IRD number for a who learner who may meet the eligibility criteria for Fees Free at the time of enrolment. In situations where you know the learner is not eligible, you will not need to collect their IRD number. For example, where a learner: · has received Fees Free entitlement previously (e.g. first-year Fees Free) · is not studying an eligible qualification · does not meet prior study criteria · will not meet residency criteria at the time they are awarded their qualification We are using Inland Revenue’s checksum code to validate the IRD number. However, we cannot determine if the learner provided an IRD number that does not belong to them. Inland Revenue will work directly with the learner to resolve this situation. The validation rule will only be triggered if a value is provided in this field. |