From cf7dcc8dd463d76452e6d2f5c1b351e53b128e7a Mon Sep 17 00:00:00 2001
From: Max Martens <max.martens@intraffic.nl>
Date: Fri, 27 Mar 2026 11:22:48 +0100
Subject: [PATCH] Add serviceId in purchasedProducts CRUD API

---
 src/openapi/customers/SE-customers-v2.yaml    |  8 ++++----
 src/openapi/orders/orders-crud.yaml           |  1 -
 .../products/purchased_products-crud.yaml     | 19 ++++++++++++++++---
 3 files changed, 20 insertions(+), 8 deletions(-)

diff --git a/src/openapi/customers/SE-customers-v2.yaml b/src/openapi/customers/SE-customers-v2.yaml
index 7aeeffa..f42ed6b 100644
--- a/src/openapi/customers/SE-customers-v2.yaml
+++ b/src/openapi/customers/SE-customers-v2.yaml
@@ -3402,7 +3402,7 @@ paths:
                             "orderId": "501B17EF-36C4-4039-B92C-6517969B464E",
                             "orderLineId": "38B17EF-36C4-4039-B92C-4817969B464E",                            
                             "ticketReference": "KJj43nejhbTxhrfef287",
-                            "serviceId": "DEF-4321-7654-7659",
+                            "serviceId": "HTM-4321-7654-7659",
                             "issuedAt": "2026-03-21T09:01:35",
                             "activatedAt": null,
                             "blocked": false,
@@ -3435,7 +3435,7 @@ paths:
                             "orderId": "501B17EF-36C4-4039-B92C-6517969B464E",
                             "orderLineId": "38B17EF-36C4-4039-B92C-4817969B464E",                            
                             "ticketReference": "KJj43nejhbTxhr897287",
-                            "serviceId": "ABC-1234-7654-8945",
+                            "serviceId": "HTM-1234-7654-8945",
                             "issuedAt": "2026-03-21T10:01:12",
                             "activatedAt": "2026-03-21T12:45:01",
                             "blocked": false,
@@ -3610,7 +3610,7 @@ paths:
                             "orderId": "501B17EF-36C4-4039-B92C-6517969B464E",
                             "orderLineId": "38B17EF-36C4-4039-B92C-4817969B464E",
                             "ticketReference": "KJj43nejhbTxhr897287",
-                            "serviceId": "ABC-1234-7654-8945",
+                            "serviceId": "HTM-1234-7654-8945",
                             "issuedAt": "2026-03-21T10:01:12",
                             "activatedAt": "2026-03-21T12:45:01",
                             "blocked": false,
@@ -4442,7 +4442,7 @@ components:
                     example: KJj43nejhbTxhr897287
                   serviceId:
                     type: string
-                    example: ABC-1234-7654-8945
+                    example: HTM-1234-7654-8945
                   issuedAt:
                     type: string
                     format: date-time-offset
diff --git a/src/openapi/orders/orders-crud.yaml b/src/openapi/orders/orders-crud.yaml
index 2d54fdf..d8988eb 100644
--- a/src/openapi/orders/orders-crud.yaml
+++ b/src/openapi/orders/orders-crud.yaml
@@ -60,7 +60,6 @@ paths:
           name: externalDeviceId
           schema:
             type: string
-            format: uuid
             example: "7a28bd54-7ca9-499a-a722-d15ab858ab99"
           required: false
           description: The external id of the device used to place the order.
diff --git a/src/openapi/products/purchased_products-crud.yaml b/src/openapi/products/purchased_products-crud.yaml
index ff549fb..628a83b 100644
--- a/src/openapi/products/purchased_products-crud.yaml
+++ b/src/openapi/products/purchased_products-crud.yaml
@@ -170,7 +170,8 @@ paths:
                                   "lastUpdatedOn": "2024-10-04T12:34:56.000",
                                   "createdBy": "user",
                                   "lastUpdatedBy": "user",
-                                  "externalDeviceId": "c5545584-04af-4c60-a955-d6a70baab848"
+                                  "externalDeviceId": "c5545584-04af-4c60-a955-d6a70baab848",
+                                  "serviceId": "HTM-1234-7654-8945"
                                 },
                               ],
                             "issuedVouchers": [],
@@ -342,7 +343,8 @@ paths:
                             "lastUpdatedOn": "2024-10-04T12:34:56.000",
                             "createdBy": "user",
                             "lastUpdatedBy": "user",
-                            "externalDeviceId": "c5545584-04af-4c60-a955-d6a70baab848"
+                            "externalDeviceId": "c5545584-04af-4c60-a955-d6a70baab848",
+                            "serviceId": "HTM-1234-7654-8945"
                           },
                         ],
                       "issuedVouchers": [],
@@ -904,6 +906,12 @@ paths:
             type: string
             example: c5545584-04af-4c60-a955-d6a70baab848
           description: The external id of the device.
+        - in: query
+          name: serviceId
+          schema:
+            type: string
+            example: HTM-1234-7654-8945
+          description: A printable id that needs to be next to the printed barcode on the ticket, which is used when the customer contacts the service desk.
       responses:
         "200":
           description: OK
@@ -926,7 +934,8 @@ paths:
                         "lastUpdatedOn": "2024-10-04T12:34:56.000",
                         "createdBy": "user",
                         "lastUpdatedBy": "user",
-                        "externalDeviceId": "c5545584-04af-4c60-a955-d6a70baab848"
+                        "externalDeviceId": "c5545584-04af-4c60-a955-d6a70baab848",
+                        "serviceId": "HTM-1234-7654-8945"
                       },
                     ],
                 }
@@ -1184,6 +1193,7 @@ components:
         - createdOn
         - lastUpdatedOn
         - createdBy
+        - serviceId
       properties:
         issuedAt:
           type: string
@@ -1217,6 +1227,9 @@ components:
         externalDeviceId:
           type: string
           example: c5545584-04af-4c60-a955-d6a70baab848
+        serviceId:
+          type: string
+          example: HTM-1234-7654-8945
     BulkResponseBody:
       type: object
       properties: