Service Reference Variant

2.1 · Update Prepay Configuration

Service details

Identifiers, rules, and applicability

Service reference: 2.1
Service Reference Variant: 2.1
DUIS section: 3.8.8
Command variants: 4, 5, 6, 7
DUIS possible responses: Response to Transform Request - PreCommand FormatAcknowledgementService Response from Device - GBCSPayloadFutureDatedDeviceAlertMessageResponse to a Command for Local Delivery Request - LocalCommand FormatCountersigned SMETS1 Response
Critical: Yes
Sensitive response: No
Protection against replay: Yes
On demand: Yes
Future dated: Device
DSP scheduled: No
DCC only: No
SMETS1 applicability: Yes
SAPC requirement: Optional
DUIS applicability: 3.0, 3.1, 4.0, 5.0, 5.1, 5.2, 5.3

Cross-specification evidence

SMETS/CHTS to GBCS Mapping

This section shows the SMETS and CHTS attributes that can be read or written by the identified GBCS Use Case. Command requirements are shown separately from the mapped attributes.

ECS08a7 attributes0x00DEESME

Specification	Item	Reference	Description
SMETS	Debt Recovery Rate Cap [INFO]	5.7.4.13	The maximum amount in Currency Units per unit time that can be recovered through Payment-based Debt Recovery when ESME is operating in Prepayment Mode.
SMETS	Emergency Credit Limit [INFO]	5.7.4.16	The amount of Emergency Credit in Currency Units to be made available to a Consumer where Emergency Credit is activated.
SMETS	Emergency Credit Threshold [INFO]	5.7.4.17	The threshold in Currency Units below which Emergency Credit Balance [INFO](5.7.5.15) may be activated if so configured when ESME is operating in Prepayment Mode.
SMETS	Low Credit Threshold [INFO]	5.7.4.23	The threshold in Currency Units below which a low credit Alert is signalled.
SMETS	Maximum Credit Threshold	5.7.4.25	The maximum credit which can be applied by any Add Credit Command.
SMETS	Maximum Meter Balance Threshold	5.7.4.27	The Meter Balance [INFO](5.7.5.22) threshold in Currency Units above which an Add Credit Command is rejected.
SMETS	Non-Disablement Calendar [INFO]	5.7.4.30	A Switching Table comprising a set of rules specifying periods during which the Supply will not be Disabled due to the Meter Balance [INFO](5.7.5.22) being below, or falling below, the Disablement Threshold [INFO](5.7.4.15) and, if Emergency Credit is activated, the Emergency Credit Balance [INFO](5.7.5.15) being, or falling to, zero, when ESME is operating in Prepayment Mode.

GCS058 attributes0x006FGSME

Specification	Item	Reference	Description
SMETS	Billing Calendar	4.6.4.2	A calendar defining billing dates for the storage of billing related information in the Billing Data Log(4.6.5.3).
SMETS	Debt Recovery Rate Cap	4.6.4.10	The maximum amount in Currency Units per unit time that can be recovered through Payment-based Debt Recovery when GSME is operating in Prepayment Mode.
SMETS	Emergency Credit Limit	4.6.4.13	The amount of Emergency Credit in Currency Units to be made available to a Consumer where Emergency Credit is activated.
SMETS	Emergency Credit Threshold	4.6.4.14	The threshold in Currency Units below which Emergency Credit Balance(4.6.5.8) may be activated if so configured when GSME is operating in Prepayment Mode.
SMETS	Low Credit Threshold	4.6.4.16	The threshold in Currency Units below which a low credit Alert is signalled.
SMETS	Maximum Credit Threshold	4.6.4.17	The maximum credit which can be applied by any Add Credit Command.
SMETS	Maximum Meter Balance Threshold	4.6.4.18	The Meter Balance(4.6.5.11) threshold in Currency Units above which an Add Credit Command is rejected.
SMETS	Non-Disablement Calendar	4.6.4.20	A Switching Table comprising a set of rules specifying periods during which the Supply will not be Disabled due to the Meter Balance(4.6.5.11) being below, or falling below, the Disablement Threshold(4.6.4.12) and, if Emergency Credit is activated, the Emergency Credit Balance(4.6.5.8) being, or falling to, zero when GSME is operating in Prepayment Mode.

