SMS Roll Returns

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.

Quick Links
2010 Roll Return..
Roll Return and Audit Testing..
Test Scripts and Test Plans..
Ministry Validation Tool..
Country Code List..
Iwi Codes List..
Language Codes..

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-relese 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 links:

March School Roll Return

July School Roll Return

2010 Roll Return and eReturns Specification Manual (Version 16.0)

The manual provides the roll return specifications for Student Management Systems (SMS) in schools. Please see the section on Key Changes (pages 6 and 7) which outlines the changes to roll return specifications for 2010.

2010 Roll Return and eReturns Specification Manual (Version 16.0) .zip [Zipped MS Word doc - 1.09 mb]

Roll Return and Audit Testing (2010)

This is part of the data sharing framework for SMSs at the Ministry of Education. SMS vendors who wish to participate in roll return and audit testing:

please read the information sheet below
then complete an application form (either as a company or an individual applicant) and send to the Ministry by 13 October 2009.
Contact and address details are on the information sheet.

Application Information Sheet [68 kb]

Application Form Company [34.5 kb]

Application Form Individual [34kb]

Test Scripts and Test Plan for 2010 Roll return and Audit requirements

The test scripts are provided by the Ministry for the SMS vendors participating in Data Sharing approval for Roll returns (as part of the Data Sharing Framework). The test plan outlines the goals, requirements and schedule for the testing phase. Test .moe files will be emailed to vendors on receipt of the application to test.

Test Scripts [zipped MS Excel, 208kb]
2010 Roll Return Test Plan [127kb]

Ministry Validation Tool 2010 version 2.15.5

This program accepts the moe data file produced by a school's Student Management system. The program then validates the data according to Ministry specifications and if the data is error free generates the Roll return tables for either March or July.

The program runs within a windows platform and is installed to the PC via the Setup.exe file, the application will default install to C:\Program files\SMS2009Validation2.15.5. It is recommended that earlier versions of the Validation tool be uninstalled before installing a new version. The program is not compatible with the Apple Mac system.

Ministry Validation Tool 2010 version 2.15.5 [429 kb] zipped file