Merge branch 'main' into develop

src/openapi/contracts/contracts-se.yaml

@@ -235,6 +235,136 @@ paths:
                     "isCredit": false,
                   },
                 ]
+  /contracts/{contractId}/cancellationmoments:
+    parameters:
+      - in: header
+        name: X-HTM-JWT-AUTH-HEADER
+        schema:
+          type: string
+          example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
+        required: true
+        description: The JWT of the logged in customer.
+      - in: path
+        name: contractId
+        schema:
+          type: string
+          format: uuid
+          example: 9e224750-3065-471d-af57-85b9cffa7c89
+        required: true
+        description: The id of the contract to process.
+    get:
+      summary: Get all cancellation moments for a given contract.
+      description: Get all cancellation moments for a given contract.
+      tags:
+        - SE Contract Cancellation v2
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/unavailable"
+              example:
+                {
+                  "cancellationMoment": "termBound", 
+                  "termDuration": "P1M",
+                  "billingDay": 18,
+                  "cancellationFrom": "2024-08-10T00:00:00",
+                  "cancellationUntil": "2026-08-10T00:00:00"
+                }
+  /contracts/{contractId}/cancellationvalidation:
+    parameters:
+      - in: header
+        name: X-HTM-JWT-AUTH-HEADER
+        schema:
+          type: string
+          example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
+        required: true
+        description: The JWT of the logged in customer.
+      - in: path
+        name: contractId
+        schema:
+          type: string
+          format: uuid
+          example: 9e224750-3065-471d-af57-85b9cffa7c89
+        required: true
+        description: The id of the contract to process.
+    post:
+      summary: Validate a cancellation for a given contract.
+      description: Validate a cancellation for a given contract.
+      tags:
+        - SE Contract Cancellation v2
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/unavailable"
+            example:
+              {
+                "end": "2024-08-10T00:00:00"
+              }
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/unavailable"
+              example:
+                {
+                  "validationResult": "true",
+                  "validationMessage": "",
+                  "end": "2024-08-10T03:59:59",
+                  "refundAmount": "2489",
+                  "refundMethods": [ "creditInvoice", "iDeal" ]
+                }
+  /contracts/{contractId}/cancellation:
+    parameters:
+      - in: header
+        name: X-HTM-JWT-AUTH-HEADER
+        schema:
+          type: string
+          example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
+        required: true
+        description: The JWT of the logged in customer.
+      - in: path
+        name: contractId
+        schema:
+          type: string
+          format: uuid
+          example: 9e224750-3065-471d-af57-85b9cffa7c89
+        required: true
+        description: The id of the contract to process.
+    post:
+      summary: Cancel a contract.
+      description: Cancel a contract.
+      tags:
+        - SE Contract Cancellation v2
+      requestBody:
+        required: true
+        content: 
+          application/json:
+            schema:
+              $ref: "#/components/schemas/unavailable"
+            example:
+              {
+                "end": "2024-08-10T00:00:00",
+                "refundMethod": "creditInvoice"
+              }
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/unavailable"
+              example:
+                {
+                  "end": "2024-08-10T03:59:59",
+                  "refundAmount": "2489",
+                  "refundMethod": "creditInvoice"
+                }
 components:
   securitySchemes:
     bearerToken:

src/openapi/fiko/fiko-crud.yaml

@@ -123,6 +123,8 @@ paths:
               schema:
                 $ref: "#/components/schemas/unavailable"
               example:
+                {
+                  "transactionItems":
                     [
                       {
                         "transactionItemId": "afce35b2-1dff-4ace-98d0-4b9ac405c87d",
@@ -141,7 +143,26 @@ paths:
                         "aggregationReference": "FIKO-123456",
                         "accountingSystemReference": "U4F-123456",
                       },
-                ]
+                      {
+                        "transactionItemId": "e63cc37b-4d87-4278-8eb5-1477e07edf3d",
+                        "sourceName": "Verkoopengine",
+                        "transactionId": "1001237",
+                        "transactionLineId": "1",
+                        "name": "HTM Maandkorting 20%",
+                        "quantity": 1,
+                        "taxCode": "V21",
+                        "amountExclTax": 100,
+                        "amountInclTax": 121,
+                        "amountTax": 21,
+                        "occurredOn": "2024-10-04T00:05:00Z",
+                        "type": "debit",
+                        "productCode": "HTM-MND-20",
+                        "aggregationReference": "FIKO-123456",
+                        "accountingSystemReference": "U4F-123456",
+                      },
+                    ],
+                  "href": null,
+                }
     post:
       summary: Add a finanicial transaction item.
       description: Add a finanicial transaction item.
