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

v1.15.0 More ambiguity into x-fapi-auth-date not less #489

Closed
perlboy opened this issue Mar 14, 2022 · 2 comments
Closed

v1.15.0 More ambiguity into x-fapi-auth-date not less #489

perlboy opened this issue Mar 14, 2022 · 2 comments
Labels
Security Change or question related to the information security profile

Comments

@perlboy
Copy link

perlboy commented Mar 14, 2022

Description

#430 and the Maintenance Iteration decision ConsumerDataStandardsAustralia/standards#212 "clarified" x-fapi-auth-date with:

The decision is to adopt this change based on community feedback and consultation. The change fixes endpoint documentation to align with the mandatory requirements for the x-fapi-auth-date header already defined in the High Level Standards HTTP Headers section of the data standards.

However all authenticated Banking API endpoints were then updated with:

The time when the customer last logged in to the Data Recipient Software Product. Required for all resource calls (customer present and unattended) if the customer has logged in. Not to be included for unauthenticated calls.

Which isn't what the Decision Proposal outlined and is now ambiguous because it seems to indicate a logged in customer can make unattended calls.

Area Affected

All Banking APIs received this change.

Change Proposed

  1. Do what the Decision Proposal actually proposed.
  2. Fix the change control process so that even trivial changes aren't incorrectly applied
@CDR-API-Stream
Copy link
Collaborator

This issue was discussed in the Maintenance Iteration 11 call. It was agreed to incorporate this change request into this maintenance iteration.

markverstege added a commit to ConsumerDataStandardsAustralia/standards-staging that referenced this issue May 25, 2022
@CDR-API-Stream
Copy link
Collaborator

CDR-API-Stream added a commit to ConsumerDataStandardsAustralia/standards that referenced this issue Aug 11, 2022
* 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

* Created baseline release 1.18.0

* Updated change log

* Fixes link to profile scope data language. Addresses ConsumerDataStandardsAustralia/standards-maintenance#511 (comment)

* Fixes formatting of bullet point list in Authorisation Code Flow section. Addresses ConsumerDataStandardsAustralia/standards-maintenance#511 (comment)

* Standards Maintenance Issue 487: Fix URLs for DCR API non-normative examples. Addresses ConsumerDataStandardsAustralia/standards-maintenance#487

* Standards Maintenance Issue 494: Fixed documentation in Response Payload Structure. Addresses ConsumerDataStandardsAustralia/standards-maintenance#494

* Added link to the issue # in the changelog

* Updated changelog and added diff records

* Standards Maintenance Issue 489: Corrected references to x-fapi-auth-date in resource APIs. Addresses ConsumerDataStandardsAustralia/standards-maintenance#489

* Standards Maintenance Issue 497: Corrected references to addr-spec. Addresses ConsumerDataStandardsAustralia/standards-maintenance#497

* Standards Maintenance Issue 511: Corrected bullet point list formatting for Mandatory Fields in the Payload Conventions

* Standards Maintenance Issue 511: Updates for the Energy schema types, description and formatting. Addresses comment ConsumerDataStandardsAustralia/standards-maintenance#511 (comment)

* Updated release notes for issue 511

* Removed constraint that data holder brands could only map to a single industry

* Standards Maintenance Issue 521: Updated transition arrangements for implementation of the CDR Arrangement JWT method for the Data Recipience Arrangement Revocation endpoint

* Standards Maintenance Issue 493: Fixed error code documentation for the Banking Get Transaction Detail API

* Added clarification on algorithm coverage required for data holders and data recipients

* Added diffs and change log entries

* Added clarifying statement for Data Recipient validation

* Registration validation future obligation date changed from 15th November 2022 to 31st August 2022

* Added future improvement Register API error codes need to be aligned with the CDS standardised error codes

* Get Software Statement Assertion API v1 & v2 has the scope claim explicitly defined and added version schedule for obsolete v1 of the GetSSA API

* Corrected presentation of schema elements in the navigation bar for GetSSA V2

