Transfer Training Agreement

Transfer Training Agreement

Path Parameters
trainingAgreementLocalId string — REQUIRED

Header Parameters
EID string — REQUIRED Enter the EDUMIS (Organisation) ID

Request Body
newTrainingAgreementLocalId string — REQUIRED Possible values: 1 ≤ length ≤ 20 Training Agreement Local ID A unique number issued by the TEO that Identifies the training agreement that the Training Plan relates. Length: 20 Type: String Guidance: Training Agreement Status cannot be ‘Finished’. There must be a matching training agreement for this learner and TEO within DXP. The same Training Agreement ID must be applied against all relevant sub-programme and over-arching programme enrolments.
newTrainingAgreement object — REQUIRED employerNzbn string Employer NZBN The New Zealand Business Number issued by GS1 New Zealand to the organisation the learner is employed with. This field helps to identify an employer. Type: String Guidance: Enter your NZBN if applicable. employerName string — REQUIRED Possible values: 1 ≤ length ≤ 255 Employer Name The name of the employer. Must be the legal name of the organisation that is employing the learner. Where the employer has multiple sites, this must be the name the parent or head office is known by. Length: 255 Type: String Guidance: Must be the legal name of the organisation that is employing the learner. Where the employer has multiple sites, this must be the name the parent or head office is known by. employerSubdivisionName string Possible values: length ≤ 255 Employer Subdivision Name The name of the subdivision a learner is working for where the employer has multiple sites. Length: 255 Type: String Guidance: Enter in the name of the subdivision if known or applicable. employmentRegionCode int32 — REQUIRED Employment Region Code A code defined by Statistics New Zealand that identifies the Region the Learner’s place of employment is located in. Type: Integer Guidance: Select a value from the Statistics New Zealand Regional Council (Generalised) 2023 classification. The Region classification is available at NZ Statistics: Regional Council (Generalised) 2023. They are also listed in the DXP Data Classifications Appendices. employmentTerritorialAuthorityCode int32 — REQUIRED Employment Territorial Authority Code A code defined by Statistics New Zealand that identifies the Territorial Authority the Learner’s place of employment is located in. This is a new field that will provide a lower level of detail on where learners are employed. Type: Integer Guidance: Select a value from the Statistics New Zealand Territorial Authority (Generalised) 2023 classification. Note: There is only a single Territorial Authority Code for Auckland. There is no further breakdown of geography within the Auckland Territorial Authority area. The Territorial Authority classification is available at NZ Statistics: Territorial Authority (Generalised) 2023. They are also listed in the DXP Data Classifications Appendices. employmentTypeCode string — REQUIRED Possible values: 1 ≤ length ≤ 3 Employment Type Code A code that identifies the nature of the learners’ employment relationship with their employer. Length: 3 Type: String Guidance: Select a value from the list below: E: Employee SS: State Sector V: Volunteer SE: Self Employed. employerIndustryCode string — REQUIRED Possible values: 1 ≤ length ≤ 20 Employer Industry Code Each programme must identify the industry or industries the programme is intended for. Employer Industry Code (ANZSIC) is defined by Statistics New Zealand and identifies the industry the learner is primarily working in. Length: 20 Type: String Guidance: Select a value from the Statistics NZ Australian and New Zealand Standard Industrial Classification 2006 V1.0.0 level 4 list for your organisation. Note: Please select the most appropriate value as only one value is required. The value selected can be different to that on the Programme. The Industrial classification is available at NZ Statistics: Australian and New Zealand Standard Industrial Classification 2006 V1.0.0. They are also listed in the DXP Data Classifications Appendices. learnerOccupationCode string — REQUIRED Possible values: 1 ≤ length ≤ 20 Learner Occupation Code Each training agreement must identify the occupation of the learner. Learner Occupation Code is defined by the TEC and identifies the occupancy the learner is primarily working in. Length: 20 Type: String Guidance: Select a value from the TEC Occupation classification list for your organisation. Note: Please select the most appropriate value as only one value is required. The value selected can be different to that on the Programme. The occupation classifications are listed in the DXP Data Classifications Appendices. moeExemptionNumber string Possible values: length ≤ 20 MoE Exemption Number If a learner is 15 years of age, they are normally required to be enrolled in secondary education. This element captures a reference number provided by the MOE that identifies an exemption they have granted to a learner to not be in secondary education. Length: 20 Type: String Guidance: MOE Exemption Number must be supplied if learner is 15 years old at time of signing the training agreement. trainingAgreementSignedDate date — REQUIRED Training Agreement Signed Date Date the Training Agreement was signed by the learner, employer and TEO. Type: Date Guidance: 2024-04-08 You must use ISO-8601 for your dates. Use the last date the Training Agreement was signed. Training Agreement Signed Date must be on or before the processing date. The learner must be over 16 years old at date the training agreement is signed unless the MOE Exemption Code is supplied. Training Agreement Signed Date must be no older than 120 days from today. If the Training Agreement is the product of an Employer transfer, then the Training Agreement Signed Date of the new Training Agreement must be after the Training Agreement Signed Date of the previous Training Agreement. Also, the new Training Agreement Signed Date must be at least one day after any preceding GRACE status for the previous Training Agreement. endDate date Training Agreement End Date Type: Date Guidance: 2024-04-08 You must use ISO-8601 for your dates.