@@ -153,7 +174,23 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/unavailable"
-            example: "TBD"
+            example:
+              {
+                "sourceName": "Verkoopengine",
+                "transactionId": "1001236",
+                "transactionLineId": "1",
+                "name": "HTM Maandkorting 20%",
+                "quantity": 1,
+                "taxCode": "V21",
+                "amountExclTax": 100,
+                "amountInclTax": 121,
+                "amountTax": 21,
+                "occurredOn": "2024-10-04T00:00:00Z",
+                "type": "debit",
+                "productCode": "HTM-MND-20",
+                "aggregationReference": "FIKO-123456",
+                "accountingSystemReference": "U4F-123456",
+              }
       responses:
         "201":
           description: Created
@@ -163,6 +200,69 @@ paths:
                 $ref: "#/components/schemas/unavailable"
               example:
                 { "transactionItemId": "afce35b2-1dff-4ace-98d0-4b9ac405c87d" }
+  /transactionitems/bulk:
+    post:
+      summary: Add one ore more finanicial transaction items in bulk.
+      description: Add one ore more finanicial transaction items in bulk.
+      tags:
+        - Transactions v2
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/unavailable"
+            example:
+              [
+                {
+                  "sourceName": "Verkoopengine",
+                  "transactionId": "1001236",
+                  "transactionLineId": "1",
+                  "name": "HTM Maandkorting 20%",
+                  "quantity": 1,
+                  "taxCode": "V21",
+                  "amountExclTax": 100,
+                  "amountInclTax": 121,
+                  "amountTax": 21,
+                  "occurredOn": "2024-10-04T00:00:00Z",
+                  "type": "debit",
+                  "productCode": "HTM-MND-20",
+                  "aggregationReference": null,
+                  "accountingSystemReference": null,
+                },
+                {
+                  "sourceName": "Verkoopengine",
+                  "transactionId": "1001237",
+                  "transactionLineId": "1",
+                  "name": "HTM Maandkorting 20%",
+                  "quantity": 1,
+                  "taxCode": "V21",
+                  "amountExclTax": 100,
+                  "amountInclTax": 121,
+                  "amountTax": 21,
+                  "occurredOn": "2024-10-04T00:05:00Z",
+                  "type": "debit",
+                  "productCode": "HTM-MND-20",
+                  "aggregationReference": null,
+                  "accountingSystemReference": null,
+                },
+              ]
+      responses:
+        "201":
+          description: Created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/unavailable"
+              example:
+                [
+                  {
+                    "transactionItemId": "afce35b2-1dff-4ace-98d0-4b9ac405c87d",
+                  },
+                  {
+                    "transactionItemId": "e63cc37b-4d87-4278-8eb5-1477e07edf3d",
+                  },
+                ]
   /transactionitems/{transactionItemId}:
     parameters:
       - in: path
@@ -228,7 +328,7 @@ paths:
                 "documentCode": "VERK_FACTUUR",
                 "accountingPeriod": "2024/10",
                 "transactionDescription": "Dagkaart",
-                "contraAccount": "220.10419",
+                "contraAccountNumber": "220.10419",
                 "status": "open",
                 "occurence": 1,
                 "processingFailureInstances":
@@ -362,6 +462,8 @@ paths:
               schema:
                 $ref: "#/components/schemas/unavailable"
               example:
+                {
+                  "transactionAuditTrails":
                     [
                       {
                         "transactionAuditTrailId": "afce35b2-1dff-4ace-98d0-4b9ac405c87d",
@@ -372,7 +474,18 @@ paths:
                         "description": "Transaction created.",
                         "correlationId": "a3891560-3084-42cb-867c-f289e7cda47d",
                       },
-                ]
+                      {
+                        "transactionAuditTrailId": "e63cc37b-4d87-4278-8eb5-1477e07edf3d",
+                        "transactionItemId": "d667d293-aa82-4c9e-9b10-77cffc9058a1",
+                        "user": "fiko",
+                        "timestamp": "2022-01-01 00:01:00",
+                        "action": "processed",
+                        "description": "Transaction processed.",
+                        "correlationId": "3e9d7d4b-8adf-4e7f-8251-be308f16d3de",
+                      },
+                    ],
+                  "href": null,
+                }
   /processingfailures:
     get:
       summary: Find processing failures.