Specific Errors

Response codes and descriptions

No specific validation is defined for this SRV.

GBCS Use Case

Use cases, device coverage, and applicability

Use Case / Message Code

ECS080x001F

DUIS Applicability

v3.0 – v5.3

GBCS Applicability

v1.0 – v1.1

GBCS Criticality

Critical

Sensitive Response

Future Dated

Device

GBT

SMETS1 Applicable

Eligible Roles

EISESME

Use Case / Message Code

ECS08a0x00DE

DUIS Applicability

v3.0 – v5.3

GBCS Applicability

v2.0 – v4.3

GBCS Criticality

Critical

Sensitive Response

Future Dated

Device

GBTWhat is GBT?

CommandESMENot always GBT

SMETS1 Applicable

Yes

Eligible Roles

EISESME

Use Case / Message Code

GCS050x006F

DUIS Applicability

v3.0 – v5.3

GBCS Applicability

v1.0 – v4.3

GBCS Criticality

Critical

Sensitive Response

Future Dated

Device

GBT

SMETS1 Applicable

Yes

Eligible Roles

GISGSME

DUIS Service Definition

Data items and DCC processing

Request data items

Table 96: UpdatePrepayConfiguration (sr: UpdatePrepayConfiguration) data items

Data Item	Description / Valid Set	Type	Mandatory	Default	Units
ExecutionDateTime	A User shall only add this Data Item to the Service Request where they require the Service Request to be executed at a future date and time. The UTC date and time the User requires the command to be executed on the Device Date-time in the future that is either <= current date + 30 days or the date = ‘3000-12-31T00:00:00Z’	xs:dateTime	No	None	UTC Date-Time
UpdatePrepayConfigElectricity	Electricity Smart Meter Prepay configuration elements	sr: UpdatePrepayConfigElec see Table 97	Device Type = Electricity Smart Meter Yes Otherwise, N/A	None	N/A
UpdatePrepayConfigGas	Gas Smart Meter Prepay configuration elements	sr: UpdatePrepayConfigGas see Table 98	Device Type = Gas Smart Meter Yes Otherwise, N/A	None	N/A

Table 97: UpdatePrepayConfigElectricity (sr: UpdatePrepayConfigElec) data items

Data Item	Description / Valid Set	Type	Mandatory	Default	Units
DebtRecoveryRateCap	The maximum amount in Currency Units per unit time (week) that can be recovered through Payment-based Debt Recovery when the Meter is operating in prepayment mode.	xs: unsignedShort	Yes	None	GBP / ECB / week
EmergencyCreditLimit	The amount of Emergency Credit in Currency Units to be made available to a Consumer when Emergency Credit is activated by the Consumer.	xs:int	Yes	None	1000th pence / cent
EmergencyCreditThreshold	The threshold in Currency Units below which Emergency Credit may be activated by the Consumer, if so configured, when the Meter is operating in prepayment mode.	xs:int	Yes	None	1000th pence / cent
LowCreditThreshold	The threshold in Currency Units below which a low credit Alert is signalled.	xs:int	Yes	None	1000th pence / cent
ElectricityNonDisablementCalendar	A calendar defining UTC times, days and dates that specify periods during which the Supply will not be Disabled when the meter is operating in prepayment mode, in on and off dates/times.	sr:ElectricityNonDisablementCalendar	Yes	None	N/A
MaxMeterBalance	The Meter Balance threshold in Currency Units above which an Add Credit Command is rejected.	xs:int	Yes	None	1000th pence / cent
MaxCreditThreshold	The maximum credit which can be applied by any Add Credit Command	xs:int	Yes	None	1000th pence / cent

Table 98: UpdatePrepayConfigGas(sr: UpdatePrepayConfigGas) data items

