DCC User Gateway Interface Design Specification. Annex - Service Request Definitions 1 Product Management Service

Transcription

1 DCC User Gateway Interface Design Specification Annex - Service Request Definitions 1 Product Management Service Author: DCC Version: v0.8 Draft Date: 12 th September 2014 Page 1 of 47

2 Contents 1 Product Management Service (1 PMS) Update Import Tariff (1.1) Update Import Tariff (Primary Element) (1.1.1) Update Import Tariff (Secondary Element) (1.1.2) Update Price (1.2) Update Price (Primary Element) (1.2.1) Update Price (Secondary Element) (1.2.1) Section Section Update Meter Balance (1.5) Service Request Responses Update Payment Mode (1.6) Service Request Responses Reset Tariff Block Counter Matrix (1.7) Service Request Responses Page 2 of 47

3 1 Product Management Service (1 PMS) This section sets out the full content of the DCC Product Management Service by providing the overarching service content that includes: service request and response message types, data content items and User access roles. Service Name ProductManagement Service Id 1 Service Objective Business Context Statement User Roles To allow a DCC Service User to manage the mode of operation, price or tariff at a specified meter id, such that the meter can update its configuration and confirm that the request has either completed or the reason for its failure. The Product Management service provides DCC Service Users with the ability to effect the terms of their contractual relationship with a consumer at a meter point by requesting that the device be set to operate a particular tariff, price, mode or debt configuration. The DCC Service User agrees to supply energy to a consumer at a defined cost and mode of payment (including any debt). Once agreement has been reached the DCC Service User initiates a Product Management service request to configure the meter according to the agreement with the consumer. This service may be initiated by a variety of events, such as: Change of Tenancy Change of Supplier New product offerings Customer initiated Supplier price changes The following user roles have access to the list of service requests which make up the Product Management Service: Electricity Import Suppliers (EIS) Gas Import Suppliers (GIS) Table 1 Overview of Product Management Service The mapping between the Product Management Services and the Devices they apply to is defined as follows: Service Reference Service Reference Variant Name Business Target ID Update Import Tariff (Primary Element) ESME GSME Update Import Tariff (Secondary Element) ESME (Twin Element) Update Price (Primary Element) ESME GSME Update Price (Secondary Element) ESME (Twin Element) Update Meter Balance Update Payment Mode ESME GSME ESME GSME Reset Tariff Block Counter Matrix ESME Table 2 PMS - Service Requests / Devices Page 3 of 47

4 For each of the PMS Service Requests supported by the DCC User Gateway, this section details: the reference to the appropriate section of the XML Schema (see XML Schema document 3 of this documentation set) the structure of each Service Request and Response with examples (if specific to the Service Request) if applicable, Service Request specific Validation and Response Codes This section should be read in conjunction with the Main Document of this documentation set section 9 (which describes the general formatting for all Service Requests and Service Responses) and with the XSD (XML Schema document 3 of this documentation set). 1.1 Update Import Tariff (1.1) This Service Request maps to two GBCS Use Cases and each Use Case requires its own Request ID. Therefore the 1.1 Service Request has been broken into two parts:1.1.1 (Primary Element) and (Secondary Element) Update Import Tariff (Primary Element) (1.1.1) Service Request Name UpdateImportTariff Service Reference 1.1 Service Request Variant Name UpdateImportTariff(PrimaryElement) Service Reference Variant Service Request Objective Business Context Statement To enable a DCC Service User to send a new tariff structure to a ESME/GSME for a specified meter id, such that the meter can update its configuration and confirm that the operation has either completed or the reason for its failure. The DCC Service User requires a new or updated tariff to be applied to a specified device. The assumption is that there are unlikely to be scenarios where a tariff structure would change without an associated change in prices so this service request includes both tariff structure and price data items (also included in 1.2 see section 1.2). This service request would be initiated in the following scenarios: new customer (CoT) new supplier (CoS) customer requests move to new tariff with same supplier customer offer (tariff period) expired and Standard tariff now appropriate customer changes mode (CR to PP/PP to CR) and new tariff required User Role Access Electricity Import Supplier (EIS) Gas Import Supplier (GIS) Security Classification Critical and non-sensitive GBCS XREF: SME.C.C Page 4 of 47

5 1. This Service Request is used for creating a new tariff on the Smart Meter where the initial condition of the tariff is unknown or for updating existing tariffs over time on a specified ESME/GSME 2. This Service Request also sets the initial price associated with the specified Tariff so Service Request 1.2 is not required to be sent in addition to this Service Request for the initial Tariff Setting. Service Request 1.2 is only applicable for any subsequent updates to the Tariff price. Service Request Narrative 3. This Service Request updates the tariff and price on the Primary Element of an Electricity Smart Meter or on a Gas Smart Meter. A separate Service Request is used to update the Secondary Element on an Electricity Smart Meter. 4. This Service Request updates the following data items as specified in SMETS, - Tariff Type - Standing Charge - Tariff Block Price Matrix - Tariff Threshold Matrix - Tariff Switching Table Table 3 Update Import Tariff Service Request (Primary Element) This section should be read in conjunction with the Main Document of this documentation set section 9 (which describes the general formatting for all Service Requests and Service Responses) and with the XSD (XML Schema document 3 of this documentation set) Service Request Format The Request Body XML element of the XSD (see XML Schema document 3 of this documentation set) defines the structure of all the Service Requests. The UpdateImportTariff PrimaryElementXML element defines this Service Request and contains all the Data Items to set the tariff and price on the Device and, for Future Dated Requests, the Execution Date and Time. Page 5 of 47

6 Figure 1 UpdateImportTariffPrimaryElement Figure 2 ElectricityTariffElements Figure 3 ElectricityTariffSwitchingTable Page 6 of 47

7 Figure 4 DayProfiles Figure 5 WeekProfiles Figure 6 Seasons Figure 7 ElectricityTariffSwitchingTableSpecialDays Page 7 of 47

8 Figure 8 ElectricityTariffThresholdMatrix Figure 9 GasTariffElements Figure 10 DayProfiles Figure 11 WeekProfiles Page 8 of 47

9 Figure 12 Seasons Figure 13 GasTariffSwitchingTableSpecialDays UpdateImportTariffPrimaryElement Definition The data items contained in the Service Request are defined as: ExecutionDateTime The UTC date and time the DCC User requires the command to be executed on the Device ID xs:datetime No None UTC Date- Time Non- Valid date-time in the future ElectricityTariffElements Electricity Smart Meter specific tariff elements sr:electricitytariffelemen ts (see section ) Electricity Smart Meter: Yes Gas Smart Meter: N/A None N/A Non- GasTariffElements Gas Smart Meter specific tariff elements sr:gastariffelements (see section ) Electricity Smart Meter: N/A Gas Smart Meter: Yes None N/A Non- PriceElements All the Data Items required to update the price on the Device are defined in Service Request 1.2 Update Price sr:priceelementsprimary Element (see section ) Page 9 of 47

