Resolution of EES API SearchAddress method discrepancies

  • 1
    Withdrawn
Step 1 of 1
Withdrawn
Summary
This change aims to ensure that the returned data items have uniform labels irrespective of the API search that provides the data. This will ensure that the requestor does not have to anticipate potentially different data labels for the the same data items.

Latest update and next planned activity

Date of latest update
Latest Update
22/02/2023 - Change Proposal withdrawn with the Proposers agreement

Impacts Overview

Solution development

Documents Library

There is currently no Change Plan.

Original submission

Change details

Mark Pearce - Code Manager TDA
13 Oct 2022

Change details

Resolution of field name discrepancies returned from the SearchAddress method within the EES API and updates to EES Interface Specification.
INC0115385 was raised on the CSS Service Desk identifying a discrepancy with the labels of three returned data items when using the SearchAddress method in certain circumstances. This change aims to ensure that the returned data items have uniform labels irrespective of the scenario that provides the data. This ensures that the requestor does not have to anticipate potentially different data labels. This issue has only been raised by one party and is thought to be a relatively rare occurrence due to generally good matching between MPL and REL addresses. As background, when the SearchAddress method is used it makes two searches, one for the MPL address and one for the REL address. The results are then combined and provided back to the requestor. As shown in the matrix in the attached document the issue occurs when an MPL address is matched but not the related REL address (2nd scenario). In this scenario the MPAN identified in the first search is used to identify the REL address and it is at this point the inconsistent labels are returned. This impacts the three returned data item labels listed below. This change seeks to update the labels so that in either scenario the data items are returned with labels that do not include the ‘rel_’ prefix. In addition to the above functional fix, this change seeks to update the EES API Interface Specification to detail the data items that will be returned when the SearchAddress method call is used. The updated specification will also include corrected data labels in sections 12.5 (GetRELAddress method) and 13.5 (SearchRELAddress method).
User systems that use the EES API SearchAddress method will not be expecting inconsistent data labels in returned data. In the event that scenario 2 occurs they may not be able to process the returned data leading to internal errors potentially requiring manual workarounds.
In order to be successful this change should have a brief period of socialisation with EES API users to ensure that they have the opportunity to review and comment on the change. Once the change has been agreed with the impacted users, an appropriate release date for the change should be agreed in a reasonable timeframe.
The SearchAddress method was introduced as part of the Faster Switching programme and was tested as part of that programme, with no instances of this issue raised during industry testing. This issue has been brought to the attention of the Service Provider post go live by one EES API user.

Impacts

Electricity
Switching experience
-
No details provided
-
No details provided
-
No details provided
-
No details provided
-
No details provided
-
No details provided
Change only impacts EES API Interface Specification.
No details provided
Users of the EES API SearchAddress method.
No details provided
-
No
No details provided

Priority & timing

Yes
-
-
-
No details provided
-

Activity