Guidance for Energy Billing APIs

Introduction

The following notes are gathered from Subject Matter Expert guidance and answers to participant questions. 

Energy Billing Transactions

Energy billing transaction schemas include:

• EnergyBillingUsageTransaction
• EnergyBillingDemandTransaction
• EnergyBillingOnceOffTransaction
• EnergyBillingOtherTransaction

Concessions and Rebates

Energy Billing APIs do not include individual fields to capture concession or rebate amounts. Billing Transaction  schemas have a simple amount and description field. The amount contains the amount of the transaction. 

To include a concession or rebate amount, the DH can put the amount in an EnergyBillingOnceOffTransaction or EnergyBillingOtherTransactionstructure. 

This allows a consumer to share data without the need to disclose a hardship-related concession, or other sensitive information. 

The description field is at the discretion of the DH. It can contain an explanation for the amount. The DSB recommends the DH does not label the amount as a concession.