@@ -472,6 +585,8 @@ paths:
               schema:
                 $ref: "#/components/schemas/unavailable"
               example:
+                {
+                  "processingFailures":
                     [
                       {
                         "processingFailureId": "37a8095b-19db-498f-9349-5f37d21c5bdf",
@@ -483,7 +598,7 @@ paths:
                         "documentCode": "VERK_FACTUUR",
                         "accountingPeriod": "2024/10",
                         "transactionDescription": "Dagkaart",
-                    "contraAccount": "220.10419",
+                        "contraAccountNumber": "220.10419",
                         "status": "open",
                         "occurence": 1,
                         "processingFailureInstances":
@@ -504,7 +619,9 @@ paths:
                             },
                           ],
                       },
-                ]
+                    ],
+                  "href": null,
+                }
   /processingfailures/{processingFailureId}:
     parameters:
       - in: path
@@ -709,6 +826,9 @@ paths:
               schema:
                 $ref: "#/components/schemas/unavailable"
               example:
+                {
+                  "productMetadata":
+                    [
                       {
                         "productMetadataId": "39a87c2a-9011-4dfd-b35e-1245a98c2e61",
                         "productCode": "4031",
@@ -726,11 +846,13 @@ paths:
                               "contraAccountMetadata":
                                 {
                                   "contraAccountMetadataId": "e0af8c8f-d421-4567-a14e-48e2a1bb86fb",
-                            "contraAccount": "220.10419",
+                                  "contraAccountCode": "123456",
+                                  "contraAccountNumber": "220.10419",
                                   "validFrom": "2024-03-22T09:00:00",
                                   "validUntil": null,
                                 },
-                        "concession": { "concessionId": 2, "name": "bus" },
+                              "concession":
+                                { "concessionId": 2, "name": "bus" },
                               "sourceMetadata":
                                 {
                                   "sourceMetadataId": "bc4ea24a-27a5-40e8-bbbc-57a105afaaa0",
@@ -750,11 +872,13 @@ paths:
                               "contraAccountMetadata":
                                 {
                                   "contraAccountMetadataId": "69c562ca-5299-4585-ac92-46fb54aeb99e",
-                            "contraAccount": "220.10538",
+                                  "contraAccountCode": "123456",
+                                  "contraAccountNumber": "220.10419",
                                   "validFrom": "2024-03-22T09:00:00",
                                   "validUntil": null,
                                 },
-                        "concession": { "concessionId": 1, "name": "bus" },
+                              "concession":
+                                { "concessionId": 1, "name": "bus" },
                               "sourceMetadata":
                                 {
                                   "sourceMetadataId": "bc4ea24a-27a5-40e8-bbbc-57a105afaaa0",
@@ -771,6 +895,9 @@ paths:
                               "validUntil": null,
                             },
                           ],
+                      },
+                    ],
+                  "href": null,
                 }
     post:
       summary: Add product metadata.
@@ -929,13 +1056,14 @@ paths:
                 "user": "rmeeuws",
                 "timestamp": "2024-10-04T00:00:00",
                 "correlationId": "a03cd0c2-38b5-4619-b9e3-d6e5b842e127",
-                "metadataChanges": [
+                "metadataChanges":
+                  [
                     {
                       "fieldName": "department",
                       "oldValue": "900",
                       "newValue": "999",
-                  }
+                    },
-                ]
+                  ],
               }
       responses:
         "201":
@@ -959,11 +1087,17 @@ paths:
             example: 37a8095b-19db-498f-9349-5f37d21c5bdf
           description: The id of the contra account metadata.
         - in: query
-          name: contraAccount
+          name: contraAccountCode
+          schema:
+            type: string
+            example: 123456
+          description: The code of the contra account.
+        - in: query
+          name: contraAccountNumber
           schema:
             type: string
             example: 220.10419
