From 6453881707680cda436a9d35aa588add64d4989e Mon Sep 17 00:00:00 2001 From: "henrik.larsen@dcsa.org" Date: Tue, 3 Feb 2026 10:30:56 +0100 Subject: [PATCH 1/4] CS 1.0: SD-2834: Add `addressLines` --- cs/v1/CS_v1.0.2.yaml | 37 +++++++++++++++++++++++++++++++++++-- 1 file changed, 35 insertions(+), 2 deletions(-) diff --git a/cs/v1/CS_v1.0.2.yaml b/cs/v1/CS_v1.0.2.yaml index b7e50523..3c38779a 100644 --- a/cs/v1/CS_v1.0.2.yaml +++ b/cs/v1/CS_v1.0.2.yaml @@ -1699,11 +1699,14 @@ components: type: object description: | The location can be specified using **any** of the nested structures: - - `Address` (used to specify the location via an Address) + - `address` (used to specify the location via a **structured** Address) + - `addressLines` (used to specify a location via an **unstructured** Address) - `UNLocationCode` - `Facility` (used to specify a location using a `facilityCode` and a `facilityCodeListProvider`) It is expected that if a location is specified in multiple ways (both as an `Address` and as a `Facility`) that both ways point to the same location. + + **Condition:** Providers **or** consumers on API v1.0.1 (or earlier): `addressLines` cannot be used as the only property to identify the location. properties: locationName: type: string @@ -1718,6 +1721,19 @@ components: example: Building 123 address: $ref: '#/components/schemas/Address' + addressLines: + type: array + maxItems: 5 + description: | + Unstructured address lines, used as a fallback when structured address fields are unavailable. + + **Condition:** Providers **or** consumers on API v1.0.1 (or earlier): `addressLines` cannot be used as the only property to identify the party. + items: + type: string + maxLength: 250 + description: | + One line of an unstructured `Address`. + example: "123 Example Rd" UNLocationCode: type: string pattern: ^[A-Z]{2}[A-Z2-9]{3}$ @@ -1738,10 +1754,14 @@ components: type: object description: | General purpose object to capture location-related data, the location can be specified in **any** of the following ways: - - `Address` (used to specify the location via an Address) + - `address` (used to specify the location via a **structured** Address) + - `addressLines` (used to specify a location via an **unstructured** Address) - `UNLocationCode` - `FacilitySMDGCode` (used to specify a location using a `facilitySMDGCode`) + It is expected that if a location is specified in multiple ways (both as an `Address` and as a `Facility`) that both ways point to the same location. + + **Condition:** Providers **or** consumers on API v1.0.1 (or earlier): `addressLines` cannot be used as the only property to identify the location. properties: locationName: type: string @@ -1756,6 +1776,19 @@ components: example: Building 123 address: $ref: '#/components/schemas/Address' + addressLines: + type: array + maxItems: 5 + description: | + Unstructured address lines, used as a fallback when structured address fields are unavailable. + + **Condition:** Providers **or** consumers on API v1.0.1 (or earlier): `addressLines` cannot be used as the only property to identify the party. + items: + type: string + maxLength: 250 + description: | + One line of an unstructured `Address`. + example: "123 Example Rd" UNLocationCode: type: string pattern: ^[A-Z]{2}[A-Z2-9]{3}$ From 812d0b82d657b2817b3328cc3176b93792cf5690 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Henrik=20Helm=C3=B8=20Larsen?= Date: Tue, 3 Feb 2026 10:37:44 +0100 Subject: [PATCH 2/4] Fix typo Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- cs/v1/CS_v1.0.2.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/cs/v1/CS_v1.0.2.yaml b/cs/v1/CS_v1.0.2.yaml index 3c38779a..d9f77c80 100644 --- a/cs/v1/CS_v1.0.2.yaml +++ b/cs/v1/CS_v1.0.2.yaml @@ -1727,7 +1727,7 @@ components: description: | Unstructured address lines, used as a fallback when structured address fields are unavailable. - **Condition:** Providers **or** consumers on API v1.0.1 (or earlier): `addressLines` cannot be used as the only property to identify the party. + **Condition:** Providers **or** consumers on API v1.0.1 (or earlier): `addressLines` cannot be used as the only property to identify the location. items: type: string maxLength: 250 From 4c00928241b40cbc8a80ba56e01d44cd7c41c4c6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Henrik=20Helm=C3=B8=20Larsen?= Date: Tue, 3 Feb 2026 10:37:55 +0100 Subject: [PATCH 3/4] Fix typo Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- cs/v1/CS_v1.0.2.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/cs/v1/CS_v1.0.2.yaml b/cs/v1/CS_v1.0.2.yaml index d9f77c80..f7fdf237 100644 --- a/cs/v1/CS_v1.0.2.yaml +++ b/cs/v1/CS_v1.0.2.yaml @@ -1782,7 +1782,7 @@ components: description: | Unstructured address lines, used as a fallback when structured address fields are unavailable. - **Condition:** Providers **or** consumers on API v1.0.1 (or earlier): `addressLines` cannot be used as the only property to identify the party. + **Condition:** Providers **or** consumers on API v1.0.1 (or earlier): `addressLines` cannot be used as the only property to identify the location. items: type: string maxLength: 250 From e3357d729c1a32314e551bfd99c8f93a2a120a01 Mon Sep 17 00:00:00 2001 From: "henrik.larsen@dcsa.org" Date: Tue, 3 Feb 2026 10:42:22 +0100 Subject: [PATCH 4/4] Fix rediundant "Mg" --- cs/v1/CS_v1.0.2.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/cs/v1/CS_v1.0.2.yaml b/cs/v1/CS_v1.0.2.yaml index f7fdf237..bc9c4ec6 100644 --- a/cs/v1/CS_v1.0.2.yaml +++ b/cs/v1/CS_v1.0.2.yaml @@ -1669,7 +1669,7 @@ components: type: number format: double description: | - CO2 (Carbon Dioxide) emissions in metric tonnes (t / Mg). + CO2 (Carbon Dioxide) emissions in metric tonnes (t). example: 506.4 sox: type: number