10 Table 4 Update Import Tariff (Primary Element) Service Request Data Items ElectricityTariffElements Data Items Definition BlockDailyReset If set to Enabled the Electricity Smart Meter will reset the counters in the Tariff Block Counter Matrix once per Day and in accordance with the timetable set-out in the Billing Calendar Restriction of xs:string (Enumeration) Valid set: Enabled Not Enabled CurrencyUnits The Currency Units currently used by a Smart Meter for display purposes, which shall be GB Pounds Valid set: Restriction of xs:string (Enumeration) No GBP N/A Non- GBP. GB Pounds ElectricityTariffS witchingtable A calendar defining UTC times, days and dates for switching the Primary Element tariff sr: TariffSwitchingTablePri maryelement (see section ) ElectricityTariffS witchingtables pecialdays A calendar defining special dates for switching the Primary Element tariff sr: TariffSwitchingTableSpe cialdaysprimaryelement (see section ) ElectricityTariffT hesholdmatrix A 3 (thresholds) x 8 (rows) matrix capable of holding thresholds for controlling Block Tariffs. sr:electricitytariffthresh oldmatrix (see section ) Table 5 Update Import Tariff (Primary Element) Service Request - ElectricityTariffElements Data Items ElectricityTariffSwitchingTable Data Items Definition DayProfiles Containing up to 16 DayProfile elements sr:elecdayprofiles (see section ) WeekProfiles Containing up to 4 WeekProfile elements sr:elecweekprofiles (see section ) Seasons Containing up to 4 Season elements sr:elecseasonsprimary Element (see section ) Table 6 Update Import Tariff (Primary Element) Service Request - TariffSwitchingTablePrimaryElement Data Items DayProfile Data Items Definition Page 10 of 47

11 Day An identifier for that day that has a number of ProfileSchedule elements associated with it. Note that this is referenced from the WeekProfile element Restriction of xs:positiveinteger (totaldigits = 2) ProfileSchedule Array of 48 Actions and Start Times when an action (script) to trigger a tariff switch is to be run Note that the attribute index provides and ordering for these elements. sr:profilescheduleprima ryelelement (see section ) Yes 1 None N/A Non- Table 7 Update Import Tariff Service (Primary Element) Request - DayProfile Data Items 1 Minimum 1 and maximum ProfileSchedule Data Items Definition StartTime The time at which the action is to execute xs:time TOUTariffAction Identifier (n) of the Script to be run to apply Primary TOU Tariff Price Matrix [n] (n between 01 and 48) Valid set: Value between 01 and 48 Restriction of xs:nonnegativeinteger (mininclusive = 01, maxinclusive = 48 totaldigits = 2) TOU Tariff to be applied: Yes Otherwise: N/A None N/A Non- TOUWithBlockTar iffaction Identifier (n) of the Script to be run to apply Primary Block Tariff Price Matrix [n] (n between 101 and 108) Valid set: Value between 101 and 108 Restriction of xs:nonnegativeinteger (mininclusive = 101, maxinclusive = 108 totaldigits = 3) TOU Tariff With Block to be applied: Yes Otherwise: N/A None N/A Non- Table 8 Update Import Tariff (Primary Element) Service Request - ProfileSchedule Data Items WeekProfile Data Items Definition WeekName An identifier for the week. Restriction of xs:positiveinteger (totaldigits = 2) ReferencedElecDay Day as defined in Note that the attribute index provides and ordering for these elements. Day as defined in Table 9 Update Import Tariff (Primary Element) Service Request - WeekProfile Data Items Season Data Items Definition Page 11 of 47

12 SeasonName An identifier for the season. Note that the attribute index provides and ordering for these elements. Restriction of xs:string (maxlength = 8) SeasonStartDate The date from which this season is defined to start sr:date (See annex 17) ReferencedWeekName Week name as defined in Week name as defined in Table 10 Update Import Tariff (Primary Element) Service Request - Season Data Items ElectricityTariffSwitchingTableSpecialDays Data Items Definition ElectrictyTariffSwit chingtablespecial Days A collection of up to 20 Special Days Note that the attribute index provides and ordering for these elements. sr:elecspecialdaysprim aryeleement (see section ) Table 11 Update Import Tariff (Primary Element) Service Request ElectricityTariffSwitchingTableSpecialDays Data Items SpecialDay Data Items Definition Date The date on which the special day applies sr:date (see Annex Section 17) ReferencedDay Day as defined in Day as defined in Table 12 Update Import Tariff (Primary Element) Service Request - SpecialDay Data Items ElectricityTariffThresholdMatrix Data Items Definition ElectricityTariffThr esholds Row of Electricity Tariff Thresholds in the matrix Note that the attribute index provides and ordering for these elements. sr:electricitytariffthresh olds (see section ) Table 13 Update Tariff (Primary Element) Service Request - ElectricityTariffThresholdMatrix Data Items Yes 1 None N/A Non- 1 Minimum 1 and Maximum ElectricityTariffThresholds Data Items Definition BlockThreshold Threshold between one block and the next xs:nonnegativeinteger Yes 1 None kwh Non- Page 12 of 47

13 AssociatedTOUWi thblocktariffactio n The action (script) that is run when the prices in this row of the Block matrix are applicable Valid set: Value between 101 and 108 Restriction of xs:string (mininclusive = 101, maxinclusive = 108) No None N/A Non- Table 14 Update Tariff (Primary Element) Service Request - ElectricityTariffThresholds Data Items 1 Minimum 1 and Maximum GasTariffElements Data Items Definition GasTariffSwitchin gtable A calendar defining UTC times, days and dates for switching the tariff sr: TariffSwitchingTableGas (see section ) GasTariffSwitchin gtablespecialday s A calendar defining special dates for switching the Primary Element tariff sr:tariffswitchingtables pecialdaysgas (see section Error! Reference source not found.) Table 15 Update Import Tariff (Primary Element) Service Request - GasTariffElements Data Items GasTariffSwitchingTable Data Items Definition DayProfiles Array of up to 4 DayProfiles defining a Day identifiers and a list of 48 actions (script IDs) and start times to switch tariff sr:gasdayprofile (see section Error! Reference source not found.) WeekProfiles Array of up to 4 elements, each including a WeekName and the Day identifiers to be associated with a day of each day (Monday to Sunday) sr:weekprofilesgas Seasons Array of 2 elements, each including a Season ID, a Season Start Date and the Week ID associated to that Season ID sr:gasseasons Table 16 Update Import Tariff (Primary Element) Service Request - TariffSwitchingTablePrimaryElement Data Items DayProfile Data Items Definition Day An identifier for that day that has a number of ProfileSchedule elements associated with it. Note that this is referenced from the WeekProfile element sr:daygasname Page 13 of 47