-          description: The contra account.
+          description: The number of the contra account.
         - in: query
           name: validAt
           schema:
@@ -979,14 +1113,19 @@ paths:
               schema:
                 $ref: "#/components/schemas/unavailable"
               example:
+                {
+                  "contraAccountMetadata":
                     [
                       {
                         "contraAccountMetadataId": "37a8095b-19db-498f-9349-5f37d21c5bdf",
-                    "contraAccount": "220.10419",
+                        "contraAccountCode": "123456",
+                        "contraAccountNumber": "220.10419",
                         "validFrom": "2024-03-22T09:00:00",
                         "validUntil": null,
                       },
-                ]
+                    ],
+                  "href": null,
+                }
     post:
       summary: Add contra account metadata.
       description: Add contra account metadata.
@@ -1000,7 +1139,8 @@ paths:
               $ref: "#/components/schemas/unavailable"
             example:
               {
-                "contraAccount": "220.10419",
+                "contraAccountCode": "123456",
+                "contraAccountNumber": "220.10419",
                 "validFrom": "2024-03-22T09:00:00",
                 "validUntil": null,
               }
@@ -1038,7 +1178,7 @@ paths:
               $ref: "#/components/schemas/unavailable"
             example:
               {
-                "contraAccount": "220.10419",
+                "contraAccountNumber": "220.10419",
                 "validFrom": "2024-03-22T09:00:00",
                 "validUntil": null,
               }
@@ -1079,13 +1219,14 @@ paths:
                 "user": "rmeeuws",
                 "timestamp": "2024-10-04T00:00:00",
                 "correlationId": "a03cd0c2-38b5-4619-b9e3-d6e5b842e127",
-                "metadataChanges": [
+                "metadataChanges":
+                  [
                     {
                       "fieldName": "contraAccountMetadataId",
                       "oldValue": "873810a3-a11a-4d4d-9af7-395520fa207c",
                       "newValue": "9a8eb116-5270-4ef9-81ef-fdc2e72c281a",
-                  }
+                    },
-                ]
+                  ],
               }
       responses:
         "201":
@@ -1141,6 +1282,8 @@ paths:
               schema:
                 $ref: "#/components/schemas/unavailable"
               example:
+                {
+                  "taxMetadata":
                     [
                       {
                         "taxMetadataId": "bc4ea24a-27a5-40e8-bbbc-57a105afaaa0",
@@ -1166,7 +1309,9 @@ paths:
                         "validFrom": "2024-01-01T00:00:00.000",
                         "validUntil": null,
                       },
-                ]
+                    ],
+                  "href": null,
+                }
     post:
       summary: Add tax metadata.
       description: Add tax metadata.
@@ -1259,13 +1404,14 @@ paths:
                 "user": "rmeeuws",
                 "timestamp": "2024-10-04T00:00:00",
                 "correlationId": "a03cd0c2-38b5-4619-b9e3-d6e5b842e127",
-                "metadataChanges": [
+                "metadataChanges":
+                  [
                     {
                       "fieldName": "taxCode",
                       "oldValue": null,
                       "newValue": "V21",
-                  }
+                    },
-                ]
+                  ],
               }
       responses:
         "201":
@@ -1338,6 +1484,8 @@ paths:
               schema:
                 $ref: "#/components/schemas/unavailable"
               example:
+                {
+                  "sourceMetadata":
                     [
                       {
                         "sourceMetadataId": "bc4ea24a-27a5-40e8-bbbc-57a105afaaa0",
@@ -1350,7 +1498,9 @@ paths:
                         "validFrom": "2024-01-01T00:00:00.000",
                         "validUntil": null,
                       },
-                ]
+                    ],
+                  "href": null,
+                }
     post:
       summary: Add source metadata.
       description: Add source metadata.
@@ -1449,13 +1599,14 @@ paths:
                 "user": "rmeeuws",
                 "timestamp": "2024-10-04T00:00:00",
                 "correlationId": "a03cd0c2-38b5-4619-b9e3-d6e5b842e127",
-                "metadataChanges": [
+                "metadataChanges":
+                  [
                     {
                       "fieldName": "businessOwner",
                       "oldValue": "Corneel Verstoep",
                       "newValue": "Mark Verheij",
-                  }
+                    },
-                ]
+                  ],
               }
       responses:
         "201":