Data Item	Description / Valid Set	Type	Mandatory	Default	Units
DebtRecoveryRateCap	The maximum amount in Currency Units per unit time (week) that can be recovered through Payment-based Debt Recovery when the Meter is operating in prepayment mode.	xs:int	Yes	None	1000th pence / cent / week
EmergencyCreditLimit	The amount of Emergency Credit in Currency Units to be made available to a Consumer when Emergency Credit is activated by the Consumer.	xs:unsignedInt	Yes	None	1000th pence / cent
EmergencyCreditThreshold	The threshold in Currency Units below which Emergency Credit may be activated by the Consumer, if so configured, when the Meter is operating in prepayment mode.	xs:unsignedInt	Yes	None	1000th pence / cent
LowCreditThreshold	The threshold in Currency Units below which a low credit Alert is signalled.	xs:unsignedInt	Yes	None	1000th pence / cent
GasNonDisablementCalendar	A calendar defining UTC times, days and dates that specify periods during which the Supply will not be Disabled when the meter is operating in prepayment mode, in on and off dates/times. Calendar defining the time periods when Non-Disablement applies or doesn’t apply. The calendar includes the definition of: • Day Identifiers. Array of up to 5 elements, each including a Day ID and up to 3 times of day to run a script to start or end a disablement period • Weeks. Array of up to 2 elements, each including a Week ID and the Day ID associated to each day of that Week ID • Seasons. Array of up to 3 elements, each including a Season Start Date and the Week ID associated to that Season • Special Days. Array of up to 20 Special Day elements, defined as a date and Referenced Day Name. Special Days (e.g. public holidays) are used to apply different switching rules to those defined in the corresponding season.	sr:GasNonDisablementCalendar	Yes	None	N/A
MaxMeterBalance	The Meter Balance threshold in Currency Units above which an Add Credit Command is rejected.	xs:unsignedInt	Yes	None	1000th pence / cent
MaxCreditThreshold	The maximum credit which can be applied by any Add Credit Command	xs:unsignedInt	Yes	None	1000th pence / cent

Table 99: ElectricityNonDisablementCalendar (sr:ElectricityNonDisablementCalendar) data items

Data Item	Description / Valid Set	Type	Mandatory	Default	Units
ElectricitySpecialDays	A collection of between 0 and 20 Special Days within the mandatory group item	sr:ElecSpecialDaysPrepayment See Table 100	Yes If there are no Special Days, this XML element will be present, but empty, i.e. it will contain 0 SpecialDay elements	None	N/A
ElectricityNonDisablementSchedule	List of up to 22 schedules defining the time periods when Non-Disablement applies or doesn’t apply	sr:ElectricityNonDisablementSchedule (minOccurs = 1, maxOccurs = 22) See Table 102	Yes	None	N/A

Table 100: Electricity Special Days (sr:ElecSpecialDaysPrepayment) data items

Data Item	Description / Valid Set	Type	Mandatory	Default	Units
SpecialDay	Between 0 and 20 SpecialDay items Note that the attribute Index provides an ordering for these elements	sr:ElecSpecialDayPrepayment (minOccurs = 0, maxOccurs = 20)	No	None	N/A
Index (attribute of SpecialDay)	Provides a position within the collection of SpecialDay elements Unique and consecutive numbers starting at 1	sr:range_1_20 (xs:positiveinteger minInclusive 1 maxInclusive 20)	No (Required if SpecialDay has been defined)	None	N/A

Table 101: Special Day (sr:ElecSpecialDayPrepayment) data items

Data Item	Description / Valid Set	Type	Mandatory	Default	Units
Date	The date on which the special day applies.	sr:Date (with wildcards)	Yes	None	N/A

Table 102: ElectricityNonDisablementSchedule (sr:ElectricityNonDisablementSchedule) data items