* Added obligation date to data holder requirements regarding unsupported authorisation scopes

* Added default x-v version as 1 for all APIs where x-v is optional

* Added changes to introduction documentation to correct CDR agency hyperlinks and informative references

* Moved normative and informative reference Markdown into the 'introduction' section

* Standards Maintenance Issue #472: Made EnergyPlanControlledLoad into an array and updated structure to allow representation of time of use based rates

* Standards Maintenance Issue #150: Made changes to EnergyUsageRead structure of both primary and secondary data holder to optimise sharing of large volume of interval read data. The change also includes adding a new interval-reads query parameter to usage APIs.

* Standards Maintenance Issue 499: Corrected incorrect reference of  object as a required component of a sibling object in the energy specification

* Standards Maintenance Issue 461: Corrected the conditional statement for the EnergyPlanContract.variation parameter

* Fixed HTML rendering for the bullet point list within the Array Conventions section

* Standards Maintenance Issue #495: Added notes to clarify intent of Get Agreed Payment Schedule API. Made EnergyPaymentScheduleResponse into an array. Added digitalWallet structure to EnergyPaymentSchedule. Updated description of isTokenised by removing conditional statements for bsb and accountNumber fields

* Standards Maintenance Issue #502: Converted EnergyPlanSolarFeedInTariff.timeVaryingTariffs.timeVariations.days and EnergyPlanTariffPeriod.demandCharges.days into ENUM. Updated ENUM values for EnergyPlanTariffPeriod.timeOfUseRates.timeOfUse.days

* Standards Maintenance Issue #505: Converted timeOfUseRates.timeOfUse.startTime, timeOfUseRates.timeOfUse.endTime, demandCharges.startTime and demandCharges.endTime to TimeString type

* Standards Maintenance Issue #511: Updated description of EnergyUsageListResponse in Energy Data Holder and Secondary Data Holders endpoints with sort order

* Standards Staging Issue #192: Corrected property value name in EnergyServicePointListResponse

* Standards Staging Issue #200: Update the description of EnergyInvoice in EnergyInvoiceListResponse to clarify the sorting is done by issueDate

* Standards Maintenance Issue #485: Customer data language moved from sector specific to common area. Title of profile scope language amended

* Rebuild

* CR 515
Update change log entry got 1.18.0
Fix release notes formatting

* Rebuild

* Update for should vs must language arising from CR 511

* Standards Maintenance Issue #512: Added distributors string array to EnergyPlan.geography object

* Add test documentation link to the TOC
Rebuild

* Bump libraries

* Update swagger versions
Create archive
Rebuild

* Rebuild

* Standards Release 1.18.0# Applied DER changes identified in CR511 to secondary data holder APIs

* Rebuild

* Rebuild

Co-authored-by: James Bligh <[email protected]>
Co-authored-by: Mark Verstege <[email protected]>
Co-authored-by: James Bligh <[email protected]>
Co-authored-by: Hemang Rathod <[email protected]>
Co-authored-by: Ivan Hosgood <[email protected]>
Co-authored-by: Ivan Hosgood <[email protected]>
CDR-API-Stream added a commit to ConsumerDataStandardsAustralia/standards that referenced this issue Sep 12, 2022
* 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

* Created baseline release 1.18.0

* Updated change log

* Fixes link to profile scope data language. Addresses ConsumerDataStandardsAustralia/standards-maintenance#511 (comment)

* Fixes formatting of bullet point list in Authorisation Code Flow section. Addresses ConsumerDataStandardsAustralia/standards-maintenance#511 (comment)

* Standards Maintenance Issue 487: Fix URLs for DCR API non-normative examples. Addresses ConsumerDataStandardsAustralia/standards-maintenance#487

* Standards Maintenance Issue 494: Fixed documentation in Response Payload Structure. Addresses ConsumerDataStandardsAustralia/standards-maintenance#494

* Added link to the issue # in the changelog

* Updated changelog and added diff records