@@ -1498,13 +1649,22 @@ paths:
               schema:
                 $ref: "#/components/schemas/unavailable"
               example:
+                {
+                  "accountingPeriodMetadata":
                     [
                       {
                         "accountingPeriodMetadataId": "37a8095b-19db-498f-9349-5f37d21c5bdf",
                         "accountingPeriod": "2024-01",
+                        "isOpen": false,
+                      },
+                      {
+                        "accountingPeriodMetadataId": "0302c651-f040-4cbc-8a4d-90dc82f29a32",
+                        "accountingPeriod": "2024-02",
                         "isOpen": true,
                       },
-                ]
+                    ],
+                  "href": null,
+                }
     post:
       summary: Add accounting period metadata.
       description: Add accounting period metadata.
@@ -1587,13 +1747,14 @@ paths:
                 "user": "rmeeuws",
                 "timestamp": "2024-10-04T00:00:00",
                 "correlationId": "a03cd0c2-38b5-4619-b9e3-d6e5b842e127",
-                "metadataChanges": [
+                "metadataChanges":
+                  [
                     {
                       "fieldName": "isOpen",
                       "oldValue": "true",
                       "newValue": "false",
-                  }
+                    },
-                ]
+                  ],
               }
       responses:
         "201":
@@ -1644,6 +1805,8 @@ paths:
               schema:
                 $ref: "#/components/schemas/unavailable"
               example:
+                {
+                  "concessionMetadata":
                     [
                       {
                         "concessionMetadataId": "37a8095b-19db-498f-9349-5f37d21c5bdf",
@@ -1659,7 +1822,9 @@ paths:
                         "validFrom": "2024-01-01T00:00:00.000",
                         "validUntil": null,
                       },
-                ]
+                    ],
+                  "href": null,
+                }
     post:
       summary: Add concession metadata.
       description: Add concession metadata.
@@ -1754,7 +1919,8 @@ paths:
                 "user": "rmeeuws",
                 "timestamp": "2024-10-04T00:00:00",
                 "correlationId": "a03cd0c2-38b5-4619-b9e3-d6e5b842e127",
-                "metadataChanges": [
+                "metadataChanges":
+                  [
                     {
                       "fieldName": "percentage",
                       "oldValue": null,
@@ -1857,6 +2023,9 @@ paths:
               schema:
                 $ref: "#/components/schemas/unavailable"
               example:
+                {
+                  "metadataAuditTrails":
+                    [
                       {
                         "metadataAuditTrailId": "37a8095b-19db-498f-9349-5f37d21c5bdf",
                         "productMetadataId": "37a8095b-19db-498f-9349-5f37d21c5bdf",
@@ -1877,6 +2046,9 @@ paths:
                               "newValue": "Jan-Willem Vermeij",
                             },
                           ],
+                      },
+                    ],
+                  "href": null,
                 }
   /concessions:
     get:
@@ -1892,11 +2064,15 @@ paths:
               schema:
                 $ref: "#/components/schemas/unavailable"
               example:
+                {
+                  "concessions":
                     [
                       { "concessionId": 1, "name": "rail" },
                       { "concessionId": 2, "name": "bus" },
                       { "concessionId": 3, "name": "not_applicable" },
-                ]
+                    ],
+                  "href": null,
+                }
   /failurereasons:
     get:
       summary: Get all failure reasons.
@@ -1911,6 +2087,8 @@ paths:
               schema:
                 $ref: "#/components/schemas/unavailable"
               example:
+                {
+                  "failureReasons":
                     [
                       {
                         "failureReasonId": 1,
@@ -1922,7 +2100,9 @@ paths:
                         "reasonCode": "003",
                         "reasonDesc": "Accouting period closed",
                       },
-                ]
+                    ],
+                  "href": null,
+                }
 components:
   securitySchemes:
     bearerToken:

src/openapi/products/purchased_products-crud.yaml

@@ -21,7 +21,7 @@ paths:
           required: false
           description: The technical id of the product.
         - in: query
-          name: createdBefore
+          name: createdOnBefore
           schema:
             type: string
             format: date-time
@@ -29,7 +29,7 @@ paths:
           required: false
           description: The purchased product should be created before this timestamp.
         - in: query
