Skip to main content

Arguments

chfDeviceId : String! required

Device ID of the CHF (Communications Hub Function).

installCode : String

Code that authorises joining of the device to the HAN.

mpxn : String

MPAN/MPRN of the meter or HCALCS to join to the HAN.

newDeviceId : String! required

Device ID of the device to join to the HAN.

newDeviceType : JoinableDeviceType! required

Type of device that is being joined to the HAN.

Returns

JoinDeviceToNetwork

Send a request to the DCC to join a smart device to a HAN (Home Area Network).

Allowed Viewers

Customer Partner User Third party

Required Permissions

Can commission smart meters

Query Complexity

1

Examples

The example data in the variables and responses below are autogenerated values designed to resemble real inputs. They do not represent actual customer data, and in some cases may require additional validation.

Query

mutation JoinDeviceToNetwork( $chfDeviceId: String!, $installCode: String, $mpxn: String, $newDeviceId: String!, $newDeviceType: JoinableDeviceType! ) { joinDeviceToNetwork( chfDeviceId: $chfDeviceId, installCode: $installCode, mpxn: $mpxn, newDeviceId: $newDeviceId, newDeviceType: $newDeviceType ) { requestReference } }

Variables

{ "chfDeviceId": "29420667", "installCode": "indeed-adult-common-employee-teach", "mpxn": "operation-expert-young-election-message", "newDeviceId": "66472621", "newDeviceType": "ELECTRICITY_METER" }

Response

{ "data": { "joinDeviceToNetwork": { "requestReference": "reality-item-since-magazine-resource" } } }