Service Reference Variant

1.1.1 · Update Import Tariff (Primary Element)

Service details

Identifiers, rules, and applicability

Service reference: 1.1
Service Reference Variant: 1.1.1
DUIS section: 3.8.1
Command variants: 4, 5, 6, 7
DUIS possible responses: AcknowledgementResponse to Transform Request - PreCommand FormatService 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.

ECS01a1 command6 attributes0x0019ESME

Command mapped to ECS01a

SMETSSet Tariff5.6.3.35ESME

Specification	Item	Reference	Description
SMETS	Currency Units [INFO]	5.7.4.9	The Currency Units currently used by ESME, which shall be either GB Pounds or European Central Bank Euro.
SMETS	Standing Charge [INFO]	5.7.4.42	A charge to be levied in Currency Units per unit time when operating in Credit Mode and Prepayment Mode.
SMETS	Tariff Block Price Matrix [INFO]	5.7.4.47	A 4 x 8 matrix containing Prices for Block Pricing.
SMETS	Tariff Switching Table [INFO]	5.7.4.48	A set of rules for allocating half-hourly Consumption to a Tariff Register for Time-of-use Pricing and Time-of-use with Block Pricing. The rules stored within the table shall specify which of 16 Day Profiles should be used to allocate Consumption to Tariff Registers according to:
SMETS	Tariff Threshold Matrix [INFO]	5.7.4.49	A 3 x 8 matrix capable of holding thresholds in kWh for controlling Block Tariffs.
SMETS	Tariff TOU Price Matrix [INFO]	5.7.4.50	A 1 x 48 matrix containing prices for Time-of-use Pricing.

GCS01a1 command6 attributes0x006BGSME

Command mapped to GCS01a

SMETSSet Tariff4.5.3.22GSME

Specification	Item	Reference	Description
SMETS	Currency Units	4.6.4.6	The Currency Units currently used by GSME, which shall be either GB Pounds or European Central Bank Euro.
SMETS	Standing Charge	4.6.4.23	A charge to be levied in Currency Units per unit time when operating in Credit Mode and Prepayment Mode.
SMETS	Tariff Block Price Matrix	4.6.4.29	A 4 x 1 matrix containing Prices for Block Pricing.
SMETS	Tariff Switching Table	4.6.4.30	A set of rules for allocating daily Consumption to a Tariff Register for Time-of-use Pricing and Time-of-use with Block Pricing. The rules stored within the table shall specify which of four Day Profiles should be used to allocate Consumption to a Tariff Register according to:
SMETS	Tariff Threshold Matrix	4.6.4.31	A 3 x 1 matrix capable of holding thresholds in kWh for controlling Block Tariffs.
SMETS	Tariff TOU Price Matrix	4.6.4.32	A 1 x 4 matrix containing Prices for Time-of-use Pricing.

Specific Errors

Response codes and descriptions

Response Code	Response Code Description
`E010101`	Too many switching rules defined (exceeds 200)

Source: DUIS 3.8.1.3

SMETS1-specific validation

Additional SMETS1 conditions are shown separately from the SRV-specific DUIS table.

SMETS1 supplementary validation

E010102

If the target Device is a SMETS1 ESME according to the Smart Metering Inventory, the XML element named HybridTariff must not be included in the ElecPriceElementsPrimary element within PriceElement (see 3.8.1.2). For clarity, SMETS1 ESME are not required to support such tariffs.

Applies to: SMETS1 Devices only

Source: DUIS 1.4.6 Table 2

GBCS Use Case

Use cases, device coverage, and applicability

Use Case / Message Code

ECS01a0x0019

DUIS Applicability

v3.0 – v5.3

GBCS Applicability

v1.0 – v4.3

GBCS Criticality

Critical

Sensitive Response

Future Dated

Device

GBTWhat is GBT?

CommandESMEAlways GBT

SMETS1 Applicable

Yes

Eligible Roles

EISESME

Use Case / Message Code

GCS01a0x006B

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 44: UpdateImportTariffPrimaryElement (sr:TariffPrimaryElement) data items

Data Item	Description / Allowable values	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
ElecTariffElements	Electricity Smart Meter specific tariff elements	sr:ElecTariffElements	Electricity Smart Meter: Yes Gas Smart Meter: N/A	None	N/A
GasTariffElements	Gas Smart Meter specific tariff elements	sr:GasTariffElements	Electricity Smart Meter: N/A Gas Smart Meter: Yes	None	N/A
PriceElements	All the Data Items required to update the price on the Device are defined in Service Request 1.2.1 ‘Update Price (Primary Element)’	sr:PricePrimary	Yes	None	N/A