Data Item	Description / Valid Set	Type	Mandatory	Default	Units
NonDisablementScript	Identifier to establish whether to begin (Start) or end (Stop) the non disablement period. Valid set: START STOP	Restriction of xs: string (Enumeration)	Yes	None	N/A
SpecialDaysApplicability	Special Days to which the schedule applies	sr:SpecialDaysApplicability See Table 103	Yes If there are no Special Days, this XML element will be present, but empty, i.e. it will contain 0 SpecialDayApplicability elements	None	N/A
DaysOfWeekApplicability	The days of the week to which the schedule applies defined as an array of up to 7 DayOfWeekIDs	sr:DaysOfWeekApplicability See Table 105	Yes Minimum of 0 and maximum of 7 Days Of Week Applicability. If there are no applicable Days, this XML element will be present, but empty, i.e. it will contain 0 DayOfWeekApplicability elements	None	N/A
ScheduleDatesAndTime	The switch time and date range (without wildcards) when the script is to be run	sr:ScheduleDatesAndTimeWithoutWildcards See 3.10.1.20	Yes	None	N/A

Table 103: SpecialDaysApplicability (sr:SpecialDaysApplicability) data items

Data Item	Description / Valid Set	Type	Mandatory	Default	Units
SpecialDayApplicability	An array of between 0 and 20 SpecialDayID elements	sr:SpecialDayApplicability (minOccurs = 0, maxOccurs = 20)	No	None	N/A

Table 104: SpecialDayApplicability (sr:SpecialDayApplicability) data items

Data Item	Description / Valid Set	Type	Mandatory	Default	Units
SpecialDayID	Identifier of the Special Day, which correspond to the indices in SpecialDay Valid set: Value between 1 and 20	Restriction of xs:positiveInteger (minInclusive = 1 maxInclusive = 20)	Yes	None	N/A

Table 105: DaysOfWeekApplicability (sr:DaysOfWeekApplicability) data items

Data Item	Description / Valid Set	Type	Mandatory	Default	Units
DayOfWeekApplicability	Array of Day Of Week IDs This indicates the days on which the schedule is active. Unique and chronologically ordered, may not be consecutive.	sr:DayOfWeekApplicability (minOccurs = 0, maxOccurs = 7) If there are no applicable Days, this XML element will be present, but empty, i.e. it will contain 0 DayOfWeekApplicability elements	Yes	None	N/A

Table 106: DayOfWeekApplicability (sr:DayOfWeekApplicability) data items

Data Item	Description / Valid Set	Type	Mandatory	Default	Units
DayOfWeekID	The day of the week to which the schedule applies Valid set: • Monday • Tuesday • Wednesday • Thursday • Friday • Saturday • Sunday	xs:string (Enumeration)	Yes	None	N/A

Table 107: GasNonDisablementCalendar (sr:GasNonDisablementCalendar) data items

Data Item	Description / Valid Set	Type	Mandatory	Default	Units
DayProfiles	Array of up to 5 Day Profiles defining a Day ID and a list of 3 actions (script IDs) and start times during that day when an action (script ID) to either start or end a Non-Disablement period The actions (script IDs) applicable to this Service Request are: START STOP	sr:GasNonDisablementDayProfiles	Yes	None	N/A
WeekProfiles	Array of up to 2 elements within the group item, each including a Week ID and the Referemced Day Name associated to each day (Monday to Sunday) of that Week Name	sr:GasWeekProfilesNonDisablement	Yes	None	N/A
SeasonProfiles	Array of up to 3 elements, each including a Season Start Date and the Week ID associated to that Season.	sr:GasSeasonsNonDisablement	Yes	None	N/A
SpecialDays	Between 0 and 20 days when special Non- Disablement rules (rather than those defined in the Seasons) apply.	sr:GasSpecialDaysNonDisablement	Yes If there are no Special Days, this XML element will be present, but empty, i.e. it will contain 0 SpecialDay elements	None	N/A

Table 108: DayProfiles (sr:GasNonDisablementDayProfiles) data items

Data Item	Description / Valid Set	Type	Mandatory	Default	Units
GasNonDisablementDayProfile	Array of up to 5 Gas Non Disablement day Profile	sr:GasNonDisablementDayProfile (minOccurs = 1, maxOccurs = 5)	Yes	None	N/A

Table 109: GasNonDisablementDayProfile (sr:GasNonDisablementDayProfile) data items

