-
Notifications
You must be signed in to change notification settings - Fork 56
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Decision Proposal 116 - Billing Data Payloads #116
Comments
I note the usage lines do not have the facility for metering charges or daily connection charges. These are separate from the usage calculation. |
Time of Use type does not have an allowance for season. There are some seasonal TOU tariffs in Regional Queensland. |
Tariff 14 – Residential Demand |
Hi All, EA’s response below relates to mass market and small business customers. It is not yet clear whether large commercial and industrial customers will be in scope for the CDR and this will be determined by the ACCC in their CDR Rules. We will need to confirm large customer billing data payloads if this is looking likely. We also note that the overall purpose of the billing data is unclear. Beyond total billed amount, the billing items are very complex and non-standardised (other than what is required by regulation). It will be highly unlikely that the billing items can be combined with usage data and tariff data, to produce reliable bill estimates. We question the utility of requiring the specific billing data. We note that this issue will be determined by the ACCC at a policy level but that the DSB’ work on billing data payloads will need to follow this direction. It's also unclear how the different retailer provided data sets will be used together. Invoice Common Type
Billing Transaction Common Type
Cheers |
These are expected to be included in the |
The structures in the billing proposal do not seek to contain tariff information, only the resulting charges. As these are time dependent it is assumed that seasonal pricing will be applied at the time of the charge or invoice being generated. |
Hi @SArn-erg, in response to this comment:
Could you expand on the applicability of this to the payloads in the proposal? It isn't clear as to what part of the proposed standard this is a comment on or what the impact would be. |
In respons to @SelenaLiuEA: Thanks for the comprehensive feedback. Detailed responses are below. The general notes around utility of billing data and the applicability to large corporate customers is more policy related so will be left to the ACCC rules consultation and potentially to Treasury. Any feedback on how you see the introduction of large commercial customers may potentially impact the standards would, however, be beneficial as it would test the future flexibility of the standard.
Yes. That is the intent.
Thank you for this feedback, it was intended that it was the bill ID assigned by the retailer and it was assumed that all invoices would have this. The need for optionality will be considered.
Thank you. This is helpful feedback.
It is intended to be the former. The amount due with current balance incorporated.
The intention of this payload is that the information included on the bill at issue is presented. If discounts for on time payment are not included in the amount due on the issued bill then it is reasonable to exclude it. This detail would be picked up under the transaction end points so is still shareable.
That is the intent. We can clarify the descriptions.
This could be reasonably accommodated as account level once off charges or usage based once off charges. It would be at the discretion of the retailer as to how they categorise each charge.
Thanks you for this feedback. If there are any that cannot specifically be accommodated in the proposed structure please let us know as this may warrant changes to accommodate the specific variation.
It is expected that, under the invoice structure, this would be accommodated by having a zero value against the appropriate field.
Bill reversals are a new topic so this may require some thought. The intent of the invoice APIs is to show the billing history for a customer (according to the requirements of the designation instrument). In this context a reversed bill could be handled in multiple ways:
Which option would be most appropriate? |
In respons to @SelenaLiuEA:
It is expected that each retailer would conceptualise their billing charges differently depending on their technical implementation and policies. The structure proposed is an attempt to create a generic structure that would accommodate many different variations. The proposed structures would appear to be able to accommodate the model you describe. Are there specific issues in the structure that would prevent your charge history from being represented correctly?
This is expected. The payment structure does not include a link to a specific invoice.
The intention is that different periods, where different TOU pricing would apply, would be separated into other charge records.
That would be appreciated.
As the tariffs are presented in a separate data cluster there has been no accommodation included to make the connection between pricing and charging. Should this link be included? If so, what would be the best way to achieve that without including the same data available in the account detail end point? |
Hello, Feedback from Momentum Energy: Invoice Common Type
Billing Transaction Type
|
Hello, Feedback from AGL Energy on behalf of AGL Energy CDR technical working group AGL concours with the feedback provide by Energy Australia above and would like to additional raise the following. At AGL, a bill is issued at an account level that holds one or many arrangements. These arrangements can be electricity and non-electricity products/services that may not always be associated with a NMI (or MIRN in the gas use case). Subsequently the broader intent of the designation instrument to support item “3(c) information used to calculate a bill” may not be achievable through this technical proposal due to the following:
Invoice Common Type
Billing Transaction Common Type
|
Hi again, Re Tariff information, our feedback is the data object structure seems suitable for most customers today. But it would need to evolve for new tariff types as they are introduced e.g. the direction the AER and others are going with the introduction of Demand charging for Residential customers. Nor does it appear to support multiple dedicated circuits appropriately (unless that’s why there are three shoulder figures – but it’s hard to see how they’d be used consistently). Cheers |
A request for an extension to this consultation has been received so the consultation will be extended to close of business, Monday 9th November |
Feedback from Origin Energy on DP-116Invoice Common Type
Billing Transaction Common Type
Generic Comment Overall the payload seems more tailored to mass market bundled charges. Has the unbundled charging model of the large commercial and industrial customers been considered for these payloads or will it be submitted for consultation at a later stage after the confirmation of ACCC rule regarding inclusion of the large customers ? Cheers! |
Hi All, please see further feedback from EA below: EA’s responses:
EA can provide both amountDue including pay on time discount and without it (the first would take more data work to provide it though). Our bill presents both. It is important to note that different retailers may take different approaches re including and not including pay on time discounts in their amount due, and so we recommend that this be clarified in the standards.
Just a general question - why are the billing charges and tariffs in Tailored Data payloads so different? The latter specifies the different fees and charges in a lot more detail. It may matter if ADRs try to use tailored tariff data (if historical tailored tariffs are in scope) to analyse bills.
Fine if this is just a dollar amount.
It is fine for a zero value to be returned for the data fields that the data will not “fit”, but the data will still have to be returned and it may not be clear which field applies. For example, a subscription type plan – may involve just one aggregated charge for a month. This may not technically fall under a usage charge, as it might cover both usage, supply, and other charges, for example. The standards should clarify what should happen in this scenario and for other non-conventional tariff structures. This is also an issue for tailored tariff data.
We would suggest exclude showing them; having a flag could be even more confusing.
The proposed categories might have gaps (1) usage (2) onceOff (3) payment – e.g. what about non-usage charges that are not once off charges?
This only matters if ADRs wish to use tailored tariff data to analyse bills for example. One theoretical use case is a bill check for an issued bill – which we don’t think is likely anyway. It could also possibly be used for a bill estimate – if previous bills and the tariffs that applied to that bill are used to formulate a bill estimate. I think this is a policy issue which needs to be tested further. Cheers |
* Standards Staging Issue #115: Update text description of bulk balance for energy in endpoint version schedule * Cleared out the diff comments presented on the Version Delta tab * Added an empty release 1.16.0 release notes page * Incremented version numbers for swagger files to 1.16.0 * Added archive link to 1.15.0 * Reverted back to standard (non-festive) logo * Incremented version number in introduction * Added normative reference link to RFC9126 * Added link to 1.16.0 release notes * Corrected link for RFC2119 * Clarified requirements for Data Recipient Software Products S256 code challenge method by removing the redundant \'if supported\' text * Standards Staging Issue #116 Change type of page and page-size in Energy APIs to PositiveInteger * Updates for DP166 * Updates for DP166 * Removed duplicate section: Data Holders calling Data Recipients * Corrected GetProducts response reference from ResponseBankingProductList to ResponseBankingProductListV2 * Removed the unintended additional formatting from the cds_banking.json to make diffs easier * Corrected Register Discovery Document definition defect renaming request_object_signing_alg_values_supported to token_endpoint_auth_signing_alg_values_supported * Corrected GetDataHolderBrands RegisterDataHolderAuth and jwksEndpoint schema definitions to clarify their usage in DH to ADR client authentication * Standards Staging Issue #115: Updated release notes for this change * fixed typos and ordering * Removed tables * Rechanged ordering * Build and final checks Co-authored-by: Hemang Rathod <[email protected]> Co-authored-by: Ivan Hosgood <[email protected]> Co-authored-by: Kirkycdr <[email protected]> Co-authored-by: James Bligh <[email protected]> Co-authored-by: James Bligh <[email protected]>
* Standards Staging Issue #115: Update text description of bulk balance for energy in endpoint version schedule * Cleared out the diff comments presented on the Version Delta tab * Added an empty release 1.16.0 release notes page * Incremented version numbers for swagger files to 1.16.0 * Added archive link to 1.15.0 * Reverted back to standard (non-festive) logo * Incremented version number in introduction * Added normative reference link to RFC9126 * Added link to 1.16.0 release notes * Corrected link for RFC2119 * Clarified requirements for Data Recipient Software Products S256 code challenge method by removing the redundant \'if supported\' text * Standards Staging Issue #116 Change type of page and page-size in Energy APIs to PositiveInteger * Updates for DP166 * Updates for DP166 * Removed duplicate section: Data Holders calling Data Recipients * Corrected GetProducts response reference from ResponseBankingProductList to ResponseBankingProductListV2 * Removed the unintended additional formatting from the cds_banking.json to make diffs easier * Corrected Register Discovery Document definition defect renaming request_object_signing_alg_values_supported to token_endpoint_auth_signing_alg_values_supported * Corrected GetDataHolderBrands RegisterDataHolderAuth and jwksEndpoint schema definitions to clarify their usage in DH to ADR client authentication * Standards Staging Issue #115: Updated release notes for this change * fixed typos and ordering * Removed tables * Rechanged ordering * Build and final checks * Convert swagger to OAS Remove 4xx error codes * Rebuild * Fix json typos Update error codes for energy OAS * Rebuild * Added tooltip support for RFCs and normative/informative references. Also fixed invalid or missing RFC links * Fixed markdown issue with normative references table * Converted more normative reference links to dynamic tooltips * Updated FAPI informative reference * - Formatting improvements. - Added additional tooltip references * - Moved normative references out of the Security section into the Introduction. - Added additional tooltip references * Updated code generation for normative and informative references * Added link to the endpoint versioning schedule to the high level standards * Added 1.16.1 release notes * Added release notes for Standards Staging issue 130 * Added release notes for Standards Staging issue 132 * Updated RFC4122 links in Banking and Common schemas to include tooltips * poc secondary-dataholder-apis: Added changes to include Energy Secondary Data Holder OAS in standards * Fix for staging 139 * fix #138 * Fix for #137 * Fix #136 * Fix #135 * Fix #134 * Initial build for review * Update version number everywhere * Add archive entry for 1.16.0 Clean up diff statements Update release notes * Fixes to SR swagger * Update Swagger to OAS in markdown * Updated Energy SDH swagger file to lastest version with fixes applied for error codes and attribute types * Remove known issues that are resolved Full rebuild * Version bumps to address GitHub security notices * Updated additional informative references to include tooltips * Fix SDH security * Fix for controlledLoad flag in energy Rebuild * Minor release notes and diff fixes Co-authored-by: Hemang Rathod <[email protected]> Co-authored-by: Ivan Hosgood <[email protected]> Co-authored-by: Kirkycdr <[email protected]> Co-authored-by: James Bligh <[email protected]> Co-authored-by: James Bligh <[email protected]> Co-authored-by: Mark Verstege <[email protected]>
* Standards Staging Issue #115: Update text description of bulk balance for energy in endpoint version schedule * Cleared out the diff comments presented on the Version Delta tab * Added an empty release 1.16.0 release notes page * Incremented version numbers for swagger files to 1.16.0 * Added archive link to 1.15.0 * Reverted back to standard (non-festive) logo * Incremented version number in introduction * Added normative reference link to RFC9126 * Added link to 1.16.0 release notes * Corrected link for RFC2119 * Clarified requirements for Data Recipient Software Products S256 code challenge method by removing the redundant \'if supported\' text * Standards Staging Issue #116 Change type of page and page-size in Energy APIs to PositiveInteger * Updates for DP166 * Updates for DP166 * Removed duplicate section: Data Holders calling Data Recipients * Corrected GetProducts response reference from ResponseBankingProductList to ResponseBankingProductListV2 * Removed the unintended additional formatting from the cds_banking.json to make diffs easier * Corrected Register Discovery Document definition defect renaming request_object_signing_alg_values_supported to token_endpoint_auth_signing_alg_values_supported * Corrected GetDataHolderBrands RegisterDataHolderAuth and jwksEndpoint schema definitions to clarify their usage in DH to ADR client authentication * Standards Staging Issue #115: Updated release notes for this change * fixed typos and ordering * Removed tables * Rechanged ordering * Build and final checks * Convert swagger to OAS Remove 4xx error codes * Rebuild * Fix json typos Update error codes for energy OAS * Rebuild * Added tooltip support for RFCs and normative/informative references. Also fixed invalid or missing RFC links * Fixed markdown issue with normative references table * Converted more normative reference links to dynamic tooltips * Updated FAPI informative reference * - Formatting improvements. - Added additional tooltip references * - Moved normative references out of the Security section into the Introduction. - Added additional tooltip references * Updated code generation for normative and informative references * Added link to the endpoint versioning schedule to the high level standards * Added 1.16.1 release notes * Added release notes for Standards Staging issue 130 * Added release notes for Standards Staging issue 132 * Updated RFC4122 links in Banking and Common schemas to include tooltips * poc secondary-dataholder-apis: Added changes to include Energy Secondary Data Holder OAS in standards * Fix for staging 139 * fix #138 * Fix for #137 * Fix #136 * Fix #135 * Fix #134 * Initial build for review * Update version number everywhere * Add archive entry for 1.16.0 Clean up diff statements Update release notes * Fixes to SR swagger * Update Swagger to OAS in markdown * Updated Energy SDH swagger file to lastest version with fixes applied for error codes and attribute types * Remove known issues that are resolved Full rebuild * Version bumps to address GitHub security notices * Updated additional informative references to include tooltips * Fix SDH security * Fix for controlledLoad flag in energy Rebuild * Minor release notes and diff fixes * Standards Release 1.17.0: Added release notes file * Standards Maintenance Issue #448: Changed percentOfBill, percentOfUse, fixedAmount and percentOverThreshold attributes from optional to conditional within EnergyPlanDiscounts schema * Standards Release 1.17.0: Removed version deltas, incremented version numbers in swagger files, added archieve entry for 1.16.1 * Updates to baseline 1.17.0 to remove legacy diffs and include a link to the release notes * Standards Maintenance Issue 503: Fixed documentation for CDR Arrangement Form Parameter and JWT method requirements * Added scrollabe diffs and examples to support previous and next scrolling * Added release notes * Updated prev/next button titles * Minor refactoring to remove unused vars * Standards Maintenance Issue 504: Corrected the profile scope data language to clarify request of individual claims * Added diff * Standards Maintenance Issue #449: Made EnergyPlanSolarFeedInTariff.timeVaryingTariffs.timeVariations.days field mandatory * Added proof of concept to highlight obligations in the endpoint versioning schedule based on a selected mileston date * Added release notes * Removed diff comments * Fix for padding of last input field in datepicker * Added collapsible obligations that hide any future, retired, and inactive obligations * Tweaks to collapsed highlighting * Updated release notes to include standards maintenance issue number * Corrected release description * Updated CDR Arrangement Recovation JWT documentation to articulate requirements in accordance to self signed JWTs * Added a new section to summarise all change requests in the release notes * Added headings * Added obligation milestones * Improvement to wording of profile scope data language based on commmunity feedback * Updated diff * corrected non-normative examples using the unsupported HS256 alg. Changed examples to PS256 to align with FAPI requirements * Added 482 descriptions to the release notes * Updated release notes * Update dcr OAS so it compiles * Standards Maintenance Issue #457: Made EnergyServicePointDetail.meters.registers.registerSuffix field optional * Updated release notes to contain links to the associated change request * Updated Register swagger to addres empty content fields causing compilation issues * header requirements for versioned Register APIs moved from mandatory to optional * Standards Maintenance Issue #438: Added calculationFactors and adjustments objects to EnergyBillingOtherTransaction model * Added version delta comments * Rebuild Fix minor typos in diffs * Removed debugging output for date picker * Standards Maintenance Issue #439: Added timezone field to EnergyPlanTariffPeriod * Fixed compile issues for date picker scripts * Added Register dependency schedule table to differentiate Register delivery from Participant future dated obligations * Added requirement for data holders to ignore unsupported authorisation scopes * Updated endpoint version schedule to 2022-11-15 for register API versions where binding date was subject to ACCC review * Standards Maintenance Issue #476: Updated EnergyConcession model to cater for variable concessions. Changed RateString to represent generic percentages. * Standards Maintenance Issue #476: Moved RateString change description to High Level Standards in Release Notes. Move RateString diff in High Level Standards * Moved change description to API Endpoints sections in Release Notes * Set retirement dates for outstanding deprecated Register APIs * Added standards maintenance issue reference to release notes * Added standards maintenance issue reference to release notes * New authenticated endpoints only require cdr-register:read as the authorisation scope * Added clarification that when statuses are not received or recognised from the CDR Register, the ACCC can inform Data Holders of statuses to trust using an alternative mechanism * Added GetDataHolderBrandsSummary API to expose public details of Data Holder Brands from the CDR Register to public clients * Standards Maintenance Issue #478: Made EnergyServicePointDetail.meters and EnergyServicePointDetail.meters.registers fields optional and updated their descriptions * Documented scopes usage for the authenticated Register endpoint versions * Changed formatting of dependency dates to remove leading zero * XV header is a required field * Made SHOULD requirement bold * Added version-deltas for register scope usage * Standards Staging Issue #133: Corrected description of 'oldest-date' by removing the word 'days' * Standards Staging Issue #170: Documentation fix - EnergyServicePointDetail.meters and EnergyServicePointDetail.meters.registers have been converted into arrays * Standards Maintenance Issue #439: Updated description of EnergyPlanContract.timezone and EnergyPlanTariffPeriod.timezone to specify default values * Standards Staging Issue #131: Minor edit- clarification added that ServicePointId to be replaced with NMI in path param as well * Corrected version delta presentation * Added Get Data Holder Brands Summary to the endpoints table * Corrected whitespacing in version deltas * Standards Staging Issue #153: Modified Energy location to be a CommonPhysicalAddress model * Added support for 404 response code * Full rebuild * Add release date Reorder release notes * Standards Staging Issue #167: Corrected x-fapi-interaction-id header to be mandatory for Energy SDH APIs * Fix to force version delta code blocks to break at word boundaries not at overflow * 404 now only applies when industry is not found * Cosmetic improvements in the release notes * Cleaned up version deltas to follow conventions * Removed reference to the ACCC delivery schedule * Full rebuild * Correct change for staging issue 170 Co-authored-by: Hemang Rathod <[email protected]> Co-authored-by: Ivan Hosgood <[email protected]> Co-authored-by: Kirkycdr <[email protected]> Co-authored-by: James Bligh <[email protected]> Co-authored-by: James Bligh <[email protected]> Co-authored-by: Mark Verstege <[email protected]> Co-authored-by: Ivan Hosgood <[email protected]>
The decision proposal for Energy Billing data payloads is attached below:
Decision Proposal 116 - Billing Data Payloads.pdf
Feedback is welcome on this proposal. This thread will remain open for feedback until the 9th of November.
As previously discussed in various forums, the practice of the DSB is to respond to feedback incrementally before the consultation is complete to promote an interactive style of consultation.
Participants are therefore encouraged to provide feedback earlier in the consultation process so that the community can work together to a consensus outcome.
The text was updated successfully, but these errors were encountered: