1. WBT Integration Setup

To submit delivery data related to Work-Based learning, you must request the Work Based Training Integration in SELMA. This integrations enables real-time data sync between DXP Ngā Kete and SELMA, via the WBT API.

The WBT Integration is a subscription-based feature for Work Based Training providers only.
Please contact SELMA Support for any enquiries.

In this Section:


WBT Configuration

Figure 1i. Navigate to Settings > Integrations

Figure 1ii. Work Based Training

Select the integration: Work Based Training.

Figure 1iii. WBT Configuration

Click the heading “Configuration” to expand the drop-down.

Figure 1iv. Enter Machine Account Details

A successful integration requires a Machine Account that has been enabled with the WBT API permissions in the DXP Ngā Kete.

Enter the relevant credentials in the configuration fields. Click the checkbox next to each field to unlock the input, and save one at a time.

  • Endpoint: SELMA team to advise
  • Client ID: Machine Account username
  • Client Secret: Machine Account password
  • Organisation ID: Provider EDUMIS number

Figure 1v. Authenticate and Test Connection

1. Click “Authenticate” to fetch a token to submit to the DXP Ngā Kete.
NOTE: There is a 20 minute expiry time on a newly generated authentication token. Click “Re-authenticate” to generate a new token.

2. Click “Test Connection” to verify that the integration is successful.


    WBT Logs

    The WBT Integration logs document all associated processes executed in SELMA in the background, such as changes to configuration and responses to data sent to and received from DXP Ngā Kete.

    Figure 2. See System Information

    Click the purple help icon to see a snippet of the raw data, or click the “Context” button to display the full code. The “Message” column is a translation of the raw data, for quick review of what’s occurred.

    Related Articles

    3. WBT Student

    In this Section: Enable Student – DXP Ngā Kete API Navigate to Student > NZ Compliance Enable the WBT API from the NZ Compliance card, below. This will run validation rules, and error messages will prompt you to fill out required fields that are empty. Hover on the WBT icon on the left hand panel …

    2. WBT Programmes, Components and Employer

    In this Section: Programmes 1. WBT Programme Setup WBT Programme Actions 2. Component Setup for WBT Programmes a. Unit Standard Component Purpose: A component that links to an NZQA unit standard (required for Industry Training and apprenticeships). Steps: b. Off-Job Delivery Component Purpose: A component delivered outside the workplace (classroom, online, assessment centre). Used in …

    6. WBT Training Plan

    In this Section: A Training Plan is a formal document required for all NZ Apprenticeship (NZA) enrolments in Work Based Training. It outlines the learning and development structure for the apprentice and is synced with DXP Ngā Kete. Before a Training Plan can be created, you must have: Create a Training Plan The Training Plan …