From 956806e88fb3eada82a7403454a64c790a9fc25e Mon Sep 17 00:00:00 2001 From: hemanth Date: Fri, 1 May 2026 07:09:41 -0700 Subject: [PATCH] feat(schema): add buyer_notes field to line items Adds an optional buyer_notes string field (max 500 chars) to both line_item and order_line_item schemas, enabling per-item buyer instructions such as customization requests, dietary notes, and gift messages. - line_item.json: buyer_notes is optional on create and update - order_line_item.json: buyer_notes preserved from checkout (read-only) Closes #349 --- source/schemas/shopping/types/line_item.json | 9 +++++++++ source/schemas/shopping/types/order_line_item.json | 5 +++++ 2 files changed, 14 insertions(+) diff --git a/source/schemas/shopping/types/line_item.json b/source/schemas/shopping/types/line_item.json index 0eba9ed05..ba2370a84 100644 --- a/source/schemas/shopping/types/line_item.json +++ b/source/schemas/shopping/types/line_item.json @@ -41,6 +41,15 @@ "create": "omit", "update": "optional" } + }, + "buyer_notes": { + "type": "string", + "maxLength": 500, + "description": "Free-text buyer instructions for this line item (e.g., customization requests, gift messages, dietary notes). Business MAY act on, echo back, or ignore.", + "ucp_request": { + "create": "optional", + "update": "optional" + } } } } diff --git a/source/schemas/shopping/types/order_line_item.json b/source/schemas/shopping/types/order_line_item.json index 5f639dcff..c79e4a085 100644 --- a/source/schemas/shopping/types/order_line_item.json +++ b/source/schemas/shopping/types/order_line_item.json @@ -61,6 +61,11 @@ "parent_id": { "type": "string", "description": "Parent line item identifier for any nested structures." + }, + "buyer_notes": { + "type": "string", + "maxLength": 500, + "description": "Buyer instructions for this line item, preserved from checkout. Business SHOULD surface these in fulfillment workflows." } } }