Table 45: ElecTariffElements (sr: ElecTariffElements) data items

Data Item	Description / Allowable values	Type	Mandatory	Default	Units
CurrencyUnits	The Currency Units currently used by a Smart Meter for display purposes, which shall be GB Pounds or European Central Bank Euros Valid set: • GBP. GB Pounds • ECB. European Central Bank Euros	Restriction of xs:string (Enumeration)	Yes	None	N/A
SwitchingTable	A calendar defining UTC times, days and dates for switching the Primary Element tariff	sr:ElecSwitchingTablePrimary	Yes	None	N/A
SpecialDays	A calendar defining special dates for switching the Primary Element tariff	sr:ElecSpecialDaysPrimary	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
ThresholdMatrix	An 8 (threshold definitions) x 3 (block thresholds) matrix capable of holding thresholds for controlling Block Tariffs.	sr:ElecThresholdMatrix	Yes	None	N/A

Table 46: SwitchingTable (sr: ElecSwitchingTablePrimary) data items

Data Item	Description / Allowable values	Type	Mandatory	Default	Units
DayProfiles	Containing up to 16 DayProfile elements	sr:ElecDayProfiles	Yes	None	N/A
WeekProfiles	Containing up to 4 WeekProfile elements	sr:ElecWeekProfiles	Yes	None	N/A
Seasons	Containing up to 4 Season elements	sr:ElecSeasonsPrimary	Yes	None	N/A

Table 47: DayProfiles (sr: ElecDayProfiles) data items

Data Item	Description / Allowable values	Type	Mandatory	Default	Units
DayProfile	A profile definition for a single day Can include up to 16 Day Profiles	sr:ElecDayProfilePrimary (minOccurs = 1 maxOccurs = 16)	Yes	None	N/A

Table 48: DayProfile (sr:ElecDayProfilePrimary) data items

Data Item	Description / Allowable values	Type	Mandatory	Default	Units
DayName	An identifier for that day that has a number of ProfileSchedule elements associated with it. Note that this is referenced from the WeekProfile element. The DayName value must begin at 1 and increment by 1 for each subsequent DayName.	sr:ElecDayName (Restriction of xs:positiveInteger) (minInclusive = 1, maxInclusive = 16))	Yes	None	N/A
ProfileSchedule	Array of Actions and Start Times when a Block or TOU action that is executed at that time. For TOU the action indicates the TOU register that consumption is recorded against. For Block the action indicates which one of the 8 threshold definitions is used. Note that it is not necessary to define which block consumption would be recorded against as the device will calculate this based on consumption. A profile schedule can have either a Block or a TOU action.	sr:ElecProfileSchedulePrimary minOccurs = 1 maxOccurs = 48	Yes	None	N/A

Table 49: ProfileSchedule (sr: ElecProfileSchedulePrimary) data items

Data Item	Description / Allowable values	Type	Mandatory	Default	Units
StartTime	The time at which the action is to execute	xs:time	Yes	None	N/A
TOUTariffAction	Identifier (n) of the TOU tariff to be applied (see Table 85) Valid set: Value between 1 and 48	Restriction of xs:positiveInteger (minInclusive = 1, maxInclusive = 48)	TOU Tariff to be applied: Yes Otherwise: N/A	None	N/A
BlockTariffAction	Identifier (n) of the Action to be executed for a Block tariff Valid set: Value between 1 and 08	Restriction of xs:positiveInteger (minInclusive = 1, maxInclusive = 8)	Block Tariff to be applied: Yes Otherwise: N/A	None	N/A

Table 50: WeekProfiles (sr:ElecWeekProfiles) data items

Data Item	Description / Allowable values	Type	Mandatory	Default	Units
WeekProfile	A profile definition for a single week Can include up to 4 Week Profiles	sr:ElecWeekProfiles	Yes	None	N/A

Table 51: WeekProfile (sr:ElecWeekProfile) data items

Data Item	Description / Allowable values	Type	Mandatory	Default	Units
WeekName	An identifier for the week The WeekName value must begin at 1 and increment by 1 for each subsequent WeekName.	sr:ElecWeekName (Restriction of xs:positiveInteger (minInclusive = 1, maxInclusive = 4))	Yes	None	N/A
ReferencedDayName	DayName as defined in DayProfiles Definition above	sr:ElecReferencedDayName (minOccurs = 7, maxOccurs = 7)	Yes	None	N/A
Index (Attribute of ReferencedDayName)	Provides an ordering for the ReferencedDayName elements. Monday = 1, incrementing by day through to Sunday = 7 Unique and consecutive	sr:range_1_7 (Restriction of xs :positiveinteger (minInclusive 1, maxInclusive 7 ))	Yes	None	N/A