* Standards Maintenance Issue 489: Corrected references to x-fapi-auth-date in resource APIs. Addresses ConsumerDataStandardsAustralia/standards-maintenance#489

* Standards Maintenance Issue 497: Corrected references to addr-spec. Addresses ConsumerDataStandardsAustralia/standards-maintenance#497

* Standards Maintenance Issue 511: Corrected bullet point list formatting for Mandatory Fields in the Payload Conventions

* Standards Maintenance Issue 511: Updates for the Energy schema types, description and formatting. Addresses comment ConsumerDataStandardsAustralia/standards-maintenance#511 (comment)

* Updated release notes for issue 511

* Removed constraint that data holder brands could only map to a single industry

* Standards Maintenance Issue 521: Updated transition arrangements for implementation of the CDR Arrangement JWT method for the Data Recipience Arrangement Revocation endpoint

* Standards Maintenance Issue 493: Fixed error code documentation for the Banking Get Transaction Detail API

* Added clarification on algorithm coverage required for data holders and data recipients

* Added diffs and change log entries

* Added clarifying statement for Data Recipient validation

* Registration validation future obligation date changed from 15th November 2022 to 31st August 2022

* Added future improvement Register API error codes need to be aligned with the CDS standardised error codes

* Get Software Statement Assertion API v1 & v2 has the scope claim explicitly defined and added version schedule for obsolete v1 of the GetSSA API

* Corrected presentation of schema elements in the navigation bar for GetSSA V2

* Added obligation date to data holder requirements regarding unsupported authorisation scopes

* Added default x-v version as 1 for all APIs where x-v is optional

* Added changes to introduction documentation to correct CDR agency hyperlinks and informative references

* Moved normative and informative reference Markdown into the 'introduction' section

* Standards Maintenance Issue #472: Made EnergyPlanControlledLoad into an array and updated structure to allow representation of time of use based rates

* Standards Maintenance Issue #150: Made changes to EnergyUsageRead structure of both primary and secondary data holder to optimise sharing of large volume of interval read data. The change also includes adding a new interval-reads query parameter to usage APIs.

* Standards Maintenance Issue 499: Corrected incorrect reference of  object as a required component of a sibling object in the energy specification

* Standards Maintenance Issue 461: Corrected the conditional statement for the EnergyPlanContract.variation parameter

* Fixed HTML rendering for the bullet point list within the Array Conventions section

* Standards Maintenance Issue #495: Added notes to clarify intent of Get Agreed Payment Schedule API. Made EnergyPaymentScheduleResponse into an array. Added digitalWallet structure to EnergyPaymentSchedule. Updated description of isTokenised by removing conditional statements for bsb and accountNumber fields

* Standards Maintenance Issue #502: Converted EnergyPlanSolarFeedInTariff.timeVaryingTariffs.timeVariations.days and EnergyPlanTariffPeriod.demandCharges.days into ENUM. Updated ENUM values for EnergyPlanTariffPeriod.timeOfUseRates.timeOfUse.days

* Standards Maintenance Issue #505: Converted timeOfUseRates.timeOfUse.startTime, timeOfUseRates.timeOfUse.endTime, demandCharges.startTime and demandCharges.endTime to TimeString type

* Standards Maintenance Issue #511: Updated description of EnergyUsageListResponse in Energy Data Holder and Secondary Data Holders endpoints with sort order

* Standards Staging Issue #192: Corrected property value name in EnergyServicePointListResponse

* Standards Staging Issue #200: Update the description of EnergyInvoice in EnergyInvoiceListResponse to clarify the sorting is done by issueDate

* Standards Maintenance Issue #485: Customer data language moved from sector specific to common area. Title of profile scope language amended

* Rebuild

* CR 515
Update change log entry got 1.18.0
Fix release notes formatting

* Rebuild

* Update for should vs must language arising from CR 511

* Standards Maintenance Issue #512: Added distributors string array to EnergyPlan.geography object

* Add test documentation link to the TOC
Rebuild

* Bump libraries

* Update swagger versions
Create archive
Rebuild

* Rebuild

