Definitions

Generation One NTD: An NTD provided with the initial rollout of the nbn network. Will have an NTD type (ntdType) and NTD version (ntdVersion) as listed in the below table.

Table 1. Generation One NTDs
Access Technology NTD Type (ntdType) NTD Version (ntdVersion)

FTTP

INTERNAL

V1

FTTP

EXTERNAL

V1

FTTP

SPECIAL

V2

HFC

INTERNAL

V1

Generation Two NTD: An NTD provided to support plans with a download speed > 1000 MBit/s. Will have an NTD type (ntdType) and NTD version (ntdVersion) as listed in the below table.

Table 2. Generation Two NTDs
Access Technology NTD Type (ntdType) NTD Version (ntdVersion)

FTTP

1_PORT

V3

FTTP

4_PORT

V4

HFC

NTD_2.5

V2

Introduction

In September 2025, the NBN are introducing plans with download speeds > 1000 MBit/s for the FTTP and HFC access technology types. If the location has a generation one NTD, this means the NTD will need to be replaced with a generation two NTD.

Two-Step Process

You cannot order a plan with a download speed > 1000 MBit/s on a generation one NTD. To order a plan with a download speed > 1000 MBit/s you must follow a two-step process as follows:

  1. Order any plan with a download speed <= 1000 MBit/s.

  2. Perform a plan Change to the plan with a download speed > 1000 MBit/s.

First or Additional NTD

If there is currently no NTD at the location, or you are ordering an additional NTD, depending on the plan type (planType) you may have the option to select the NTD you want. At the moment this applies to the FTTP access technology where the plan type is Residential. In this case you will have the choice between a 1 port NTD or a 4 port NTD. You will be charged if you select the 4 port NTD. If the plan has a plan type of Business you will be offered only the 4 port NTD and you will not be charged for it. For HFC the only choice is the 2.5 NTD, and you will not be charged for it.

Service Qualification Enhancements

To show what plans are offered and what NTD’s can be chosen, the SQ has had the following fields added to it for the FTTP and HFC access technology types:

Field Description

generationTwoNtds

An array of generation two NTD details and the cost (if any) associated with choosing that NTD. For FTTP and HFC, if you need a new NTD when ordering, pass in generationTwoNtds[].name as the ntdOption value. See Order Enhancements.

firstOrAdditionalNtdPlans

An array of the plans and NTD options available if this will be the first or an additional NTD at the location. The ntdOptions array contains a reference to the NTD(s) described in generationTwoNtds array.

generationOneNtdPlans

An array of the plans available for a generation one NTD. Plans with a download speed > 1000 MBit/s are excluded from the plans available at the location. The ntdOptions array will be empty as plans requiring a generation two NTD have been excluded.

generationTwoNtdPlans

An array of the plans available for a generation two NTD. There are currently no restrictions on what plans can be ordered on a generation two NTD. The ntdOptions array will be empty as generation two NTDs support all plans.

infrastructure[].plan

A reference to either generationOneNtdPlans or generationTwoNtdPlans, depending on which generation the NTD belongs to.

generationTwoNtds Example

FTTP

  • Generation two NTDs for access technology FTTP.

  • 4_PORT_RESIDENTIAL comes with a fee of $100.

  • The "name" field is referenced via ntdOptions[] in the firstOrAdditionalNtdPlans array.