Table 52: Seasons (sr:ElecSeasonsPrimary) data items

Data Item	Description / Allowable values	Type	Mandatory	Default	Units
Season	A single season definition Can include up to 4 Seasons	sr:ElecSeasonPrimary (minOccurs = 1 maxOccurs = 4)	Yes	None	N/A

Table 53: Season (sr:ElecSeasonPrimary) data items

Data Item	Description / Allowable values	Type	Mandatory	Default	Units
SeasonName	An identifier for the season.	Restriction of xs:string (maxLength = 8)	Yes	None	N/A
SeasonStartDate	The date from which this season is defined to start The SeasonStartDate data item is set to be active from midnight (00:00) UTC. The DCC shall set this start time alongside the SeasonStartDate specified by the User within the Service Request.	sr:Date (with wildcards)	Yes	None	N/A
ReferencedWeekName	Week name as defined in WeekProfile Definition above	sr:ElecWeekName Restriction of xs:positiveInteger (minInclusive = 1, maxInclusive = 4))	Yes	None	N/A

Table 54: SpecialDays (sr:ElecSpecialDaysPrimary) data items

Data Item	Description / Allowable values	Type	Mandatory	Default	Units
SpecialDay	A collection of between 0 and 50 Special Day elements	sr:ElecSpecialDayPrimary (minOccurs = 0 maxOccurs = 50)	No	None	N/A

Table 55: SpecialDay (sr:ElecSpecialDayPrimary) data items

Data Item	Description / Allowable values	Type	Mandatory	Default	Units
Date	The date on which the special day applies	sr:Date (with wildcards)	Yes	None	N/A
ReferencedDayName	An identifier for that day	sr:ElecDayName (Restriction of xs:positiveInteger (minInclusive = 1, maxInclusive = 16))	Yes	None	N/A

Table 56: ThresholdMatrix (sr: ElecThresholdMatrix) data items

Data Item	Description / Allowable values	Type	Mandatory	Default	Units
Thresholds	A collection of 8 threshold matrix definitions Note that the attribute index provides an ordering for these elements.	sr: ElecThresholds minOccurs = 8 maxOccurs = 8	Yes	None	N/A
Index (Atrribute of Thresholds)	Provides an ordering for the Thresholds elements. Unique and consecutive numbers starting at 1.	sr:range_1_8 (positiveinteger minInclusive 1 maxInclusive 8)	Yes	None	N/A

Table 57: Thresholds (sr:ElecThresholds) data items

Data Item	Description / Allowable values	Type	Mandatory	Default	Units
BlockThreshold	Up to 3 threshold values defined within this collection, each value defines the threshold between blocks. Note that the attribute index provides an ordering for these elements.	xs:unsignedInt minOccurs = 1 maxOccurs = 3	Yes	None	Wh
Index (Atrribute of BlockThreshold)	Provides an ordering for the BlockThreshold elements. Unique and consecutive numbers starting at 1	sr:range_1_3 (positiveinteger minInclusive 1 maxInclusive 3)	Yes	None	N/A

Table 58: GasTariffElements (sr:GasTariffElements) data items

Data Item	Description / Allowable values	Type	Mandatory	Default	Units
SwitchingTable	A calendar defining UTC times, days and dates for switching the tariff	sr:GasSwitchingTable	Yes	None	N/A
SpecialDays	A calendar defining special dates for switching the Primary Element tariff	sr:GasSpecialDays	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
ThresholdMatrix	Up to 3 threshold values defined within this collection, each value defines the threshold between blocks	sr:GasThresholdMatrix	Yes	None	N/A

Table 59: GasThresholdMatrix (sr:GasThresholdMatrix) data items

Data Item	Description / Allowable values	Type	Mandatory	Default	Units
BlockThreshold	Threshold between one block and the next. Up to 3 can be defined to match the corresponding prices.	sr:GasThresholdType minOccurs = 1 maxOccurs = 3 (xs:unsignedLong) (maxInclusive = 281474976710655)	Yes	None	Wh
Index (Attribute of BlockThreshold)	Provides an ordering for the BlockThreshold elements. Unique and consecutive numbers starting at 1.	sr:range_1_3 (xs:positiveInteger from 1 to 3)	Yes	None	N/A

Table 60: GasSwitchingTable (sr:GasSwitchingTable) data items