14 ProfileSchedule Array of 48 Actions and Start Times when an action (script) to trigger a tariff switch is to be run Note that the attribute index provides and ordering for these elements. sr:profileschedulegas (see section ) Yes 1 None N/A Non- Table 17 Update Import Tariff Service (Primary Element) Request - DayProfile Data Items ProfileSchedule Data Items Definition StartTime Time when a specific Action is to be taken (script to be run) xs:time TOUTariffAction Identifier (n) of the Script to be run to apply Gas TOU Tariff Price Matrix [n] (n between 01 and 04) Valid set: Value between 01 and 04 Restriction of xs:nonnegativeinteger (mininclusive = 01, maxinclusive = 04 totaldigits = 2) TOU Tariff to be applied: Yes Otherwise: N/A None N/A Non- TOUWithBlockTar iffaction Identifier (n) of the Script to be run to apply Gas Block Tariff Price Matrix [n] (n = 101) Valid set: 101 Restriction of xs:nonnegativeinteger (mininclusive = 101, maxinclusive = 101 totaldigits = 3) TOU Tariff With Block to be applied: Yes Otherwise: N/A 101 N/A Non- Table 18 Update Import Tariff (Primary Element) Service Request - ProfileSchedule Data Items WeekProfile Data Items Definition WeekName An identifier for the week. sr:gasweekname ReferencedElecDay Day as defined in Note that the attribute index provides and ordering for these elements. Day as defined in Table 19 Update Import Tariff (Primary Element) Service Request - WeekProfile Data Items Season Data Items Definition SeasonName An identifier for the season. Note that the attribute index provides and ordering for these elements. Restriction of xs:string (maxlength = 8) Page 14 of 47

15 SeasonStartDate The date from which this season is defined to start sr:date (See annex 17) ReferencedWeekName Week name as defined in Week name as defined in Table 20 Update Import Tariff (Primary Element) Service Request - Season Data Items GasTariffSwitchingTableSpecialDays Data Items Definition ElectrictyTariffSwit chingtablespecial Days A collection of up to 20 Special Days Note that the attribute index provides and ordering for these elements. sr:gasspecialday (see section ) Table 21 Update Import Tariff (Primary Element) Service Request GasTariffSwitchingTableSpecialDays Data Items SpecialDay Data Items Definition Date The date on which the special day applies sr:date (see Annex Section 17) ReferencedDay Day as defined in Day as defined in Table 22 Update Import Tariff (Primary Element) Service Request - SpecialDay Data Items Applicable Modes of Operation The Modes of Operation applicable to this Service Request are (see Main Document of this documentation set section 2.3 for Modes of Operation definitions): Transform On Demand DCC Only Future Dated DSP Scheduled Yes Yes No Device No Table 23 Update Import Tariff (Primary Element) Modes of Operation Applicable Command Variant Values The Command Variant values applicable to this Service Request are (see Main Document of this documentation set section 3 for Command Variant definitions): Validation CV = 1 CV = 2 CV = 3 CV = 4 CV = 5 CV = 6 CV = 7 CV = 8 No No No Yes Yes Yes Yes No Table 24 Update Import Tariff (Primary Element) Command Variant Values This Service Request has no specific validation. See the Main Document of this documentation set section 7 for generic access control checks and Annex section 17.2 for Execution Date Time) validation. Page 15 of 47

16 Sample Request There are two versions applicable to this Service Request Transform Service Request Signed Pre-command Sample requests are given in Annex Introduction Appendix 2. The specific information for this Service Request (Body) is as follows: Please note only a subset of the TariffSwitchingTable has been included for illustration purposes. Due to its size and to include Electricity and Gas, the sample has been split into 4 figures. <UpdateImportTariffPrimaryElement> See Figure 15Error! Reference source not found. for details of ElectricityTariffElements See Figure 30 for details of PriceElements </UpdateImportTariffPrimaryElement> Figure 14 Update Import Tariff (Primary Element) Transform Request (Body) Format <sr:electricitytariffelements> <sr:blockdailyreset>enabled</sr:blockdailyreset> <sr:electricitytariffswitchingtable> <sr:dayprofiles> <sr:dayprofile index="1"> <sr:day>1</sr:day> <sr:profileschedule> <sr:starttime>00:00:00.000</sr:starttime> <sr:toutariffaction>01</sr:toutariffaction> </sr:profileschedule> </sr:dayprofile> <sr:dayprofile index="2"> <sr:day>2</sr:day> <sr:profileschedule> <sr:starttime>00:00:00.000</sr:starttime> <sr:toutariffaction>02</sr:toutariffaction> </sr:profileschedule> </sr:dayprofile> </sr:dayprofiles> <sr:weekprofiles> <sr:weekprofile index="1"> <sr:weekname>1</sr:weekname> <sr:referencedelecday index="1">1</sr:referencedelecday> <sr:referencedelecday index="2">1</sr:referencedelecday> <sr:referencedelecday index="3">1</sr:referencedelecday> <sr:referencedelecday index="4">1</sr:referencedelecday> <sr:referencedelecday index="5">1</sr:referencedelecday> <sr:referencedelecday index="6">1</sr:referencedelecday> <sr:referencedelecday index="7">1</sr:referencedelecday> </sr:weekprofile> </sr:weekprofiles> <sr:seasons> <sr:season index="1"> Page 16 of 47

17 <sr:seasonname>all</sr:seasonname> <sr:seasonstartdate> <sr:year><sr:nonspecifiedyear></sr:nonspecifiedyear></sr:year> <sr:month><sr:nonspecifiedmonth></sr:nonspecifiedmonth></sr:month> <sr:dayofmonth><sr:nonspecifieddayofmonth></sr:nonspecifieddayofmonth></sr:dayofmonth> <sr:dayofweek><sr:nonspecifieddayofweek></sr:nonspecifieddayofweek></sr:dayofweek> </sr:seasonstartdate> <sr:referencedweekname index="1">1</sr:referencedweekname> </sr:season> </sr:seasons> </sr:electricitytariffswitchingtable> <sr:electricitytariffswitchingtablespecialdays> <sr:specialday index="1"> <sr:date> <sr:year><sr:specifiedyear>2015</sr:specifiedyear></sr:year> <sr:month><sr:specifiedmonth>12</sr:specifiedmonth></sr:month> <sr:dayofmonth><sr:specifieddayofmonth>25</sr:specifieddayofmonth></sr:dayofmonth> <sr:dayofweek><sr:nonspecifieddayofweek></sr:nonspecifieddayofweek></sr:dayofweek> </sr:date> <sr:referencedday>2</sr:referencedday> </sr:specialday> </sr:electricitytariffswitchingtablespecialdays> <sr:electricitytariffthresholdmatrix> <sr:electricitytariffthresholds index="1"> <sr:blockthreshold>0</sr:blockthreshold> <sr:associatedtouwithblocktariffaction>101</sr:associatedtouwithblocktariffaction> </sr:electricitytariffthresholds> </sr:electricitytariffthresholdmatrix> </sr:electricitytariffelements> Figure 15 Update Import Tariff (Primary Element) Transform Request Format (ElectricityTariffElements Detail) In this example: Special Days include Christmas of 2015, with a Day Identifier set to 2. Day Profiles; Two days (day 1 and day 2) are defined, both run from midnight but with actions 01 and 02 respectively. Weeks. Week with name 1 has been defined. Seasons. Only Season ALL has been defined Responses The response messages for an Update Import Tariff (Primary Element) request follow the generic format for all Device response messages, the generic responses applicable to this request are; Pre-command Acknowledgement Page 17 of 47

