建立規格
建立規格
Authentication
每個 /v1 請求都必須帶 X-Client-Id、X-Timestamp、X-Nonce 與 X-Signature 四個標頭。X-Signature 是以 client secret 對 canonical string 做 HMAC-SHA256 後的 Base64。canonical string 的組成、可複製的簽章範例與 401 排查步驟，請參閱「驗證與簽章」。
Request
規格序號。帶 id 時一律視為更新該筆規格，不會再比對 outerSysCode；省略時改依 productId 與 outerSysCode 判斷新增或更新。PUT /v1/skus/{id} 會忽略這裡的值，一律以路徑上的 id 為準。
對應的商品序號，必須指向既有商品。新增時為必填，省略或帶入非正整數回傳 400 productId is required to create a SKU；更新時省略會保留規格目前所屬的商品，帶新值則會把規格改到另一個商品底下。outerSysCode 的去重比對也是以這個欄位限定範圍，同一組 outerSysCode 換一個 productId 視為完全不同的比對對象。
ERP 端的規格代碼，用來在同一個 productId 底下與既有規格比對、去重，不同商品下的相同代碼不會互相匹配。新增時為必填，省略回傳 400 outerSysCode is required to create a SKU；更新時省略保留現有值。長度上限 50 字元，超過回傳 400 outer_sys_code_too_long。
名稱。新增時省略視為空字串；更新時省略保留現有值。長度上限 100 字元，超過回傳 400 name_too_long。
條碼。查詢時是精確比對，與 outerSysCode、name 的子字串比對不同，詳見 listSkus 端點說明。新增時省略視為空字串；更新時省略保留現有值。長度上限 50 字元，超過回傳 400 barcode_too_long。
倉別。新增時省略視為空字串；更新時省略保留現有值。長度上限 50 字元，超過回傳 400 warehouse_too_long。
商品單位。新增時省略視為空字串；更新時省略保留現有值。長度上限 50 字元，超過回傳 400 unit_too_long。
規格內容（例如「12入」「500g」）。新增時省略視為空字串；更新時省略保留現有值。長度上限 50 字元，超過回傳 400 spec_too_long。
價格。新增時省略視為 0；更新時省略保留現有值。
賣價。新增時省略視為 0；更新時省略保留現有值。
數量精度（0 為整數，1 至 4 為小數位數）。新增時省略視為 0；更新時省略保留現有值。
Response
新增或更新成功後，該筆資料的 id。