{
  "generationTwoNtds" : [ {
    "name" : "1_PORT",
    "ntdType" : "1_PORT",
    "ntdVersion" : "V3",
    "ntdPlanTypes" : [ "RESIDENTIAL" ],
    "fees" : [ {
      "name" : "NTD_INSTALLATION_FEE",
      "oneTimeCharge" : {
        "amount" : "0.00",
        "currency" : "AUD",
        "symbol" : "&#36;"
      },
      "monthlyRecurringCharge" : {
        "amount" : "0.00",
        "currency" : "AUD",
        "symbol" : "&#36;"
      }
    } ]
  }, {
    "name" : "4_PORT",
    "ntdType" : "4_PORT",
    "ntdVersion" : "V4",
    "ntdPlanTypes" : [ "BUSINESS" ],
    "fees" : [ {
      "name" : "NTD_INSTALLATION_FEE",
      "oneTimeCharge" : {
        "amount" : "0.00",
        "currency" : "AUD",
        "symbol" : "&#36;"
      },
      "monthlyRecurringCharge" : {
        "amount" : "0.00",
        "currency" : "AUD",
        "symbol" : "&#36;"
      }
    } ]
  }, {
    "name" : "4_PORT_RESIDENTIAL",
    "ntdType" : "4_PORT",
    "ntdVersion" : "V4",
    "ntdPlanTypes" : [ "RESIDENTIAL" ],
    "fees" : [ {
      "name" : "NTD_INSTALLATION_FEE",
      "oneTimeCharge" : {
        "amount" : "100.00",
        "currency" : "AUD",
        "symbol" : "&#36;"
      },
      "monthlyRecurringCharge" : {
        "amount" : "0.00",
        "currency" : "AUD",
        "symbol" : "&#36;"
      }
    } ]
  } ]
}

HFC

  • Generation two NTDs for access technology HFC.

  • The "name" field is referenced via ntdOptions[] in the firstOrAdditionalNtdPlans array.

{
   "generationTwoNtds":[
      {
         "name":"NTD_2.5",
         "ntdType":"NTD_2.5",
         "ntdVersion":"V2",
         "ntdPlanTypes":[
            "RESIDENTIAL",
            "BUSINESS"
         ],
         "fees":[
            {
               "name":"NTD_INSTALLATION_FEE",
               "oneTimeCharge":{
                  "amount":"0.00",
                  "currency":"AUD",
                  "symbol":"&#36;"
               },
               "monthlyRecurringCharge":{
                  "amount":"0.00",
                  "currency":"AUD",
                  "symbol":"&#36;"
               }
            }
         ]
      }
   ]
}

firstOrAdditionalNtdPlans Example

  • Plans available for the first NTD or an additional NTD at the location.

  • ntdOptions[] is populated with the NTD choices for the plan. References generationTwoNtds[].name.

FTTP

{
   "firstOrAdditionalNtdPlans":[
      {
         "name":"Home Fast 25/5",
         "type":"RESIDENTIAL",
         "speedDown":25,
         "speedUp":5,
          "ntdOptions":[
            "1_PORT",
            "4_PORT_RESIDENTIAL"
         ]
      },
      {
         "name":"Home Hyperfast 2000/500",
         "type":"BUSINESS",
         "speedDown":250,
         "speedUp":100,
         "ntdOptions":[
            "4_PORT"
         ]
      }
  ]
}

HFC

{
   "firstOrAdditionalNtdPlans":[
      {
         "name":"Home Fast 25/5",
         "type":"RESIDENTIAL",
         "speedDown":25,
         "speedUp":5,
          "ntdOptions":[
            "NTD_2.5"
         ]
      },
      {
         "name":"Home Hyperfast 2000/500",
         "type":"BUSINESS",
         "speedDown":250,
         "speedUp":100,
         "ntdOptions":[
            "NTD_2.5"
         ]
      }
  ]
}

generationOneNtdPlans Example

  • Plans available for a generation one NTD.

  • Only populated if there is a generation one NTD at the location.

  • Plans with a download speed > 1000 MBit/s are excluded.

  • ntdOptions[] is empty as plans requiring a generation two NTD have been excluded.

  • To order plans with a download speed > 1000 MBit/s follow the two-step process.

{
   "generationOneNtdPlans":[
      {
         "name":"Home Fast 25/5",
         "type":"RESIDENTIAL",
         "speedDown":25,
         "speedUp":5,
         "ntdOptions":[

         ]
      }
  ]
}

generationTwoNtdPlans Example

  • Plans available for a generation two NTD.

  • Only populated if there is a generation two NTD at the location.

  • ntdOptions[] is empty as generation two NTDs support all plans.