18 Service Response (from Device) - GBCSPayload Service Response (from Device) - FutureDatedDeviceAlertMessage Command for Local Delivery Response & Alert Common Interface Sample responses are given in Annex Introduction Appendix 1, response specific information details are given below Response & Alert Common Interface Format The response to this request returns only status without any substantial payload. The XML type is UpdateImportTariffPrimaryElementRsp. Please see Annex section 18.8 for a description of how status-only responses are represented in the Response and Alert Common Interface XML schema Specific Header Data Items Data Item Electricity Response Gas Response GBCSHexadecimalMessageCode B GBCSUseCaseNumber ECS01a GCS01a GBCSUseCaseName Set Tariff and Price on ESME Set Tariff and Price on GSME Table 25 - Update Import Tariff (Primary Element) Parse Response Header Data Items Update Import Tariff (Secondary Element) (1.1.2) Service Request Name UpdateImportTariff Service Reference 1.1 Service Request Variant Name UpdateImportTariff(SecondaryElement) Service Reference Variant Service Request Objective To enable a DCC Service User to create a new tariff for second element and update this Tariff on a specified Electricity Smart Meter where the initial condition of the tariff is unknown or for updating existing tariffs for second element. Page 18 of 47

19 Business Context Statement The DCC Service User requires a new or updated tariff to be applied to a specified device. The assumption is that there are unlikely to be scenarios where a tariff structure would change without an associated change in prices so this service request includes both tariff structure and price data items (also included in 1.2 see section 1.2). This service request would be initiated in the following scenarios: new customer (CoT) new supplier (CoS) customer requests move to new tariff with same supplier customer offer (tariff period) expired and Standard tariff now appropriate customer changes mode (CR to PP/PP to CR) and new tariff required User Role Access Electricity Import Supplier (EIS) Security Classification Critical and non-sensitive GBCS XREF: SME.C.C 1. This Service Request updates the tariff and price on the Secondary Element of a Twin Element Electricity Smart Meter 2. This Service Request updates the following data items as specific din SMETS, Service Request Narrative - Tariff Switching Table - Secondary Tariff TOU Price Matrix - A 1 x 4 matrix containing prices for Time-of-use Pricing Tariffs relating to Supply via the secondary measuring element of the Electricity Meter Table 26 Update Import Tariff (Secondary Element) Service Request This section should be read in conjunction with the Main Document of this documentation set section 9 (which describes the general formatting for all Service Requests and Service Responses) and with the XSD (XML Schema document 3 of this documentation set) Service Request Format The Request Body XML element of the XSD (see XML Schema document 3 of this documentation set) defines the structure of all the Service Requests. The UpdateImportTariffSecondaryElement XML element defines this Service Request and contains all the Data Items to set the tariff and price on the Secondary Element of the Meter and, for Future Dated Requests, the Execution Date and Time. Page 19 of 47

20 Figure 16 UpdateImportTariffSecondaryElement Figure 17 ElectricityTariffSwitchingTable Figure 18 DayProfile Page 20 of 47

21 Figure 19 WeekProfile Figure 20 Season Figure 21 ElectricityTariffSwitchingTableSpecialDays Figure 22 PriceElements Specific Data Items Definition The data items contained in the Service Request are defined as: Page 21 of 47

22 ExecutionDateTime The UTC date and time the DCC User requires the command to be executed on the Device ID xs:datetime No None UTC Date- Time Non- Valid date-time in the future ElectricityTariffSwitc hingtable A calendar defining UTC times, days and dates for switching the Secondary Element tariff sr: TariffSwitchingTableSec ondaryelement (see section ) ElectricityTariffSwitc hingtablespecialda ys A calendar defining special dates for switching the Secondary Element tariff sr: TariffSwitchingTableSpe cialdayssecondaryelem ent (see section Error! Reference source not found.) PriceElements All the Data Items required to update the price on the Second Element of the Electricity Smart Meter will be defined in Service Request Update Price Secondary Element sr:priceelementssecond aryelement (see section TBC) Table 27 Update Import Tariff (Secondary Element) Service Request Data Items TariffSwitchingTableSecondaryElement Data Items Definition DayProfiles Containing up to 16 DayProfile elements sr:elecdayprofilessecon dary (see section ) WeekProfiles Containing up to 4 WeekProfile elements sr:elecweekprofiles (see section ) Seasons Containing up to 4 Season elements sr:elecseasonsseconda ryelement (see section ) Table 28 Update Import Tariff (Secondary Element) Service Request - TariffSwitchingTableSecondaryElement Data Items DayProfile Data Items Definition Day An identifier for that day that has a number of ProfileSchedule elements associated with it. Note that this is referenced from the WeekProfile element Restriction of xs:positiveinteger (totaldigits = 2) ProfileSchedule Array of 4 Actions and Start Times when an action (script) to trigger a tariff switch is to be run Note that the attribute index provides and ordering for these elements. sr:profileschedulesecon daryelement (see section ) Page 22 of 47

23 ProfileSchedule Data Items Definition StartTime The time at which the action is to execute xs:time TOUTariffAction Identifier (n) of the Script to be run to apply Primary TOU Tariff Price Matrix [n] (n between 01 and 48) Valid set: Value between 01 and 48 Restriction of xs:nonnegativeinteger (mininclusive = 01, maxinclusive = 04 totaldigits = 2) TOU Tariff to be applied: Yes Otherwise: N/A None N/A Non WeekProfile Data Items Definition WeekName An identifier for the week. Restriction of xs:positiveinteger (totaldigits = 2) ReferencedElecDay Day as defined in Note that the attribute index provides and ordering for these elements. Day as defined in Season Data Items Definition SeasonName An identifier for the season. Note that the attribute index provides and ordering for these elements. Restriction of xs:string (maxlength = 8) SeasonStartDate The date from which this season is defined to start sr:date (See Annex 17) ReferencedWeekName Week name as defined in Week name as defined DayIdentifiersSecondaryElement Data Items Definition TimeStartAction Array of 4 Actions and Start Times when an action (script) to trigger a tariff switch is to be run sr:date (see Annex 17) Yes 1 None N/A Non- DayIdentifier DayIdentifier that can be referred to in the other Switching structures, e.g. SpecialDays, Weeks Restriction of xs:positiveinteger (totaldigits = 2) Table 29 Update Import Tariff (Secondary Element) Service Request - DayIdentifiersSecondaryElement Data Items 1 Minimum 1 and maximum ElectricityTariffSwitchingTableSpecialDays Data Items Definition Page 23 of 47

