Skip to content
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

Distributor needed for EnergyPlan.geography object #512

Closed
joe-aer opened this issue May 12, 2022 · 5 comments
Closed

Distributor needed for EnergyPlan.geography object #512

joe-aer opened this issue May 12, 2022 · 5 comments
Labels

Comments

@joe-aer
Copy link

joe-aer commented May 12, 2022

Description

When the energy standards was in draft, the geography object contained a distributor string field (child of the supply area object) that identified the distributors that operated in the postcodes where a plan was available.

When the energy standards went live, the supply area, including the distributor field was removed.

See DP190: ConsumerDataStandardsAustralia/standards#190 for background.

Whilst the removal of the supply area object was the correct decision, the removal of the distributor was not.

In the context of a price comparator, e.g. Energy Made Easy, the distributor is important criterion for identifying the plans that are relevant for a consumer when more than one distributor operates in their postcode. Without the distributor being selected, comparator results may contain plans that are unavailable and irrelevant for a consumer by virtue of their property not being on a distributor's network.

By way of example, the postcode of Tarban NSW 2372 is serviced by both Ergon and Essential Energy.

We feel that without the distributor data being available, price comparators would be unable to provide consumers with a quality service.

Area Affected

The EnergyPlan.geography object schema.

Change Proposed

The addition of a EnergyPlan.geography.distributors[] string array field.

While an array is proposed, there is typically only one distributor per product but it is important to offer the flexibility for any exceptions to this.

@CDR-API-Stream
Copy link
Collaborator

As per action raised in MI11 session on 25th May to assess and re-prioritise energy items, the DSB is including this CR in MI11 for consultation.

@joe-aer, do you propose the EnergyPlan.geography.distributors[] array field to be mandatory? The assumption here is that this value is also held by Retailers.

Feedback from other participants is welcome.

@joe-aer
Copy link
Author

joe-aer commented Jun 6, 2022

@joe-aer, do you propose the EnergyPlan.geography.distributors[] array field to be mandatory? The assumption here is that this value is also held by Retailers.

Yes, I am proposing that the distributors array field should be both mandatory and contain at least one item. It would also be my assumption that retailers would know that distributors that operate in their retail areas.

The challenge that I foresee with this field is ensuring consistency across DHs of the string content of the array items. One solution could be for DHs to manually reference the distributor names published on the AER's website.

@CDR-API-Stream
Copy link
Collaborator

This issue was discussed during the Energy MI call on 14th June.

Feedback during the call suggested that whilst including the distributors array would be ok, it should be optional. However, @joe-aer makes good point, there appears to be no scenario where a distributor for a given account/plan would not be known to a retailer.

As mentioned during the call, if a DH holds value for an optional field they are required to provide it as per CDR standards (i.e. they are not optionally implementable by the DH). The DH will have to share the value of distributors if they have it even if it is optional.

The DSB is seeking feedback to understand if there are any scenarios where an active account/plan can exist without a distributor? If there is no such case, the DSB proposes to take @joe-aer's recommendation and add EnergyPlan.geography.distributors[] as a mandatory array.

@perlboy
Copy link

perlboy commented Jun 19, 2022

On review of the existing payloads EnergyPlan isn't actually used anywhere other than Get Generic Plans and Get Generic Plan Details? On this basis a DH would only be supplying this value voluntarily as EME is the only body mandated to supply it?

@joe-aer
Copy link
Author

joe-aer commented Jun 19, 2022

Splitting hairs I know, but if a DH voluntarily provisions the Get Generic Plans and Get Generic Plan Detail endpoints then it becomes mandatory for them to provide the EnergyPlan.geography.distributors[] field/value. And yes, both the AER and DELWP systems can provide the distributor field/value.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
Archived in project
Development

No branches or pull requests

4 participants