* Standards Release 1.18.0# Applied DER changes identified in CR511 to secondary data holder APIs

* Rebuild

* Rebuild

* Baseline for v1.19.0

* Removed legacy v1.18.0 diff notes

* Standards Maintenance Issue 429: Updated Energy data language standards

* Updated the version number in the release notes heading

* Simplified delta comments and corrected the referenced change request in the release notes

* Removed FDO because it is the commencement of Energy go-live

* Decision Proposal 260: Updated get energy accounts and get energy account details with changes from DP260

* Added obsolete v1 versions for Get Energy Accounts and Get Energy Account Detail. Updated Energy OAS object versions accordingly

* Decision Proposal #260: Updated changelog, releasenotes, fdo, energy api version schedule. Renamed get-energy-account-v1.html.md to get-energy-accounts-v1.html.md

* Added release notes for OAIC link fix

* Added archive for v1.18.0

* fixed typos in changelog and get energy account v1

* Moved the diff statements closer to the changes within the energy data language standards

* Updated release notes

* Rebuild

* Update publish dates
Minor changes to release notes

* Update swagger version numbers

Co-authored-by: Mark Verstege <[email protected]>
Co-authored-by: Ivan Hosgood <[email protected]>
Co-authored-by: James Bligh <[email protected]>
Co-authored-by: Hemang Rathod <[email protected]>
Co-authored-by: James Bligh <[email protected]>
Co-authored-by: Ivan Hosgood <[email protected]>
CDR-API-Stream added a commit to ConsumerDataStandardsAustralia/standards that referenced this issue Sep 13, 2022
* 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

* Created baseline release 1.18.0

* Updated change log

* Fixes link to profile scope data language. Addresses ConsumerDataStandardsAustralia/standards-maintenance#511 (comment)

* Fixes formatting of bullet point list in Authorisation Code Flow section. Addresses ConsumerDataStandardsAustralia/standards-maintenance#511 (comment)

* Standards Maintenance Issue 487: Fix URLs for DCR API non-normative examples. Addresses ConsumerDataStandardsAustralia/standards-maintenance#487

* Standards Maintenance Issue 494: Fixed documentation in Response Payload Structure. Addresses ConsumerDataStandardsAustralia/standards-maintenance#494

* Added link to the issue # in the changelog

* Updated changelog and added diff records

* Standards Maintenance Issue 489: Corrected references to x-fapi-auth-date in resource APIs. Addresses ConsumerDataStandardsAustralia/standards-maintenance#489

* Standards Maintenance Issue 497: Corrected references to addr-spec. Addresses ConsumerDataStandardsAustralia/standards-maintenance#497

* Standards Maintenance Issue 511: Corrected bullet point list formatting for Mandatory Fields in the Payload Conventions

* Standards Maintenance Issue 511: Updates for the Energy schema types, description and formatting. Addresses comment ConsumerDataStandardsAustralia/standards-maintenance#511 (comment)

* Updated release notes for issue 511

* Removed constraint that data holder brands could only map to a single industry

* Standards Maintenance Issue 521: Updated transition arrangements for implementation of the CDR Arrangement JWT method for the Data Recipience Arrangement Revocation endpoint

* Standards Maintenance Issue 493: Fixed error code documentation for the Banking Get Transaction Detail API

* Added clarification on algorithm coverage required for data holders and data recipients

* Added diffs and change log entries

* Added clarifying statement for Data Recipient validation

* Registration validation future obligation date changed from 15th November 2022 to 31st August 2022

* Added future improvement Register API error codes need to be aligned with the CDS standardised error codes

* Get Software Statement Assertion API v1 & v2 has the scope claim explicitly defined and added version schedule for obsolete v1 of the GetSSA API

* Corrected presentation of schema elements in the navigation bar for GetSSA V2

* Added obligation date to data holder requirements regarding unsupported authorisation scopes

* Added default x-v version as 1 for all APIs where x-v is optional

* Added changes to introduction documentation to correct CDR agency hyperlinks and informative references