24 ElectrictyTariffSwit chingtablespecial Days A collection of up to 20 Special Days Note that the attribute index provides and ordering for these elements. sr:elecspecialdaysseco ndaryeleement (see section ) SpecialDay Data Items Definition Date The date on which the special day applies sr:date (see Annex 17) ReferencedDay Day as defined in X Day as defined in PriceElements Data Items Definition ElectricityPriceEle ments Twin Element Electricity Smart Meter: A 1 x 4 matrix containing prices for Time-of-use Pricing Tariffs relating to Supply via the secondary measuring element of the Electricity Meter sr:electricitytarifftoum atrixsecondaryelement (see section ) Table 30 Update Import Tariff (Secondary Element) Service Request - PriceElementsSecondaryElement Data Items None N/A Non- 1 Minimum 1 and maximum ElectricityPriceElements Data Items Definition TOUPrice Price applicable to a TOU Tariff when the corresponding Action (script) defined in the Tariff Switching Table Day Identifiers Time Start Action is triggered. See section Error! Reference source not found.. xs:nonnegativeinteger Yes None 1000 th pence per kwh Non- AssociatedTOUTa riffaction Identifier (n) of the Script to be run to apply Secondary Tariff Price Matrix [n] (n between 01 and 04). Included in this array to link the Price to the corresponding action (script) Valid set: Value between 01 and 04 Restriction of xs:nonnegativeinteger (mininclusive = 01, maxinclusive = 04 totaldigits = 2) Table 31 Update Import Tariff (Secondary Element) Service Request - SecondaryTariffTOUPriceTariff Data Items Applicable Modes of Operation The Modes of Operation applicable to this Service Request are (see Main Document of this documentation set section 2.3 for Modes of Operation definitions): Page 24 of 47

25 Transform On Demand DCC Only Future Dated DSP Scheduled Yes Yes No Device No Table 32 Update Import Tariff (Secondary Element) Modes of Operation Applicable Command Variant Values The Command Variant values applicable to this Service Request are (see Main Document of this documentation set section 3 for Command Variant definitions): Validation CV = 1 CV = 2 CV = 3 CV = 4 CV = 5 CV = 6 CV = 7 CV = 8 No No No Yes Yes Yes Yes No Table 33 Update Import Tariff (Secondary Element) Command Variant Values This Service Request has no specific validation. See the Main Document of this documentation set section 7 for generic access control checks and Annex section 17.2 for Execution Date Time) validation Sample Request There are two versions applicable to this Service Request Transform Service Request Signed Pre-command Sample requests are given in Annex Introduction Appendix 2. The specific information for this Service Request (Body) is as follows: Due to its size, the sample has been split into multiple figures. <UpdateImportTariffSecondaryElement> See Figure 24 for details of Tariff Switching Table See Figure 25 for details of Tariff Switching Table Special Days See Figure 26 for details of PriceElements </UpdateImportTariffSecondaryElement> Figure 23 Update Import Tariff (Secondary Element) Transform Request (Body) Format Page 25 of 47

26 <sr:electricitytariffswitchingtable> <sr:dayprofiles> <sr:dayprofile index="1"> <sr:day>1</sr:day> <sr:profileschedule> <sr:starttime>00:00:00.000</sr:starttime> <sr:toutariffaction>24</sr:toutariffaction> </sr:profileschedule> </sr:dayprofile> <sr:dayprofile index="2"> <sr:day>1</sr:day> <sr:profileschedule> <sr:starttime>00:00:00.000</sr:starttime> <sr:toutariffaction>25</sr:toutariffaction> </sr:profileschedule> </sr:dayprofile> </sr:dayprofiles> <sr:weekprofiles> <sr:weekprofile index="1"> <sr:weekname>128</sr:weekname> <sr:referencedelecday index="1">1</sr:referencedelecday> <sr:referencedelecday index="2">1</sr:referencedelecday> <sr:referencedelecday index="3">1</sr:referencedelecday> <sr:referencedelecday index="4">1</sr:referencedelecday> <sr:referencedelecday index="5">1</sr:referencedelecday> <sr:referencedelecday index="6">1</sr:referencedelecday> <sr:referencedelecday index="7">1</sr:referencedelecday> </sr:weekprofile> </sr:weekprofiles> <sr:seasons> <sr:season> <sr:seasonname>spring</sr:seasonname> <sr:seasonstartdate> <sr:year><sr:specifiedyear>2015</sr:specifiedyear></sr:year> <sr:month><sr:nonspecifiedmonth>ff</sr:nonspecifiedmonth></sr:month> <sr:dayofmonth><sr:nonspecifieddayofmonth>ff</sr:nonspecifieddayofmonth></sr:dayofmonth> <sr:dayofweek><sr:nonspecifieddayofweek>f</sr:nonspecifieddayofweek></sr:dayofweek> </sr:seasonstartdate> <sr:referencedweekname index="1">1</sr:referencedweekname> </sr:season> </sr:seasons> </sr:electricitytariffswitchingtable> Figure 24 Update Import Tariff (Secondary Element) Transform Request Format (TariffSwitchingTable Detail) Page 26 of 47

27 <sr:electricitytariffswitchingtablespecialdays> <sr:specialday index="10"> <sr:date> <sr:year><sr:specifiedyear>2015</sr:specifiedyear></sr:year> <sr:month><sr:specifiedmonth>12</sr:specifiedmonth></sr:month> <sr:dayofmonth><sr:specifieddayofmonth>26</sr:specifieddayofmonth></sr:dayofmonth> <sr:dayofweek><sr:nonspecifieddayofweek></sr:nonspecifieddayofweek></sr:dayofweek> </sr:date> <sr:referencedday>2</sr:referencedday> </sr:specialday> </sr:electricitytariffswitchingtablespecialdays> Figure 25 Update Import Tariff (Secondary Element) Transform Request Format (TariffSwitchingTableSpecialDays Detail) <sr:priceelements> <sr:electricitypriceelements index="1"> <sr:tarifftouprice>50</sr:tarifftouprice> <sr:associatedtoutariffaction>1</sr:associatedtoutariffaction> </sr:electricitypriceelements> <sr:electricitypriceelements index="2"> <sr:tarifftouprice>55</sr:tarifftouprice> <sr:associatedtoutariffaction>2</sr:associatedtoutariffaction> </sr:electricitypriceelements> </sr:priceelements> Figure 26 Update Import Tariff (Secondary Element) Transform Request Format (PriceElements Detail) In this example: Special Days include Christmas and Boxing Day of every year, both with a Day Identifier set to 02. Day Profiles; Day 01 defined with action 24 and Day 02 defined with action 25. Weeks. Week 1 has been defined, each day of the week references Day 1 Seasons. Only Season Identifier Spring has been defined, which references week Responses The response messages for an Update Import Tariff(Secondary Element) request follow the generic format for all Device response messages, the generic responses applicable to this request are; Pre-command Acknowledgement Service Response (from Device) - GBCSPayload Service Response (from Device) - FutureDatedDeviceAlertMessage Command for Local Delivery Response & Alert Common Interface Sample responses are given in Annex Introduction Appendix 1, response specific information details are given below. Page 27 of 47