-          name: createdAfter
+          name: createdOnAfter
           schema:
             type: string
             format: date-time
@@ -37,7 +37,7 @@ paths:
           required: false
           description: The purchased product should be created after this timestamp.
         - in: query
-          name: lastUpdatedBefore
+          name: lastUpdatedOnBefore
           schema:
             type: string
             format: date-time
@@ -45,7 +45,7 @@ paths:
           required: false
           description: The purchased product should be last updated before this timestamp.
         - in: query
-          name: lastUpdatedAfter
+          name: lastUpdatedOnAfter
           schema:
             type: string
             format: date-time
@@ -53,14 +53,14 @@ paths:
           required: false
           description: The purchased product should be last updated after this timestamp.
         - in: query
-          name: resrouceName
+          name: resourceName
           schema:
             type: string
             example: orders
           required: false
           description: The name of the resource.
         - in: query
-          name: resrouceIdentifier
+          name: resourceIdentifier
           schema:
             type: string
             example: f461004f-d98e-4323-aa26-f09bf8ea2f2d
@@ -74,6 +74,8 @@ paths:
               schema:
                 $ref: "#/components/schemas/unavailable"
               example:
+                {
+                  "purchasedProducts":
                     [
                       {
                         "purchasedProductId": "45573af8-a9aa-4f7c-95f4-b1971bf2c3c6",
@@ -101,16 +103,24 @@ paths:
                               "purchasedGboProductId": "a9b3dea5-fb8a-4b1e-9fe6-90cad31c0cfd",
                               "salesTimestamp": "2024-10-04T12:34:56.000",
                               "refundTimestamp": "2024-10-04T12:34:56.000",
+                              "fromInclusive": "2024-10-04T12:34:56.000",
+                              "untilInclusive": "2024-10-04T12:34:56.000",
                               "packageTemplateId": "30003",
                               "xBot": "f15efe6f-7353-4968-b134-60ba6fc2da8b",
                               "xTat": "42efebf7-132e-4ee0-9cbb-4037a9a54ad8",
                               "xSpit": "d67b2f72-918a-4e6c-957d-a39ed9c9e16b",
                               "customerTokenId": "b6492322-c458-4857-9ac3-a109c1887b9f",
                               "ovPayTokenId": 13,
+                              "createdOn": "2024-10-04T12:34:56.000",
+                              "lastUpdatedOn": "2024-10-04T12:34:56.000",
+                              "createdBy": "someuser",
+                              "lastUpdatedBy": null,
                             },
                           ],
                       },
-                ]
+                    ],
+                  "href": null,
+                }
     post:
       tags:
         - Purchased Product
@@ -130,12 +140,11 @@ paths:
                 "purchasedProductResources":
                   [
                     {
-                      "resourceName":
+                      "resourceNameId": 1,
-                        { "resourceNameId": 1, "name": "contracts" },
                       "resourceIdentifier": "408eefa9-b393-4bb3-8439-b2e51833abc7",
                     },
                     {
-                      "resourceName": { "resourceNameId": 2, "name": "orders" },
+                      "resourceNameId": 2,
                       "resourceIdentifier": "f809a6e1-1c8d-4f8e-8a6e-0d0b1e1e1e1e",
                     },
                   ],
@@ -144,12 +153,18 @@ paths:
                     {
                       "salesTimestamp": "2024-10-04T12:34:56.000",
                       "refundTimestamp": "2024-10-04T12:34:56.000",
+                      "fromInclusive": "2024-10-04T12:34:56.000",
+                      "untilInclusive": "2024-10-04T12:34:56.000",
                       "packageTemplateId": "30003",
                       "xBot": "f15efe6f-7353-4968-b134-60ba6fc2da8b",
                       "xTat": "42efebf7-132e-4ee0-9cbb-4037a9a54ad8",
                       "xSpit": "d67b2f72-918a-4e6c-957d-a39ed9c9e16b",
                       "customerTokenId": "b6492322-c458-4857-9ac3-a109c1887b9f",
                       "ovPayTokenId": 13,
+                      "createdOn": "2024-10-04T12:34:56.000",
+                      "lastUpdatedOn": "2024-10-04T12:34:56.000",
+                      "createdBy": "someuser",
+                      "lastUpdatedBy": null,
                     },
                   ],
               }
@@ -208,12 +223,18 @@ paths:
                       {
                         "salesTimestamp": "2024-10-04T12:34:56.000",
                         "refundTimestamp": "2024-10-04T12:34:56.000",
+                        "fromInclusive": "2024-10-04T12:34:56.000",
+                        "untilInclusive": "2024-10-04T12:34:56.000",
                         "packageTemplateId": "30003",
                         "xBot": "f15efe6f-7353-4968-b134-60ba6fc2da8b",
                         "xTat": "42efebf7-132e-4ee0-9cbb-4037a9a54ad8",
                         "xSpit": "d67b2f72-918a-4e6c-957d-a39ed9c9e16b",
                         "customerTokenId": "b6492322-c458-4857-9ac3-a109c1887b9f",
                         "ovPayTokenId": 13,
+                        "createdOn": "2024-10-04T12:34:56.000",
+                        "lastUpdatedOn": "2024-10-04T12:34:56.000",
+                        "createdBy": "someuser",
+                        "lastUpdatedBy": null,
                       },
                     ],
                 }
@@ -261,7 +282,7 @@ paths:
               $ref: "#/components/schemas/unavailable"
             example:
               {
-                "resourceName": 1,
+                "resourceNameId": 1,
                 "resourceIdentifier": "502d2e0d-4e3b-4a7e-9f6e-0d0b1e1e1e1e",
               }
       responses:
@@ -300,12 +321,18 @@ paths:
               {
                 "salesTimestamp": "2024-10-04T12:34:56.000",
                 "refundTimestamp": "2024-10-04T12:34:56.000",
+                "fromInclusive": "2024-10-04T12:34:56.000",
+                "untilInclusive": "2024-10-04T12:34:56.000",
                 "packageTemplateId": "30003",
                 "xBot": "f15efe6f-7353-4968-b134-60ba6fc2da8b",
                 "xTat": "42efebf7-132e-4ee0-9cbb-4037a9a54ad8",
                 "xSpit": "d67b2f72-918a-4e6c-957d-a39ed9c9e16b",
                 "customerTokenId": "b6492322-c458-4857-9ac3-a109c1887b9f",
                 "ovPayTokenId": 13,
+                "createdOn": "2024-10-04T12:34:56.000",
+                "lastUpdatedOn": "2024-10-04T12:34:56.000",
+                "createdBy": "someuser",
+                "lastUpdatedBy": null,
               }
       responses:
         "201":
@@ -367,6 +394,34 @@ paths:
             format: date-time
             example: 2024-10-04T12:34:56.000
           description: The purchased GBO product should be refunded after this timestamp.
+        - in: query
+          name: fromInclusiveBefore
+          schema:
+            type: string
+            format: date-time
+            example: 2024-10-04T12:34:56.000
+          description: The purchased GBO product should be valid before this timestamp.
+        - in: query
+          name: fromInclusiveAfter
+          schema:
+            type: string
+            format: date-time
+            example: 2024-10-04T12:34:56.000
+          description: The purchased GBO product should be valid after this timestamp.
+        - in: query
+          name: untilInclusiveBefore
+          schema:
+            type: string
+            format: date-time
+            example: 2024-10-04T12:34:56.000
+          description: The purchased GBO product should be valid before this timestamp.
+        - in: query
+          name: untilInclusiveAfter
+          schema:
+            type: string
+            format: date-time
+            example: 2024-10-04T12:34:56.000
+          description: The purchased GBO product should be valid after this timestamp.
         - in: query
           name: packageTemplateId
           schema:
@@ -408,6 +463,46 @@ paths:
             type: integer
             example: 13
           description: The id of the ov pay token.
