更新商品
更新商品
依 id 更新商品，路徑上的 id 永遠優先於 body 帶的 id，即使 body 另外指定了別的 id 也一律以路徑為準。更新是部分合併，只送有異動的欄位；省略的欄位維持原值，不會被清空。省略 `productCategoryId` 會保留目前的分類；若有帶值，會依建立時相同的規則重新驗證（必須是可指派的子分類）。
id 不存在或屬於其他租戶時回傳 404；指向組合商品時同樣回傳 404，組合商品無法透過本端點更新。
Authentication
X-Signaturestring
每個 /v1 請求都必須帶 `X-Client-Id`、`X-Timestamp`、`X-Nonce` 與 `X-Signature` 四個標頭。`X-Signature` 是以 client secret 對 canonical string 做 HMAC-SHA256 後的 Base64。
canonical string 的組成、可複製的簽章範例與 401 排查步驟，請參閱[「驗證與簽章」](/authentication)。
Path parameters
id
要更新的商品序號。這個值永遠優先於 body 裡的 id，兩者不一致時一律以路徑為準。不存在或屬於其他租戶時，回傳 404；error 是該資源的簡短說明，而非 not_found。
Request
This endpoint expects an object.
id
商品序號。帶 id 時一律視為更新該筆商品，不會再比對 outerSysCode；省略時改依 outerSysCode 判斷新增或更新。PUT /v1/products/{id} 會忽略這裡的值，一律以路徑上的 id 為準。
outerSysCode
ERP 端的商品代碼，用來與既有商品比對、去重。新增時省略視為空字串；更新時省略保留現有值。長度上限 50 字元，超過回傳 400 outer_sys_code_too_long。
name
商品名稱。新增時省略視為空字串；更新時省略保留現有值。長度上限 100 字元，超過回傳 400 name_too_long。
productCategoryId
商品分類序號，必須是可指派的（子）分類 id，透過商品分類端點的 isAssignable: true 取得。新增時必填，省略回傳 400 product_category_id_required；帶了但分類不存在、不可指派或屬於其他租戶，回傳 400 invalid_product_category_id。
更新時省略會保留商品目前的分類；若有帶值，會依相同規則重新驗證。
Response
OK
id
新增或更新成功後，該筆資料的 id。
Errors
400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error