Service Reference Variant
Service details
Specific Errors
| Response Code | Response Code Description |
|---|---|
E120201 | The Device ID already existed in Smart Metering Inventory and its Status was not ‘Decommissioned’ or ‘Withdrawn’ |
E120203 | The Device Type / Manufacturer / Model / Firmware Version data specified by the User do not match the values contained on the Central Products List (CPL) that have been approved for use. |
E120204 | Not all the applicable optional data items are included in the Request or not applicable data items are included in the Request |
E120207 | This Device Type (GPF) can’t be Pre-notified |
Source: DUIS 3.8.128.3
GBCS Use Case
DevicePrenotificationDUIS Service Definition
| Data Item | Description / Allowable values | Type | Mandatory | Default | Units |
|---|---|---|---|---|---|
| DeviceID | A unique ID for the Device | sr:EUI (See clause 3.10.1.3) | Yes | None | N/A |
| DeviceManufacturer | The name of the Device’s manufacturer. With the exception of IHD and CAD: • The Device Manufacturer is the <device_model_manufacturer_identifier> from the CPL and presented in the format XXXX where each X is one of the characters 0 to 9 or A to F • This data item should be aligned with the value on the CPL otherwise a validation error is raised, see E120203. Note that the DUIS data item removes the colon punctuation that exists in the CPL definition between octet values. For IHD and CAD this data item is free text and is not validated by the DCC. | sr:DeviceManufacturer (Restriction of xs:string (maxLength = 30)) | Yes | None | N/A |
| DeviceModel | The specific model of the Device, as used by the manufacturer. With the exception of IHD and CAD: • The Device Model is the concatenation of <device_model .model_identifier>< device_model .hardware_version.version>< device_model .hardware_version.revision> from the CPL and presented in the format XXXXXXXX where each X is one of the characters 0 to 9 or A to F Where: • the first 4 characters are the model identifier • the next 2 characters are the hardware version.version • the final 2 characters are the hardware version.revision • This data item must be aligned with the value on the CPL otherwise a validation error is raised, see E120203. Note that the DUIS data item removes the colon punctuation that exists in the CPL definition between octet values. For IHD and CAD this data item is free text and is not validated by the DCC. | sr:DeviceModel (Restriction of xs:string (maxLength = 30)) | Yes | None | N/A |
| DeviceType | The Type of Device Valid set: ESME GSME CHF HCALCS PPMID IHD CAD With the exception of IHD and CAD, which are not validated by the DCC, this data item must be aligned with the value on the Central Products List otherwise a validation error is raised, see E120203. See Table below for mapping between XML enumeration valid set values and CPL values. | sr:DeviceType (Restriction of xs:string (Enumeration)) | Yes | None | N/A |
| SMETSCHTSVersion | The version of SMETS or CHTS that the Device complies with e.g. V1.58 This should align with the SMETS_CHTS version version_number value contained on the CPL. | sr:SMETSCHTSVersion (Restriction of xs:string (minLength = 1, maxLength = 20)) | Device Type = CAD: N/A Otherwise: Yes | None | N/A |
| FirmwareVersion | The operational version of Firmware of the Device The Firmware version as held in the CPL and presented in the format XXXXXXXX where each X is one of the characters 0 to 9 or A to FA This data item must be aligned with the value on the Central Products List otherwise a validation error is raised, see E120203. Note that the DUIS data item removes the colon punctuation that exists in the CPL definition between octet values. | sr:FirmwareVersion (Restriction of xs:string (minLength = 1, maxLength = 8)) | All Devices except Type 2: Yes Type 2: N/A | None | N/A |
| ESMEVariant | See Table 229 for mapping and valid set. Values including F or G are not applicable to Devices prior to GBCS v4.0 | sr:ESMEVariant Restriction of xs:string (Enumeration) | DeviceType = ESME: Yes Otherwise: N/A | None | N/A |
| AssociatedGPFDeviceID | A unique ID for the Gas Proxy Function Device associated with the Communications Hub Function | sr:EUI (See clause 3.10.1.3) | DeviceType = CommunicationsHubFunction: Yes Otherwise: N/A | None | N/A |
Upon successful execution of a DevicePrenotification Service Request, the DCC shall update the Smart Metering Inventory and set the SMI Status of the DeviceId to ‘Pending’ where the Device Type is one that has an SMI Status recorded within the Smart Metering Inventory.
Message Patterns & Examples