28 Response & Alert Common Interface Format The response to this request returns only status without any substantial payload. The XML type is UpdateImportTariffSecondaryElementRsp. Please see Annex section 18.8 for a description of how status-only responses are represented in the Response and Alert Common Interface XML schema Specific Header Data Items Data Item Electricity Response GBCSHexadecimalMessageCode GBCSUseCaseNumber GBCSUseCaseName 00B7 ECS01c Set Tariff and Price on ESME secondary Table 34 - Update Import Tariff (Secondary Element) Parse Response Header Data Items 1.2 Update Price (1.2) This Service Request maps to two GBCS Use Cases and each Use Case requires its own Request ID. Therefore the 1.2 Service Request has been broken into two parts:1.2.1 (Primary Element) and (Secondary Element) Update Price (Primary Element) (1.2.1) Service Request Name UpdatePrice Service Reference 1.2 Service Request Variant Name UpdatePrice(PrimaryElement) Service Reference Variant Service Request Objective Business Context Statement To enable a DCC Service User to send a new currency unit price per time/unit of energy consumed to a meter such that the meter can update its configuration and confirm that the operation has either completed, or the reason for its failure. The DCC Service User requires a new or updated pricing structure to be applied to a specified meter, e.g. following a supplier price change, without changing tariff structure. The price update must be effected within a reasonable period of time after the agreement or after the preceding event (e.g. CoS). This period may be the same day. User Role Access Electricity Import Supplier (EIS) Gas Import Supplier (GIS) Security Classification Critical and non-sensitive GBCS XREF: SME.C.C Page 28 of 47

29 Service Request Narrative 1. This Service Request updates the price on the Primary Element of an Electricity Smart Meter or on a Gas Smart Meter Table 35 Update Price (Primary Element) Service Request This section should be read in conjunction with the Main Document of this documentation set section 9 (which describes the general formatting for all Service Requests and Service Responses) and with the XSD (XML Schema document 3 of this documentation set) Service Request Format The Request Body XML element of the XSD (see XML Schema document 3 of this documentation set) defines the structure of all the Service Requests. Its UpdatePricePrimaryElement XML element defines this Service Request and contains the Execution Date and Time and all the Data Items to set the price on the Device. Figure 27 UpdatePricePrimaryElement Figure 28 ElectricityPriceElements Page 29 of 47

30 Figure 29 GasPriceElements Specific Data Items Definition The data items contained in the Service Request are defined as: ExecutionDateTime The UTC date and time the DCC User requires the command to be executed on the Device ID Valid date-time in the future xs:datetime Yes None UTC Date- Time Non- PriceElements All the Data Items required to update prices on the Primary Element of the Device sr:priceelements (see section ) Table 36 Update Price (Primary Element) Service Request Data Items PriceElements Data Items Definition StandingCharge A charge to be levied in Currency Units per unit time when operating in Credit Mode and Prepayment Mode xs:nonnegativeinteger Yes None 1000 th pence per day Non- Valid set: >= 0 Page 30 of 47

31 TariffType The Tariff type in operation, being Time-of-use or Time-of-use with Block. Restriction of xs:string (Enumeration) Valid Set: TOU TOU With Block ElectricityPriceEle ments Electricity Smart Meter specific price elements sr:electricitypriceeleme nts (see section ) Electricity Smart Meter: Yes Gas Smart Meter: N/A None N/A Non- GasPriceElement s Gas Smart Meter specific price elements sr:gaspriceelements (see section ) Electricity Smart Meter: N/A Gas Smart Meter: Yes None N/A Non- Table 37 Update Price (Primary Element) Service Request - PriceElements Data Items ElectricityPriceElements Data Items Definition ElectricityTariffBlo ckpricematrix Up to 8 block price defintions, with 4 prices per block sr:electricitytariffblockp ricematrix (see section ) Yes 1 None N/A Non- ElectricityTariffTO UPriceMatrix Up to 48 TOU prices sr:electricitytarifftoupri cematrix (see section ) Yes 2 None N/A Non- Table 38 Update Price (Primary Element) Service Request - ElectricityPriceElements Data Items 1 Minimum 1 and Maximum 8 2 Minimum 1 and Maximum ElectricityTariffBlockPriceMatrix Data Items Definition BlockPrices Price applicable to a TOU with Block Tariff sr:blockprices Yes None 1000 th pence per kwh Non- Page 31 of 47

32 AssociatedTOUWi thblocktariffactio n Identifier (n) of the Script to be run to apply Primary TOU With Block Tariff Price Matrix [n] (n between 101 and 108). Included in this array to link the Price to the corresponding action (script) Valid set: Value between 101 and 108 Restriction of xs:string (mininclusive = 101, maxinclusive = 108) Table 39 Update Price (Primary Element) Service Request - ElectricityTariffBlockPriceMatrix Data Items BlockPrices Data Items Definition Price Up to 4 prices for each block. Note that the attribute index provides and ordering for these elements. xs:nonnegativeinteger Yes 1 None 1000 th pence per kwh Table 40 Update Price (Primary Element) Service Request - BlockPrices Data Items Non ElectricityTariffTOUPriceMatrix Data Items Definition TariffTOUPrice Price applicable to a TOU Tariff xs:nonnegativeinteger Yes None 1000 th pence per kwh Non- AssociatedTOUTa riffaction Identifier (n) of the Script to be run to apply Primary TOU Tariff Price Matrix [n] (n between 01 and 48). Included in this array to link the Price to the corresponding action (script) Valid set: Value between 01 and 48 Restriction of xs:string (mininclusive = 01, maxinclusive = 48 totaldigits = 2) Table 41 Update Price (Primary Element) Service Request - ElectricityTariffTOUPriceMatrix Data Items GasPriceElements Data Items Definition CurrencyUnits The Currency Units currently used by a Smart Meter for display purposes only, which shall be GB Pounds Restriction of xs:string (Enumeration) No GBP N/A Non- Valid set: GBP. GB Pounds GasTariffBlockPri cematrix Gas Smart Meter: A 4 x 1 matrix containing Prices for Block Pricing sr:gastariffblockpricem atrix (see section ) Yes 1 None N/A Non- Page 32 of 47

33 GasTariffTOUPric ematrix Gas Smart Meter: A 1 x 4 matrix containing Prices for Time-of-use Pricing sr:gastarifftoupricema trix (see section ) Yes 1 None N/A Non- GasTariffTheshol dmatrix A 3 x 1 matrix capable of holding thresholds for controlling Block Tariffs. sr:gastariffthresholdm atrix (see section ) Yes 2 None N/A Non- Table 42 Update Price (Primary Element) Service Request - GasPriceElements Data Items 1 Minimum 1 and Maximum 4 2 Minimum 1 and Maximum GasTariffBlockPriceMatrix Data Items Definition BlockPrices Up to 4 Prices applicable to a TOU with Block Tariff sr:blockprices see Yes 1 None 1000 th pence per kwh Non- AssociatedTOUWi thblocktariffactio n Identifier (n) of the Script to be run to apply Gas TOU With BlockTariff Price Matrix [n] (n = 101). Included in this array to link the Price to the corresponding action (script) Valid set: 101 Restriction of xs:string (mininclusive = 101, maxinclusive = 101) No 101 N/A Non- Table 43 Update Price (Primary Element) Service Request - GasTariffBlockPriceMatrix Data Items 1 Minimum 1 and Maximum GasTariffTOUPriceMatrix Data Items Definition TOUPrice Price applicable to a TOU Tariff xs:nonnegativeinteger Yes 1 None 1000 th pence per kwh Non- AssociatedTOUTarif faction Identifier (n) of the Script to be run to apply Gas TOU With BlockTariff Price Matrix [n] (n between 01 and 04). Included in this array to link the Price to the corresponding action (script) Valid set: Value between 01 and 04 Restriction of xs:string (mininclusive = 01, maxinclusive = 04 totaldigits = 2) Table 44 Update Price (Primary Element) Service Request - GasTariffTOUPriceMatrix Data Items 1 Minimum 1 and Maximum GasTariffThreshold Data Items Definition Page 33 of 47

