fixes

cmd/cart/openapi.json

@@ -358,6 +358,40 @@
         }
       }
     },
+    "/cart/item/{itemId}/custom-fields": {
+      "put": {
+        "summary": "Set/merge custom input fields on a line item",
+        "parameters": [
+          {
+            "name": "itemId",
+            "in": "path",
+            "required": true,
+            "schema": { "type": "integer", "format": "int64", "minimum": 0 },
+            "description": "Internal cart line item identifier."
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": { "$ref": "#/components/schemas/SetCustomFieldsRequest" }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Custom fields updated",
+            "content": {
+              "application/json": {
+                "schema": { "$ref": "#/components/schemas/CartGrain" }
+              }
+            }
+          },
+          "400": { "description": "Invalid body or id" },
+          "500": { "description": "Server error" }
+        }
+      }
+    },
     "/cart/item/{itemId}/marking": {
       "put": {
         "summary": "Set marking for line item",
@@ -955,10 +989,14 @@
       },
       "CartItem": {
         "type": "object",
+        "description": "Cart line item. Beyond the typed properties below, arbitrary dynamic product data is flattened onto the object as additional top-level keys (see additionalProperties).",
         "properties": {
           "id": { "type": "integer" },
           "itemId": { "type": "integer" },
-          "parentId": { "type": "integer" },
+          "parentId": {
+            "type": "integer",
+            "description": "Line-item id (the `id` field) of the parent item, set when this line is a child/sub-article"
+          },
           "sku": { "type": "string" },
           "price": { "$ref": "#/components/schemas/Price" },
           "totalPrice": { "$ref": "#/components/schemas/Price" },
@@ -975,11 +1013,19 @@
           "meta": { "$ref": "#/components/schemas/ItemMeta" },
           "saleStatus": { "type": "string" },
           "marking": { "$ref": "#/components/schemas/Marking" },
+          "customFields": {
+            "type": "object",
+            "additionalProperties": { "type": "string" },
+            "description": "User-supplied custom input fields for this line"
+          },
           "subscriptionDetailsId": { "type": "string" },
           "orderReference": { "type": "string" },
           "isSubscribed": { "type": "boolean" }
         },
-        "required": ["id", "sku", "price", "qty"]
+        "required": ["id", "sku", "price", "qty"],
+        "additionalProperties": {
+          "description": "Dynamic product data carried through verbatim (e.g. glas, hangning, materialkular). Value can be any JSON type."
+        }
       },
       "CartDelivery": {
         "type": "object",
@@ -1021,7 +1067,17 @@
             "type": "string",
             "description": "Two-letter country code (inferred if omitted)"
           },
-          "storeId": { "type": "string", "nullable": true }
+          "storeId": { "type": "string", "nullable": true },
+          "children": {
+            "type": "array",
+            "description": "Sub-articles (accessories, services, insurance, ...) added as separate cart lines whose parentId points to this item's line, and priced relative to this parent item.",
+            "items": { "$ref": "#/components/schemas/Item" }
+          },
+          "customFields": {
+            "type": "object",
+            "additionalProperties": { "type": "string" },
+            "description": "Optional user-supplied input fields for this line"
+          }
         },
         "required": ["sku"]
       },
@@ -1042,7 +1098,17 @@
         "properties": {
           "sku": { "type": "string" },
           "quantity": { "type": "integer", "minimum": 1 },
-          "storeId": { "type": "string", "nullable": true }
+          "storeId": { "type": "string", "nullable": true },
+          "children": {
+            "type": "array",
+            "description": "Sub-articles (accessories, services, insurance, ...). Each is added as a separate cart line whose parentId points to this item's line, and is priced relative to this parent item.",
+            "items": { "$ref": "#/components/schemas/Item" }
+          },
+          "customFields": {
+            "type": "object",
+            "additionalProperties": { "type": "string" },
+            "description": "Optional user-supplied input fields for this line"
+          }
         },
         "required": ["sku", "quantity"]
       },
@@ -1121,6 +1187,17 @@
         },
         "required": ["type", "text"]
       },
+      "SetCustomFieldsRequest": {
+        "type": "object",
+        "properties": {
+          "customFields": {
+            "type": "object",
+            "additionalProperties": { "type": "string" },
+            "description": "Fields to upsert on the line; keys not present are left untouched"
+          }
+        },
+        "required": ["customFields"]
+      },
       "Notice": {
         "type": "object",
         "properties": {