* Moved normative and informative reference Markdown into the 'introduction' section

* Standards Maintenance Issue #472: Made EnergyPlanControlledLoad into an array and updated structure to allow representation of time of use based rates

* Standards Maintenance Issue #150: Made changes to EnergyUsageRead structure of both primary and secondary data holder to optimise sharing of large volume of interval read data. The change also includes adding a new interval-reads query parameter to usage APIs.

* Standards Maintenance Issue 499: Corrected incorrect reference of  object as a required component of a sibling object in the energy specification

* Standards Maintenance Issue 461: Corrected the conditional statement for the EnergyPlanContract.variation parameter

* Fixed HTML rendering for the bullet point list within the Array Conventions section

* Standards Maintenance Issue #495: Added notes to clarify intent of Get Agreed Payment Schedule API. Made EnergyPaymentScheduleResponse into an array. Added digitalWallet structure to EnergyPaymentSchedule. Updated description of isTokenised by removing conditional statements for bsb and accountNumber fields

* Standards Maintenance Issue #502: Converted EnergyPlanSolarFeedInTariff.timeVaryingTariffs.timeVariations.days and EnergyPlanTariffPeriod.demandCharges.days into ENUM. Updated ENUM values for EnergyPlanTariffPeriod.timeOfUseRates.timeOfUse.days

* Standards Maintenance Issue #505: Converted timeOfUseRates.timeOfUse.startTime, timeOfUseRates.timeOfUse.endTime, demandCharges.startTime and demandCharges.endTime to TimeString type

* Standards Maintenance Issue #511: Updated description of EnergyUsageListResponse in Energy Data Holder and Secondary Data Holders endpoints with sort order

* Standards Staging Issue #192: Corrected property value name in EnergyServicePointListResponse

* Standards Staging Issue #200: Update the description of EnergyInvoice in EnergyInvoiceListResponse to clarify the sorting is done by issueDate

* Standards Maintenance Issue #485: Customer data language moved from sector specific to common area. Title of profile scope language amended

* Rebuild

* CR 515
Update change log entry got 1.18.0
Fix release notes formatting

* Rebuild

* Update for should vs must language arising from CR 511

* Standards Maintenance Issue #512: Added distributors string array to EnergyPlan.geography object

* Add test documentation link to the TOC
Rebuild

* Bump libraries

* Update swagger versions
Create archive
Rebuild

* Rebuild

* Standards Release 1.18.0# Applied DER changes identified in CR511 to secondary data holder APIs

* Rebuild

* Rebuild

* Baseline for v1.19.0

* Removed legacy v1.18.0 diff notes

* Standards Maintenance Issue 429: Updated Energy data language standards

* Updated the version number in the release notes heading

* Simplified delta comments and corrected the referenced change request in the release notes

* Removed FDO because it is the commencement of Energy go-live

* Decision Proposal 260: Updated get energy accounts and get energy account details with changes from DP260

* Added obsolete v1 versions for Get Energy Accounts and Get Energy Account Detail. Updated Energy OAS object versions accordingly

* Decision Proposal #260: Updated changelog, releasenotes, fdo, energy api version schedule. Renamed get-energy-account-v1.html.md to get-energy-accounts-v1.html.md

* Added release notes for OAIC link fix

* Added archive for v1.18.0

* fixed typos in changelog and get energy account v1

* Moved the diff statements closer to the changes within the energy data language standards

* Updated release notes

* Rebuild

* Update publish dates
Minor changes to release notes

* Update swagger version numbers

* Defect fix: removed open-status query param from Get Energy Account Detail API

* Fixes

Co-authored-by: Mark Verstege <[email protected]>
Co-authored-by: Ivan Hosgood <[email protected]>
Co-authored-by: James Bligh <[email protected]>
Co-authored-by: Hemang Rathod <[email protected]>
Co-authored-by: James Bligh <[email protected]>
Co-authored-by: Ivan Hosgood <[email protected]>
CDR-API-Stream pushed a commit to ConsumerDataStandardsAustralia/standards that referenced this issue Nov 3, 2022
* 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