34 BlockThreshold Threshold between one block and the next Xs:nonNegativeInteger Yes 1 None kwh Non- AssociatedTOUWi thblocktariffactio n The action (script) that is run when Gas TOU With Block Tariff is applicable Valid set: 101 Restriction of xs:string (mininclusive = 101, maxinclusive = 101) No 101 N/A Non- Table 45 Update Price (Primary Element) Service Request - GasTariffThresholdMatrix Data Items 1 Minimum 1 and Maximum Applicable Modes of Operation The Modes of Operation applicable to this Service Request are (see Main Document of this documentation set section 2.3 for Modes of Operation definitions): Transform On Demand DCC Only Future Dated DSP Scheduled Yes No No Device No Table 46 Update Price (Primary Element) Modes of Operation Applicable Command Variant Values The Command Variant values applicable to this Service Request are (see Main Document of this documentation set section 3 for Command Variant definitions): Validation CV = 1 CV = 2 CV = 3 CV = 4 CV = 5 CV = 6 CV = 7 CV = 8 No No No Yes Yes No No No Table 47 Update Price (Primary Element) Command Variant Values This Service Request has no specific validation. See Main Document of this documentation set section 7 for generic access control checks and Annex section 17.2 for Execution Date Time validation Sample Request There are two versions applicable to this Service Request Transform Service Request Signed Pre-command Sample requests are given in Annex Introduction Appendix 2. The specific information for this Service Request (Body) is as follows (Due to its size and to include Electricity and Gas, the sample has been split into 3 figures): Page 34 of 47

35 <UpdatePricePrimaryElement> <ExecutionDateTime> T10:08:00.0</ExecutionDateTime> <PriceElements> <StandingCharge>5000</StandingCharge> <TariffType>TOU</TariffType> See Figure 31 for details of ElectricityPriceElements See Figure 32 for details of GasPriceElements </PriceElements> </UpdatePricePrimaryElement> Figure 30 Update Price (Primary Element) Transform Request (Body) Format <sr:electricitypriceelements> <sr:electricitytariffblockpricematrix index="1"> <sr:blockprices> <sr:price index="1">50</sr:price> <sr:price index="2">70</sr:price> </sr:blockprices> <sr:associatedtouwithblocktariffaction>104</sr:associatedtouwithblocktariffaction> </sr:electricitytariffblockpricematrix> <sr:electricitytariffblockpricematrix index="2"> <sr:blockprices> <sr:price index="1">30</sr:price> <sr:price index="2">40</sr:price> </sr:blockprices> <sr:associatedtouwithblocktariffaction>105</sr:associatedtouwithblocktariffaction> </sr:electricitytariffblockpricematrix> <sr:electricitytarifftoupricematrix index="1"> <sr:tarifftouprice>70</sr:tarifftouprice> <sr:associatedtoutariffaction>01</sr:associatedtoutariffaction> </sr:electricitytarifftoupricematrix> <sr:electricitytarifftoupricematrix index="2"> <sr:tarifftouprice>80</sr:tarifftouprice> <sr:associatedtoutariffaction>02</sr:associatedtoutariffaction> </sr:electricitytarifftoupricematrix> </sr:electricitypriceelements> Figure 31 Update Price (Primary Element) Transform Request Format (ElectricityPriceElements Detail) Page 35 of 47

36 <sr:priceelements> <sr:standingcharge>50</sr:standingcharge> <sr:tarifftype>tou</sr:tarifftype> <sr:gaspriceelements> <sr:gastariffblockpricematrix> <sr:blockprices> <sr:price index="1">123</sr:price> <sr:price index="2">432</sr:price> </sr:blockprices> <sr:associatedtouwithblocktariffaction>101</sr:associatedtouwithblocktariffaction> </sr:gastariffblockpricematrix> <sr:gastarifftoupricematrix index="1"> <sr:tarifftouprice>43</sr:tarifftouprice> <sr:associatedtoutariffaction>01</sr:associatedtoutariffaction> </sr:gastarifftoupricematrix> <sr:gastariffthresholds> <sr:blockthreshold index="1">100</sr:blockthreshold> <sr:blockthreshold index="2">200</sr:blockthreshold> <sr:associatedtouwithblocktariffaction>101</sr:associatedtouwithblocktariffaction> </sr:gastariffthresholds> </sr:gaspriceelements> Responses Figure 32 Update Price (Primary Element) Transform Request Format (GasPriceElements Detail) The response messages for an Update Price (Primary Element) request follow the generic format for all Device response messages, the generic responses applicable to this request are; Pre-command Acknowledgement Service Response (from Device) - GBCSPayload Service Response (from Device) - FutureDatedDeviceAlertMessage Response & Alert Common Interface Sample responses are given in Annex Introduction Appendix 1, response specific information details are given below Response & Alert Common Interface Format The response to this request returns only status without any substantial payload. The XML type is UpdatePricePrimaryElementRsp. Please see Annex section 18.8 for a description of how status-only responses are represented in the Response and Alert Common Interface XML schema Specific Header Data Items Data Item Electricity Response Gas Response GBCSHexadecimalMessageCode 00A2 00A3 GBCSUseCaseNumber ECS01b GCS01b GBCSUseCaseName Set Price on ESME Set Price on GSME Page 36 of 47

37 Table 48 - Update Price (Primary Element) Parse Response Header Data Items Update Price (Secondary Element) (1.2.1) GBCS v0.8 does not define a Use Case to enable the update of price for the secondary element of an Electricity Smart Meter. This is expected to be included in a future version of GBCS and so this section is a placeholder for this Service Request. This shall be populated once the associated GBCS use case is defined and published. 1.3 Section Section 1.4 This section has been intentionally left blank as there is no Service Reference 1.3. This section has been intentionally left blank as there is no Service Reference Update Meter Balance (1.5) Service Request Name UpdateMeterBalance Service Reference 1.5 Service Request Variant Name UpdateMeterBalance Service Reference Variant 1.5 Service Request Objective Business Context Statement To enable a DCC Service User to send a command to a meter at a specified ESME/GSME to adjust the amount of money in currency units accounted for by the Smart Meter. The DCC Service User requires an update to be made to the current balance on a specified device, e.g. to adjust the balance to take into account such things as CV calculations made in a Supplier s billing systems. User Role Access Electricity Import Supplier (EIS) Gas Import Supplier (GIS) Security Classification Critical and non-sensitive GBCS XREF: SME.C.C 1. If operating in Prepayment Mode, the Meter Balance represents ESME / GSME s determination of the amount of credit available to the Consumer (excluding any Emergency Credit Balance). Service Request Narrative 2. If operating in Credit Mode, it represents ESME/ GSME s determination of the amount of money due from the Consumer since the Meter Balance was last reset. As the DSP does not maintain a record of the meter accounting state (prepayment/credit) then it is necessary for the Service User to choose the appropriate data items. This Service Request supports the following Meter Balance Page 37 of 47

