SMS Vendors Data Services
This is the main page for vendors of student management systems (SMS) with regard to school roll returns, that is, the collection of student data from schools.
Last Updated: November 2023
Description
This page is specifically developed for the vendors of student management systems and focuses on school roll returns. Information on this page is often technical in nature. Code sets made available here are specifically for vendors. These code sets may be pre-release versions and should not be used by schools until they are formally released as they will provide invalid results. Schools looking for current information on roll returns should use the following link: Collection Forms
Page Contents:
- Roll Return and e-Returns Specification Manual
- e-Return SMS Design Specification
- Business Requirements for electronic sign-off for Roll Returns
- Test Scripts and Test Plans for Roll Return and Audit Requirements
- Application Forms for Data Sharing
- Country of Citizenship Codes
- Iwi Classification Codes
- Language Codes
- Subject Codes
- Secondary Tertiary Programmes
- Directory of Educational Institutions
- School Name and Number Codes
- ART - Numbers, Names Needs
Roll Return and e-Returns
Specification Manual (Version 30.2) Updated: November 2023
The manual provides the roll return specifications for Student Management Systems (SMS) in schools. Please see the section on Key Changes (page 8) which outlines the changes to the most recent roll return specifications.
Historical Specification Manuals
- 2023 Roll Return Specification Manual Version 29.4 [PDF 4.3mB]
- 2022 Roll Return Specification Manual Version 28.4 [PDF 3.8mB]
- 2021 Roll Return Specification Manual Version 27.1 [PDF 3.8mB]
- 2020 Roll Return Specification Manual Version 26.1 [PDF 4.5mB]
- 2019 Roll Return Specification Manual Version 25.1 [PDF 4.5mB]
- 2018 Roll Return Specification Manual Version 24.1 [PDF 3.3mB]
- 2017 Roll Return Specification Manual Version 23.2 [PDF 1.6mB]
- 2016 Roll Return Specification Manual Version 22.2 [PDF 4.7mB]
- 2015 Roll Return Specification Manual Version 21.2 [PDF 2.5mB]
- 2014 Roll Return Specification Manual Version 20.2 [PDF 2.2mB]
- 2013 Roll Return Specification Manual Version 19.2 [PDF 3.8mB]
- 2012 Roll Return Specification Manual Version 18.3 [PDF 2.6mB]
- 2011 Roll Return Specification Manual Version 17.3[PDF 1.9mB]
- 2010 Roll Return Specification Manual Version 16.0[MS Word Zipped 904kB]
- 2009 Roll Return Specification Manual Version 15.2[MS Word Zipped 904kB]
- 2008 Roll Return Specification Manual Version 14.3[MS Word 4.2mB]
e-Return SMS Design SpecificationUpdated: September 2012
Business Requirements for
electronic sign-off for Roll Returns Updated: October 2018
This document has been included in the Roll Returns and e-Returns Specifications Manual 2019.
Test Scripts and Test Plan Updated: October 2023
- 2024 Roll Return Test Scripts [Zipped File 526kB]
Data Sharing Approval Student Management Systems Updated: October 2023
- 2024 Application form - Company [MS Word 40kB]
- 2024 Application form - Individual [MS Word 40kB]
- 2024 Information for data sharing approval [MS Word 47kB]
Country or Jurisdiction of Citizenship CodesUpdated: October 2023
- Country or Jurisdiction of Citizenship Codes Version 2.15 [MS Excel 22kB]
Iwi Classification CodesUpdated: October 2023
- Iwi Classification Codes 2024 [MS Excel 14kB]
Language CodesUpdated: Nov-2019
- Language Codes - Schooling [PDF 423kB]
- Language Codes - Schooling [MS Word 812kB]
Schooling Subject CodesUpdated: Oct-2020
- 2021 Subject Codes Schooling [PDF 101kB]
- 2021 Subject Codes Schooling [MS Word 26kB]
Secondary Tertiary Programme CodesUpdated: October 2023
- 2024 Secondary Tertiary Programme Codes [MS Excel 13kB]
Current Directory of Educational Institutions
You can find current addresses and other descriptive details of all New Zealand Educational Institutions from schools through to tertiary education providers.
School Name and Number CodesUpdated: October 2023
A list of School Names and School Number Codes are provided for those schools completing the "Previous School" question in Roll Returns.
- 2024 School Name and Number Codes [MS Excel 221kB]
ART (Achievement Reporting Specifications) - Numbers, Names NeedsUpdated: October 2016
- ART - Numbers, Names Needs 2016 Version 1.1 [PDF 549kB]