Data Item	Description / Allowable values	Type	Mandatory	Default	Units
DayProfiles	Array of up to 4 DayProfiles defining a DayName identifiers and a list of 4 actions and start times to switch tariff	sr:GasDayProfiles	Yes	None	N/A
WeekProfiles	Array of up to 2 elements, each including a WeekName and the Day identifiers to be associated with a day of each day (Monday to Sunday)	sr:GasWeekProfiles	Yes	None	N/A
Seasons	Array of 3 elements, each including a Season ID, a Season Start Date and the Week ID associated to that Season ID	sr:GasSeasons	Yes	None	N/A

Table 61: DayProfiles (sr: GasDayProfiles) data items

Data Item	Description / Allowable values	Type	Mandatory	Default	Units
DayProfile	A profile definition for a single day Can include up to 4 Day Profiles	sr:GasDayProfile (minOccurs = 1 maxOccurs = 4)	Yes	None	N/A

Table 62: DayProfile (sr:GasDayProfile) data items

Data Item	Description / Allowable values	Type	Mandatory	Default	Units
DayName	An identifier for that day that has a number of ProfileSchedule elements associated with it. Note that this is referenced from the WeekProfile element. The DayName value must begin at 1 and increment by 1 for each subsequent DayName.	sr:GasDayName (Restriction of xs:positiveInteger (minInclusive = 1, maxInclusive = 4))	Yes	None	N/A
TOUTariffAction	Identifier (n) of the entry in the Gas TOU tariff to be applied (see Table 89) (n between 1 and 4) Valid set: Value between 1 and 4 Note that all TOU rates run from midnight, it is not possible to modify the start time.	Restriction of xs:positiveInteger (minInclusive = 1, maxInclusive = 4)	TOU Tariff to be applied: Yes Otherwise: N/A	None	N/A
BlockTariff	Indicates that the block tariff is active on this day. Note that Gas devices do not support a mixture of TOU and Block tariffs. When defining a block tariff all week profiles need to point to a day profile that is set with a Profile Schedule of BlockTariff.	sr:NoType	Block Tariff to be applied: Yes Otherwise: N/A	None	N/A

Table 63: WeekProfiles (sr:GasWeekProfiles) data items

Data Item	Description / Allowable values	Type	Mandatory	Default	Units
WeekProfile	A profile definition for a single week Can include up to 2 Week Profiles	sr:WeekProfileGas (minOccurs = 1 maxOccurs = 2)	Yes	None	N/A

Table 64: WeekProfile (sr:WeekProfileGas) data items

Data Item	Description / Allowable values	Type	Mandatory	Default	Units
WeekName	An identifier for the week. The WeekName value must begin at 1 and increment by 1 for each subsequent WeekName.	sr:GasWeekName (Restriction of xs:positiveInteger (minInclusive = 1, maxInclusive = 2))	Yes	None	N/A
ReferencedDayName	DayName as defined above in DayProfile Definition Note that the attribute index provides an ordering for these elements.	sr:GasReferencedDayName (minOccurs = 7 maxOccurs = 7) Restriction of xs:positiveInteger (minInclusive = 1, maxInclusive = 4)	Yes	None	N/A
Index (Attribute of ReferencedDayName)	Provides an ordering for the ReferencedDayName elements. Monday = 1, incrementing by day through to Sunday = 7. Unique and consecutive numbers starting at 1	sr:range_1_7 (positiveInteger minInclusive 1 maxInclusive 7)	Yes	None	N/A

Table 65: Seasons (sr:GasSeasons) data items

Data Item	Description / Allowable values	Type	Mandatory	Default	Units
Season	A definition for a single season Can include up to 3 Seasons	sr:GasSeason (minOccurs = 1 maxOccurs = 3)	Yes	None	N/A

Table 66: Seasons (sr:GasSeason) data items

Data Item	Description / Allowable values	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 WeekProfile Definition	sr:GasWeekName (Restriction of xs:positiveInteger (minInclusive = 1, maxInclusive = 2))	Yes	None	N/A

Table 67: SpecialDays (sr: GasSpecialDays) data items

Data Item	Description / Allowable values	Type	Mandatory	Default	Units
SpecialDay	A collection of between 0 and 20 Special Day elements	sr:GasSpecialDay(minOccurs = 0 maxOccurs = 20)	No	None	N/A

Table 68: SpecialDay (sr:GasSpecialDay) data items

Data Item	Description / Allowable values	Type	Mandatory	Default	Units
Date	The date on which the special day applies	sr:GasDateWithWildcards See Table 319	Yes	None	N/A
ReferencedDayName	DayName as defined	sr:GasDayName (Restriction of xs:positiveInteger (minInclusive = 1, maxInclusive = 4))	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 →