38 updates: Electricity Smart Meter Adjustment of balance Reset. The Accumulated Debt Register and the Emergency Credit Balance are also reset Gas Smart Meter Adjustment of balance Reset The Accumulated Debt Register and the Emergency Credit Balance are also reset Table 49 Update Meter Balance Service Request This section should be read in conjunction with the Main Document of this documentation set section 9 (which describes the general formatting for all Service Requests and Service Responses) and with the XSD (XML Schema document 3 of this documentation set) Service Request Format The Request Body XML element of the XSD (see XML Schema document 3 of this documentation set) defines the structure of all the Service Requests. Its UpdateMeterBalance XML element defines this Service Request and contains the Update type (Adjustment or Reset) and, for Adjustment, the Amount to be added to / subtracted from the Balance. Figure 33 Update Meter Balance Service Request Structure Specific Data Items Definition The data items contained in the Service Request are defined as: PrepaymentMode The Smart Meter is operating in Prepayment mode sr: AdjustOrReset (see section ) Yes (if in credit mode) None N/A Non- Page 38 of 47

39 CreditMode The Smart Meter is operating in Credit mode sr:adjustorreset (see section ) Yes (if in prepayment mode) Table 50 Update Meter Balance Service Request Data Items None N/A Non AdjustOrReset Data Items Definition Either AdjustMeterBalance or ResetMeterBalance must be defined in the request. AdjustMeterBalance The amount by which the Meter Balance is to be adjusted (which may be a positive or negative Integer). xs:integer Yes if adjusting the balance None 1000 th pence Non- ResetMeterBalance Reset the Meter Balance to zero N/A Yes if resetting the balance Table 51 Update Meter Balance Service Request - AdjustOrReset Items Applicable Modes of Operation None N/A Non- The Modes of Operation applicable to this Service Request are (see Main Document of this documentation set section 2.3 for Modes of Operation definitions): Transform On Demand DCC Only Future Dated DSP Scheduled Yes Yes No No No Applicable Command Variant Values Table 52 Update Meter Balance Modes of Operation The Command Variant values applicable to this Service Request are (see Main Document of this documentation set section 3 for Command Variant definitions): Validation CV = 1 CV = 2 CV = 3 CV = 4 CV = 5 CV = 6 CV = 7 CV = 8 No No No Yes Yes Yes Yes No Table 53 Update Meter Balance Command Variant Values This Service Request has no specific validation. See Main Document of this documentation set section 7 for generic access control checks Sample Request There are two versions applicable to this Service Request Transform Service Request Signed Pre-command Sample requests are given in Annex Introduction Appendix 2. The specific information for this Service Request (Body) is as follows: Page 39 of 47

40 <UpdateMeterBalance> <PrepaymentMode> <AdjustMeterBalance>100000</AdjustMeterBalance> </PrepaymentMode> </UpdateMeterBalance> Responses Figure 34 Update Meter Balance Transform Request (Body) Format The response messages for an Update Meter Balance request follow the generic format for all Device response messages, the generic responses applicable to this request are; Pre-command Acknowledgement Service Response (from Device) - GBCSPayload Command for Local Delivery Response & Alert Common Interface Sample responses are given in Annex Introduction Appendix 1, response specific information details are given below Response & Alert Common Interface Format The response to this request returns only status without any substantial payload. The XML type is UpdateMeterBalanceRsp. Please see Annex section 18.8 for a description of how status-only responses are represented in the Response and Alert Common Interface XML schema Specific Header Data Items This Service Request 1.5 will be implemented by a meter command in one of 6 different GBCS use cases, depending on the input parameters sent by the DCC Service User, so there are 6 different GBCS uses cases which may be returned in the response. Input circumstances GBCSHexadecimal MessageCode GBCSUseCase Number GBCSUseCaseName AdjustMeterBalance for ESME (both PrepaymentMode & CreditMode) ResetMeterBalance for ESME (both PrepaymentMode & CreditMode) PrepaymentMode & AdjustMeterBalance for GSME PrepaymentMode & ResetMeterBalance for GSME CreditMode & AdjustMeterBalance for GSME 0x001C ECS04a Adjust Meter Balance on the ESME (Credit / Prepayment Mode) 0x00B3 ECS04b Reset Meter Balance on the ESME (Credit / Prepayment Mode) 0x0086 GCS04a Adjust Meter Balance on the GSME (Prepayment Mode) 0x00B4 GCS04b Reset Meter Balance on the GSME (Prepayment Mode) 0x00C0 GCS40c Adjust Meter Balance on the GSME (Credit Mode) CreditMode & ResetMeterBalance for GSME 0x00C2 GCS40d Reset Meter Balance on the GSME (Credit Mode) Table 54 - Update Meter Balance Parse Response Header Data Items Page 40 of 47

41 1.6 Update Payment Mode (1.6) Service Request Name UpdatePaymentMode Service Reference 1.6 Service Request Variant Name UpdatePaymentMode Service Reference Variant 1.6 Service Request Objective Business Context Statement To enable a DCC Service User to send a command to a ESME or GSME to set the payment mode to either Prepayment Mode or Credit Mode such that the meter can update its configuration. The customer has requested, either as a result of a change of tenancy, change of supplier or out of personal choice, a change of payment mode to either Prepayment Mode or Credit Mode. The supplier is responsible for resolving accounts, providing means to vend, ensuring that a payment mode is safe and practicable prior to undertaking the mode change. User Role Access Electricity Import Supplier (EIS) Gas Import Supplier (GIS) Security Classification Critical and non-sensitive GBCS XREF: SME.C.C NB change of payment mode to credit from prepayment has the effect of zeroing the debt register values On change of Payment Mode the device may create and store various snapshots on information and record in the Billing Data Log, as defined in SMETS. Update Payment Mode to Prepayment Mode This Service Request sets the following SMETS data items on the ESME/GSME; Service Request Narrative - Payment Mode - Disablement Threshold - Suspend Debt Disabled - Suspend Debt Emergency Update Payment Mode to Credit Mode This Service Request sets the following SMETS data items on the ESME/GSME; - Payment Mode - Suspend Debt Disabled - Suspend Debt Emergency PLUS in addition on the GSME Page 41 of 47

42 - Disablement Threshold Table 55 Update Price Service Request This section should be read in conjunction with the Main Document of this documentation set section 9 (which describes the general formatting for all Service Requests and Service Responses) and with the XSD (XML Schema document 3 of this documentation set) Service Request Format The Request Body XML element of the XSD (see XML Schema document 3 of this documentation set) defines the structure of all the Service Requests. Its UpdatePaymentMode XML element defines this Service Request and contains the Payment Mode and associated data to be set on the Device and, for Future Dated Requests, the Execution Date Time Specific Data Items Definition Figure 35 Update Payment Mode Service Request Structure The data items contained in the Service Request are defined as: ExecutionDateTime The UTC date and time the DCC User requires the command to be executed on the Device ID xs:datetime No None UTC Date- Time Non- Valid date-time in the future Page 42 of 47