Data Item	Description / Valid Set	Type	Mandatory	Default	Units
TimeStartAction	List of Actions (script) to be taken and at what start times	sr:GasNonDisablementTimeStartAction (minOccurs = 1, maxOccurs = 3)	Yes	None	N/A
GasDayName	Identifier of the day to which the Time Start Action list applies	sr:GasDayNameNonDisablement Restriction of xs:positiveInteger (minInclusive =1, maxInclusive = 5)	Yes	None	N/A

Table 110: TimeStartAction (sr:GasNonDisablementTimeStartAction) data items

Data Item	Description / Valid Set	Type	Mandatory	Default	Units
StartTime	Time when a specific Action is to be taken The first one for each Day Profile has to be set to 00:00:00	xs:time	Yes	None	N/A
NonDisablementAction	Identifier of the Script to be run to apply or not apply Non-Disablement Valid set: START STOP	Restriction of xs:string (Enumeration)	Yes	None	N/A

Table 111: WeekProfiles (sr:GasWeekProfilesNonDisablement) data items

Data Item	Description / Valid Set	Type	Mandatory	Default	Units
WeekProfile	Array of 2 Week Profile elements	sr:WeekProfileGasNonDisablement (minOccurs = 1, maxOccurs = 2)	Yes	None	N/A

Table 112: WeekProfile (sr:WeekProfileGasNonDisablement) data items

Data Item	Description / Valid Set	Type	Mandatory	Default	Units
WeekName	An identifier for the week.	sr:GasWeekName Restriction of xs:positiveInteger (minInclusive = 1, maxInclusive = 2)	Yes	None	N/A
ReferencedDayName	Day Identifier as defined above	sr:GasReferencedDayNameNonDisablement (minOccurs = 7 maxOccurs = 7) See Table 117	Yes 7 elements, one for each day of the week (1: Monday, 7: Sunday)	None	N/A

Table 113: SeasonProfiles (sr:GasSeasonsNonDisablement) data items

Data Item	Description / Valid Set	Type	Mandatory	Default	Units
Season	Array of 3 Season elements	sr:GasSeasonNonDisablement (minOccurs = 1, maxOccurs = 3)	Yes	None	N/A

Table 114: Season (sr:GasSeasonNonDisablement) data items

Data Item	Description / Valid Set	Type	Mandatory	Default	Units
SeasonStartDate	The date from which this season is defined to start	sr:GasDateWithWildcards See Table 319	Yes	None	N/A
ReferencedWeekName	WeekName as defined above in WeekProfileGas Definition	sr:GasWeekNameNonDisablement Restriction of xs:positiveInteger (minInclusive = 1, maxInclusive =2)	Yes	None	N/A

Table 115: SpecialDays (sr:GasSpecialDaysNonDisablement) data items

Data Item	Description / Valid Set	Type	Mandatory	Default	Units
SpecialDay	Array of between 0 and 20 Gas SpecialDay elements	sr:GasSpecialDayNonDisablement minOccurs = 0 maxOccurs = 20	No	None	N/A

Table 116: SpecialDay (sr:GasSpecialDayNonDisablement) data items

Data Item	Description / Valid Set	Type	Mandatory	Default	Units
Date	The date on which the special day applies	sr:GasDateWithWildcards See Table 319	Yes	None	N/A
ReferencedDayName	GasDayNameas defined in GasNonDisablementDayProfile Definition above	sr:GasDayNameNonDisablement	Yes	None	N/A

Table 117: ReferencedDayName (sr:GasReferencedDayNameNonDisablement) data items

Data Item	Description / Valid Set	Type	Mandatory	Default	Units
ReferencedDayName	Day Identifier Note that the attribute index provides an ordering for these elements.	sr:GasDayNameNonDisablement (xs:positiveInteger minInclusive = 1, maxInclusive = 5)	Yes	None	N/A
Index	Provides an ordering for the ReferencedDayName elements Unique (may not be consecutive)	sr:range_1_7 (positiveinteger minInclusive 1 maxInclusive 7)	Yes	None	N/A

Message Patterns & Examples

Pattern explorer

Open Message Patterns →

SMETS1 Supporting Requirements

Device-model variations and equivalent steps

Review the Section 18 requirements and their applicability across the documented manufacturer, Device Type, model, and firmware profiles.

Open S1SR Requirements →