Chorus Portal and B 2 B System Changes
Chorus Portal and B 2 B System Changes February 2020 External Customer Change Pack
Overview • In preparation for the launch of the Chorus NGA National Tail Extension product, Chorus is making a number of changes to the Chorus Portal and B 2 B. The changes outlined in this pack will be visible to RSPs. • The Billing Invoice Description of Current Tail Extension products will be updated to include a Tail Extension billing step code ‘A’ • In addition Chorus will be deploying some additional enhancements to improve the visibility of Customer Located Network Equipment (CLNE); the ONT. • Examples of the updated XML is included in the appendix on the last page. • We are looking to put these changes in production on 07 Feb 2020 • B 2 B changes for National Tail Extension (slides 3 – 6) will be visible in EMMA on 26 Nov 2019 • B 2 B changes for Chorus CLNE (slides 7 – 9) will be visible in EMMA on 14 Jan 2020 • Customers will need to ensure that the changes being introduced will not impact any current ordering processes for existing Chorus products. Any prices shown are indicative only and purely used for testing and in the development of this document
Customer Changes (To support National Tail Extension) What happens today What the changes mean for you To provide national coverage for NGA fibre a minimum of 5 regional handovers is required. One in each regional POI. Auckland, Hamilton, Wellington, Christchurch and Dunedin. It will be possible to designate any Local or Regional handover to be a National Handover (this includes existing and new handovers) and support the connection of a fibre service from any NZ wide location. At launch ALL handovers will be designated as not being a national handover. Depending on the location for a fibre connection the handover used will be grouped: Step S A B C In the Portal the list of available voice or data handovers is not grouped depending on the National Tail Extension step Scenario Local (No Tail Extension Applies) Regional step National step, same island as the location for service National step, different island as the location for service Handovers will be grouped based on the step: Step B or C handover will only be displayed if a national handover has been designated.
Customer Changes (To support National Tail Extension) What happens today What the changes mean for you B 2 B query. Order. Feasibility. Response only returns Local or Regional handovers If a handover has been designated as national the query. Order. Feasibility. Response will return the handover ID for designated national handover B 2 B create. Order. Request does not support the inclusion of a designated National handover The B 2 B create. Orde. Request will allow the inclusion of a handover designated as national. In the create. Order. Response if the handover has not been designated as national the existing 026 exception code will be provided. <Exception. Item> <id>7 aadb 298 -cfa 3 -4 a 84 -9586 -b 87 f 180 a 7 bff</id> <code>026</code> <description>Request validation failed: Characteristic [name: DATA_HANDOVER_CONNECTION_ID, value: 987123445] out of range. </description> <reference>//Product. Characteristic</reference> </Exception. Item> Via the Chorus Implementation Team a voice or data handover can be designated as being the default handover for fibre order entry but only if this is a local handover A default handover can now be set as being local, regional or national. It will only be possible to set a default data handover. If no default handover has been used the Chorus Portal will not selected a preferred handover when entering order characteristic details.
Customer Changes (To support National Tail Extension) What happens today What the changes mean for you The order charges screen contains columns that are no longer used The order charges screen has been updated to remove unwanted columns (Billing Code) and new columns added to allow improved information if Tail Extension is being used Reflects the Tail Extension step (A, B or C) Will reflect that Tail Extension is being used to supply service for this product/offer Any prices shown are indicative only and purely used for testing and in the development of this document
Customer Changes (To support National Tail Extension) What happens today What the changes mean for you The completed billing notification has a total value for any one-off or recurring charges The completed billing notification and B 2 B Amend. Order. Notification: Completed_BILLING will now show separate charges for one-off, recurring and separate offer characteristic e. g. Tail Extension EG 1 We have 3 separate CSE’s that are used when requesting an ONT or CPE to be relocated internally (Internal Relocation – CPE Only, Internal Relocation – CPE and ONT, Internal Relocation – ONT only). These 3 CSE’s will be consolidated into two separate CSE’s for ONT or CPE relocation based on segment (Residential or Business/Education). This will be achieved by renaming the current CPE ‘Internal Relocation - ONT Only’ to ‘Consumer Internal Relocation’. The renamed ONT will only be available for selection on Residential offers. The other two CSE’s (Internal Relocation – CPE Only and Internal Relocation – CPE and ONT) will be withdrawn. From a service company and work order perspective these three CSE’s are all treated the same. A new Business and Education CSE will be introduced for the relocation of an ONT or CPE in these two segments ‘Business Internal Relocation’. This new CSE will only be selectable for Business and Education offers. For customers using the B 2 B a new product catalogue extract will be provided showing the removal of product ID’s 155 and 156. The Query. Order. Response does not return characteristic based values New values will be returned with the Query. Order. Response. Characteristic. Name and charasteristic. Value <category>Product</category> <product. Offer>Business 1</product. Offer> <characteristic. Name>TAIL EXTENSION DATA 1</characteristic. Name> <characteristic. Value>C</characteristic. Value> <product. Id>1636007952</product. Id> <charge. Type>Recurring</charge. Type> <unit. Cost>48</unit. Cost> <quantity>1</quantity> <value>48</value> EG 5
Customer Changes (To improve the visibility of Chorus CLNE) What happens today What the changes mean for you The Chorus Portal does not allow a location to be derived using the ONT serial number The Chorus Portal only displays limited information on the ONT or ONTs available at a location The basic location search function will be enhanced with a new drop down to allow search using a Chorus ONT serial number. The full 12 digit serial number must be entered and will return only the ONT associated with this serial number and any other ONT’s at the location Once a location has been found (irrespective of the criteria used) additional information will be presented on the. The new fields will be ‘Type’ and ‘Mode’. The type will reflect the ONT model actually displayed on the physical ONT: ONT Type ONT Model Type 100 I-240 G-R Type 200 G 240 G-P Type 300 G-140 W-C SFP G-010 S-A or G 010 S-P The mode will be ‘Standard’ at outset for all ONT models Once fully expanded the spare resources available on the ONT will be displayed
Customer Changes (To improve the visibility of Chorus CLNE) What happens today What the changes mean for you You can’t search for an order using the ONT serial number The basic order search will be enhanced to include a new drop down that allows orders to be searched using the Chorus ONT serial number. The full 12 digit serial number must be entered B 2 B call Query. Place does not support the input of an ONT serial number to determine the location The 12 digit ONT serial number will be accepted as an input in the B 2 B call Query. Place. Request. The B 2 B Query. Place. Response will return the same details and information as returned today EG 3 B 2 B does not have exception handling to support an invalid ONT serial number being entered If a B 2 B call is sent with an invalid serial number using Query. Place or Query. Site. Information the following exception codes will be returned: B 2 B Code B 2 B Message Reason 050 “ONT Serial Number is not valid” If not 12 characters long 051 “ONT Serial Number not found” If not alphanumeric (i. e. no wild characters are allowed in the serial number) If not found in ONT Inventory
Customer Changes (To improve the visibility of Chorus CLNE) What happens today What the changes mean for you B 2 B call Query. Site. Information. Request does not support the ONT serial number as an input. The Query. Site. Information. Response does not return resource information for the ONT or ONT’s at a location The 12 digit ONT serial number will be accepted as an input in the B 2 B call Query. Site. Information. Request. The Query. Site. Information. Response will return the following {name: value} pairs in the Site. Information. Interaction. Item. Detail Name Query. Site. Information. Response does not return the Product Offer name. Type min. Occurs max. Occurs ONT_ID string 0 1 ONT_MODEL string 0 1 ONT_TYPE string 0 1 ONT_MODE string 0 1 ONT_SERIAL_NUMBER string 0 1 SPARE_UNI_PORTS string 0 1 SPARE_ATA_PORTS string 0 1 EG 2 The ONT ID Is already returned. All other values are new The Query. Site. Information. Response will be updated to include the product offer name even when the installed service is not owned by the RSP. The Product Offer will also include the segment where the service is not owned by the RSP. The main use case for returning the generic Product Offer name is to ensure the B 2 B matches information already provided in the Portal and allow B 2 B users to identify when a Chorus led migration order is in-flight. In the screenshot below the Product Offer name returned via the B 2 B would be ‘Chorus Connect’ EG 4
Appendix (B 2 B XML Examples) B 2 B Web Service EG 1 Amend. Order. Notification: Completed_BILLING EG 2 query. Site. Information. Response (PRODUCT_OFFER) EG 3 query. Place. Request EG 4 query. Site. Information EG 5 query. Order. Response Example XML
- Slides: 10