* Created baseline release 1.18.0

* Updated change log

* Fixes link to profile scope data language. Addresses ConsumerDataStandardsAustralia/standards-maintenance#511 (comment)

* Fixes formatting of bullet point list in Authorisation Code Flow section. Addresses ConsumerDataStandardsAustralia/standards-maintenance#511 (comment)

* Standards Maintenance Issue 487: Fix URLs for DCR API non-normative examples. Addresses ConsumerDataStandardsAustralia/standards-maintenance#487

* Standards Maintenance Issue 494: Fixed documentation in Response Payload Structure. Addresses ConsumerDataStandardsAustralia/standards-maintenance#494

* Added link to the issue # in the changelog

* Updated changelog and added diff records

* Standards Maintenance Issue 489: Corrected references to x-fapi-auth-date in resource APIs. Addresses ConsumerDataStandardsAustralia/standards-maintenance#489

* Standards Maintenance Issue 497: Corrected references to addr-spec. Addresses ConsumerDataStandardsAustralia/standards-maintenance#497

* Standards Maintenance Issue 511: Corrected bullet point list formatting for Mandatory Fields in the Payload Conventions

* Updated non-normative examples

* Standards Maintenance Issue 511: Updates for the Energy schema types, description and formatting. Addresses comment ConsumerDataStandardsAustralia/standards-maintenance#511 (comment)

* Updated release notes for issue 511

* Removed constraint that data holder brands could only map to a single industry

* Standards Maintenance Issue 521: Updated transition arrangements for implementation of the CDR Arrangement JWT method for the Data Recipience Arrangement Revocation endpoint

* Standards Maintenance Issue 493: Fixed error code documentation for the Banking Get Transaction Detail API

* Added clarification on algorithm coverage required for data holders and data recipients

* Added diffs and change log entries

* Added clarifying statement for Data Recipient validation

* Registration validation future obligation date changed from 15th November 2022 to 31st August 2022

* Added future improvement Register API error codes need to be aligned with the CDS standardised error codes

* Get Software Statement Assertion API v1 & v2 has the scope claim explicitly defined and added version schedule for obsolete v1 of the GetSSA API

* Corrected presentation of schema elements in the navigation bar for GetSSA V2

* Added obligation date to data holder requirements regarding unsupported authorisation scopes

* Added default x-v version as 1 for all APIs where x-v is optional

* Added changes to introduction documentation to correct CDR agency hyperlinks and informative references

* Moved normative and informative reference Markdown into the 'introduction' section

* Standards Maintenance Issue #472: Made EnergyPlanControlledLoad into an array and updated structure to allow representation of time of use based rates

* Standards Maintenance Issue #150: Made changes to EnergyUsageRead structure of both primary and secondary data holder to optimise sharing of large volume of interval read data. The change also includes adding a new interval-reads query parameter to usage APIs.

* Standards Maintenance Issue 499: Corrected incorrect reference of  object as a required component of a sibling object in the energy specification

* Standards Maintenance Issue 461: Corrected the conditional statement for the EnergyPlanContract.variation parameter

* Fixed HTML rendering for the bullet point list within the Array Conventions section

* Standards Maintenance Issue #495: Added notes to clarify intent of Get Agreed Payment Schedule API. Made EnergyPaymentScheduleResponse into an array. Added digitalWallet structure to EnergyPaymentSchedule. Updated description of isTokenised by removing conditional statements for bsb and accountNumber fields

* Standards Maintenance Issue #502: Converted EnergyPlanSolarFeedInTariff.timeVaryingTariffs.timeVariations.days and EnergyPlanTariffPeriod.demandCharges.days into ENUM. Updated ENUM values for EnergyPlanTariffPeriod.timeOfUseRates.timeOfUse.days

* Standards Maintenance Issue #505: Converted timeOfUseRates.timeOfUse.startTime, timeOfUseRates.timeOfUse.endTime, demandCharges.startTime and demandCharges.endTime to TimeString type

