From ca39d2d01183c41625ac33242b497e414dd12f91 Mon Sep 17 00:00:00 2001 From: hemanth Date: Mon, 20 Jul 2026 21:48:57 -0700 Subject: [PATCH] feat(schema): add optional note field to line items Add note (string, maxLength 500) to line_item.json for buyer-supplied per-item instructions (e.g. gift wrapping, dietary preferences, engraving text). - ucp_request: optional on create and update - Business echoes value in responses, MAY forward to fulfillment Closes #349 --- source/schemas/shopping/types/line_item.json | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/source/schemas/shopping/types/line_item.json b/source/schemas/shopping/types/line_item.json index 0eba9ed05..c293d49e2 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" } + }, + "note": { + "type": "string", + "maxLength": 500, + "description": "Buyer-supplied free-text note for this line item (e.g., gift wrapping instructions, dietary preferences, engraving text). Business echoes the value in responses and MAY include it in order webhook payloads for downstream fulfillment.", + "ucp_request": { + "create": "optional", + "update": "optional" + } } } }