From adf1eaf0ee3d574eb27f49dd632460af35e10ce4 Mon Sep 17 00:00:00 2001
From: mk <martin.kanal@doubleslash.de>
Date: Wed, 31 Jan 2024 20:13:12 +0100
Subject: [PATCH 01/24] chore(logo):replace logo

---
 README.md |   3 ++-
 logo.png  | Bin 32040 -> 71293 bytes
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 53664b07d4..20b81a4d64 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,5 @@
-# ![Item Relationship Service (IRS)](https://raw.githubusercontent.com/eclipse-tractusx/item-relationship-service/main/logo.png)
+# ![Item Relationship Service (IRS)](https://github.com/catenax-ng/tx-item-relationship-service/blob/main/docs/logo/IRS_Logo.png)
+
 
 [![Apache 2 License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://github.com/eclipse-tractusx/item-relationship-service/blob/main/LICENSE)  
 [![Build](https://github.com/eclipse-tractusx/item-relationship-service/actions/workflows/irs-build.yml/badge.svg)](https://github.com/eclipse-tractusx/item-relationship-service/actions/workflows/irs-build.yml)
diff --git a/logo.png b/logo.png
index 14e1894060067ff12bfb61107bf78095010a3d58..4fddcbe5592fa07256433ecdc9699af63f08cb2e 100644
GIT binary patch
literal 71293
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%0A^f|BL;XB%bZh(
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
Bix&U@

literal 32040
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


From d7dd4c55d8005842acc56a4750e63a383cd1e26e Mon Sep 17 00:00:00 2001
From: mk <martin.kanal@doubleslash.de>
Date: Wed, 31 Jan 2024 20:15:50 +0100
Subject: [PATCH 02/24] chore(logo): adjust url to logo

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 20b81a4d64..b2ee8c0ba9 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# ![Item Relationship Service (IRS)](https://github.com/catenax-ng/tx-item-relationship-service/blob/main/docs/logo/IRS_Logo.png)
+# ![Item Relationship Service (IRS)](https://github.com/catenax-ng/tx-item-relationship-service/blob/main/logo.png)
 
 
 [![Apache 2 License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://github.com/eclipse-tractusx/item-relationship-service/blob/main/LICENSE)  

From 38f83c39f2229cb3b08f7d4e9d506b0bfa412b2f Mon Sep 17 00:00:00 2001
From: mk <martin.kanal@doubleslash.de>
Date: Wed, 31 Jan 2024 20:17:46 +0100
Subject: [PATCH 03/24] chore(logo): adjust url to eclipse repos

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index b2ee8c0ba9..e8e7135b0c 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# ![Item Relationship Service (IRS)](https://github.com/catenax-ng/tx-item-relationship-service/blob/main/logo.png)
+# ![Item Relationship Service (IRS)](https://github.com/eclipse-tractusx/item-relationship-service/blob/main/logo.png)
 
 
 [![Apache 2 License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://github.com/eclipse-tractusx/item-relationship-service/blob/main/LICENSE)  

From ad739f2f3d21f2f4daaa1aab6877eb68960b8b6a Mon Sep 17 00:00:00 2001
From: mk <martin.kanal@doubleslash.de>
Date: Wed, 31 Jan 2024 20:18:15 +0100
Subject: [PATCH 04/24] chore(logo): add changelog entry

---
 CHANGELOG.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 458cdcad76..abaec79550 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -13,6 +13,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Updated license header to "Copyright (c) 2021,2024 Contributors to the Eclipse Foundation"
 - Changed lookupGlobalAssetIds to lookupShellsByBPN, which provides full object.
 - Suppressed CVE-2024-20932 from graal-sdk-21.2.0.jar because this is not applicable for IRS.
+- Change logo of irs 
 
 ### Fixed
 - Update to Spring Boot 3.1.8. This fixes the following CVEs:

From 360f7bf3e9e0549af659ef40befaf2e9d3278799 Mon Sep 17 00:00:00 2001
From: mk <martin.kanal@doubleslash.de>
Date: Wed, 21 Feb 2024 14:19:22 +0100
Subject: [PATCH 05/24] fix(concept):[#367] fix typos

---
 .../#367-adapt-to-changes-industry-core.md          | 13 ++++---------
 1 file changed, 4 insertions(+), 9 deletions(-)

diff --git a/docs/concept/#367-adapt-to-changes-of-industry-core/#367-adapt-to-changes-industry-core.md b/docs/concept/#367-adapt-to-changes-of-industry-core/#367-adapt-to-changes-industry-core.md
index 8aa18a942d..5ba1446538 100644
--- a/docs/concept/#367-adapt-to-changes-of-industry-core/#367-adapt-to-changes-industry-core.md
+++ b/docs/concept/#367-adapt-to-changes-of-industry-core/#367-adapt-to-changes-industry-core.md
@@ -72,6 +72,9 @@ The product IRS MUST align with the Industry Code Standard CX-126 and CX-127.
 For serialized parts, batches, and JIS parts this will be deprecated with new version 3.x.x of AAS.
 ASS parameter assetLifecyclePhase will not be used anymore to detect BOMLifecycle. Parameter  'digitalTwinType' is used instead.
 
+**assetLifecyclePhase is not used to detect BomLifecyle any more.**
+
+
 ### Use parameter 'digitalTwinType' to detect  BOMLifecycle
 
 **Parameter 'digitalTwinType'**
@@ -99,17 +102,9 @@ alt aas contains 'digitalTwinType'
     else digitalTwinType any other value or null
        BOMLifecycleDetector -->>  IRS : throw Exception
     end
-else   aas contains 'assetLifecyclePhase'
-   alt assetLifecyclePhase="AsBuilt"
-        BOMLifecycleDetector -->>  IRS : return asBuilt  
-   else assetLifecyclePhase="AsPlanned"
-        BOMLifecycleDetector -->>  IRS : return asPlanned
-   else assetLifecyclePhase any other value or null
-        BOMLifecycleDetector -->>  IRS :   throw Exception
-   end
 else
    IRS -->> BOMLifecycleDetector : throw Exception (BOMLifecylce could not be detected)
-   BOMLifecycleDetector -->> IRS : retrun BOMLifecyle
+   BOMLifecycleDetector -->> IRS : return BOMLifecyle
 end   
 
 ````

From e07fe75339655a4431b8049af95a51f0d548c16b Mon Sep 17 00:00:00 2001
From: mk <martin.kanal@doubleslash.de>
Date: Wed, 21 Feb 2024 14:23:53 +0100
Subject: [PATCH 06/24] fix(concept):[#367] assetLifecyclePhase is not used any
 more in 24.5

---
 .../#367-adapt-to-changes-industry-core.md                   | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/concept/#367-adapt-to-changes-of-industry-core/#367-adapt-to-changes-industry-core.md b/docs/concept/#367-adapt-to-changes-of-industry-core/#367-adapt-to-changes-industry-core.md
index 5ba1446538..c4242f6b5d 100644
--- a/docs/concept/#367-adapt-to-changes-of-industry-core/#367-adapt-to-changes-industry-core.md
+++ b/docs/concept/#367-adapt-to-changes-of-industry-core/#367-adapt-to-changes-industry-core.md
@@ -111,13 +111,14 @@ end
 
 #### Configuration of parameter 'digitalTwinType'
 Parameter is configurable for dDTR instance and has to be configured for integration test.
+Setup dDTR registry on used environments. INT, DEV, PEN, STABLE 
 
 - [Values.yaml](https://github.com/eclipse-tractusx/sldt-digital-twin-registry/blob/f438fe96a7ae1f1b920e8e4fb4114fb7af32643d/charts/registry/values.yaml#L51)
 - [README.md](https://github.com/eclipse-tractusx/sldt-digital-twin-registry/blob/f438fe96a7ae1f1b920e8e4fb4114fb7af32643d/charts/registry/README.md#:~:text=externalSubjectIdWildcardAllowedTypes)
 
 values.yaml
 ````json
-   registry.externalSubjectIdWildcardAllowedTypes = manufacturerPartId,assetLifecyclePhase,digitalTwinType
+   registry.externalSubjectIdWildcardAllowedTypes = manufacturerPartId,digitalTwinType
 ````
 
 
@@ -181,7 +182,7 @@ values.yaml
 |manufacturerId | Mandatory                                | The Business Partner Number (BPNL) of the manufacturer of the part.                                                                                                                                                                                   |
 |manufacturerPartId | Mandatory                                |                                                                                                                                                                                                                                                       |
 |customerPartId | Optional                                 |                                                                                                                                                                                                                                                       |
-|assetLifecyclePhase | asPlanned(Mandatory) / asBuilt(Optional) | @Deprecated For serialized parts, batches, and JIS parts, use the value AsBuilt. For catalog parts in a Digital Twin As-Planned lifecycle phase, use the value AsPlanned.                                                                             |
+|assetLifecyclePhase | asPlanned(Mandatory) / asBuilt(Optional) | @Deprecated Not used any more. For serialized parts, batches, and JIS parts, use the value AsBuilt. For catalog parts in a Digital Twin As-Planned lifecycle phase, use the value AsPlanned.                                                          |
 |digitalTwinType | Mandatory                                | digitalTwinType="PartType" OR digitalTwinType="PartInstance" For parts on an instance level (e.g. serialized parts, batches, and JIS parts), use the value PartInstance. For parts on a part type level (e.g. catalog parts), use the value PartType. |                                                                                                                                                                       | |
 
 # PartAsPlanned

From a31f72c00180cde2b5cd6e2e76fc924eb49fa53f Mon Sep 17 00:00:00 2001
From: mk <martin.kanal@doubleslash.de>
Date: Thu, 22 Feb 2024 10:40:29 +0100
Subject: [PATCH 07/24] chore(concept):[#367] update to industry core for R24.5

---
 .../#367-adapt-to-changes-industry-core.md    | 25 ++++++++-----------
 1 file changed, 11 insertions(+), 14 deletions(-)

diff --git a/docs/concept/#367-adapt-to-changes-of-industry-core/#367-adapt-to-changes-industry-core.md b/docs/concept/#367-adapt-to-changes-of-industry-core/#367-adapt-to-changes-industry-core.md
index c4242f6b5d..c839bcbc1d 100644
--- a/docs/concept/#367-adapt-to-changes-of-industry-core/#367-adapt-to-changes-industry-core.md
+++ b/docs/concept/#367-adapt-to-changes-of-industry-core/#367-adapt-to-changes-industry-core.md
@@ -37,20 +37,17 @@ The product IRS MUST align with the Industry Code Standard CX-126 and CX-127.
 
 ## Version matrix
 
-| Artefact                   | Version | Availability                                        | link                                                                                                                                              |
-|----------------------------|---------|-----------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------|
-| AAS                        |         |                                                     |                                                                                                                                                   |
-| PartAsPlanned              | 1.0.1   | Mandatory                                           | [PartAsPlanned 1.0.1](https://github.com/eclipse-tractusx/sldt-semantic-models/tree/main/io.catenax.part_as_planned/1.0.1)                        |
-| PartAsPlanned              | 2.0.0   | Optional (Mandatory for next version of CX-0126)    | [PartAsPlanned 2.0.0](https://github.com/eclipse-tractusx/sldt-semantic-models/tree/main/io.catenax.part_as_planned/2.0.0)                        |
-| SingleLevelBomAsPlanned    | 1.1.0   | Mandatory                                           | [SingleLevelBomAsPlanned 1.1.0](https://github.com/eclipse-tractusx/sldt-semantic-models/tree/main/io.catenax.single_level_bom_as_planned/1.1.0)] |
-| SingleLevelBomAsPlanned    | 2.0.0   | Optional (Mandatory for next version of CX-0126)    | [SingleLevelBomAsPlanned 2.0.0](https://github.com/eclipse-tractusx/sldt-semantic-models/tree/main/io.catenax.single_level_bom_as_planned/2.2.0)] |
-| SerialPart                 | 1.0.1   | Mandatory                                           | [SerialPart 1.0.1](https://github.com/eclipse-tractusx/sldt-semantic-models/tree/main/io.catenax.serial_part/1.0.1)                               |
-| SerialPart                 | 2.0.0   | Optional                                            | [SerialPart 2.0.0](https://github.com/eclipse-tractusx/sldt-semantic-models/tree/main/io.catenax.serial_part/2.0.0)                               |
-| Batch                      | 2.0.0   | Mandatory                                           | [Batch 2.0.0](https://github.com/eclipse-tractusx/sldt-semantic-models/tree/main/io.catenax.batch/2.0.0)                                          |
-| Batch                      | 2.0.1   | Optional                                            | [Batch 2.0.1](https://github.com/eclipse-tractusx/sldt-semantic-models/tree/main/io.catenax.batch/2.0.1)                                          |
-| JustInSequencePart         | 2.0.0   | Optional                                            | [JustInSequencePart 2.0.0](https://github.com/eclipse-tractusx/sldt-semantic-models/tree/main/io.catenax.just_in_sequence_part/2.0.0)             |
-| SingleLevelBomAsBuilt      | 2.0.0   | Mandatory                                           | [SingleLevelBomAsBuilt 2.0.0](https://github.com/eclipse-tractusx/sldt-semantic-models/tree/main/io.catenax.single_level_bom_as_built/2.0.0)      |
-| PartSiteInformationAsBuilt | 1.0.0   | Integrated in Aspects JustInSequencePart / Batch / SerialPart | https://github.com/eclipse-tractusx/sldt-semantic-models/tree/main/io.catenax.shared.part_site_information_as_built/1.0.0                                                                                                                                               |
+
+|Artefact| Version | Availability                                                 | link                                                                                                                                              |
+|---|---------|--------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------|
+| AAS |         |                                                              |                                                                                                                                                   |
+|PartAsPlanned | 2.0.0   | Mandatory             | [PartAsPlanned 2.0.0](https://github.com/eclipse-tractusx/sldt-semantic-models/tree/main/io.catenax.part_as_planned/2.0.0)                        |
+| SingleLevelBomAsPlanned| 2.0.0   | Mandatory              | [SingleLevelBomAsPlanned 2.0.0](https://github.com/eclipse-tractusx/sldt-semantic-models/tree/main/io.catenax.single_level_bom_as_planned/2.2.0)  |
+| SerialPart| 3.0.0   | Mandatory                                                    | [SerialPart 3.0.0](https://github.com/eclipse-tractusx/sldt-semantic-models/tree/main/io.catenax.serial_part/3.0.0/gen)                           |
+| Batch| 3.0.0   | Mandatory                                                    | [Batch 3.0.0](https://github.com/eclipse-tractusx/sldt-semantic-models/tree/main/io.catenax.batch/3.0.0)                                          |
+| JustInSequencePart| 3.0.0   | Mandatory                                                     | [JustInSequencePart 3.0.0](https://github.com/eclipse-tractusx/sldt-semantic-models/tree/main/io.catenax.just_in_sequence_part/3.0.0)             |
+| SingleLevelBomAsBuilt| 2.0.0   | Mandatory                                                    | [SingleLevelBomAsBuilt 2.0.0](https://github.com/eclipse-tractusx/sldt-semantic-models/tree/main/io.catenax.single_level_bom_as_built/2.0.0)      |
+| PartSiteInformationAsBuilt| 1.0.0   | Integrated in Aspects JustInSequencePart / Batch / SerialPart | https://github.com/eclipse-tractusx/sldt-semantic-models/tree/main/io.catenax.shared.part_site_information_as_built/1.0.0                         |
 
 
 - JustInSequencePart:  https://github.com/eclipse-tractusx/sldt-semantic-models/pull/563

From 98ae9f7a7d90d3e9714826b78870f849b0569e97 Mon Sep 17 00:00:00 2001
From: ds-lcapellino <lucas.capellino@doubleslash.de>
Date: Mon, 26 Feb 2024 09:25:49 +0100
Subject: [PATCH 08/24] feature: 420 add
 /management/v2/contractagreements/request and GET 
 /management/v2/contractagreements/{contractAgreementId}/negotiation to
 irs-edc-client lib

---
 CHANGELOG.md                                  |   1 +
 .../irs/edc/client/EdcConfiguration.java      |   1 +
 .../EdcContractAgreementListWrapper.java      |  37 +++++
 .../exception/ContractAgreementException.java |  27 +++
 .../service/EdcContractAgreementService.java  |  82 +++++++++
 .../EdcContractAgreementServiceTest.java      | 155 ++++++++++++++++++
 6 files changed, 303 insertions(+)
 create mode 100644 irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/EdcContractAgreementListWrapper.java
 create mode 100644 irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/exception/ContractAgreementException.java
 create mode 100644 irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementService.java
 create mode 100644 irs-edc-client/src/test/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementServiceTest.java

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 671abfac4a..f5e0eb5765 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
 ### Added
 - DigitalTwinRegistryCreateShellService in irs-registry-client for creating shells in DTR directly
+- POST /management/v2/contractagreements/request and GET  /management/v2/contractagreements/{contractAgreementId}/negotiation to irs-edc-client lib
 
 
 ## [4.6.0] - 2024-02-20
diff --git a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/EdcConfiguration.java b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/EdcConfiguration.java
index 3eebea2e4a..019781a863 100644
--- a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/EdcConfiguration.java
+++ b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/EdcConfiguration.java
@@ -72,6 +72,7 @@ public static class EndpointConfig {
             private String policyDefinition;
             private String transferProcess;
             private String stateSuffix;
+            private String contractAgreements;
 
         }
 
diff --git a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/EdcContractAgreementListWrapper.java b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/EdcContractAgreementListWrapper.java
new file mode 100644
index 0000000000..722fdf9d37
--- /dev/null
+++ b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/EdcContractAgreementListWrapper.java
@@ -0,0 +1,37 @@
+/********************************************************************************
+ * Copyright (c) 2022,2024 Bayerische Motoren Werke Aktiengesellschaft (BMW AG)
+ * Copyright (c) 2021,2024 Contributors to the Eclipse Foundation
+ *
+ * See the NOTICE file(s) distributed with this work for additional
+ * information regarding copyright ownership.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Apache License, Version 2.0 which is available at
+ * https://www.apache.org/licenses/LICENSE-2.0.
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+ * License for the specific language governing permissions and limitations
+ * under the License.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ ********************************************************************************/
+package org.eclipse.tractusx.irs.edc.client.contract.model;
+
+import java.util.List;
+
+import lombok.Builder;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+import lombok.ToString;
+import org.eclipse.edc.connector.contract.spi.types.agreement.ContractAgreement;
+
+@ToString
+@Builder
+@RequiredArgsConstructor
+@Getter
+public class EdcContractAgreementListWrapper {
+    final private List<ContractAgreement> contractAgreementList;
+
+}
diff --git a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/exception/ContractAgreementException.java b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/exception/ContractAgreementException.java
new file mode 100644
index 0000000000..c9535aa963
--- /dev/null
+++ b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/exception/ContractAgreementException.java
@@ -0,0 +1,27 @@
+/********************************************************************************
+ * Copyright (c) 2022,2024 Bayerische Motoren Werke Aktiengesellschaft (BMW AG)
+ * Copyright (c) 2021,2024 Contributors to the Eclipse Foundation
+ *
+ * See the NOTICE file(s) distributed with this work for additional
+ * information regarding copyright ownership.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Apache License, Version 2.0 which is available at
+ * https://www.apache.org/licenses/LICENSE-2.0.
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+ * License for the specific language governing permissions and limitations
+ * under the License.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ ********************************************************************************/
+package org.eclipse.tractusx.irs.edc.client.contract.model.exception;
+
+public class ContractAgreementException extends RuntimeException {
+
+    public ContractAgreementException(final String message) {
+        super(message);
+    }
+}
diff --git a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementService.java b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementService.java
new file mode 100644
index 0000000000..d98cb7e27c
--- /dev/null
+++ b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementService.java
@@ -0,0 +1,82 @@
+/********************************************************************************
+ * Copyright (c) 2022,2024 Bayerische Motoren Werke Aktiengesellschaft (BMW AG)
+ * Copyright (c) 2021,2024 Contributors to the Eclipse Foundation
+ *
+ * See the NOTICE file(s) distributed with this work for additional
+ * information regarding copyright ownership.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Apache License, Version 2.0 which is available at
+ * https://www.apache.org/licenses/LICENSE-2.0.
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+ * License for the specific language governing permissions and limitations
+ * under the License.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ ********************************************************************************/
+package org.eclipse.tractusx.irs.edc.client.contract.service;
+
+import java.util.Arrays;
+import java.util.List;
+
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.eclipse.edc.connector.contract.spi.types.agreement.ContractAgreement;
+import org.eclipse.edc.connector.contract.spi.types.negotiation.ContractNegotiation;
+import org.eclipse.edc.spi.query.Criterion;
+import org.eclipse.edc.spi.query.QuerySpec;
+import org.eclipse.tractusx.irs.edc.client.EdcConfiguration;
+import org.eclipse.tractusx.irs.edc.client.contract.model.EdcContractAgreementListWrapper;
+import org.eclipse.tractusx.irs.edc.client.contract.model.exception.ContractAgreementException;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.client.RestTemplate;
+
+@Slf4j
+@RequiredArgsConstructor
+public class EdcContractAgreementService {
+
+    private final EdcConfiguration config;
+    private final RestTemplate restTemplate;
+
+    public List<ContractAgreement> getContractAgreements(String... contractAgreementIds) {
+
+        QuerySpec querySpec = buildQuerySpec(contractAgreementIds);
+        final ResponseEntity<EdcContractAgreementListWrapper> edcContractAgreementListResponseEntity = restTemplate.postForEntity(
+                config.getControlplane().getEndpoint().getContractAgreements(), querySpec,
+                EdcContractAgreementListWrapper.class);
+
+        System.out.println("QuerySpec: " + querySpec.toString());
+
+        if (edcContractAgreementListResponseEntity.getBody() != null) {
+            return edcContractAgreementListResponseEntity.getBody().getContractAgreementList();
+        } else {
+            throw new ContractAgreementException(
+                    "Empty message body on edc response: " + edcContractAgreementListResponseEntity);
+        }
+
+    }
+
+    public ContractNegotiation getContractAgreementNegotiation(String contractAgreementId) {
+        final ResponseEntity<ContractNegotiation> contractNegotiationResponseEntity = restTemplate.getForEntity(
+                config.getControlplane().getEndpoint().getContractAgreements() + "/" + contractAgreementId
+                        + "/negotiation", ContractNegotiation.class);
+        return contractNegotiationResponseEntity.getBody();
+    }
+
+    private QuerySpec buildQuerySpec(final String[] contractAgreementIds) {
+
+        final List<Criterion> criterionList = Arrays.stream(contractAgreementIds)
+                                                    .map(id -> Criterion.Builder.newInstance()
+                                                                                .operandLeft(
+                                                                                        "https://w3id.org/edc/v0.0.1/ns/assetId")
+                                                                                .operator("=")
+                                                                                .operandRight(id)
+                                                                                .build())
+                                                    .toList();
+        return QuerySpec.Builder.newInstance().filter(criterionList).build();
+    }
+
+}
diff --git a/irs-edc-client/src/test/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementServiceTest.java b/irs-edc-client/src/test/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementServiceTest.java
new file mode 100644
index 0000000000..e13a7f0b03
--- /dev/null
+++ b/irs-edc-client/src/test/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementServiceTest.java
@@ -0,0 +1,155 @@
+/********************************************************************************
+ * Copyright (c) 2022,2024 Bayerische Motoren Werke Aktiengesellschaft (BMW AG)
+ * Copyright (c) 2021,2024 Contributors to the Eclipse Foundation
+ *
+ * See the NOTICE file(s) distributed with this work for additional
+ * information regarding copyright ownership.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Apache License, Version 2.0 which is available at
+ * https://www.apache.org/licenses/LICENSE-2.0.
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+ * License for the specific language governing permissions and limitations
+ * under the License.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ ********************************************************************************/
+package org.eclipse.tractusx.irs.edc.client.contract.service;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.anyString;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.when;
+
+import java.util.List;
+
+import org.eclipse.edc.connector.contract.spi.types.agreement.ContractAgreement;
+import org.eclipse.edc.connector.contract.spi.types.negotiation.ContractNegotiation;
+import org.eclipse.edc.policy.model.Policy;
+import org.eclipse.tractusx.irs.edc.client.EdcConfiguration;
+import org.eclipse.tractusx.irs.edc.client.contract.model.EdcContractAgreementListWrapper;
+import org.eclipse.tractusx.irs.edc.client.contract.model.exception.ContractAgreementException;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.mockito.Answers;
+import org.mockito.Mock;
+import org.mockito.Mockito;
+import org.mockito.junit.jupiter.MockitoExtension;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.client.RestTemplate;
+
+@ExtendWith(MockitoExtension.class)
+class EdcContractAgreementServiceTest {
+
+    @Mock
+    private RestTemplate restTemplate;
+    @Mock(answer = Answers.RETURNS_DEEP_STUBS)
+    private EdcConfiguration edcConfiguration;
+
+    private EdcContractAgreementService edcContractAgreementService;
+
+    @BeforeEach
+    void setUp() {
+        this.edcContractAgreementService = new EdcContractAgreementService(edcConfiguration, restTemplate);
+    }
+
+    @Test
+    void shouldReturnContractAgreements() {
+        //GIVEN
+        String[] contractAgreementIds = { "contractAgreementId" };
+        when(edcConfiguration.getControlplane().getEndpoint().getContractAgreements()).thenReturn(
+                "/management/v2/contractagreements/request");
+
+        final ContractAgreement contractAgreement = ContractAgreement.Builder.newInstance()
+                                                                             .id("id")
+                                                                             .assetId("assetId")
+                                                                             .consumerId("consumerId")
+                                                                             .providerId("providerId")
+                                                                             .policy(Policy.Builder.newInstance()
+                                                                                                   .build())
+                                                                             .build();
+        final EdcContractAgreementListWrapper edcContractAgreementListWrapper = EdcContractAgreementListWrapper.builder()
+                                                                                                               .contractAgreementList(
+                                                                                                                       List.of(contractAgreement))
+                                                                                                               .build();
+        when(restTemplate.postForEntity(anyString(), any(), eq(EdcContractAgreementListWrapper.class))).thenReturn(
+                ResponseEntity.ok(edcContractAgreementListWrapper));
+
+        //WHEN
+        final List<ContractAgreement> contractAgreements = edcContractAgreementService.getContractAgreements(
+                contractAgreementIds);
+
+        //THEN
+        Mockito.verify(restTemplate)
+               .postForEntity(eq("/management/v2/contractagreements/request"), any(),
+                       eq(EdcContractAgreementListWrapper.class));
+        assertNotNull(contractAgreements);
+    }
+
+    @Test
+    void shouldThrowContractAgreementExceptionWhenResponseBodyIsEmtpy() {
+        //GIVEN
+        String[] contractAgreementIds = { "contractAgreementId" };
+        when(edcConfiguration.getControlplane().getEndpoint().getContractAgreements()).thenReturn(
+                "/management/v2/contractagreements/request");
+
+        final ContractAgreement contractAgreement = ContractAgreement.Builder.newInstance()
+                                                                             .id("id")
+                                                                             .assetId("assetId")
+                                                                             .consumerId("consumerId")
+                                                                             .providerId("providerId")
+                                                                             .policy(Policy.Builder.newInstance()
+                                                                                                   .build())
+                                                                             .build();
+        final EdcContractAgreementListWrapper edcContractAgreementListWrapper = EdcContractAgreementListWrapper.builder()
+                                                                                                               .contractAgreementList(
+                                                                                                                       List.of(contractAgreement))
+                                                                                                               .build();
+        when(restTemplate.postForEntity(anyString(), any(), eq(EdcContractAgreementListWrapper.class))).thenReturn(
+                ResponseEntity.ok().build());
+
+        //WHEN
+        final ContractAgreementException contractAgreementException = assertThrows(ContractAgreementException.class,
+                () -> edcContractAgreementService.getContractAgreements(contractAgreementIds));
+
+        //THEN
+        Mockito.verify(restTemplate)
+               .postForEntity(eq("/management/v2/contractagreements/request"), any(),
+                       eq(EdcContractAgreementListWrapper.class));
+        assertEquals("Empty message body on edc response: <200 OK OK,[]>", contractAgreementException.getMessage());
+    }
+
+    @Test
+    void shouldReturnContractAgreementNegotiation() {
+        //GIVEN
+        String contractAgreementId = "contractAgreementId";
+        when(edcConfiguration.getControlplane().getEndpoint().getContractAgreements()).thenReturn(
+                "/management/v2/contractagreements");
+
+        final ContractNegotiation contractAgreementNegotiationMock = ContractNegotiation.Builder.newInstance()
+                                                                                                .id("id")
+                                                                                                .counterPartyId("")
+                                                                                                .counterPartyAddress("")
+                                                                                                .protocol("")
+                                                                                                .build();
+        when(restTemplate.getForEntity(anyString(), eq(ContractNegotiation.class))).thenReturn(
+                ResponseEntity.ok(contractAgreementNegotiationMock));
+
+        //WHEN
+        final ContractNegotiation contractAgreementNegotiation = edcContractAgreementService.getContractAgreementNegotiation(
+                contractAgreementId);
+
+        //THEN
+        Mockito.verify(restTemplate)
+               .getForEntity(eq("/management/v2/contractagreements/contractAgreementId/negotiation"),
+                       eq(ContractNegotiation.class));
+        assertNotNull(contractAgreementNegotiation);
+    }
+}
\ No newline at end of file

From 0c171ad710f6cd8547042162e829b54ab325d52c Mon Sep 17 00:00:00 2001
From: ds-lcapellino <lucas.capellino@doubleslash.de>
Date: Mon, 26 Feb 2024 09:53:36 +0100
Subject: [PATCH 09/24] feature: 420 add javadoc

---
 .../contract/model/EdcContractAgreementListWrapper.java     | 6 +++++-
 .../model/exception/ContractAgreementException.java         | 3 +++
 .../contract/service/EdcContractAgreementService.java       | 4 ++++
 3 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/EdcContractAgreementListWrapper.java b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/EdcContractAgreementListWrapper.java
index 722fdf9d37..18a975204f 100644
--- a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/EdcContractAgreementListWrapper.java
+++ b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/EdcContractAgreementListWrapper.java
@@ -27,11 +27,15 @@
 import lombok.ToString;
 import org.eclipse.edc.connector.contract.spi.types.agreement.ContractAgreement;
 
+/**
+ * EdcContractAgreementListWrapper used for wrapping the response of /management/v2/contractagreements/request where a List of
+ * {@link ContractAgreement} is returned.
+ */
 @ToString
 @Builder
 @RequiredArgsConstructor
 @Getter
 public class EdcContractAgreementListWrapper {
-    final private List<ContractAgreement> contractAgreementList;
+    private final List<ContractAgreement> contractAgreementList;
 
 }
diff --git a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/exception/ContractAgreementException.java b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/exception/ContractAgreementException.java
index c9535aa963..6ec118728e 100644
--- a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/exception/ContractAgreementException.java
+++ b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/exception/ContractAgreementException.java
@@ -19,6 +19,9 @@
  ********************************************************************************/
 package org.eclipse.tractusx.irs.edc.client.contract.model.exception;
 
+/**
+ * ContractAgreementException used for failures in {@link org.eclipse.tractusx.irs.edc.client.contract.service.EdcContractAgreementService}
+ */
 public class ContractAgreementException extends RuntimeException {
 
     public ContractAgreementException(final String message) {
diff --git a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementService.java b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementService.java
index d98cb7e27c..58660adc99 100644
--- a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementService.java
+++ b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementService.java
@@ -34,6 +34,10 @@
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.client.RestTemplate;
 
+
+/**
+ * EdcContractAgreementService used for contract agreements and contract agreement negotiation details
+ */
 @Slf4j
 @RequiredArgsConstructor
 public class EdcContractAgreementService {

From 87d40ccc5058102acf482dc56b6a88eb7e6eaf99 Mon Sep 17 00:00:00 2001
From: ds-lcapellino <lucas.capellino@doubleslash.de>
Date: Mon, 26 Feb 2024 09:58:42 +0100
Subject: [PATCH 10/24] feature: 420 fix PMD failures

---
 .../contract/model/EdcContractAgreementListWrapper.java   | 4 ++--
 .../model/exception/ContractAgreementException.java       | 3 ++-
 .../contract/service/EdcContractAgreementService.java     | 8 +++-----
 3 files changed, 7 insertions(+), 8 deletions(-)

diff --git a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/EdcContractAgreementListWrapper.java b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/EdcContractAgreementListWrapper.java
index 18a975204f..f86c6d4bc5 100644
--- a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/EdcContractAgreementListWrapper.java
+++ b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/EdcContractAgreementListWrapper.java
@@ -28,8 +28,8 @@
 import org.eclipse.edc.connector.contract.spi.types.agreement.ContractAgreement;
 
 /**
- * EdcContractAgreementListWrapper used for wrapping the response of /management/v2/contractagreements/request where a List of
- * {@link ContractAgreement} is returned.
+ * EdcContractAgreementListWrapper used for wrapping the response of /management/v2/contractagreements/request where
+ * a List of {@link ContractAgreement} is returned.
  */
 @ToString
 @Builder
diff --git a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/exception/ContractAgreementException.java b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/exception/ContractAgreementException.java
index 6ec118728e..b996d80c3e 100644
--- a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/exception/ContractAgreementException.java
+++ b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/exception/ContractAgreementException.java
@@ -20,7 +20,8 @@
 package org.eclipse.tractusx.irs.edc.client.contract.model.exception;
 
 /**
- * ContractAgreementException used for failures in {@link org.eclipse.tractusx.irs.edc.client.contract.service.EdcContractAgreementService}
+ * ContractAgreementException used for failures in
+ * {@link org.eclipse.tractusx.irs.edc.client.contract.service.EdcContractAgreementService}
  */
 public class ContractAgreementException extends RuntimeException {
 
diff --git a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementService.java b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementService.java
index 58660adc99..3d70ef0d14 100644
--- a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementService.java
+++ b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementService.java
@@ -45,15 +45,13 @@ public class EdcContractAgreementService {
     private final EdcConfiguration config;
     private final RestTemplate restTemplate;
 
-    public List<ContractAgreement> getContractAgreements(String... contractAgreementIds) {
+    public List<ContractAgreement> getContractAgreements(final String... contractAgreementIds) {
 
-        QuerySpec querySpec = buildQuerySpec(contractAgreementIds);
+        final QuerySpec querySpec = buildQuerySpec(contractAgreementIds);
         final ResponseEntity<EdcContractAgreementListWrapper> edcContractAgreementListResponseEntity = restTemplate.postForEntity(
                 config.getControlplane().getEndpoint().getContractAgreements(), querySpec,
                 EdcContractAgreementListWrapper.class);
 
-        System.out.println("QuerySpec: " + querySpec.toString());
-
         if (edcContractAgreementListResponseEntity.getBody() != null) {
             return edcContractAgreementListResponseEntity.getBody().getContractAgreementList();
         } else {
@@ -63,7 +61,7 @@ public List<ContractAgreement> getContractAgreements(String... contractAgreement
 
     }
 
-    public ContractNegotiation getContractAgreementNegotiation(String contractAgreementId) {
+    public ContractNegotiation getContractAgreementNegotiation(final String contractAgreementId) {
         final ResponseEntity<ContractNegotiation> contractNegotiationResponseEntity = restTemplate.getForEntity(
                 config.getControlplane().getEndpoint().getContractAgreements() + "/" + contractAgreementId
                         + "/negotiation", ContractNegotiation.class);

From 69edc86d0fcc6347e662d0ab8ddde153c03e46af Mon Sep 17 00:00:00 2001
From: ds-lcapellino <lucas.capellino@doubleslash.de>
Date: Mon, 26 Feb 2024 10:57:28 +0100
Subject: [PATCH 11/24] feature: 420 fix PMD failures

---
 .../contract/model/EdcContractAgreementListWrapper.java       | 4 ++--
 .../client/contract/service/EdcContractAgreementService.java  | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/EdcContractAgreementListWrapper.java b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/EdcContractAgreementListWrapper.java
index f86c6d4bc5..15bea6831c 100644
--- a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/EdcContractAgreementListWrapper.java
+++ b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/EdcContractAgreementListWrapper.java
@@ -28,8 +28,8 @@
 import org.eclipse.edc.connector.contract.spi.types.agreement.ContractAgreement;
 
 /**
- * EdcContractAgreementListWrapper used for wrapping the response of /management/v2/contractagreements/request where
- * a List of {@link ContractAgreement} is returned.
+ * EdcContractAgreementListWrapper used for wrapping the response of /management/v2/contractagreements/request
+ * where a List of {@link ContractAgreement} is returned.
  */
 @ToString
 @Builder
diff --git a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementService.java b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementService.java
index 3d70ef0d14..1ec1f40ab4 100644
--- a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementService.java
+++ b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementService.java
@@ -68,7 +68,7 @@ public ContractNegotiation getContractAgreementNegotiation(final String contract
         return contractNegotiationResponseEntity.getBody();
     }
 
-    private QuerySpec buildQuerySpec(final String[] contractAgreementIds) {
+    private QuerySpec buildQuerySpec(final String... contractAgreementIds) {
 
         final List<Criterion> criterionList = Arrays.stream(contractAgreementIds)
                                                     .map(id -> Criterion.Builder.newInstance()

From dc399df30d29ba9b31fb158777e0f07074727667 Mon Sep 17 00:00:00 2001
From: ds-lcapellino <lucas.capellino@doubleslash.de>
Date: Mon, 26 Feb 2024 11:02:04 +0100
Subject: [PATCH 12/24] feature: 420 fix PMD failures

---
 .../contract/model/EdcContractAgreementListWrapper.java       | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/EdcContractAgreementListWrapper.java b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/EdcContractAgreementListWrapper.java
index 15bea6831c..d4ed191ca5 100644
--- a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/EdcContractAgreementListWrapper.java
+++ b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/EdcContractAgreementListWrapper.java
@@ -28,8 +28,8 @@
 import org.eclipse.edc.connector.contract.spi.types.agreement.ContractAgreement;
 
 /**
- * EdcContractAgreementListWrapper used for wrapping the response of /management/v2/contractagreements/request
- * where a List of {@link ContractAgreement} is returned.
+ * EdcContractAgreementListWrapper used for wrapping the response of
+ * /management/v2/contractagreements/request where a List of {@link ContractAgreement} is returned.
  */
 @ToString
 @Builder

From 890c9c3d45c26cf008f7a2eb274fbddbe756a2f1 Mon Sep 17 00:00:00 2001
From: ds-lcapellino <lucas.capellino@doubleslash.de>
Date: Mon, 26 Feb 2024 11:07:06 +0100
Subject: [PATCH 13/24] feature: 420 fix PMD failures

---
 .../client/contract/service/EdcContractAgreementService.java | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementService.java b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementService.java
index 1ec1f40ab4..41413be38d 100644
--- a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementService.java
+++ b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementService.java
@@ -52,8 +52,9 @@ public List<ContractAgreement> getContractAgreements(final String... contractAgr
                 config.getControlplane().getEndpoint().getContractAgreements(), querySpec,
                 EdcContractAgreementListWrapper.class);
 
-        if (edcContractAgreementListResponseEntity.getBody() != null) {
-            return edcContractAgreementListResponseEntity.getBody().getContractAgreementList();
+        final EdcContractAgreementListWrapper contractAgreementListWrapper = edcContractAgreementListResponseEntity.getBody();
+        if (contractAgreementListWrapper != null) {
+            return contractAgreementListWrapper.getContractAgreementList();
         } else {
             throw new ContractAgreementException(
                     "Empty message body on edc response: " + edcContractAgreementListResponseEntity);

From be4a28d2f79a74a2f457f41275f8b89f2f775ec3 Mon Sep 17 00:00:00 2001
From: ds-lcapellino <lucas.capellino@doubleslash.de>
Date: Mon, 26 Feb 2024 11:08:57 +0100
Subject: [PATCH 14/24] feature: 420 fix PMD failures

---
 .../service/EdcContractAgreementServiceTest.java     | 12 ------------
 1 file changed, 12 deletions(-)

diff --git a/irs-edc-client/src/test/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementServiceTest.java b/irs-edc-client/src/test/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementServiceTest.java
index e13a7f0b03..7048b2f322 100644
--- a/irs-edc-client/src/test/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementServiceTest.java
+++ b/irs-edc-client/src/test/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementServiceTest.java
@@ -100,18 +100,6 @@ void shouldThrowContractAgreementExceptionWhenResponseBodyIsEmtpy() {
         when(edcConfiguration.getControlplane().getEndpoint().getContractAgreements()).thenReturn(
                 "/management/v2/contractagreements/request");
 
-        final ContractAgreement contractAgreement = ContractAgreement.Builder.newInstance()
-                                                                             .id("id")
-                                                                             .assetId("assetId")
-                                                                             .consumerId("consumerId")
-                                                                             .providerId("providerId")
-                                                                             .policy(Policy.Builder.newInstance()
-                                                                                                   .build())
-                                                                             .build();
-        final EdcContractAgreementListWrapper edcContractAgreementListWrapper = EdcContractAgreementListWrapper.builder()
-                                                                                                               .contractAgreementList(
-                                                                                                                       List.of(contractAgreement))
-                                                                                                               .build();
         when(restTemplate.postForEntity(anyString(), any(), eq(EdcContractAgreementListWrapper.class))).thenReturn(
                 ResponseEntity.ok().build());
 

From 971fdbf0133e669488bba5632f162b299b87a09e Mon Sep 17 00:00:00 2001
From: ds-lcapellino <lucas.capellino@doubleslash.de>
Date: Mon, 26 Feb 2024 12:21:10 +0100
Subject: [PATCH 15/24] feature: 420 fix sonar findings

---
 .../contract/service/EdcContractAgreementServiceTest.java     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/irs-edc-client/src/test/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementServiceTest.java b/irs-edc-client/src/test/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementServiceTest.java
index 7048b2f322..aedeb839c1 100644
--- a/irs-edc-client/src/test/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementServiceTest.java
+++ b/irs-edc-client/src/test/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementServiceTest.java
@@ -136,8 +136,8 @@ void shouldReturnContractAgreementNegotiation() {
 
         //THEN
         Mockito.verify(restTemplate)
-               .getForEntity(eq("/management/v2/contractagreements/contractAgreementId/negotiation"),
-                       eq(ContractNegotiation.class));
+               .getForEntity("/management/v2/contractagreements/contractAgreementId/negotiation",
+                       ContractNegotiation.class);
         assertNotNull(contractAgreementNegotiation);
     }
 }
\ No newline at end of file

From bdf831adc0c0ea20a4f97e7c0da6f43863624ad6 Mon Sep 17 00:00:00 2001
From: ds-lcapellino <lucas.capellino@doubleslash.de>
Date: Mon, 26 Feb 2024 16:24:42 +0100
Subject: [PATCH 16/24] feature: 420 refactor

---
 charts/irs-helm/values.yaml                   |  7 +++---
 ...ava => EdcContractAgreementsResponse.java} |  2 +-
 .../exception/ContractAgreementException.java |  2 +-
 .../service/EdcContractAgreementService.java  | 19 ++++++++-------
 .../EdcContractAgreementServiceTest.java      | 24 +++++++++----------
 5 files changed, 28 insertions(+), 26 deletions(-)
 rename irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/{EdcContractAgreementListWrapper.java => EdcContractAgreementsResponse.java} (97%)

diff --git a/charts/irs-helm/values.yaml b/charts/irs-helm/values.yaml
index a62c3cff2e..63977c4b0d 100644
--- a/charts/irs-helm/values.yaml
+++ b/charts/irs-helm/values.yaml
@@ -173,10 +173,11 @@ edc:
   controlplane:
     endpoint:
       data: ""  # <edc-controlplane-endpoint-data>
-      catalog: /v2/catalog/request  # EDC consumer controlplane catalog path
-      contractnegotiation: /v2/contractnegotiations  # EDC consumer controlplane contract negotiation path
-      transferprocess: /v2/transferprocesses  # EDC consumer controlplane transfer process path
+      catalog: /management/v2/catalog/request  # EDC consumer controlplane catalog path
+      contractnegotiation: /management/v2/contractnegotiations  # EDC consumer controlplane contract negotiation path
+      transferprocess: /management/v2/transferprocesses  # EDC consumer controlplane transfer process path
       statesuffix: /state  # Path of the state suffix for contract negotiation and transfer process
+      contractAgreements: /management/v2/contractagreements # EDC consumer controlplane contract agreements path
     request:
       ttl: PT10M  # Requests to controlplane will time out after this duration (see https://en.wikipedia.org/wiki/ISO_8601#Durations)
     provider:
diff --git a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/EdcContractAgreementListWrapper.java b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/EdcContractAgreementsResponse.java
similarity index 97%
rename from irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/EdcContractAgreementListWrapper.java
rename to irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/EdcContractAgreementsResponse.java
index d4ed191ca5..45232cbc87 100644
--- a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/EdcContractAgreementListWrapper.java
+++ b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/EdcContractAgreementsResponse.java
@@ -35,7 +35,7 @@
 @Builder
 @RequiredArgsConstructor
 @Getter
-public class EdcContractAgreementListWrapper {
+public class EdcContractAgreementsResponse {
     private final List<ContractAgreement> contractAgreementList;
 
 }
diff --git a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/exception/ContractAgreementException.java b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/exception/ContractAgreementException.java
index b996d80c3e..ca3715fc95 100644
--- a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/exception/ContractAgreementException.java
+++ b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/exception/ContractAgreementException.java
@@ -23,7 +23,7 @@
  * ContractAgreementException used for failures in
  * {@link org.eclipse.tractusx.irs.edc.client.contract.service.EdcContractAgreementService}
  */
-public class ContractAgreementException extends RuntimeException {
+public class ContractAgreementException extends Exception {
 
     public ContractAgreementException(final String message) {
         super(message);
diff --git a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementService.java b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementService.java
index 41413be38d..3064b5f5f3 100644
--- a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementService.java
+++ b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementService.java
@@ -29,12 +29,11 @@
 import org.eclipse.edc.spi.query.Criterion;
 import org.eclipse.edc.spi.query.QuerySpec;
 import org.eclipse.tractusx.irs.edc.client.EdcConfiguration;
-import org.eclipse.tractusx.irs.edc.client.contract.model.EdcContractAgreementListWrapper;
+import org.eclipse.tractusx.irs.edc.client.contract.model.EdcContractAgreementsResponse;
 import org.eclipse.tractusx.irs.edc.client.contract.model.exception.ContractAgreementException;
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.client.RestTemplate;
 
-
 /**
  * EdcContractAgreementService used for contract agreements and contract agreement negotiation details
  */
@@ -42,17 +41,20 @@
 @RequiredArgsConstructor
 public class EdcContractAgreementService {
 
+    public static final String EDC_REQUEST_SUFFIX = "/request";
+    public static final String EDC_ASSET_ID = "https://w3id.org/edc/v0.0.1/ns/assetId";
     private final EdcConfiguration config;
     private final RestTemplate restTemplate;
 
-    public List<ContractAgreement> getContractAgreements(final String... contractAgreementIds) {
+    public List<ContractAgreement> getContractAgreements(final String... contractAgreementIds)
+            throws ContractAgreementException {
 
         final QuerySpec querySpec = buildQuerySpec(contractAgreementIds);
-        final ResponseEntity<EdcContractAgreementListWrapper> edcContractAgreementListResponseEntity = restTemplate.postForEntity(
-                config.getControlplane().getEndpoint().getContractAgreements(), querySpec,
-                EdcContractAgreementListWrapper.class);
+        final ResponseEntity<EdcContractAgreementsResponse> edcContractAgreementListResponseEntity = restTemplate.postForEntity(
+                config.getControlplane().getEndpoint().getContractAgreements() + EDC_REQUEST_SUFFIX, querySpec,
+                EdcContractAgreementsResponse.class);
 
-        final EdcContractAgreementListWrapper contractAgreementListWrapper = edcContractAgreementListResponseEntity.getBody();
+        final EdcContractAgreementsResponse contractAgreementListWrapper = edcContractAgreementListResponseEntity.getBody();
         if (contractAgreementListWrapper != null) {
             return contractAgreementListWrapper.getContractAgreementList();
         } else {
@@ -73,8 +75,7 @@ private QuerySpec buildQuerySpec(final String... contractAgreementIds) {
 
         final List<Criterion> criterionList = Arrays.stream(contractAgreementIds)
                                                     .map(id -> Criterion.Builder.newInstance()
-                                                                                .operandLeft(
-                                                                                        "https://w3id.org/edc/v0.0.1/ns/assetId")
+                                                                                .operandLeft(EDC_ASSET_ID)
                                                                                 .operator("=")
                                                                                 .operandRight(id)
                                                                                 .build())
diff --git a/irs-edc-client/src/test/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementServiceTest.java b/irs-edc-client/src/test/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementServiceTest.java
index aedeb839c1..f58c118ac9 100644
--- a/irs-edc-client/src/test/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementServiceTest.java
+++ b/irs-edc-client/src/test/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementServiceTest.java
@@ -33,7 +33,7 @@
 import org.eclipse.edc.connector.contract.spi.types.negotiation.ContractNegotiation;
 import org.eclipse.edc.policy.model.Policy;
 import org.eclipse.tractusx.irs.edc.client.EdcConfiguration;
-import org.eclipse.tractusx.irs.edc.client.contract.model.EdcContractAgreementListWrapper;
+import org.eclipse.tractusx.irs.edc.client.contract.model.EdcContractAgreementsResponse;
 import org.eclipse.tractusx.irs.edc.client.contract.model.exception.ContractAgreementException;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
@@ -61,11 +61,11 @@ void setUp() {
     }
 
     @Test
-    void shouldReturnContractAgreements() {
+    void shouldReturnContractAgreements() throws ContractAgreementException {
         //GIVEN
         String[] contractAgreementIds = { "contractAgreementId" };
         when(edcConfiguration.getControlplane().getEndpoint().getContractAgreements()).thenReturn(
-                "/management/v2/contractagreements/request");
+                "/management/v2/contractagreements");
 
         final ContractAgreement contractAgreement = ContractAgreement.Builder.newInstance()
                                                                              .id("id")
@@ -75,12 +75,12 @@ void shouldReturnContractAgreements() {
                                                                              .policy(Policy.Builder.newInstance()
                                                                                                    .build())
                                                                              .build();
-        final EdcContractAgreementListWrapper edcContractAgreementListWrapper = EdcContractAgreementListWrapper.builder()
-                                                                                                               .contractAgreementList(
+        final EdcContractAgreementsResponse edcContractAgreementsResponse = EdcContractAgreementsResponse.builder()
+                                                                                                         .contractAgreementList(
                                                                                                                        List.of(contractAgreement))
-                                                                                                               .build();
-        when(restTemplate.postForEntity(anyString(), any(), eq(EdcContractAgreementListWrapper.class))).thenReturn(
-                ResponseEntity.ok(edcContractAgreementListWrapper));
+                                                                                                         .build();
+        when(restTemplate.postForEntity(anyString(), any(), eq(EdcContractAgreementsResponse.class))).thenReturn(
+                ResponseEntity.ok(edcContractAgreementsResponse));
 
         //WHEN
         final List<ContractAgreement> contractAgreements = edcContractAgreementService.getContractAgreements(
@@ -89,7 +89,7 @@ void shouldReturnContractAgreements() {
         //THEN
         Mockito.verify(restTemplate)
                .postForEntity(eq("/management/v2/contractagreements/request"), any(),
-                       eq(EdcContractAgreementListWrapper.class));
+                       eq(EdcContractAgreementsResponse.class));
         assertNotNull(contractAgreements);
     }
 
@@ -98,9 +98,9 @@ void shouldThrowContractAgreementExceptionWhenResponseBodyIsEmtpy() {
         //GIVEN
         String[] contractAgreementIds = { "contractAgreementId" };
         when(edcConfiguration.getControlplane().getEndpoint().getContractAgreements()).thenReturn(
-                "/management/v2/contractagreements/request");
+                "/management/v2/contractagreements");
 
-        when(restTemplate.postForEntity(anyString(), any(), eq(EdcContractAgreementListWrapper.class))).thenReturn(
+        when(restTemplate.postForEntity(anyString(), any(), eq(EdcContractAgreementsResponse.class))).thenReturn(
                 ResponseEntity.ok().build());
 
         //WHEN
@@ -110,7 +110,7 @@ void shouldThrowContractAgreementExceptionWhenResponseBodyIsEmtpy() {
         //THEN
         Mockito.verify(restTemplate)
                .postForEntity(eq("/management/v2/contractagreements/request"), any(),
-                       eq(EdcContractAgreementListWrapper.class));
+                       eq(EdcContractAgreementsResponse.class));
         assertEquals("Empty message body on edc response: <200 OK OK,[]>", contractAgreementException.getMessage());
     }
 

From 975eda7f8026000da612d5f705a95e377ce792aa Mon Sep 17 00:00:00 2001
From: ds-lcapellino <lucas.capellino@doubleslash.de>
Date: Mon, 26 Feb 2024 16:25:37 +0100
Subject: [PATCH 17/24] feature: 420 refactor

---
 .../contract/model/exception/ContractAgreementException.java  | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/exception/ContractAgreementException.java b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/exception/ContractAgreementException.java
index ca3715fc95..d8343e91d9 100644
--- a/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/exception/ContractAgreementException.java
+++ b/irs-edc-client/src/main/java/org/eclipse/tractusx/irs/edc/client/contract/model/exception/ContractAgreementException.java
@@ -19,11 +19,13 @@
  ********************************************************************************/
 package org.eclipse.tractusx.irs.edc.client.contract.model.exception;
 
+import org.eclipse.tractusx.irs.edc.client.exceptions.EdcClientException;
+
 /**
  * ContractAgreementException used for failures in
  * {@link org.eclipse.tractusx.irs.edc.client.contract.service.EdcContractAgreementService}
  */
-public class ContractAgreementException extends Exception {
+public class ContractAgreementException extends EdcClientException {
 
     public ContractAgreementException(final String message) {
         super(message);

From ae866924e32094f1076b0bb3f44758460b36f3da Mon Sep 17 00:00:00 2001
From: ds-lcapellino <lucas.capellino@doubleslash.de>
Date: Tue, 27 Feb 2024 08:22:50 +0100
Subject: [PATCH 18/24] feature: 420 refactor

---
 .../templates/configmap-spring-app-config.yaml       |  1 +
 charts/irs-helm/values.yaml                          |  8 ++++----
 .../service/EdcContractAgreementServiceTest.java     | 12 ++++++------
 3 files changed, 11 insertions(+), 10 deletions(-)

diff --git a/charts/irs-helm/templates/configmap-spring-app-config.yaml b/charts/irs-helm/templates/configmap-spring-app-config.yaml
index c5811fc1a7..6c4c0fd430 100644
--- a/charts/irs-helm/templates/configmap-spring-app-config.yaml
+++ b/charts/irs-helm/templates/configmap-spring-app-config.yaml
@@ -108,6 +108,7 @@ data:
           contract-negotiation: {{ .Values.edc.controlplane.endpoint.contractnegotiation | default "/v2/contractnegotiations" | quote }}
           transfer-process: {{ .Values.edc.controlplane.endpoint.transferprocess | default "/v2/transferprocesses" | quote }}
           state-suffix: {{ .Values.edc.controlplane.endpoint.statesuffix | default "/state" | quote }}
+          contract-agreements: {{ .Values.edc.controlplane.endpoint.contractAgreements | default "/v2/contractagreements" | quote }}
         provider-suffix: {{ tpl .Values.edc.controlplane.provider.suffix . | quote }}
         catalog-limit: {{ .Values.edc.controlplane.catalog.limit }}
         catalog-page-size: {{ .Values.edc.controlplane.catalog.pagesize }}
diff --git a/charts/irs-helm/values.yaml b/charts/irs-helm/values.yaml
index 63977c4b0d..e3a2b759d6 100644
--- a/charts/irs-helm/values.yaml
+++ b/charts/irs-helm/values.yaml
@@ -173,11 +173,11 @@ edc:
   controlplane:
     endpoint:
       data: ""  # <edc-controlplane-endpoint-data>
-      catalog: /management/v2/catalog/request  # EDC consumer controlplane catalog path
-      contractnegotiation: /management/v2/contractnegotiations  # EDC consumer controlplane contract negotiation path
-      transferprocess: /management/v2/transferprocesses  # EDC consumer controlplane transfer process path
+      catalog: /v2/catalog/request  # EDC consumer controlplane catalog path
+      contractnegotiation: /v2/contractnegotiations  # EDC consumer controlplane contract negotiation path
+      transferprocess: /v2/transferprocesses  # EDC consumer controlplane transfer process path
       statesuffix: /state  # Path of the state suffix for contract negotiation and transfer process
-      contractAgreements: /management/v2/contractagreements # EDC consumer controlplane contract agreements path
+      contractAgreements: /v2/contractagreements  # EDC consumer controlplane contract agreements path
     request:
       ttl: PT10M  # Requests to controlplane will time out after this duration (see https://en.wikipedia.org/wiki/ISO_8601#Durations)
     provider:
diff --git a/irs-edc-client/src/test/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementServiceTest.java b/irs-edc-client/src/test/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementServiceTest.java
index f58c118ac9..38e14d5677 100644
--- a/irs-edc-client/src/test/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementServiceTest.java
+++ b/irs-edc-client/src/test/java/org/eclipse/tractusx/irs/edc/client/contract/service/EdcContractAgreementServiceTest.java
@@ -65,7 +65,7 @@ void shouldReturnContractAgreements() throws ContractAgreementException {
         //GIVEN
         String[] contractAgreementIds = { "contractAgreementId" };
         when(edcConfiguration.getControlplane().getEndpoint().getContractAgreements()).thenReturn(
-                "/management/v2/contractagreements");
+                "/v2/contractagreements");
 
         final ContractAgreement contractAgreement = ContractAgreement.Builder.newInstance()
                                                                              .id("id")
@@ -88,7 +88,7 @@ void shouldReturnContractAgreements() throws ContractAgreementException {
 
         //THEN
         Mockito.verify(restTemplate)
-               .postForEntity(eq("/management/v2/contractagreements/request"), any(),
+               .postForEntity(eq("/v2/contractagreements/request"), any(),
                        eq(EdcContractAgreementsResponse.class));
         assertNotNull(contractAgreements);
     }
@@ -98,7 +98,7 @@ void shouldThrowContractAgreementExceptionWhenResponseBodyIsEmtpy() {
         //GIVEN
         String[] contractAgreementIds = { "contractAgreementId" };
         when(edcConfiguration.getControlplane().getEndpoint().getContractAgreements()).thenReturn(
-                "/management/v2/contractagreements");
+                "/v2/contractagreements");
 
         when(restTemplate.postForEntity(anyString(), any(), eq(EdcContractAgreementsResponse.class))).thenReturn(
                 ResponseEntity.ok().build());
@@ -109,7 +109,7 @@ void shouldThrowContractAgreementExceptionWhenResponseBodyIsEmtpy() {
 
         //THEN
         Mockito.verify(restTemplate)
-               .postForEntity(eq("/management/v2/contractagreements/request"), any(),
+               .postForEntity(eq("/v2/contractagreements/request"), any(),
                        eq(EdcContractAgreementsResponse.class));
         assertEquals("Empty message body on edc response: <200 OK OK,[]>", contractAgreementException.getMessage());
     }
@@ -119,7 +119,7 @@ void shouldReturnContractAgreementNegotiation() {
         //GIVEN
         String contractAgreementId = "contractAgreementId";
         when(edcConfiguration.getControlplane().getEndpoint().getContractAgreements()).thenReturn(
-                "/management/v2/contractagreements");
+                "/v2/contractagreements");
 
         final ContractNegotiation contractAgreementNegotiationMock = ContractNegotiation.Builder.newInstance()
                                                                                                 .id("id")
@@ -136,7 +136,7 @@ void shouldReturnContractAgreementNegotiation() {
 
         //THEN
         Mockito.verify(restTemplate)
-               .getForEntity("/management/v2/contractagreements/contractAgreementId/negotiation",
+               .getForEntity("/v2/contractagreements/contractAgreementId/negotiation",
                        ContractNegotiation.class);
         assertNotNull(contractAgreementNegotiation);
     }

From 12dfc2b857f1eca7ccf00eb7f2fb221bcb2a8eda Mon Sep 17 00:00:00 2001
From: ds-lcapellino <lucas.capellino@doubleslash.de>
Date: Tue, 27 Feb 2024 08:24:11 +0100
Subject: [PATCH 19/24] feature: 420 refactor

---
 CHANGELOG.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index f5e0eb5765..a449e8c3c9 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,7 +7,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
 ### Added
 - DigitalTwinRegistryCreateShellService in irs-registry-client for creating shells in DTR directly
-- POST /management/v2/contractagreements/request and GET  /management/v2/contractagreements/{contractAgreementId}/negotiation to irs-edc-client lib
+- POST /management/v2/contractagreements/request and GET /management/v2/contractagreements/{contractAgreementId}/negotiation to irs-edc-client lib
 
 
 ## [4.6.0] - 2024-02-20

From eb40a9f9d763271c15770f93715d82b766416cd2 Mon Sep 17 00:00:00 2001
From: "Krzysztof Massalski (Extern)"
 <Krzysztof.Massalski@partner.doubleslash.de>
Date: Tue, 27 Feb 2024 10:20:35 +0100
Subject: [PATCH 20/24] feat(impl):[#312] irs local helm setup

---
 local/deployment/irs-local/Chart.yaml  |  35 ++++++++
 local/deployment/irs-local/README.md   | 113 +++++++++++++++++++++++++
 local/deployment/irs-local/values.yaml |  50 +++++++++++
 3 files changed, 198 insertions(+)
 create mode 100644 local/deployment/irs-local/Chart.yaml
 create mode 100644 local/deployment/irs-local/README.md
 create mode 100644 local/deployment/irs-local/values.yaml

diff --git a/local/deployment/irs-local/Chart.yaml b/local/deployment/irs-local/Chart.yaml
new file mode 100644
index 0000000000..41742cf1a6
--- /dev/null
+++ b/local/deployment/irs-local/Chart.yaml
@@ -0,0 +1,35 @@
+# Copyright (c) 2021,2022,2023
+#       2022: ZF Friedrichshafen AG
+#       2022: ISTOS GmbH
+#       2022,2023: Bayerische Motoren Werke Aktiengesellschaft (BMW AG)
+#       2022,2023: BOSCH AG
+# Copyright (c) 2021,2022,2023 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Apache License, Version 2.0 which is available at
+# https://www.apache.org/licenses/LICENSE-2.0. *
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+#
+# SPDX-License-Identifier: Apache-2.0
+#
+apiVersion: v2
+name: irs-helm-local
+description: IRS Helm chart for local Kubernetes
+home: https://eclipse-tractusx.github.io/
+sources:
+  - https://github.com/eclipse-tractusx/item-relationship-service
+type: application
+version: 6.14.0
+appVersion: "4.5.0"
+
+dependencies:
+  - name: irs-helm
+    repository: https://eclipse-tractusx.github.io/item-relationship-service
+    version: 6.14.0
diff --git a/local/deployment/irs-local/README.md b/local/deployment/irs-local/README.md
new file mode 100644
index 0000000000..20cccbd201
--- /dev/null
+++ b/local/deployment/irs-local/README.md
@@ -0,0 +1,113 @@
+# Item Relationship Service
+
+## Local deployment of IRS with minimum dependencies setup
+
+### Step 1: Prerequisites
+
+1. [Docker](https://docs.docker.com/get-docker/) is installed and the Docker deamon is running with at least 8GB of memory
+2. [helm](https://helm.sh/docs/intro/install/) is installed
+3. Any Kubernetes cluster is installed and running, eg. [Minikube](https://minikube.sigs.k8s.io/docs/start/)
+4. [kubectl](https://kubernetes.io/docs/tasks/tools/) is installed
+
+### Step 2: Update and build the irs-helm chart
+
+```bash
+$ helm dependency build
+```
+You should see console output with messages like below:
+```bash
+Hang tight while we grab the latest from your chart repositories...
+...Successfully got an update from the "irs" chart repository
+...Successfully got an update from the "tractusx-dev" chart repository
+...Successfully got an update from the "prometheus-community" chart repository
+Update Complete. ⎈Happy Helming!⎈
+Saving 1 charts
+Downloading irs-helm from repo https://eclipse-tractusx.github.io/item-relationship-service
+Deleting outdated charts
+```
+Please note that irs repository has to be added to helm repo list
+```bash
+$ helm repo add irs https://eclipse-tractusx.github.io/item-relationship-service
+$ helm repo list
+NAME                    URL
+irs                     https://eclipse-tractusx.github.io/item-relationship-service
+```
+
+### Step 3: Installing the IRS
+
+#### 1. Start the cluster
+
+To deploy IRS on kubernetes with helm run
+
+```bash
+$ helm install irs-local .
+```
+
+##### 1.1 Get the Status of the deployment
+
+Helm can give you feedback on the release status:
+
+```bash
+$ helm list
+NAME            NAMESPACE       REVISION        UPDATED                                 STATUS          CHART                   APP VERSION
+irs-local       default         1               2024-02-26 11:36:46.399546 +0100 CET    deployed        irs-helm-local-6.14.0   4.5.0
+```
+Kubectl can give you feedback on how the status of the deployment currently is, there should be two pods deployed - IRS and Minio:
+```bash
+$ kubectl get pods
+NAME                                 READY   STATUS    RESTARTS      AGE
+irs-local-minio-7cc78d8985-qggrx     1/1     Running   0             10m
+irs-local-irs-helm-c84f98ffb-zg59z   1/1     Running   0             10m
+
+```
+
+#### 2. Forward Ports
+
+When the deployment has been finished please use the command to forward the port:
+
+```bash
+$  kubectl port-forward svc/irs-local-irs-helm 8080:8080
+```
+
+After that you can access the Swagger UI page:
+
+* **IRS Swagger:** [http://localhost:8080/api/swagger-ui/index.html](http://localhost:8080/api/swagger-ui/index.html)
+
+## Testing the Item Relationship Service
+
+You can use any approach to access exposed by IRS API endpoints, for example mentioned above Swagger UI page. There is also prepared Insomnia collection with example calls to IRS, see [IRS_Request_Collection.json](../../testing/IRS_Request_Collection.json)
+
+### Valid Global Asset Ids for testing
+
+IRS is loading with mocked data from Testdata file, see [CX_Testdata.json](../../../irs-models/src/main/resources/test_data/CX_Testdata.json)
+
+### Valid test requests for testing
+
+You can use these snippets for testing purposes.
+
+```json
+{
+  "bomLifecycle": "asBuilt",
+  "lookupBPNs": true,
+  "direction": "downward",
+  "depth": 10,
+  "auditContractNegotiation": false,
+  "key": {
+    "globalAssetId": "urn:uuid:951f1ebf-ebcf-427c-8a4d-7fe1f67c8d58",
+    "bpn": "BPNL00000003B0Q0"
+  }
+}
+````
+
+```json
+{
+  "aspects": [
+    "SerialPart"
+  ],
+  "depth": 1,
+  "key": {
+    "globalAssetId": "urn:uuid:951f1ebf-ebcf-427c-8a4d-7fe1f67c8d58",
+    "bpn": "BPNL00000003B0Q0"
+  }
+}
+```
\ No newline at end of file
diff --git a/local/deployment/irs-local/values.yaml b/local/deployment/irs-local/values.yaml
new file mode 100644
index 0000000000..0e2b74461c
--- /dev/null
+++ b/local/deployment/irs-local/values.yaml
@@ -0,0 +1,50 @@
+irs-helm:
+  #####################
+  # IRS Configuration #
+  #####################
+  irsUrl: "http://localhost:8080"
+  bpn: "BPNL000000000000"
+  apiKeyAdmin: "01234567890123456789"
+  apiKeyRegular: "09876543210987654321"
+  env:
+    - name: SPRING_PROFILES_ACTIVE
+      value: local
+
+  digitalTwinRegistry:
+    type: central
+  discovery:
+    discoveryFinderUrl: https://localhost
+  semanticshub:
+    url: https://localhost
+  bpdm:
+    url: https://localhost
+
+  minioUser: "testtest"
+  minioPassword: "testtest"
+
+  resources:
+    limits:
+      cpu: "1000m"
+      memory: "500Mi"
+    requests:
+      cpu: "50m"
+      memory: "100Mi"
+
+  #######################
+  # Minio Configuration #
+  #######################
+  minio:
+    rootUser: "testtest"
+    rootPassword: "testtest"
+
+  #########################
+  # Grafana Configuration #
+  #########################
+  grafana:
+    enabled: false
+
+  ############################
+  # Prometheus Configuration #
+  ############################
+  prometheus:
+    enabled: false

From 728bb77d5f75e8923041c8d2f97c2b9b73dec0bd Mon Sep 17 00:00:00 2001
From: "Krzysztof Massalski (Extern)"
 <Krzysztof.Massalski@partner.doubleslash.de>
Date: Tue, 27 Feb 2024 13:07:24 +0100
Subject: [PATCH 21/24] feat(impl):[#312] fix review comments

---
 local/deployment/irs-local/Chart.yaml  |  8 ++++----
 local/deployment/irs-local/values.yaml | 23 ++++++++++++++++++++++-
 2 files changed, 26 insertions(+), 5 deletions(-)

diff --git a/local/deployment/irs-local/Chart.yaml b/local/deployment/irs-local/Chart.yaml
index 41742cf1a6..c6992876b6 100644
--- a/local/deployment/irs-local/Chart.yaml
+++ b/local/deployment/irs-local/Chart.yaml
@@ -1,9 +1,9 @@
-# Copyright (c) 2021,2022,2023
+# Copyright (c) 2022,2024
 #       2022: ZF Friedrichshafen AG
 #       2022: ISTOS GmbH
-#       2022,2023: Bayerische Motoren Werke Aktiengesellschaft (BMW AG)
+#       2022,2024: Bayerische Motoren Werke Aktiengesellschaft (BMW AG)
 #       2022,2023: BOSCH AG
-# Copyright (c) 2021,2022,2023 Contributors to the Eclipse Foundation
+# Copyright (c) 2021,2024 Contributors to the Eclipse Foundation
 #
 # See the NOTICE file(s) distributed with this work for additional
 # information regarding copyright ownership.
@@ -18,7 +18,7 @@
 # under the License.
 #
 # SPDX-License-Identifier: Apache-2.0
-#
+
 apiVersion: v2
 name: irs-helm-local
 description: IRS Helm chart for local Kubernetes
diff --git a/local/deployment/irs-local/values.yaml b/local/deployment/irs-local/values.yaml
index 0e2b74461c..c78e7b77df 100644
--- a/local/deployment/irs-local/values.yaml
+++ b/local/deployment/irs-local/values.yaml
@@ -1,3 +1,24 @@
+# Copyright (c) 2022,2024
+#       2022: ZF Friedrichshafen AG
+#       2022: ISTOS GmbH
+#       2022,2024: Bayerische Motoren Werke Aktiengesellschaft (BMW AG)
+#       2022,2023: BOSCH AG
+# Copyright (c) 2021,2024 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Apache License, Version 2.0 which is available at
+# https://www.apache.org/licenses/LICENSE-2.0. *
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+#
+# SPDX-License-Identifier: Apache-2.0
+
 irs-helm:
   #####################
   # IRS Configuration #
@@ -28,7 +49,7 @@ irs-helm:
       memory: "500Mi"
     requests:
       cpu: "50m"
-      memory: "100Mi"
+      memory: "500Mi"
 
   #######################
   # Minio Configuration #

From a5e939a28f96701df97293ab644cb0c8528207b0 Mon Sep 17 00:00:00 2001
From: "Krzysztof Massalski (Extern)"
 <Krzysztof.Massalski@partner.doubleslash.de>
Date: Tue, 27 Feb 2024 14:44:57 +0100
Subject: [PATCH 22/24] feat(impl):[#312] update copyright

---
 Dockerfile                             | 6 +-----
 local/deployment/irs-local/Chart.yaml  | 6 +-----
 local/deployment/irs-local/values.yaml | 6 +-----
 3 files changed, 3 insertions(+), 15 deletions(-)

diff --git a/Dockerfile b/Dockerfile
index ad62273994..a6f0be30ea 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -1,8 +1,4 @@
-# Copyright (c) 2022,2024
-#       2022: ZF Friedrichshafen AG
-#       2022: ISTOS GmbH
-#       2022,2024: Bayerische Motoren Werke Aktiengesellschaft (BMW AG)
-#       2022,2023: BOSCH AG
+# Copyright (c) 2022,2024 Bayerische Motoren Werke Aktiengesellschaft (BMW AG)
 # Copyright (c) 2021,2024 Contributors to the Eclipse Foundation
 #
 # See the NOTICE file(s) distributed with this work for additional
diff --git a/local/deployment/irs-local/Chart.yaml b/local/deployment/irs-local/Chart.yaml
index c6992876b6..cd18449143 100644
--- a/local/deployment/irs-local/Chart.yaml
+++ b/local/deployment/irs-local/Chart.yaml
@@ -1,8 +1,4 @@
-# Copyright (c) 2022,2024
-#       2022: ZF Friedrichshafen AG
-#       2022: ISTOS GmbH
-#       2022,2024: Bayerische Motoren Werke Aktiengesellschaft (BMW AG)
-#       2022,2023: BOSCH AG
+# Copyright (c) 2022,2024 Bayerische Motoren Werke Aktiengesellschaft (BMW AG)
 # Copyright (c) 2021,2024 Contributors to the Eclipse Foundation
 #
 # See the NOTICE file(s) distributed with this work for additional
diff --git a/local/deployment/irs-local/values.yaml b/local/deployment/irs-local/values.yaml
index c78e7b77df..1efcafc82f 100644
--- a/local/deployment/irs-local/values.yaml
+++ b/local/deployment/irs-local/values.yaml
@@ -1,8 +1,4 @@
-# Copyright (c) 2022,2024
-#       2022: ZF Friedrichshafen AG
-#       2022: ISTOS GmbH
-#       2022,2024: Bayerische Motoren Werke Aktiengesellschaft (BMW AG)
-#       2022,2023: BOSCH AG
+# Copyright (c) 2022,2024 Bayerische Motoren Werke Aktiengesellschaft (BMW AG)
 # Copyright (c) 2021,2024 Contributors to the Eclipse Foundation
 #
 # See the NOTICE file(s) distributed with this work for additional

From 1811f32ad04d0f8dfbf99797458cd54f286a12ab Mon Sep 17 00:00:00 2001
From: "Krzysztof Massalski (Extern)"
 <Krzysztof.Massalski@partner.doubleslash.de>
Date: Tue, 27 Feb 2024 14:57:36 +0100
Subject: [PATCH 23/24] feat(impl):[#312] update copyright

---
 Dockerfile | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/Dockerfile b/Dockerfile
index a6f0be30ea..ad62273994 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -1,4 +1,8 @@
-# Copyright (c) 2022,2024 Bayerische Motoren Werke Aktiengesellschaft (BMW AG)
+# Copyright (c) 2022,2024
+#       2022: ZF Friedrichshafen AG
+#       2022: ISTOS GmbH
+#       2022,2024: Bayerische Motoren Werke Aktiengesellschaft (BMW AG)
+#       2022,2023: BOSCH AG
 # Copyright (c) 2021,2024 Contributors to the Eclipse Foundation
 #
 # See the NOTICE file(s) distributed with this work for additional

From dfd3cc4aad7a627abea5734a2925c96fab90907d Mon Sep 17 00:00:00 2001
From: Jaro Hartmann <57985712+ds-jhartmann@users.noreply.github.com>
Date: Tue, 27 Feb 2024 17:05:42 +0100
Subject: [PATCH 24/24] fix(concept):[#367] fix URL schema in version matrix

---
 .../#367-adapt-to-changes-industry-core.md                  | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/concept/#367-adapt-to-changes-of-industry-core/#367-adapt-to-changes-industry-core.md b/docs/concept/#367-adapt-to-changes-of-industry-core/#367-adapt-to-changes-industry-core.md
index c839bcbc1d..372aa549da 100644
--- a/docs/concept/#367-adapt-to-changes-of-industry-core/#367-adapt-to-changes-industry-core.md
+++ b/docs/concept/#367-adapt-to-changes-of-industry-core/#367-adapt-to-changes-industry-core.md
@@ -42,12 +42,12 @@ The product IRS MUST align with the Industry Code Standard CX-126 and CX-127.
 |---|---------|--------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------|
 | AAS |         |                                                              |                                                                                                                                                   |
 |PartAsPlanned | 2.0.0   | Mandatory             | [PartAsPlanned 2.0.0](https://github.com/eclipse-tractusx/sldt-semantic-models/tree/main/io.catenax.part_as_planned/2.0.0)                        |
-| SingleLevelBomAsPlanned| 2.0.0   | Mandatory              | [SingleLevelBomAsPlanned 2.0.0](https://github.com/eclipse-tractusx/sldt-semantic-models/tree/main/io.catenax.single_level_bom_as_planned/2.2.0)  |
-| SerialPart| 3.0.0   | Mandatory                                                    | [SerialPart 3.0.0](https://github.com/eclipse-tractusx/sldt-semantic-models/tree/main/io.catenax.serial_part/3.0.0/gen)                           |
+| SingleLevelBomAsPlanned| 2.0.0   | Mandatory              | [SingleLevelBomAsPlanned 2.0.0](https://github.com/eclipse-tractusx/sldt-semantic-models/tree/main/io.catenax.single_level_bom_as_planned/2.0.0)  |
+| SerialPart| 3.0.0   | Mandatory                                                    | [SerialPart 3.0.0](https://github.com/eclipse-tractusx/sldt-semantic-models/tree/main/io.catenax.serial_part/3.0.0)                           |
 | Batch| 3.0.0   | Mandatory                                                    | [Batch 3.0.0](https://github.com/eclipse-tractusx/sldt-semantic-models/tree/main/io.catenax.batch/3.0.0)                                          |
 | JustInSequencePart| 3.0.0   | Mandatory                                                     | [JustInSequencePart 3.0.0](https://github.com/eclipse-tractusx/sldt-semantic-models/tree/main/io.catenax.just_in_sequence_part/3.0.0)             |
 | SingleLevelBomAsBuilt| 2.0.0   | Mandatory                                                    | [SingleLevelBomAsBuilt 2.0.0](https://github.com/eclipse-tractusx/sldt-semantic-models/tree/main/io.catenax.single_level_bom_as_built/2.0.0)      |
-| PartSiteInformationAsBuilt| 1.0.0   | Integrated in Aspects JustInSequencePart / Batch / SerialPart | https://github.com/eclipse-tractusx/sldt-semantic-models/tree/main/io.catenax.shared.part_site_information_as_built/1.0.0                         |
+| PartSiteInformationAsBuilt| 1.0.0   | Integrated in Aspects JustInSequencePart / Batch / SerialPart | [PartSiteInformationAsBuilt 1.0.0](https://github.com/eclipse-tractusx/sldt-semantic-models/tree/main/io.catenax.shared.part_site_information_as_built/1.0.0)                         |
 
 
 - JustInSequencePart:  https://github.com/eclipse-tractusx/sldt-semantic-models/pull/563