{
   "generationTwoNtdPlans":[
      {
         "name":"Home Fast 25/5",
         "type":"RESIDENTIAL",
         "speedDown":25,
         "speedUp":5,
          "ntdOptions":[
         ]
      },
      {
         "name":"Home Hyperfast 2000/500",
         "type":"BUSINESS",
         "speedDown":250,
         "speedUp":100,
         "ntdOptions":[
         ]
      }
  ]
}

infrastructure Example

  • plans references generationOneNtdPlans or generationTwoNtdPlans depending on the generation of the NTD

{
     "infrastructures":[
        {
          ...
          "ntdType":"Internal",
          "ntdVersion":"V1",
          "plans": "generationOneNtdPlans",
          ...
        }
    ]
}

Order Enhancements

When you are ordering your first NTD, or an additional NTD, and there is a list of generation two NTDs to choose from, include ntdOption in your order request to specify the NTD you want.

FTTP Example

  • Use SQ response to determine the list of ntdOptions available for your chosen plan

{
   "firstOrAdditionalNtdPlans":[
      {
         "name":"Home Fast 25/5",
         "type":"RESIDENTIAL",
         "speedDown":25,
         "speedUp":5,
          "ntdOptions":[
            "1_PORT",
            "4_PORT_RESIDENTIAL"
         ]
      }
  ]
}
  • Specify ntdOption in the create order request payload with the NTD you want

{
   "planName" : "Home Fast 25/5",
   "ntdOption": "4_PORT_RESIDENTIAL",
   ...
}
  • If ntdOption not provided in the create order request payload, the first option will be selected

1_PORT

HFC Example

  • Use SQ response to determine the list of ntdOptions available for your chosen plan

{
   "firstOrAdditionalNtdPlans":[
      {
         "name":"Home Fast 25/5",
         "type":"RESIDENTIAL",
         "speedDown":25,
         "speedUp":5,
          "ntdOptions":[
            "NTD_2.5"
         ]
      }
  ]
}
  • Specify ntdOption in the create order request payload with the NTD you want

{
   "planName" : "Home Fast 25/5",
   "ntdOption": "NTD_2.5",
   ...
}
  • If ntdOption not provided in the create order request payload, the first option will be selected

NTD_2.5

Service Plan Change Enhancements

To show what plans are offered and what NTD’s can be chosen, the plan change options response had the following added to it for FTTP and HFC access technology types:

  1. ntdOptions. An array containing available NTD options and any associated costs.

    • If the current NTD is Generation One & download speed > 1000 MBit/s, this array will contain one or more entries, each detailing an available upgrade option and its cost (if applicable).

    • If the current NTD is Generation Two, this array will be empty, as no upgrade is needed or available.

Important

  • When selecting plans with speeds greater than 1000 MBit/s, you must include a valid ntdOption in the request payload. These high-speed plans are not compatible with Generation one NTDs, and an upgrade must be specified.

Generation One ntdOptions Example

  • ntdOptions available for a generation one NTD.