Responses
201 The operation returned successfully and a new resource was created. Schema — OPTIONAL newTrainingAgreementLocalId string Possible values: 1 ≤ length ≤ 20 Training Agreement Local ID A unique number issued by the TEO that Identifies the training agreement that the Training Plan relates. Length: 20 Type: String Guidance: Training Agreement Status cannot be ‘Finished’. There must be a matching training agreement for this learner and TEO within DXP. The same Training Agreement ID must be applied against all relevant sub-programme and over-arching programme enrolments. newTrainingAgreement object employerNzbn string — OPTIONAL Employer NZBN The New Zealand Business Number issued by GS1 New Zealand to the organisation the learner is employed with. This field helps to identify an employer. Type: String Guidance: Enter your NZBN if applicable. employerName string Possible values: 1 ≤ length ≤ 255 Employer Name The name of the employer. Must be the legal name of the organisation that is employing the learner. Where the employer has multiple sites, this must be the name the parent or head office is known by. Length: 255 Type: String Guidance: Must be the legal name of the organisation that is employing the learner. Where the employer has multiple sites, this must be the name the parent or head office is known by. employerSubdivisionName string — OPTIONAL Possible values: length ≤ 255 Employer Subdivision Name The name of the subdivision a learner is working for where the employer has multiple sites. Length: 255 Type: String Guidance: Enter in the name of the subdivision if known or applicable. employmentRegionCode int32 Employment Region Code A code defined by Statistics New Zealand that identifies the Region the Learner’s place of employment is located in. Type: Integer Guidance: Select a value from the Statistics New Zealand Regional Council (Generalised) 2023 classification. The Region classification is available at NZ Statistics: Regional Council (Generalised) 2023. They are also listed in the DXP Data Classifications Appendices. employmentTerritorialAuthorityCode int32 Employment Territorial Authority Code A code defined by Statistics New Zealand that identifies the Territorial Authority the Learner’s place of employment is located in. This is a new field that will provide a lower level of detail on where learners are employed. Type: Integer Guidance: Select a value from the Statistics New Zealand Territorial Authority (Generalised) 2023 classification. Note: There is only a single Territorial Authority Code for Auckland. There is no further breakdown of geography within the Auckland Territorial Authority area. The Territorial Authority classification is available at NZ Statistics: Territorial Authority (Generalised) 2023. They are also listed in the DXP Data Classifications Appendices. employmentTypeCode string Possible values: 1 ≤ length ≤ 3 Employment Type Code A code that identifies the nature of the learners’ employment relationship with their employer. Length: 3 Type: String Guidance: Select a value from the list below: E: Employee SS: State Sector V: Volunteer SE: Self Employed. employerIndustryCode string Possible values: 1 ≤ length ≤ 20 Employer Industry Code Each programme must identify the industry or industries the programme is intended for. Employer Industry Code (ANZSIC) is defined by Statistics New Zealand and identifies the industry the learner is primarily working in. Length: 20 Type: String Guidance: Select a value from the Statistics NZ Australian and New Zealand Standard Industrial Classification 2006 V1.0.0 level 4 list for your organisation. Note: Please select the most appropriate value as only one value is required. The value selected can be different to that on the Programme. The Industrial classification is available at NZ Statistics: Australian and New Zealand Standard Industrial Classification 2006 V1.0.0. They are also listed in the DXP Data Classifications Appendices. learnerOccupationCode string Possible values: 1 ≤ length ≤ 20 Learner Occupation Code Each training agreement must identify the occupation of the learner. Learner Occupation Code is defined by the TEC and identifies the occupancy the learner is primarily working in. Length: 20 Type: String Guidance: Select a value from the TEC Occupation classification list for your organisation. Note: Please select the most appropriate value as only one value is required. The value selected can be different to that on the Programme. The occupation classifications are listed in the DXP Data Classifications Appendices. moeExemptionNumber string — OPTIONAL Possible values: length ≤ 20 MoE Exemption Number If a learner is 15 years of age, they are normally required to be enrolled in secondary education. This element captures a reference number provided by the MOE that identifies an exemption they have granted to a learner to not be in secondary education. Length: 20 Type: String Guidance: MOE Exemption Number must be supplied if learner is 15 years old at time of signing the training agreement. trainingAgreementSignedDate date Training Agreement Signed Date Date the Training Agreement was signed by the learner, employer and TEO. Type: Date Guidance: 2024-04-08 You must use ISO-8601 for your dates. Use the last date the Training Agreement was signed. Training Agreement Signed Date must be on or before the processing date. The learner must be over 16 years old at date the training agreement is signed unless the MOE Exemption Code is supplied. Training Agreement Signed Date must be no older than 120 days from today. If the Training Agreement is the product of an Employer transfer, then the Training Agreement Signed Date of the new Training Agreement must be after the Training Agreement Signed Date of the previous Training Agreement. Also, the new Training Agreement Signed Date must be at least one day after any preceding GRACE status for the previous Training Agreement. endDate date — OPTIONAL Training Agreement End Date Type: Date Guidance: 2024-04-08 You must use ISO-8601 for your dates.
400 Bad request. Check errors and codes for more detail. Schema — OPTIONAL type string — OPTIONAL title string — OPTIONAL status int32 — OPTIONAL detail string — OPTIONAL instance string — OPTIONAL errors object — OPTIONAL
401 Unauthorized Schema — OPTIONAL type string — OPTIONAL title string — OPTIONAL status int32 — OPTIONAL detail string — OPTIONAL instance string — OPTIONAL errors object — OPTIONAL
429 Rate Limiting may apply. Refer to Retry-After header Schema — OPTIONAL type string — OPTIONAL title string — OPTIONAL status int32 — OPTIONAL detail string — OPTIONAL instance string — OPTIONAL