批次寫入商品 | OrderUpB2B

一次寫入多筆商品，逐筆各自新增、更新或去重，互不影響。

送出空陣列或沒有 body 會在受理前被拒絕，回傳 400 empty_batch；已受理的請求一律回傳 HTTP 200，逐筆的處理結果放在回應 body 的 items 裡，單筆失敗不會讓其他筆一起失敗。

每一筆的新增/更新/去重規則與單筆端點相同：帶 id 就更新該筆；不帶 id 但 outerSysCode 命中既有商品就改為更新（冪等去重）；兩者都沒有則新增。若 outerSysCode 命中的是一筆組合商品，該筆回報 failed 並帶 product_type_conflict，絕不會改為新增，其餘各筆不受影響。更新一律是部分合併，只會覆蓋你送出的欄位；productCategoryId 的必填與驗證規則也與單筆端點相同。

一次寫入多筆商品，逐筆各自新增、更新或去重，互不影響。送出空陣列或沒有 body 會在受理前被拒絕，回傳 400 empty_batch；已受理的請求一律回傳 HTTP 200，逐筆的處理結果放在回應 body 的 `items` 裡，單筆失敗不會讓其他筆一起失敗。每一筆的新增/更新/去重規則與單筆端點相同：帶 `id` 就更新該筆；不帶 `id` 但 `outerSysCode` 命中既有商品就改為更新（冪等去重）；兩者都沒有則新增。若 `outerSysCode` 命中的是一筆組合商品，該筆回報 failed 並帶 product_type_conflict，絕不會改為新增，其餘各筆不受影響。更新一律是部分合併，只會覆蓋你送出的欄位；`productCategoryId` 的必填與驗證規則也與單筆端點相同。

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 排查步驟，請參閱「驗證與簽章」。

每個 /v1 請求都必須帶 `X-Client-Id`、`X-Timestamp`、`X-Nonce` 與 `X-Signature` 四個標頭。`X-Signature` 是以 client secret 對 canonical string 做 HMAC-SHA256 後的 Base64。 canonical string 的組成、可複製的簽章範例與 401 排查步驟，請參閱[「驗證與簽章」](/authentication)。

Request

This endpoint expects a list of objects.

idlong or nullOptional

商品序號。帶 id 時一律視為更新該筆商品，不會再比對 outerSysCode；省略時改依 outerSysCode 判斷新增或更新。PUT /v1/products/{id} 會忽略這裡的值，一律以路徑上的 id 為準。

outerSysCodestring or nullOptional

ERP 端的商品代碼，用來與既有商品比對、去重。新增時省略視為空字串；更新時省略保留現有值。長度上限 50 字元，超過回傳 400 outer_sys_code_too_long。

namestring or nullOptional

商品名稱。新增時省略視為空字串；更新時省略保留現有值。長度上限 100 字元，超過回傳 400 name_too_long。

productCategoryIdlong or nullOptional

商品分類序號，必須是可指派的（子）分類 id，透過商品分類端點的 isAssignable: true 取得。新增時必填，省略回傳 400 product_category_id_required；帶了但分類不存在、不可指派或屬於其他租戶，回傳 400 invalid_product_category_id。

更新時省略會保留商品目前的分類；若有帶值，會依相同規則重新驗證。

Response

itemslist of objects or nullOptional

逐筆的處理結果，順序與送出的陣列相同，一筆對一筆。

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error

一次寫入多筆商品，逐筆各自新增、更新或去重，互不影響。