{
    "plans": [
        {
            "sourceType": "NBN",
            "accessTechnology": "FTTP",
            "plan": "Home Fast 25/5",
            "term": "1",
            "downSpeed": {
                "speed": 25,
                "unit": "MBit/s"
            },
            "upSpeed": {
                "speed": 5,
                "unit": "MBit/s"
            },
            "planFee": {
                "attributes": {
                    "plan": "Home Fast 25/5",
                    "term": "1"
                },
                "oneTimeCharge": {
                    "amount": "0.00",
                    "currency": "AUD",
                    "symbol": "&#36;"
                },
                "monthlyRecurringCharge": {
                    "amount": "0.00",
                    "currency": "AUD",
                    "symbol": "&#36;"
                }
            },
            "nfasFee": null,
            "ntdOptions": []
        },
        {
            "sourceType": "NBN",
            "accessTechnology": "FTTP",
            "plan": "Home Hyperfast 2000/200",
            "term": "1",
            "downSpeed": {
                "speed": 2000,
                "unit": "MBit/s"
            },
            "upSpeed": {
                "speed": 200,
                "unit": "MBit/s"
            },
            "planFee": {
                "attributes": {
                    "plan": "Home Hyperfast 2000/200",
                    "term": "1"
                },
                "oneTimeCharge": {
                    "amount": "0.00",
                    "currency": "AUD",
                    "symbol": "&#36;"
                },
                "monthlyRecurringCharge": {
                    "amount": "115.00",
                    "currency": "AUD",
                    "symbol": "&#36;"
                }
            },
            "nfasFee": null,
            "ntdOptions": [
                {
                    "option": "1_PORT",
                    "recommended": true,
                    "fee": {
                        "attributes": {
                            "ntd_installation_fee": "1_PORT"
                        },
                        "oneTimeCharge": {
                            "amount": "0.00",
                            "currency": "AUD",
                            "symbol": "&#36;"
                        },
                        "monthlyRecurringCharge": {
                            "amount": "0.00",
                            "currency": "AUD",
                            "symbol": "&#36;"
                        }
                    }
                },
                {
                    "option": "4_PORT_RESIDENTIAL",
                    "recommended": false,
                    "fee": {
                        "attributes": {
                            "ntd_installation_fee": "4_PORT_RESIDENTIAL"
                        },
                        "oneTimeCharge": {
                            "amount": "100.00",
                            "currency": "AUD",
                            "symbol": "&#36;"
                        },
                        "monthlyRecurringCharge": {
                            "amount": "0.00",
                            "currency": "AUD",
                            "symbol": "&#36;"
                        }
                    }
                }
            ]
        }
    ]
}

Generation Two ntdOptions Example

  • ntdOptions not available for a generation two NTD.

{
    "plans": [
        {
            "sourceType": "NBN",
            "accessTechnology": "FTTP",
            "plan": "Home Fast 25/5",
            "term": "1",
            "downSpeed": {
                "speed": 25,
                "unit": "MBit/s"
            },
            "upSpeed": {
                "speed": 5,
                "unit": "MBit/s"
            },
            "planFee": {
                "attributes": {
                    "plan": "Home Fast 25/5",
                    "term": "1"
                },
                "oneTimeCharge": {
                    "amount": "0.00",
                    "currency": "AUD",
                    "symbol": "&#36;"
                },
                "monthlyRecurringCharge": {
                    "amount": "0.00",
                    "currency": "AUD",
                    "symbol": "&#36;"
                }
            },
            "nfasFee": null,
            "ntdOptions": []
        },
        {
            "sourceType": "NBN",
            "accessTechnology": "FTTP",
            "plan": "Home Hyperfast 2000/200",
            "term": "1",
            "downSpeed": {
                "speed": 2000,
                "unit": "MBit/s"
            },
            "upSpeed": {
                "speed": 200,
                "unit": "MBit/s"
            },
            "planFee": {
                "attributes": {
                    "plan": "Home Hyperfast 2000/200",
                    "term": "1"
                },
                "oneTimeCharge": {
                    "amount": "0.00",
                    "currency": "AUD",
                    "symbol": "&#36;"
                },
                "monthlyRecurringCharge": {
                    "amount": "115.00",
                    "currency": "AUD",
                    "symbol": "&#36;"
                }
            },
            "nfasFee": null,
            "ntdOptions": []
        }
    ]
}

Service Plan Change Request with ntdOption Example

{
    "serviceId": 10000,
    "planName": "Home Hyperfast 2000/200",
    "term": 1,
    "restorationSla": "Standard",
    "ntdOption": "4_PORT_RESIDENTIAL"
}

Webhooks

Appointment webhooks have a new field "appointmentFor" added. This field can have a value of ORDER or SERVICE_PLAN_CHANGE. It indicates if the appointment is due to an order or a service plan change. At the moment only the AppointmentBooked notification can have either of the two values. The rest will always have ORDER as the value. That is because AppointmentBooked is currently the only notification being sent if the appointment is due to a service plan change. The other appointment notifications will be implemented soon.

  ...
  "appointmentFor":"SERVICE_PLAN_CHANGE",
  ...