From 2a8637263cf8ae2059200d7431b45df8983e0c34 Mon Sep 17 00:00:00 2001 From: FluxTailor <48300298+FluxTailor@users.noreply.github.com> Date: Thu, 31 Mar 2022 22:46:03 -0400 Subject: [PATCH 1/4] Proposed retailcustomer.xsd Statement update The first draft of an update of the retailcustomer.xsd schema to include a new "Statement" element. The proposed initial update has a limited scope and includes only issue date and attachment reference. The update is intended to enable customer authorized access to utility bill images via Green Button Connect APIs. --- etc/retailcustomer.xsd | 66 +++++++++++++++++++++++++++++++++++++++--- 1 file changed, 62 insertions(+), 4 deletions(-) diff --git a/etc/retailcustomer.xsd b/etc/retailcustomer.xsd index be1ff2e0..2eef9eea 100644 --- a/etc/retailcustomer.xsd +++ b/etc/retailcustomer.xsd @@ -1,8 +1,8 @@ - - + The retail customer schema provides details about a UsagePoint that are considered Personally identifiable information (PII) and @@ -159,7 +159,8 @@ Resources The last amount that will be billed to the customer prior to shut off of the account. - + Set of customer account notifications. @@ -200,12 +201,14 @@ Resources Final date and time the service will be billed to the previous customer. - + Demand Response program characteristics covered by Customer Agreement - + All pricing structures applicable to this customer agreement. @@ -215,7 +218,8 @@ Resources Currency for all monetary amounts for this agreement. - + [extension] Known future changes to CustomerAgreement's Status of Service. @@ -274,7 +278,8 @@ Some devices may use an optical port that conforms to the ANSI C12.18 standard f Meter form designation per ANSI C12.10 or other applicable standard. An alphanumeric designation denoting the circuit arrangement for which the meter is applicable and its specific terminal arrangement. - + All multipliers applied at this meter. @@ -295,7 +300,8 @@ Some devices may use an optical port that conforms to the ANSI C12.18 standard f - + [extension] Program date description @@ -326,7 +332,8 @@ Some devices may use an optical port that conforms to the ANSI C12.18 standard f True if inspection is needed of facilities at this service location. This could be requested by a customer, due to suspected tampering, environmental concerns (e.g., a fire in the vicinity), or to correct incompatible data. - + All usage points delivering service (of the same type) to this service location. @@ -366,6 +373,28 @@ Some devices may use an optical port that conforms to the ANSI C12.18 standard f + + + [extension Copyright GBA] Billing statement for provided services. + + + + + + + [extension Copyright GBA] Date and time at which a billing statement was issued. + + + + + [extension Copyright GBA] Contains document reference metadata needed to access a document representation of a billing statement. + + + + + + [extension] Contains attributes related to the configuration of the time service. @@ -694,37 +723,6 @@ Additional Complex Types - - - Object attachment reference information - - - - - - - Name of attachment document or file including filename extension if present. - - - - - attachment media type as published by IANA (see https://www.iana.org/assignments/media-types/media-types.xhtml) e.g PDF, excel - - - - - URL used to access attachment. Use CDATA or URL encoding to escape characters not allowed in XML. - - - - - - - - - - - Includes elements that make it possible to include multiple transactions in a single (batch) request. @@ -1258,19 +1256,26 @@ Example values for 'docStatus.status' are draft, approved, cancelled, etc. - + + + [extension Copyright GBA] A sequence of references to a document associated with a Statement. + - + - + - Date and time at which a billing statement was issued + [extension Copyright GBA] Name of document or file including filename extension if present. - + + + [extension Copyright GBA] Document media type as published by IANA, see https://www.iana.org/assignments/media-types for more information. + + + - One or more attachments related to a statement + [extension Copyright GBA] URL used to access a representation of a statement, for example a bill image. Use CDATA or URL encoding to escape characters not allowed in XML. @@ -1857,6 +1862,88 @@ Month: 3 + + + [extension Copright GBA] Media type for document as registered by IANA. + + + + + + + json + + + + + pdf + + + + + vnd.ms-excel + + + + + vnd.oasis.opendocument.spreadsheet + + + + + vnd.oasis.opendocument.text + + + + + vnd.openxmlformats-officedocument.spreadsheetml.sheet + + + + + gif + + + + + jpeg + + + + + png + + + + + csv + + + + + html + + + + + plain + + + + + rtf + + + + + XML + + + + + + Kind of meter multiplier. @@ -3057,7 +3144,6 @@ Global Elements - @@ -3086,6 +3172,7 @@ Global Elements + From 158f3efc3080f1e4ecb06e6b01815b44d92b2fe9 Mon Sep 17 00:00:00 2001 From: Klaar De Schepper Date: Tue, 19 Jul 2022 09:51:13 -0400 Subject: [PATCH 4/4] Updated types for fileName and statementURL, added .zip as MediaType --- etc/retailcustomer.xsd | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/etc/retailcustomer.xsd b/etc/retailcustomer.xsd index d915ddb2..1a87f5d2 100644 --- a/etc/retailcustomer.xsd +++ b/etc/retailcustomer.xsd @@ -1263,7 +1263,7 @@ Example values for 'docStatus.status' are draft, approved, cancelled, etc. - + [extension Copyright GBA] Name of document or file including filename extension if present. @@ -1273,7 +1273,7 @@ Example values for 'docStatus.status' are draft, approved, cancelled, etc.[extension Copyright GBA] Document media type as published by IANA, see https://www.iana.org/assignments/media-types for more information. - + [extension Copyright GBA] URL used to access a representation of a statement, for example a bill image. Use CDATA or URL encoding to escape characters not allowed in XML. @@ -1864,7 +1864,7 @@ Month: 3 - [extension Copright GBA] Media type for document as registered by IANA. + [extension Copright GBA] Media type for document as registered by IANA, allowed subset in enumeration. @@ -1900,6 +1900,11 @@ Month: 3 vnd.openxmlformats-officedocument.spreadsheetml.sheet + + + zip + + gif