* Standards Maintenance Issue #511: Updated description of EnergyUsageListResponse in Energy Data Holder and Secondary Data Holders endpoints with sort order

* Standards Staging Issue #192: Corrected property value name in EnergyServicePointListResponse

* Standards Staging Issue #200: Update the description of EnergyInvoice in EnergyInvoiceListResponse to clarify the sorting is done by issueDate

* Standards Maintenance Issue #485: Customer data language moved from sector specific to common area. Title of profile scope language amended

* Rebuild

* CR 515
Update change log entry got 1.18.0
Fix release notes formatting

* Rebuild

* Update for should vs must language arising from CR 511

* Standards Maintenance Issue #512: Added distributors string array to EnergyPlan.geography object

* Add test documentation link to the TOC
Rebuild

* Bump libraries

* Update swagger versions
Create archive
Rebuild

* Rebuild

* Standards Release 1.18.0# Applied DER changes identified in CR511 to secondary data holder APIs

* Rebuild

* Rebuild

* Baseline for v1.19.0

* Standards Maintenance Issue 447: Corrected typo for CORS

* Standards Maintenance Issue 411: Clarification that the x-fapi-interaction-id is not used for unathenticated APIs.

* Standards Maintenance Issue 414: Corrected conditional requirements for NPP extendedData>extendedDescription

* Removed legacy v1.18.0 diff notes

* Added diff notes

* Added diff notes

* Corrected diff notes

* Corrected diff notes

* Standards Maintenance Issue 429: Updated Energy data language standards

* Updated the version number in the release notes heading

* Simplified delta comments and corrected the referenced change request in the release notes

* Removed FDO because it is the commencement of Energy go-live

* Decision Proposal 260: Updated get energy accounts and get energy account details with changes from DP260

* Added obsolete v1 versions for Get Energy Accounts and Get Energy Account Detail. Updated Energy OAS object versions accordingly

* Decision Proposal #260: Updated changelog, releasenotes, fdo, energy api version schedule. Renamed get-energy-account-v1.html.md to get-energy-accounts-v1.html.md

* Added release notes for OAIC link fix

* Added archive for v1.18.0

* fixed typos in changelog and get energy account v1

* Moved the diff statements closer to the changes within the energy data language standards

* Baseline for v1.20.0

* Standards Maintenance Issue 525: Corrected the softwareProductDescription to be a mandatory response paramater returned by the CDR Register

* Updated release notes

* Rebuild

* Update publish dates
Minor changes to release notes

* Update swagger version numbers

* Defect fix: removed open-status query param from Get Energy Account Detail API

* Fixes

* Removed v1.19.0 diff statements and updated archives and changelog

* Standards Maintenance Issue #524: Updated description of fields in EnergyDerRecord.acConnections noting 0 as default when value not known

* Standards Maintenance Issue #526: Changed type of EnergyDerRecord.availablePhasesCount and EnergyDerRecord.installedPhasesCount to NaturalNumber. Updated description of approvedCapacity, availablePhasesCount and installedPhasesCount fields in EnergyDerRecord to note 0 indicates no DER record exsits

* Standards Maintenance Issue #506: Added isSecondaryDataHolderError flag to Error Response Structure and noted its FDO

* Standards Maintenance Issue #506: Updated FDO date to 15th May 2023

* Updated changes to target release v1.20.0

* Updated all Swagger files to release version 1.20.0

* Updated non-normative security examples

* Add energy swagger

* Build

* Updated non-normative security examples

* Update Telco standards and build

* Do checklist items

* Corrected release notes

* Minor fixes

* Build

* Fixes to markdown generation
Rebuild

* Complete holistic changes

Co-authored-by: Hemang Rathod <[email protected]>
Co-authored-by: Ivan Hosgood <[email protected]>
Co-authored-by: Ivan Hosgood <[email protected]>
Co-authored-by: Mark Verstege <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Security Change or question related to the information security profile
Projects
Archived in project
Development

No branches or pull requests

3 participants