EnergyBillingDemandTransactionV2 - Measure Unit

[rhys-ergon]

Description

In Energy, demand transactions are assumed to be measured in kVA. Ergon Energy has some customers, particularly with older meters (Type 6 or Basic), that are charged in kW for demand tariffs. To convert from kW to kVA requires an equipment power factor from behind the meter for every 30 minutes, which is not recorded and therefore we cannot convert kVA.

Area Affected

Schema - EnergyBillingDemandTransactionV2
APIs - GET /energy/accounts/{accountId}/billing and GET /energy/accounts/billing

Change Proposed

Add a new property to EnergyBillingDemandTransactionV2

Name = MeasureUnit
Type = string
Required = optional (Assumed KVA if absent)
enum = KVA, KW

DSB Proposed Solution

The current DSB proposal for this issue is in #587 (comment).

[rhys-ergon]

Supporting information

Demand tariffs 44, 45 & 46 can be charged in kVA or kW

[HemangCDR]

Below is the proposed EnergyBillingTransactionV2.demand object with the option measureUnit field:

{
  "servicePointId": "string",
  "invoiceNumber": "string",
  "timeOfUseType": "PEAK",
  "description": "string",
  "isEstimate": true,
  "startDate": "string",
  "endDate": "string",
  "measureUnit": [ "KWH", "KVA", "KVAR", "KVARH", "KW", "DAYS", "METER", "MONTH" ], // optional - The measurement unit of rate. Assumed to be KVA if absent
  "rate": 0, //The rate for the demand charge . Assumed to be KVA if measureUnit not provided. A negative value indicates power generated
  "amount": "string",
  "calculationFactors": [
    {
      "value": 0,
      "type": "DLF"
    }
  ],
  "adjustments": [
    {
      "amount": "string",
      "description": "string"
    }
  ]
}

As discussed during the MI call on 18th October, this would be considered a breaking change. However, given the change involves adding an option field (which not every retailer may need), no future dated obligation is being proposed for the new version. Retailers may choose to implement the new version as required. It is also proposed The current version MAY be retired on September 9th 2024 if the new version is implemented.

Feedback on the above is welcome.

[rhys-ergon]

Thanks Hemang, this fulfils our requirements.

[CDR-API-Stream]

This change has been staged and can be reviewed here: ConsumerDataStandardsAustralia/standards-staging@d315a33

[CDR-API-Stream]

Note: The following Billing APIs impacted by this change have incorrect endpoint version number of 2 (instead of 3) noted in v1.29.0 of the standards:

• Get Bulk Billing
• Get Billing For Specific Accounts

This issue has been raised in staging and noted in the Known Issues section of v1.29.0 of the standards. It will be fixed in the next version release.