+        - in: query
+          name: createdOnBefore
+          schema:
+            type: string
+            format: date-time
+            example: 2024-10-04T12:34:56.000
+          description: The purchased GBO product should be created before this timestamp.
+        - in: query
+          name: createdOnAfter
+          schema:
+            type: string
+            format: date-time
+            example: 2024-10-04T12:34:56.000
+          description: The purchased GBO product should be created after this timestamp.
+        - in: query
+          name: lastUpdatedOnBefore
+          schema:
+            type: string
+            format: date-time
+            example: 2024-10-04T12:34:56.000
+          description: The purchased GBO product should be updated before this timestamp.
+        - in: query
+          name: lastUpdatedOnAfter
+          schema:
+            type: string
+            format: date-time
+            example: 2024-10-04T12:34:56.000
+          description: The purchased GBO product should be updated after this timestamp.
+        - in: query
+          name: createdBy
+          schema:
+            type: string
+            example: someuser
+          description: The user that created the purchased GBO product.
+        - in: query
+          name: lastUpdatedBy
+          schema:
+            type: string
+            example: someuser
+          description: The user that last updated the purchased GBO product.
       responses:
         "201":
           description: Created
@@ -416,32 +511,48 @@ paths:
               schema:
                 $ref: "#/components/schemas/unavailable"
               example:
+                {
+                  "purchasedGboProducts":
                     [
                       {
                         "purchasedGboProductId": "a9b3dea5-fb8a-4b1e-9fe6-90cad31c0cfd",
                         "purchasedProductId": "9e166bb3-806a-4f43-a7a2-0d5b1e90e0c3",
                         "salesTimestamp": "2024-10-04T12:34:56.000",
                         "refundTimestamp": "2024-10-05T12:34:56.000",
+                        "fromInclusive": "2024-10-04T12:34:56.000",
+                        "untilInclusive": "2024-10-05T12:34:56.000",
                         "packageTemplateId": "30003",
                         "xBot": "f15efe6f-7353-4968-b134-60ba6fc2da8b",
                         "xTat": "42efebf7-132e-4ee0-9cbb-4037a9a54ad8",
                         "xSpit": "d67b2f72-918a-4e6c-957d-a39ed9c9e16b",
                         "customerTokenId": "b6492322-c458-4857-9ac3-a109c1887b9f",
                         "ovPayTokenId": 13,
+                        "createdOn": "2024-10-04T12:34:56.000",
+                        "lastUpdatedOn": "2024-10-04T12:34:56.000",
+                        "createdBy": "someuser",
+                        "lastUpdatedBy": null,
                       },
                       {
                         "purchasedGboProductId": 431e481f-4330-4ad4-be47-393db38cfe38,
                         "purchasedProductId": "9e166bb3-806a-4f43-a7a2-0d5b1e90e0c3",
                         "salesTimestamp": "2024-10-05T12:34:56.000",
                         "refundTimestamp": "2024-10-06T12:34:56.000",
+                        "fromInclusive": "2024-10-05T12:34:56.000",
+                        "untilInclusive": "2024-10-06T12:34:56.000",
                         "packageTemplateId": "30003",
                         "xBot": "f8f13d64-fd07-44e8-9c85-968857da5d68",
                         "xTat": "01a82ebe-5d07-45d8-a897-66152e8954dd",
                         "xSpit": "c3868858-b250-4480-9cb4-725d2e9198f3",
                         "customerTokenId": "6c7a6d4b-7e6c-4f6a-9b1e-0a9b1e6c7a6d",
                         "ovPayTokenId": 14,
+                        "createdOn": "2024-10-05T12:34:56.000",
+                        "lastUpdatedOn": "2024-10-05T12:34:56.000",
+                        "createdBy": "someuser",
+                        "lastUpdatedBy": null,
                       },
-                ]
+                    ],
+                  "href": null,
+                }
   /purchasedgboproducts/{purchasedGboProductId}:
     parameters:
       - in: path
@@ -463,7 +574,12 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/unavailable"
-            example: { "refundTimestamp": "2024-10-05T12:34:56.000" }
+            example:
+              {
+                "refundTimestamp": "2024-10-05T12:34:56.000",
+                "lastUpdatedOn": "2024-10-05T12:34:56.000",
+                "lastUpdatedBy": "someuser",
+              }
       responses:
         "201":
           description: Created
@@ -472,7 +588,9 @@ paths:
               schema:
                 $ref: "#/components/schemas/unavailable"
               example:
-                { "purchasedGboProductId": "a9b3dea5-fb8a-4b1e-9fe6-90cad31c0cfd" }
+                {
+                  "purchasedGboProductId": "a9b3dea5-fb8a-4b1e-9fe6-90cad31c0cfd",
+                }
 components:
   securitySchemes:
     bearerToken: