Product

/v1/Product/GetAttachedList

取得商店的加購品/贈品資料

Attribute	Value
API Name	取加購品/贈品 (/Product/GetAttachedList)
API Desc	取得商店的加購品/贈品資料
Version	1
Request URI	https://tw.ews.mall.yahooapis.com/stauth/v1/Product/GetAttachedList OR https://tw.ews.mall.yahooapis.com/oauth/v1/Product/GetAttachedList
Change Log	*

Request parameters

Parameter	Value	Description
ProductType	string(Require)	商品型態 Addon/Freebie Addon：加購品 Freebie：贈品
ProductStatus	string(14/Require)	商品狀態 Online:上架中 OnlineLowstock:上架中低庫存 OnlineNostock:上架中無庫存 Offline:已下架 NotOnline:未上架
Position	int(Require)	由第幾筆開始拿資料
Count	int(Require)	資料筆數 Count=1~100

Response fields

Field	Description
AttachedList	包含此商店的Attached Product List，屬性： Count：資料筆數
TotalCount	符合ProductType和ProductStatus的總資料筆數
Attached	包含一筆Attached Product的資料，屬性： Id ：商品編號
CustomizeId	自訂貨號 (string/30)
Name	商品名稱 (string/150)
SalePrice	網路價 (number/12,2) 賣場上的銷售價格，當 ProductType=Freebie 時 SalePrice=Null
CostPrice	成本價 (number/12,2)
CurrentStock	商品目前庫存量 (int)

Sample response

JSON sample

{
  "Response":{
    "@Status":"ok",
    "TotalCount":25,
    "ProductList":{
      "@Count":3,
      "Product":[
        {
          "@Id":"p094912693",
          "CustomizeId":"",
          "Name":"add on price test",
          "SalePrice":123456789,
          "CostPrice":0,
          "CurrentStock":999
        },
        {
          "@Id":"p094912860",
          "CustomizeId":"",
          "Name":"\u52a0\u8cfc\u54c1-ddd",
          "SalePrice":11,
          "CostPrice":0,
          "CurrentStock":3
        },
        {
          "@Id":"p094912865",
          "CustomizeId":"",
          "Name":"notify1",
          "SalePrice":11,
          "CostPrice":0,
          "CurrentStock":11
        }
      ]
    }
  }
}

Errors

ErrorCode	ErrorMessage
1601	StoreId is empty
1602	ProductType is empty
1603	ProductStatus is empty
1604	Position is empty or not numeric
1605	Count is empty or not numeric
1606	unknow ProductType
1607	unknow ProductStatus

/v2/Product/SubmitVerifyMain

Attribute	Value
API Name	驗證主商品內容 (SubmitVerifyMain)
API Desc	驗證刊登的主商品內容以及資料是否正確
Version	2
Request URI	https://tw.ews.mall.yahooapis.com/stauth/v2/Product/SubmitVerifyMain OR https://tw.ews.mall.yahooapis.com/oauth/v2/Product/SubmitVerifyMain
Change Log	2011/08 - Init Version.

Request parameters

Parameter	Value	Description
SaleType	string (20/Require)	商品銷售方式 Normal/PreSaleByShipDate/PreSaleByShipdays Normal：一般方式(現貨銷售) PreSaleByShipDate：DATE 預購 by shipDate(指定出貨日期) PreSaleByShipdays：DAYS 預購 by shipdays(訂購後多少天出貨)
SaleTypeInfo	string (Optional)	商品銷售資訊 Normal：empty this field PreSaleByShipDate： Date(2009/11/30) PreSaleByShipdays：Days(20)
ProductName	string (150/Require)	商品名稱
TaxonomyId	string (Require)	商品分類代號商品欲刊登的leaf層category id
StoreCategoryId	int (Optional)	商品歸類可接受多筆，請重複使用此parameter ex：StoreCategoryId=1234&StoreCategoryId=1235
BrandId	string (Require)	商品品牌編號請參考 https://tw.user.mall.yahoo.com/store_admin/view/brandIdSearch (需有小幫手權限方可查看)
MarketPrice	number (12,2/Optional)	商品市價
SalePrice	number (12,2/Require)	網路價賣場上的銷售價格，需大於0 & 大於"成本價"
CostPrice	number (12,2/Optional)	成本價
MaxBuyNum	int (3/Optional)	最高購買數量商品一次最多可被購買的數量(default:30) 可接受1~100
ShortDescription	string (200/Require)	商品簡述
VideoPath	string (256/Optional)	商品影音檔Path 符合youtube短網址
LongDescription	string (Optional)	商品介紹
LinkAddon	string (Optional)	加購品可帶多個加購品商品編號，請重複使用此parameter ex：LinkAddon=P13456& LinkAddon=P13456
LinkFreebie	string (Optional)	贈品可帶多個贈品商品編號，請重複使用此parameter ex：LinkFreebie=P13456& LinkFreebie=P13456
PayTypeId	int (Require)	付款方式代號商品可接受的付款方式，可帶多個付款方式，請重複使用此parameter ex：PayTypeId=1&PayTypeId=1
ShippingId	int (Require)	物流方式代號商品可接受的物流方式，可帶多個物流方式，請重複使用此parameter ex：ShippingId=1&ShippingId=1
ClusterId	string (Require)	商品規格表代號商品分類代號（TaxonomyId）可能對應多個商品規格表代號（ClusterId），請選擇最適合的商品規格表在此處填入代號，並需填寫對應的 Attributes ex：ClusterId=18744273
Attribute.n.Name	string (Optional)	商品屬性欄位名稱可建立多組商品屬性資料一組商品屬性資料包含：Attribute.n.Name + Attribute.n.Content 請將parameter中的"n"以數字代換，ex：Attribute.1.Name=材質特別說明: 當商城類別選擇以下類別時, 本欄位為必填值, 本欄位必須增填 [分級標示], 而且在 Attribute.n.Value 的欄位也須增填商品級別(相關說明請見 Attribute.n.Value) "圖書/文具 > 書籍/雜誌期刊" (含以下) "圖書/文具 > 音樂/電影/影集" 之相關的類別"休閒/交通 > 18禁專區 > 限制級書籍/寫真" (含以下) "休閒/交通 > 18禁專區 > 限制級影音" (含以下) 當商城類別選擇以下類別時, 本欄位為必填值, 本欄位必須增填 [分級標示], 若是商品本身有情節時, 尚需額外增填 [情節標示] (無情節免填), 而且在 Attribute.n.Value 的欄位也須增填商品級別和情節內容(相關說明請見 Attribute.n.Value) "消費電子 > 電玩/玩具" 之相關的類別"休閒/交通 > 18禁專區 > 18禁電玩遊戲" (含以下) 當類別選擇 No1 or 2 時, 因為欄位值有對應關係, n 的數字也要對應, 且必須配合 Attribute.n.Value 的欄位值(相關說明請見 Attribute.n.Value) Ex：Attribute.1.Name=分級標示 & Attribute.2.Name=情節標示
Attribute.n.Value	string (Optional)	商品屬性欄位內容請將parameter中的"n"以數字代換，ex：Attribute.1.Value=棉特別說明：當商城類別選擇 "圖書/文具 > 書籍/雜誌期刊" (含以下) 的類別時, 本欄位為必填值, 本欄位必須增填 [普級] Ex：假如Attribute.1.Name=分級標示, 則 Attribute.1.Value=普級當商城類別選擇 "圖書/文具 > 音樂/電影/影集"相關的類別時, 本欄位為必填值, 本欄位必須增填 [普級] 或 [保護級] 或 [輔導級] 三擇一Ex：假如Attribute.1.Name=分級標示, 則 Attribute.1.Value=保護級當商城類別選擇 "休閒/交通 > 18禁專區 > 限制級書籍/寫真" (含以下) 的類別時, 本欄位為必填值, 本欄位必須增填 [限制級] Ex：假如Attribute.1.Name=分級標示, 則 Attribute.1.Value=限制級當商城類別選擇 "休閒/交通 > 18禁專區 > 限制級影音" (含以下) 的類別時, 本欄位為必填值, 本欄位必須增填 [限制級] Ex：假如Attribute.1.Name=分級標示, 則 Attribute.1.Value=限制級當商城類別選擇 "消費電子 > 電玩/玩具"相關的類別時, 本欄位為必填值, 本欄位必須增填 [普級] 或 [保護級] 或 [輔導級+12] 或 [輔導級+15] 四擇一。當商品有情節時(無情節免填), 商品依法須標示情節, 欄位也須增填情節內容(情節請見 No 7 和 8) Ex： (有商品情節)假如Attribute.1.Name=分級標示和 Attribute.2.Name=情節標示, 則 Attribute.1.Value=輔導級+12, Attribute.2.Value=性,暴力,恐怖 (無商品情節)假如Attribute.1.Name=分級標示, 則 Attribute.1.Value=保護級當商城類別選擇 "休閒/交通 > 18禁專區 > 18禁電玩遊戲" (含以下) 的類別時, 本欄位為必填值, 本欄位必須增填 [限制級] 。當商品有情節時(無情節免填), 商品依法須標示情節, 欄位也須增填情節內容(情節請見 No 7 和 8) Ex：假如Attribute.1.Name=分級標示和 Attribute.2.Name=情節標示, 則 Attribute.1.Value=限制級, Attribute.2.Value=恐怖,不當言語,反社會性,棋牌益智「情節標示」欄位只可填 [性], [暴力], [恐怖], [菸酒], [毒品], [不當言語], [反社會性], [棋牌益智], [戀愛交友] 9 個選項(可複選) 「分級標示」和「情節標示」欄位只接受固定的級別與這 9 個選項, 複選的選項請用逗號隔開, 請勿填錯字, 以免操作失敗.
ProductPromotion.n.Amount	int (Optional)	商品促銷方式 - 數量可建立多組商品促銷方式資料一組商品屬性資料包含：ProductPromotion.n.Amount + ProductPromotion.n.Price 請將parameter中的"n"以數字代換，ex：ProductPromotion.1.Amount=5 ProductPromotion.n.Amount 必須大於 ProductPromotion.(n-1).amount
ProductPromotion.n.Price	int (Optional)	商品促銷方式 - 價格請將parameter中的"n"以數字代換，ex：ProductPromotion.1.Price=100 ProductPromotion.n.Price必須小於網路價，而且要小於ProductPromotion.(n-1).Price
IsTaxFree	int(Optional)	此商品是否為免稅商品商店為免稅商店及商品刊登於免稅分類時，此設定才能被設定為1。(default:0) 當此設定為1時，就不得設定加購品
SpecTypeDimension	string (required)	商品規格, 為無規格、一階商品或是二階商品 0 無規格商品 1 商品規格為一階層 * 2 商品規格為二階層
CustomizedMainProductId	string (Optional)	商品主貨號 (商品無規格時適用)
Stock	string (Optional)	商品庫存量 (商品無規格時適用)
SaftyStock	string (Optional)	商品庫存最低警告量 (商品無規格時適用)
SpecDimension1	string (Optional)	商品規格名稱1ex 顏色
SpecDimension2	string (Optional)	商品規格名稱2ex 尺寸
SpecDimension1Description	string (Optional)	第一個商品規格名稱描述，可新增多筆，最多 40 筆。例如：SpecDimension1Description=White&SpecDimension1Description=Yellow 注意：所有商品展開後，商品規格總數不得超過 60 種。
SpecDimension2Description	string (Optional)	第二個商品規格名稱描述，可新增多筆，最多 40 筆。例如：SpecDimension2Description=XL&SpecDimension2Description=XS 注意：所有商品展開後，商品規格總數不得超過 60 種。

Response fields

Field	Description
ProductId	商品編號 (string) Mall給每一個商品的唯一商品編號
ErrorMsgList	包含此商品verify的error message list
ErrorMsg	包含一組error message
ErrorCode	錯誤代碼 (string)
ErrorParameter	錯誤參數 (string)
ErrorMsg	錯誤訊息 (string)

Sample response

JSON sample

{
  "Response":{
    "@Status":"ok"
  }
}

Errors

ErrorCode	ErrorMessage
1310	Attribute: 商品屬性為非合法值
1311	Attribute: 商品屬性不可為空值
1351	商品總數超過上限
1352	加購品超出上限 {max addon limit}
1353	贈品超出上限 {max gift limit}
1354	當商品為免稅時，不可設定加購品
1355	非合法的商店代號
1356	Spec: 規格不可為空值
1371	Promotion: 數量與價錢必須是成對的值
1372	Attribute: 欄位名稱和欄位內容必須是成對的值

其它錯誤請參閱共用錯誤表

/v2/Product/SubmitMain (包含商品規格表)

Attribute	Value
API Name	刊登主商品 (SubmitMain)
API Desc	刊登主商品
Version	2
Request URI	https://tw.ews.mall.yahooapis.com/stauth/v2/Product/SubmitMain OR https://tw.ews.mall.yahooapis.com/oauth/v2/Product/SubmitMain

Request parameters

Parameter	Value	Description
SaleType	string (20/Require)	商品銷售方式 Normal/PreSaleByShipDate/PreSaleByShipdays Normal：一般方式(現貨銷售) PreSaleByShipDate：DATE 預購 by shipDate(指定出貨日期) PreSaleByShipdays：DAYS 預購 by shipdays(訂購後多少天出貨)
SaleTypeInfo	string (Optional)	商品銷售資訊 Normal：empty this field PreSaleByShipDate： Date(2018/11/30) PreSaleByShipdays：Days(20)
ProductName	string (150/Require)	商品名稱
TaxonomyId	string (Require)	商品分類代號商品欲刊登的leaf層category id
StoreCategoryId	int (Optional)	商品歸類可接受多筆，請重複使用此parameter ex：StoreCategoryId=1234&StoreCategoryId=1235
BrandId	string (Require)	商品品牌編號請參考 https://tw.user.mall.yahoo.com/store_admin/view/brandIdSearch (需有小幫手權限方可查看)
MarketPrice	number (12,2/Optional)	商品市價
SalePrice	number (12,2/Require)	網路價賣場上的銷售價格，需大於0 & 大於"成本價"
CostPrice	number (12,2/Optional)	成本價
MaxBuyNum	int (3/Optional)	最高購買數量商品一次最多可被購買的數量(default:30) 可接受1~100
ShortDescription	string (200/Require)	商品簡述
VideoPath	string (256/Optional)	商品影音檔Path 符合youtube短網址
LongDescription	string (Optional)	商品介紹
LinkAddon	string (Optional)	加購品可帶多個加購品商品編號，請重複使用此parameter。若沒有加購品，請勿放入此參數。 ex：LinkAddon=P13456&LinkAddon=P13456
LinkFreebie	string (Optional)	贈品可帶多個贈品商品編號，請重複使用此parameter。若沒有贈品，請勿放入此參數。 ex：LinkFreebie=P13456&LinkFreebie=P13456
PayTypeId	int (Require)	付款方式代號商品可接受的付款方式，可帶多個付款方式，請重複使用此parameter ex：PayTypeId=1&PayTypeId=1
ShippingId	int (Require)	物流方式代號商品可接受的物流方式，可帶多個物流方式，請重複使用此parameter ex：ShippingId=1&ShippingId=1
ClusterId	string (Require)	商品規格表代號商品分類代號（TaxonomyId）可能對應多個商品規格表代號（ClusterId），請選擇最適合的商品規格表在此處填入代號，並需填寫對應的 Attributes ex：ClusterId=18744273
Attribute.n.Name	string (Require)	商品屬性欄位名稱可建立多組商品屬性資料一組商品屬性資料包含：Attribute.n.Name + Attribute.n.Value 請將 parameter 中的 "n" 以數字代換，ex：Attribute.1.Name=可放容量&Attribute.2.Name=可放記憶卡&Attribute.3.Name=材質
Attribute.n.Value	string (Require)	商品屬性欄位內容請將 parameter 中的 "n" 以數字代換，ex：Attribute.1.Value=1片&Attribute.2.Value=SDHC,Micro SD&Attribute.3.Value=塑膠 PVC
IsTaxFree	int(Optional)	此商品是否為免稅商品商店為免稅商店及商品刊登於免稅分類時，此設定才能被設定為1。(default:0) 當此設定為1時，就不得設定加購品
SpecTypeDimension	string (required)	商品規格, 為無規格、一階商品或是二階商品 0 無規格商品 1 商品規格為一階層 * 2 商品規格為二階層
CustomizedMainProductId	string (Optional)	商品主貨號 (商品無規格時適用)
Stock	string (Optional)	商品庫存量 (商品無規格時適用)
SaftyStock	string (Optional)	商品庫存最低警告量 (商品無規格時適用)
SpecDimension1	string (Optional)	商品規格名稱1ex 顏色
SpecDimension2	string (Optional)	商品規格名稱2ex 尺寸
SpecDimension1Description	string (Optional)	第一個商品規格名稱描述，可新增多筆，最多 40 筆。例如：SpecDimension1Description=White&SpecDimension1Description=Yellow 注意：所有商品展開後，商品規格總數不得超過 60 種。
SpecDimension2Description	string (Optional)	第二個商品規格名稱描述，可新增多筆，最多 40 筆。例如：SpecDimension2Description=XL&SpecDimension2Description=XS 注意：所有商品展開後，商品規格總數不得超過 60 種。

Sample Request:

https://tw.ews.mall.yahooapis.com/stauth/v2/Product/SubmitMain?SaleType=Normal&ProductName=%E6%B8%AC%E8%A9%A6API%E5%88%8A%E7%99%BB%E7%84%A1%E8%A6%8F%E6%A0%BC%E5%95%86%E5%93%811111&TaxonomyId=4386831&SalePrice=1&ShortDescription=%E6%B8%AC%E8%A9%A6%E5%95%86%E5%93%81%E4%B8%8D%E6%9C%83%E5%87%BA%E8%B2%A8%EF%BC%8C%E8%AB%8B%E5%8B%BF%E8%B3%BC%E8%B2%B7&PayTypeId=1&ShippingId=1&SpecTypeDimension=0&LongDescription=<a href="" target="_blank"><img src="xx.jpg"></a>&Stock=100&SaftyStock=1&ClusterId=18744273&Attribute.1.Name=%E5%8F%AF%E6%94%BE%E5%AE%B9%E9%87%8F&Attribute.1.Value=1%E7%89%87&Attribute.2.Name=%E5%8F%AF%E6%94%BE%E8%A8%98%E6%86%B6%E5%8D%A1&Attribute.2.Value=SDHC,Micro SD&Attribute.3.Name=%E6%9D%90%E8%B3%AA&Attribute.3.Value=%E5%A1%91%E8%86%A0%20PVC&Format=json

Response fields

Field	Description
ProductId	商品編號 (string) 系統給每一個商品的唯一商品編號
ErrorMsgList	包含此商品verify的error message list
ErrorMsg	包含一組error message
ErrorCode	錯誤代碼 (string)
ErrorParameter	錯誤參數 (string)
ErrorMsg	錯誤訊息 (string)

Sample response

JSON sample

{
  "Response":{
    "@Status":"ok",
    "ProductId":"p098547550"
  }
}

Errors

ErrorCode	ErrorMessage
1310	Attribute: 商品屬性為非合法值
1311	Attribute: 商品屬性不可為空值
1351	商品總數超過上限
1352	加購品超出上限 {max addon limit}
1353	贈品超出上限 {max gift limit}
1354	當商品為免稅時，不可設定加購品
1355	非合法的商店代號
1356	Spec: 規格不可為空值
1371	Promotion: 數量與價錢必須是成對的值
1372	Attribute: 欄位名稱和欄位內容必須是成對的值

其它錯誤請參閱共用錯誤表

/v1/Product/UpdateAddon

更新單一加購品資料

Attribute	Value
API Name	更新單一加購品 (/Product/UpdateAddon)
API Desc	更新單一加購品資料
Version	1
Request URI	https://tw.ews.mall.yahooapis.com/stauth/v1/Product/UpdateAddon OR https://tw.ews.mall.yahooapis.com/oauth/v1/Product/UpdateAddon
Change Log	*

Request parameters

Parameter	Value	Description
ProductId	string (16/Require)	商品編號
ProductName	string (150/Optional)	商品名稱
SalePrice	number (12,2/Optional)	網路價賣場上的銷售價格大於0 & 大於"成本價"
CostPrice	number (12,2/Optional)	成本價
ShortDescription	string (200/Optional)	商品簡述

Response fields

Field	Description
ProductId	商品編號 (string) Mall給每一個商品的唯一商品編號
ErrorMsgList	包含此商品verify的error message list
ErrorMsg	包含一組error message
ErrorCode	錯誤代碼 (string)
ErrorParameter	錯誤參數 (string)
ErrorMsg	錯誤訊息 (string)

Sample response

JSON sample

{
  "Response":{
    "@Status":"ok",
    "ProductId":"p098547550"
  }
}

Errors

ErrorCode	ErrorMessage
1351	商品總數超過上限
1355	非合法的商店代號

其它錯誤請參閱共用錯誤表

/v1/Product/SubmitVerifyAddon

驗證刊登的加購品內容

Attribute	Value
API Name	驗證加購品內容 (Product/SubmitVerifyAddon)
API Desc	驗證刊登的加購品內容格式以及資料是否有正確
Version	1
Request URI	https://tw.ews.mall.yahooapis.com/stauth/v1/Product/SubmitVerifyAddon OR https://tw.ews.mall.yahooapis.com/oauth/v1/Product/SubmitVerifyAddon
Change Log	*

Request parameters

Parameter	Value	Description
ProductType	string (12/Require)	商品型態 Addon/Freebie Addon：加購品 Freebie：贈品
ProductName	string (150/Require)	商品名稱
SalePrice	number (12,2/Require)	網路價賣場上的銷售價格大於0 & 大於"成本價"
CostPrice	number (12,2/Optional)	成本價
ShortDescription	string (200/Require)	商品簡述
SpecDescription	string (64/Require)	此欄位請帶入'-'
Stock	int (4/Require)	商品庫存量可接受1~999
SaftyStock	int (4/Require)	商品安全庫存最低警告量不可小於1
CustomizedProductId	string (90/Optional)	自訂貨號

Sample Request：

https://tw.ews.mall.yahooapis.com/stauth/v1/Product/SubmitVerifyAddon?&Format=json

Response fields

Field	Description
ErrorMsgList	包含此商品verify的error message list
ErrorMsg	包含一組error message
ErrorCode	錯誤代碼 (string)
ErrorParameter	錯誤參數 (string)
ErrorMsg	錯誤訊息 (string)

Sample response

JSON sample

{
  "Response":{
    "@Status":"ok"
  }
}

Errors

ErrorCode	ErrorMessage
1351	商品總數超過上限
1355	非合法的商店代號

其它錯誤請參閱共用錯誤表

/v1/Product/SubmitAddon

刊登加購品

Attribute	Value
API Name	刊登加購品 (/Product/SubmitAddon)
API Desc	刊登加購品
Version	1
Request URI	https://tw.ews.mall.yahooapis.com/stauth/v1/Product/SubmitAddon OR https://tw.ews.mall.yahooapis.com/oauth/v1/Product/SubmitAddon
Change Log	*

Request parameters

Parameter	Value	Description
ProductType	string (12/Require)	商品型態 Addon/Freebie Addon：加購品 Freebie：贈品
ProductName	string (150/Require)	商品名稱
SalePrice	number (12,2/Require)	網路價賣場上的銷售價格大於0 & 大於"成本價"
CostPrice	number (12,2/Optional)	成本價
ShortDescription	string (200/Require)	商品簡述
Spec.1.Description	string (64/Require)	此欄位請帶入'-'
Spec.1.Stock	int (4/Require)	商品庫存量可接受1~999
Spec.1.SaftyStock	int (4/Require)	商品安全庫存最低警告量不可小於1
Spec.1.CustomizedProductId	string (90/Optional)	自訂貨號

Sample Request：

https://tw.ews.mall.yahooapis.com/stauth/v1/Product/SubmitAddon?&Format=json

Response fields

Field	Description
ProductId	商品編號 (string) Mall給每一個商品的唯一商品編號
ErrorMsgList	包含此商品verify的error message list
ErrorMsg	包含一組error message
ErrorCode	錯誤代碼 (string)
ErrorParameter	錯誤參數 (string)
ErrorMsg	錯誤訊息 (string)

Sample response

JSON sample

{
  "Response":{
    "@Status":"ok",
    "ProductId":"p098547550"
  }
}

Errors

ErrorCode	ErrorMessage
1351	商品總數超過上限
1355	非合法的商店代號

其它錯誤請參閱共用錯誤表

/v1/Product/SubmitVerifyFreebie

驗證刊登的贈品內容

Attribute	Value
API Name	驗證刊登的贈品內容 (/Product/SubmitVerifyFreebie)
API Desc	驗證刊登的贈品內容資料格式是否有錯誤
Version	1
Request URI	https://tw.ews.mall.yahooapis.com/stauth/v1/Product/SubmitVerifyFreebie OR https://tw.ews.mall.yahooapis.com/oauth/v1/Product/SubmitVerifyFreebie
Change Log	*

Request parameters

Parameter	Value	Description
ProductType	string (12/Require)	商品型態 Addon/Freebie Addon：加購品 Freebie：贈品
ProductName	string (150/Require)	商品名稱
SalePrice	number (12,2/Require)	網路價賣場上的銷售價格大於0 & 大於"成本價"
CostPrice	number (12,2/Optional)	成本價
ShortDescription	string (200/Require)	商品簡述
SpecDescription	string (64/Require)	此欄位請帶入'-'
Stock	int (4/Require)	商品庫存量可接受1~999
SaftyStock	int (4/Require)	商品安全庫存最低警告量不可小於1
CustomizedProductId	string (90/Optional)	自訂貨號

Response fields

Field	Description
ErrorMsgList	包含此商品verify的error message list
ErrorMsg	包含一組error message
ErrorCode	錯誤代碼 (string)
ErrorParameter	錯誤參數 (string)
ErrorMsg	錯誤訊息 (string)

Sample response

JSON sample

{
  "Response":{
    "@Status":"ok"
  }
}

Errors

ErrorCode	ErrorMessage
1351	商品總數超過上限
1355	非合法的商店代號

其它錯誤請參閱共用錯誤表

/v1/Product/SubmitFreebie

刊登贈品

Attribute	Value
API Name	刊登贈品 (/Product/SubmitFreebie)
API Desc	刊登贈品
Version	1
Request URI	https://tw.ews.mall.yahooapis.com/stauth/v1/Product/SubmitFreebie OR https://tw.ews.mall.yahooapis.com/oauth/v1/Product/SubmitFreebie
Change Log	*

Request parameters

Parameter	Value	Description
ProductType	string (12/Require)	商品型態 Addon/Freebie Addon：加購品 Freebie：贈品
ProductName	string (150/Require)	商品名稱
SalePrice	number (12,2/Require)	網路價賣場上的銷售價格大於0 & 大於"成本價"
CostPrice	number (12,2/Optional)	成本價
ShortDescription	string (200/Require)	商品簡述
Spec.1.Description	string (64/Require)	此欄位請帶入'-'
Spec.1.Stock	int (4/Require)	商品庫存量可接受1~999
Spec.1.SaftyStock	int (4/Require)	商品安全庫存最低警告量不可小於1
Spec.1.CustomizedProductId	string (90/Optional)	自訂貨號

Sample Request：

https://tw.ews.mall.yahooapis.com/stauth/v1/Product/SubmitFreebie?&Format=json

Response fields

Field	Description
ProductId	商品編號 (string) Mall給每一個商品的唯一商品編號
ErrorMsgList	包含此商品verify的error message list
ErrorMsg	包含一組error message
ErrorCode	錯誤代碼 (string)
ErrorParameter	錯誤參數 (string)
ErrorMsg	錯誤訊息 (string)

Sample response

JSON sample

Errors

ErrorCode	ErrorMessage
1351	商品總數超過上限
1355	非合法的商店代號

其它錯誤請參閱共用錯誤表

/v1/Product/UploadImage

商品圖片上傳

Attribute	Value
API Name	圖片上傳 (/Product/UploadImage)
API Desc	商品圖片上傳 Category 資訊
Version	1
Request URI	https://tw.ews.mall.yahooapis.com/stauth/v1/Product/UploadImage OR https://tw.ews.mall.yahooapis.com/oauth/v1/Product/UploadImage
Change Log	*

簽章製作只需針對以下參數來製作 ApiKey,TimeStamp,MainImage,ProductId,Format,Purge

圖檔上傳容量限制：單個圖檔限制:3MB，一次上傳最大量: 10MB

Request parameters

Parameter	Value	Description
ProductId	string(Required)	商品編號
ImageFilen	string(Required)	Image Filename n: 1~10 主商品:10張加購品:1 張贈品: 1張此參數不加入簽章(Signature)運算
MainImage	string(Optional)	商品主圖的ImageFile Image Filename: ImageFile1~ImageFile10 主商品:1~10 加購品:1 (default value) 贈品: 1 (default value)
Purge	string(Optional)	true:將該商品之前上傳所有圖片刪除,保留此次上傳的圖片 false:不清除商品之前上傳的所有圖片

Sample Request：

https://tw.ews.mall.yahooapis.com/stauth/v1/Product/UploadImage?ProductId=p0740162419939&MainImage=ImageFile1&Purge=false&Format=json

Response fields

Field	Description
SuccessList	成功的圖片列表
Image	成功圖片資訊（Name: 圖片名稱；IsMainImage: 是否為商品主圖；FileName: 上傳後的圖檔檔名）
FailList	上傳失敗列表
Image	失敗圖片資訊（Name: 圖片名稱）
PicList	上傳後的商品圖列表
ImageName	上傳後的圖檔檔名
ErrorCode	錯誤代碼
ErrorMessage	錯誤訊息

Sample response

JSON sample

{
  "Response": {
    "@Status": "ok",
    "SuccessList": {
      "Image": [
        {
          "@Name": "ImageFile1",
          "@IsMainImage": "false",
          "@FileName": "p094917013-item-0144xf2x0600x0366-m.jpg"
        },
        {
          "@Name": "ImageFile2",
          "@IsMainImage": "false",
          "@FileName": "p094917013-item-5276xf2x0600x0366-m.jpg"
        },
        {
          "@Name": "ImageFile3",
          "@IsMainImage": "false",
          "@FileName": "p094917013-item-4588xf2x0600x0366-m.jpg"
        },
        {
          "@Name": "ImageFile4",
          "@IsMainImage": "false",
          "@FileName": "p094917013-item-0443xf2x0600x0366-m.jpg"
        },
        {
          "@Name": "ImageFile5",
          "@IsMainImage": "false",
          "@FileName": "p094917013-item-2616xf2x0600x0366-m.jpg"
        },
        {
          "@Name": "ImageFile6",
          "@IsMainImage": "false",
          "@FileName": "p094917013-item-0657xf2x0600x0366-m.jpg"
        },
        {
          "@Name": "ImageFile7",
          "@IsMainImage": "false",
          "@FileName": "p094917013-item-5190xf1x0600x0366-m.jpg"
        },
        {
          "@Name": "ImageFile8",
          "@IsMainImage": "false",
          "@FileName": "p094917013-item-4015xf2x0600x0366-m.jpg"
        },
        {
          "@Name": "ImageFile9",
          "@IsMainImage": "false",
          "@FileName": "p094917013-item-2541xf1x0600x0366-m.jpg"
        },
        {
          "@Name": "ImageFile10",
          "@IsMainImage": "false",
          "@FileName": "p094917013-item-8575xf2x0600x0366-m.jpg"
        }
      ]
    },
    "FailList": [

    ],
    "PicList": {
      "ImageName": [
        "p094917013-item-0144xf2x0600x0366-m.jpg",
        "p094917013-item-5276xf2x0600x0366-m.jpg",
        "p094917013-item-4588xf2x0600x0366-m.jpg",
        "p094917013-item-0443xf2x0600x0366-m.jpg",
        "p094917013-item-2616xf2x0600x0366-m.jpg",
        "p094917013-item-0657xf2x0600x0366-m.jpg",
        "p094917013-item-5190xf1x0600x0366-m.jpg",
        "p094917013-item-4015xf2x0600x0366-m.jpg",
        "p094917013-item-2541xf1x0600x0366-m.jpg",
        "p094917013-item-8575xf2x0600x0366-m.jpg"
      ]
    }
  }
}

Sample Code (PHP)

請按此參考PHP Sample Code 及相關參數說明。

Errors

ErrorCode	ErrorMessage
1101	無上傳檔案
1156	圖片檔案大小太大{max size} bytes
1157	圖片寬度太大。最大為 {max size}
1158	圖片高度太大。最大為 {max size}
1159	圖片格式錯誤
1160	圖片格式不支援
1161	檔案編號取得失敗
1162	縮圖製作失敗
1163	系統錯誤(權限問題)
1164	系統錯誤(未知的錯誤)
1171	超過圖片上傳數量

其它錯誤請參閱共用錯誤表

/v1/Product/GetMainList

取得商店的主商品列表資料

Attribute	Value
API Name	取得主商品列表 (/Product/GetMainList)
API Desc	取得商店主商品列表資料
Version	1
Request URI	https://tw.ews.mall.yahooapis.com/stauth/v1/Product/GetMainList OR https://tw.ews.mall.yahooapis.com/oauth/v1/Product/GetMainList
Change Log	*

Request parameters

Parameter	Value	Description
StoreCategoryId	string(Optional)	需填入leaf層的category Id (空值代表不分類別)
ProductStatus	string(14/Optional)	商品狀態 (空值代表不分狀態) Online:上架中 OnlineLowstock:上架中低庫存 OnlineNostock:上架中無庫存 OnlineOffByReserve:上架中已到期 OfflineWaitByReserve:已預約上架 Offline:已下架 NotOnline:未上架
Keyword	string(Optional)	根據關鍵字進行商品名稱的搜尋
OrderBy	string(Optional)	列表資料依據更新時間的排列順序 Desc:降冪排列(預設值) Asc:升冪排列
Position	int(Require)	由第幾筆開始拿資料
Count	int(Require)	資料筆數 Count=1~100

Response fields

Field	Description
MainList	包含此商店的Main Product List，屬性： Count：資料筆數
TotalCount	符合StoreCategoryId和ProductStatus的總資料筆數
Main	包含一筆Main Product的資料，屬性： Id ：商品編號
Name	商品名稱 (string/150)
SalePrice	網路價 (number/12,2) 賣場上的銷售價格，當 ProductType=Freebie 時 SalePrice=Null
CostPrice	成本價 (number/12,2)
SpecList	包含此商品屬性欄位規格list
Spec	包含一筆Main Product的規格： Id ：商品編號
SpecDescription	型號說明
CustomizeId	自訂貨號 (string)
CurrentStock	商品目前庫存量 (int)
SaftyStock	商品安全庫存最低警告量 (int)

Sample response

JSON sample

{
  "Response": {
    "@Status": "ok",
    "TotalCount": "25",
    "MainList": {
      "@Count": 3,
      "Product": [
        {
          "Main": {
            "@Id": "p094910899",
            "Name": "peter test 2009-12-23",
            "SalePrice": 333,
            "CostPrice": 0,
            "Spec": [
              {
                "@Id": 1,
                "SpecDescription ": "-",
                "CustomizeId": "",
                "CurrentStock": 3,
                "SaftyStock": 1
              }
            ]
          }
        },
        {
          "Main": {
            "@Id": "p094910600",
            "Name": "ZAKKA idea- \u52d5\u7269\u5c0f\u4e16\u754c\u58c1\u8cbc-\u8eb2\u96e8\u5927\u8c61",
            "SalePrice": 399,
            "CostPrice": 0,
            "Spec": [
              {
                "@Id": 1,
                "SpecDescription ": "-",
                "CustomizeId": "",
                "CurrentStock": 996,
                "SaftyStock": 1
              }
            ]
          }
        },
        {
          "Main": {
            "@Id": "p094910584",
            "Name": "\u5317\u6d77\u73cd\u73e0\u9805\u934a~\u5927\u512a\u5f85",
            "SalePrice": 1800,
            "CostPrice": 0,
            "Spec": [
              {
                "@Id": 1,
                "SpecDescription ": "\u7d2b",
                "CustomizeId": "",
                "CurrentStock": 91,
                "SaftyStock": 1
              },
              {
                "@Id": 2,
                "SpecDescription ": "\u767d",
                "CustomizeId": "",
                "CurrentStock": 88,
                "SaftyStock": 1
              },
              {
                "@Id": 3,
                "SpecDescription ": "\u7c89",
                "CustomizeId": "",
                "CurrentStock": 99,
                "SaftyStock": 1
              }
            ]
          }
        }
      ]
    }
  }
}

Errors

ErrorCode	ErrorMessage
1801	StoreCategoryId為空值
1802	ProductStatus為空值
1803	Position為空值或非數字
1804	Count為空值或非數字
1805	StoreCategoryId並不存在
1806	非法的ProductStatus

/v3/Product/GetMain

取得單一主商品資料

Attribute	Value
API Name	取得商品資料 (/Product/GetMain)
API Desc	取得單一主商品資料
Version	3
Request URI	https://tw.ews.mall.yahooapis.com/stauth/v3/Product/GetMain OR https://tw.ews.mall.yahooapis.com/oauth/v3/Product/GetMain
Change Log	2011/09 Init Version.

Request parameters

Parameter	Value	Description
ProductId	string(16/Require)	商品編號

Response fields

Field	Description
ProductId	商品編號 Mall給每一個商品的唯一商品編號
SaleType	商品銷售方式 Normal/PreSaleByShipDate/PreSaleByShipdays Normal：一般方式(現貨銷售) PreSaleByShipDate：DATE 預購 by shipDate(指定出貨日期) PreSaleByShipdays：DAYS 預購 by shipdays(訂購後多少天出貨)
SaleTypeInfo	商品銷售資訊 Normal：empty this field PreSaleByShipDate： Date(2009/11/30) PreSaleByShipdays：Days(20)
ProductStatus	商品狀態 Online:上架中 OnlineLowstock:上架中低庫存 OnlineNostock:上架中無庫存 Offline:已下架 CcBlock:客服下架 Delete:刪除 NotOnline:未上架
ProductName	商品名稱
TaxonomyId	商品分類代號商品刊登的leaf層category Id
BrandId	商品品牌編號
MarketPrice	商品市價
SalePrice	網路價
CostPrice	成本價
MaxBuyNum	最高購買數量 1~100,商品一次最多可被購買的數量(default:30)
ShortDescription	商品簡述
VideoPath	商品影音檔Path符合youtube短網址
LongDescription	商品介紹
LinkAddonList	加購品列表
LinkFreebieList	贈品列表
PayTypeIdList	付款方式代號列表
ShippingIdList	物流方式代號列表
ImageList	包含此商品的商品圖list
Name	商品圖名稱
IsMainImage	是否為商品主圖true:是商品主圖 false:不是商品主圖
ImageUrl	商品圖Url
FullSizeImageUrl	商品大圖Url
SpecList	包含此商品的規格list
@Id	商品規格編號
SpecDescription	商品規格此商品沒有spec,此欄位顯示'-'
CurrentStock	商品庫存量1~999
SaftySock	商品安全庫存最低警告量
CustomizedProductId	自訂貨號
BarCode	商品條碼
ClusterId	商品規格表代號
ClusterAttributeList	商品屬性資料
Name	商品屬性名稱
Content	商品屬性欄位內容依據getMallCategory中的AttributeSpec填
PromotionList	包含此商品的促銷方式list
Amount	商品促銷方式 - 數量商品促銷方式的數量,數量必須大於(n-1).amount
Price	商品促銷方式 - 價格商品促銷方式的價格,價格必須小於網路價,而且要比小於(n-1).price
SpecDimension1	商品規格名稱一
SpecDimension2	商品規格名稱二
CustomizedMainProductId	商品主貨號
SpecTypeDimension	商品規格 (0: 無規格商品, 1: 一個規格商品, 2: 二個規格商品)
StoreCategoryList	商店自訂分類列表

Sample response

JSON sample

{
  "Response": {
    "@Status": "ok", 
    "Product": {
      "CostPrice": 0, 
      "CustomizedMainProductId": "A-12345", 
      "ImageList": {
        "Image": [
          {
            "FullSizeImageUrl": "https://tw.bid.yimg.com/pimg2/64/3b/p09491457373-item-9292xf2x0600x0553-m.jpg",
            "ImageUrl": "https://tw.bid.yimg.com/pimg2/52/52/p09491457373-item-9292xf2x0600x0553-s.jpg", 
            "IsMainImage": "true", 
            "Name": "p09491457373-item-9292xf2x0600x0553-m.jpg"
          }, 
          {
            "FullSizeImageUrl": "https://tw.bid.yimg.com/pimg2/c1/38/p09491457373-item-5969xf2x0507x0600-m.jpg",
            "ImageUrl": "https://tw.bid.yimg.com/pimg2/dd/56/p09491457373-item-5969xf2x0507x0600-s.jpg", 
            "IsMainImage": "false", 
            "Name": "p09491457373-item-5969xf2x0507x0600-m.jpg"
          }, 
          {
            "FullSizeImageUrl": "https://tw.bid.yimg.com/pimg2/41/39/p09491457373-item-1109xf2x0507x0600-m.jpg",
            "ImageUrl": "https://tw.bid.yimg.com/pimg2/32/d9/p09491457373-item-1109xf2x0507x0600-s.jpg", 
            "IsMainImage": "false", 
            "Name": "p09491457373-item-1109xf2x0507x0600-m.jpg"
          }
        ]
      }, 
      "IsTaxFree": 0, 
      "LinkAddonList": {
        "LinkAddon": [
          {
            "@Id": "p09491436060", 
            "Desc": "YIV_FILTER_STRIPPEDYIV_FILTER_STRIPPED", 
            "Image": {
              "FullSizeImageUrl": "", 
              "ImageUrl": ""
            }, 
            "ProductStatus": "Online", 
            "_Title": "\u6e2c\u8a66\u52a0\u8cfc\u54c12015"
          }
        ]
      }, 
      "LinkFreebieList": {
        "LinkFreebie": [
          {
            "@Id": "p09491435984", 
            "Desc": "test", 
            "Image": {
              "FullSizeImageUrl": "", 
              "ImageUrl": ""
            }, 
            "ProductStatus": "Online", 
            "_Title": "\u6eff\u4ef6\u9001"
          }
        ]
      }, 
      "TaxonomyId": 31813933,
      "ClusterId": "31917367",
            "ClusterAttributeList": [
                {
                    "Name": "品牌",
                    "Value": "測試店"
                },
                {
                    "Name": "顏色",
                    "Value": "黑"
                },
                {
                    "Name": "尺寸",
                    "Value": "XS,S,M,L,XL"
                }
            ], 
      "BrandId": "41172378",
      "MarketPrice": 10, 
      "MaxBuyNum": 20, 
      "PayTypeIdList": {
        "PayTypeId": [
          {
            "@Id": 1
          }, 
          {
            "@Id": 2
          }, 
          {
            "@Id": 4
          }, 
          {
            "@Id": 5
          }, 
          {
            "@Id": 6
          }, 
          {
            "@Id": 7
          }, 
          {
            "@Id": 8
          }, 
          {
            "@Id": 9
          }, 
          {
            "@Id": 10
          }, 
          {
            "@Id": 11
          }
        ]
      }, 
      "ProductId": "p09491457373", 
      "ProductStatus": "NotOnline",
      "SalePrice": 10, 
      "SaleType": "Normal", 
      "SaleTypeInfo": "", 
      "ShippingIdList": {
        "ShippingId": [
          {
            "@Id": 1
          }, 
          {
            "@Id": 2
          }, 
          {
            "@Id": 3
          }, 
          {
            "@Id": 80
          }
        ]
      }, 
      "SpecDimensionList": {
        "SpecDimension": [
          {
            "@Id": 1, 
            "DescriptionList": {
              "Description": [
                {
                  "@Id": 1, 
                  "_Name": "\u7d05\u8272"
                }, 
                {
                  "@Id": 2, 
                  "_Name": "\u9ec3\u8272"
                }
              ]
            }
          }, 
          {
            "@Id": 2, 
            "DescriptionList": {
              "Description": [
                {
                  "@Id": 1, 
                  "_Name": "L"
                }
              ]
            }
          }
        ]
      }, 
      "SpecList": {
        "Spec": [
          {
            "@Id": 1, 
            "CurrentStock": 1, 
            "CustomizedProductId": "Q-1234",
            "BarCode": "12341234",            
            "DimensionList": {
              "Dimension": [
                {
                  "@Id": 1, 
                  "Description": {
                    "@Id": 1
                  }
                }, 
                {
                  "@Id": 2, 
                  "Description": {
                    "@Id": 1
                  }
                }
              ]
            }, 
            "SaftyStock": 1, 
            "Stock": 1, 
            "_SpecDescription": "\u7d05\u8272/L"
          }, 
          {
            "@Id": 2, 
            "CurrentStock": 1, 
            "CustomizedProductId": "Q-5678", 
            "BarCode": "50345234",
            "DimensionList": {
              "Dimension": [
                {
                  "@Id": 1, 
                  "Description": {
                    "@Id": 2
                  }
                }, 
                {
                  "@Id": 2, 
                  "Description": {
                    "@Id": 1
                  }
                }
              ]
            }, 
            "SaftyStock": 1, 
            "Stock": 1, 
            "_SpecDescription": "\u9ec3\u8272/L"
          }
        ]
      }, 
      "SpecTypeDimension": 2, 
      "StoreCategoryList": "", 
      "_LongDescription": "\u5546\u54c1\u4ecb\u7d39\u5340\u57df\n", 
      "_ProductName": "API \u7bc4\u4f8b\u6e2c\u8a66\u5546\u54c1", 
      "_ShortDescription": "\u5546\u54c1\u7c21\u8ff0\u5340\u57df", 
      "_SpecDimension1": "\u984f\u8272", 
      "_SpecDimension2": "\u5c3a\u5bf8", 
      "_VideoPath": ""
    }
  }
}

Errors

ErrorCode	ErrorMessage
1384	商品編號非主商品

其它錯誤請參閱共用錯誤表

/v1/Product/GetAddon

取得單一加購品資料

Attribute	Value
API Name	取得加購品資料 (/Product/GetAddon)
API Desc	取得單一加購品資料
Version	1
Request URI	https://tw.ews.mall.yahooapis.com/stauth/v1/Product/GetAddon OR https://tw.ews.mall.yahooapis.com/oauth/v1/Product/GetAddon
Change Log	*

Request parameters

Parameter	Value	Description
ProductId	string(16/Require)	商品編號

Response fields

Field	Description
ProductId	商品編號 Mall給每一個商品的唯一商品編號
ProductStatus	商品狀態 Online:上架中 OnlineLowstock:上架中低庫存 OnlineNostock:上架中無庫存 Offline:已下架 CcBlock:客服下架 Delete:刪除 NotOnline:未上架
ProductName	商品名稱
ImageMain	商品主圖縮圖url
MarketPrice	商品市價
SalePrice	網路價
CostPrice	成本價
ShortDescription	商品簡述
SpecList	包含此商品的規格list
@Id	商品規格編號
SpecDescription	商品規格此商品沒有spec,此欄位顯示'-'
CurrentStock	商品庫存量1~999
SaftySock	商品安全庫存最低警告量
CustomizedProductId	自訂貨號

Sample response

JSON sample

{ "Response" : { "@Status" : "ok",
      "Product" : { "CostPrice" : 100,
          "ImageMain" : "https://b-iu101.ac.tw1.yahoo.com/pimg1/c0/05/p09498618-itema-1991xf1x0300x0183-s.jpg",
          "MarketPrice" : 0,
          "ProductId" : "p09498618",
          "ProductName" : "清涼櫻花剉冰111",
          "ProductStatus" : "Online",
          "SalePrice" : 200,
          "ShortDescription" : "白玉櫻花剉冰~清涼退火又消暑",
          "spec" : [ { "@Id" : 1,
                "CurrentStock" : 300,
                "CustomizedProductId" : "",
                "SpecDescription " : "-",
                "Stock" : 1
              } ]
        }
    } }

Errors

ErrorCode	ErrorMessage
1385	商品編號非加購品

其它錯誤請參閱共用錯誤表

/v1/Product/GetFreebie

取得單一贈品資料

Attribute	Value
API Name	取得贈品資料 (/Product/GetFreebie)
API Desc	取得單一贈品資料
Version	1
Request URI	https://tw.ews.mall.yahooapis.com/stauth/v1/Product/GetFreebie OR https://tw.ews.mall.yahooapis.com/oauth/v1/Product/GetFreebie
Change Log	*

Request parameters

Parameter	Value	Description
ProductId	string(16/Require)	商品編號

Response fields

Field	Description
ProductId	商品編號 Mall給每一個商品的唯一商品編號
ProductStatus	商品狀態 Online:上架中 OnlineLowstock:上架中低庫存 OnlineNostock:上架中無庫存 Offline:已下架 CcBlock:客服下架 Delete:刪除 NotOnline:未上架
ProductName	商品名稱
ImageMain	商品主圖縮圖url
CostPrice	成本價
ShortDescription	商品簡述
SpecList	包含此商品的規格list
@Id	商品規格編號
SpecDescription	商品規格此商品沒有spec,此欄位顯示'-'
CurrentStock	商品庫存量1~999
SaftySock	商品安全庫存最低警告量
CustomizedProductId	自訂貨號

Sample response

JSON sample

{ "Response" : { "@Status" : "ok",
      "Product" : { "CostPrice" : 10,
          "ImageMain" : "https://tw.bid.yimg.com/pimg1/a7/a7/p09499467-itema-1253xf1x0300x0157-s.jpg",
          "ProductId" : "p09499467",
          "ProductName" : "Jeff test 贈品",
          "ProductStatus" : "Online",
          "ShortDescription" : "test test tttt",
          "spec" : [ { "@Id" : 1,
                "CurrentStock" : 500,
                "CustomizedProductId" : "",
                "SpecDescription " : "-",
                "Stock" : 5
              } ]
        }
    } }

Errors

ErrorCode	ErrorMessage
1386	商品編號非加贈品

其它錯誤請參閱共用錯誤表

/v1/Product/UpdateMain

更新單一主商品資料

Attribute	Value
API Name	更新商品資料 (/Product/UpdateMain)
API Desc	更新單一主商品資料
Version	1
Request URI	https://tw.ews.mall.yahooapis.com/stauth/v1/Product/UpdateMain OR https://tw.ews.mall.yahooapis.com/oauth/v1/Product/UpdateMain
Change Log	2011/07 - 新增 CustomizedMainProductId (自訂商品主貨號), SpecDimension1(商品規格名稱1), SpecDimension2 (商品規格名稱2)

Request parameters

Parameter	Value	Description
ProductId	string (16/Require)	商品編號
SaleType	string (20/Optional)	商品銷售方式 Normal/PreSaleByShipDate/PreSaleByShipdays Normal：一般方式(現貨銷售) PreSaleByShipDate：DATE 預購 by shipDate(指定出貨日期) PreSaleByShipdays：DAYS 預購 by shipdays(訂購後多少天出貨)
SaleTypeInfo	string (Optional)	商品銷售資訊 Normal：empty this field PreSaleByShipDate： Date(2009/11/30) PreSaleByShipdays：Days(20)
ProductName	string (150/Optional)	商品名稱
TaxonomyId	string (Require)	商品分類代號商品欲刊登的leaf層category id
StoreCategoryId	int (Optional)	商品歸類可接受多筆，請重複使用此parameter ex：StoreCategoryId=1234&StoreCategoryId=1235
BrandId	string (Require)	商品品牌編號請參考 https://tw.user.mall.yahoo.com/store_admin/view/brandIdSearch (需有小幫手權限方可查看)
MarketPrice	number (12,2/Optional)	商品市價
SalePrice	number (12,2/Optional)	網路價賣場上的銷售價格，需大於0 & 大於"成本價"
CostPrice	number (12,2/Optional)	成本價
MaxBuyNum	int (3/Optional)	最高購買數量商品一次最多可被購買的數量(default:30) 可接受1~100
ShortDescription	string (200/Optional)	商品簡述
VideoPath	string (256/Optional)	商品影音檔Path 符合youtube短網址
LongDescription	string (Optional)	商品介紹
LinkAddon	string (Optional)	加購品可帶多個加購品商品編號，請重複使用此parameter ex：LinkAddon=P13456& LinkAddon=P13456
LinkFreebie	string (Optional)	贈品可帶多個贈品商品編號，請重複使用此parameter ex：LinkFreebie=P13456& LinkFreebie=P13456
PayTypeId	int (Optional)	付款方式代號商品可接受的付款方式，可帶多個付款方式，請重複使用此parameter ex：PayTypeId=1&PayTypeId=1
ShippingId	int (Optional)	物流方式代號商品可接受的物流方式，可帶多個物流方式，請重複使用此parameter ex：ShippingId=1&ShippingId=1
ClusterId	string (Require)	商品規格表代號商品分類代號（TaxonomyId）可能對應多個商品規格表代號（ClusterId），請選擇最適合的商品規格表在此處填入代號，並需填寫對應的 Attributes ex：ClusterId=18744273
Attribute.n.Name	string (Optional)	商品屬性欄位名稱可建立多組商品屬性資料一組商品屬性資料包含：Attribute.n.Name + Attribute.n.Content 請將parameter中的"n"以數字代換，ex：Attribute.1.Name=材質特別說明: 當商城類別選擇以下類別時, 本欄位為必填值, 本欄位必須增填 [分級標示], 而且在 Attribute.n.Value 的欄位也須增填商品級別(相關說明請見 Attribute.n.Value) "圖書/文具 > 書籍/雜誌期刊" (含以下) "圖書/文具 > 音樂/電影/影集" 之相關的類別"休閒/交通 > 18禁專區 > 限制級書籍/寫真" (含以下) "休閒/交通 > 18禁專區 > 限制級影音" (含以下) 當商城類別選擇以下類別時, 本欄位為必填值, 本欄位必須增填 [分級標示], 若是商品本身有情節時, 尚需額外增填 [情節標示] (無情節免填), 而且在 Attribute.n.Value 的欄位也須增填商品級別和情節內容(相關說明請見 Attribute.n.Value) "消費電子 > 電玩/玩具" 之相關的類別"休閒/交通 > 18禁專區 > 18禁電玩遊戲" (含以下) 當類別選擇 No1 or 2 時, 因為欄位值有對應關係, n 的數字也要對應, 且必須配合 Attribute.n.Value 的欄位值(相關說明請見 Attribute.n.Value) Ex：Attribute.1.Name=分級標示 & Attribute.2.Name=情節標示
Attribute.n.Value	string (Optional)	商品屬性欄位內容請將parameter中的"n"以數字代換，ex：Attribute.1.Value=棉特別說明：當商城類別選擇 "圖書/文具 > 書籍/雜誌期刊" (含以下) 的類別時, 本欄位為必填值, 本欄位必須增填 [普級] Ex：假如Attribute.1.Name=分級標示, 則 Attribute.1.Value=普級當商城類別選擇 "圖書/文具 > 音樂/電影/影集"相關的類別時, 本欄位為必填值, 本欄位必須增填 [普級] 或 [保護級] 或 [輔導級] 三擇一Ex：假如Attribute.1.Name=分級標示, 則 Attribute.1.Value=保護級當商城類別選擇 "休閒/交通 > 18禁專區 > 限制級書籍/寫真" (含以下) 的類別時, 本欄位為必填值, 本欄位必須增填 [限制級] Ex：假如Attribute.1.Name=分級標示, 則 Attribute.1.Value=限制級當商城類別選擇 "休閒/交通 > 18禁專區 > 限制級影音" (含以下) 的類別時, 本欄位為必填值, 本欄位必須增填 [限制級] Ex：假如Attribute.1.Name=分級標示, 則 Attribute.1.Value=限制級當商城類別選擇 "消費電子 > 電玩/玩具"相關的類別時, 本欄位為必填值, 本欄位必須增填 [普級] 或 [保護級] 或 [輔導級+12] 或 [輔導級+15] 四擇一。當商品有情節時(無情節免填), 商品依法須標示情節, 欄位也須增填情節內容(情節請見 No 7 和 8) Ex： (有商品情節)假如Attribute.1.Name=分級標示和 Attribute.2.Name=情節標示, 則 Attribute.1.Value=輔導級+12, Attribute.2.Value=性,暴力,恐怖 (無商品情節)假如Attribute.1.Name=分級標示, 則 Attribute.1.Value=保護級當商城類別選擇 "休閒/交通 > 18禁專區 > 18禁電玩遊戲" (含以下) 的類別時, 本欄位為必填值, 本欄位必須增填 [限制級] 。當商品有情節時(無情節免填), 商品依法須標示情節, 欄位也須增填情節內容(情節請見 No 7 和 8) Ex：假如Attribute.1.Name=分級標示和 Attribute.2.Name=情節標示, 則 Attribute.1.Value=限制級, Attribute.2.Value=恐怖,不當言語,反社會性,棋牌益智「情節標示」欄位只可填 [性], [暴力], [恐怖], [菸酒], [毒品], [不當言語], [反社會性], [棋牌益智], [戀愛交友] 9 個選項(可複選) 「分級標示」和「情節標示」欄位只接受固定的級別與這 9 個選項, 複選的選項請用逗號隔開, 請勿填錯字, 以免操作失敗.
ProductPromotion.n.Amount	int (Optional)	商品促銷方式 - 數量可建立多組商品促銷方式資料一組商品屬性資料包含：ProductPromotion.n.Amount + ProductPromotion.n.Price 請將parameter中的"n"以數字代換，ex：ProductPromotion.1.Amount=5 ProductPromotion.n.Amount必須大於 ProductPromotion.(n-1).amount
ProductPromotion.n.Price	int (Optional)	商品促銷方式 - 價格請將parameter中的"n"以數字代換，ex：ProductPromotion.1.Price=100 ProductPromotion.n.Price必須小於網路價，而且要小於ProductPromotion.(n-1).Price
IsTaxFree	int(Optional)	此商品是否為免稅商品商店為免稅商店及商品刊登於免稅分類時，此設定才能被設定為1。(default:0) 當此設定為1時，就不得設定加購品
DeleteAddon	string(Optional)	此商品是否移除加購品資訊如果要移除加購品資訊，則設定為 true。(default:false) 當此設定為 true 時，就不得使用 LinkAddon 設定加購品
DeleteFreebie	string(Optional)	此商品是否刪除贈品資訊如果要移除贈品資訊，則設定為 true。(default:false) 當此設定為 true 時，就不得使用 LinkFreebie 設定贈品
CustomizedMainProductId	string(Optional)	自訂商品主貨號
SpecDimension1	string(Optional)	商品規格名稱1
SpecDimension2	string(Optional)	商品規格名稱2
DeleteProductPromotion	string(Optional)	此商品是否移除商品促銷方式如果要移除促銷方式，則設定為 true。(default:false) 當此設定為 true 時，就不得使用 ProductPromotion 設定商品促銷方式

Sample Request：

https://tw.ews.mall.yahooapis.com/stauth/v1/Product/UpdateMain?ProductId=p0740162400890&ProductName=%E6%B8%AC%E8%A9%A6API%E6%9B%B4%E6%96%B0%E5%95%86%E5%93%810613&SalePrice=2&ShortDescription=%E6%B8%AC%E8%A9%A6%E5%95%86%E5%93%81%EF%BC%8C%E4%B8%8D%E6%9C%83%E5%87%BA%E8%B2%A8%E3%80%82%E6%9B%B4%E6%96%B0%E6%96%87%E5%AD%97%E3%80%82&Format=json

Response fields

Field	Description
ProductId	商品編號 (string) Mall給每一個商品的唯一商品編號
ErrorMsgList	包含此商品verify的error message list
ErrorMsg	包含一組error message
ErrorCode	錯誤代碼 (string)
ErrorParameter	錯誤參數 (string)
ErrorMsg	錯誤訊息 (string)

Sample response

JSON sample

{
  "Response":{
    "@Status":"ok",
    "ProductId":"p098547550"
  }
}

Errors

ErrorCode	ErrorMessage
1310	Attribute: 商品屬性為非合法值
1311	Attribute: 商品屬性不可為空值
1351	商品總數超過上限
1352	加購品超出上限 {max addon limit}
1353	贈品超出上限 {max gift limit}
1354	當商品為免稅時，不可設定加購品
1355	非合法的商店代號
1356	Spec: 規格不可為空值
1371	Promotion: 數量與價錢必須是成對的值
1372	Attribute: 欄位名稱和欄位內容必須是成對的值
1373	不得同時設定加購品以及移除加購品
1374	不得同時設定贈品以及移除贈品
1375	不得同時設定優惠條件又移除優惠條件

其它錯誤請參閱共用錯誤表

/v1/Product/UpdateAddon

更新單一加購品資料

Attribute	Value
API Name	更新單一加購品 (/Product/UpdateAddon)
API Desc	更新單一加購品資料
Version	1
Request URI	https://tw.ews.mall.yahooapis.com/stauth/v1/Product/UpdateAddon OR https://tw.ews.mall.yahooapis.com/oauth/v1/Product/UpdateAddon
Change Log	*

Request parameters

Parameter	Value	Description
ProductId	string (16/Require)	商品編號
ProductName	string (150/Optional)	商品名稱
SalePrice	number (12,2/Optional)	網路價賣場上的銷售價格大於0 & 大於"成本價"
CostPrice	number (12,2/Optional)	成本價
ShortDescription	string (200/Optional)	商品簡述

Response fields

Field	Description
ProductId	商品編號 (string) Mall給每一個商品的唯一商品編號
ErrorMsgList	包含此商品verify的error message list
ErrorMsg	包含一組error message
ErrorCode	錯誤代碼 (string)
ErrorParameter	錯誤參數 (string)
ErrorMsg	錯誤訊息 (string)

Sample response

JSON sample

{
  "Response":{
    "@Status":"ok",
    "ProductId":"p098547550"
  }
}

Errors

ErrorCode	ErrorMessage
1351	商品總數超過上限
1355	非合法的商店代號

其它錯誤請參閱共用錯誤表

/v1/Product/UpdateFreebie

更新單一贈品資料

Attribute	Value
API Name	更新單一贈品資料 (/Product/UpdateFreebie)
API Desc	更新單一贈品資料
Version	1
Request URI	https://tw.ews.mall.yahooapis.com/stauth/v1/Product/UpdateFreebie OR https://tw.ews.mall.yahooapis.com/oauth/v1/Product/UpdateFreebie
Change Log	*

Request parameters

Parameter	Value	Description
ProductId	string (16/Require)	商品編號
ProductName	string (150/Optional)	商品名稱
SalePrice	number (12,2/Optional)	網路價賣場上的銷售價格大於0 & 大於"成本價"
ShortDescription	string (200/Optional)	商品簡述

Response fields

Field	Description
ProductId	商品編號 (string) Mall給每一個商品的唯一商品編號
ErrorMsgList	包含此商品verify的error message list
ErrorMsg	包含一組error message
ErrorCode	錯誤代碼 (string)
ErrorParameter	錯誤參數 (string)
ErrorMsg	錯誤訊息 (string)

Sample response

JSON sample

Errors

ErrorCode	ErrorMessage
1351	商品總數超過上限
1355	非合法的商店代號

其它錯誤請參閱共用錯誤表

/v1/Product/UpdateStock

更新商品庫存

Attribute	Value
API Name	更新商品庫存 (/Product/UpdateStock)
API Desc	更新特定單一商品庫存量
Version	1
Request URI	https://tw.ews.mall.yahooapis.com/stauth/v1/Product/UpdateStock OR https://tw.ews.mall.yahooapis.com/oauth/v1/Product/UpdateStock
Change Log	*

Request parameters

Parameter	Value	Description
ProductId	string (16/Require)	商品編號
Spec.n.Id	int (3/Require)	規格編號請將parameter中的"n"以數字代換 ex：Spec.1.Id=1
Spec.n.CustomizedProductId	string (90/Optional)	自訂貨號此欄位有值將會與平台上的資料進行比對請將parameter中的"n"以數字代換， ex：Spec.1.CustomizedProductId=w001
Spec.n.Action	string (3/Require)	對庫存做的動作(增加/減少) 請將parameter中的"n"以數字代換， add:增加 del:減少
Spec.n.Stock	int (4/Require)	庫存量請將parameter中的"n"以數字代換，
Spec.n.ExpectStock	int (4/Optional)	期待完成後的商品庫存量請將parameter中的"n"以數字代換，
Spec.n.SaftyStock	int (4/Optional)	商品安全庫存最低警告量不可小於1 請將parameter中的"n"以數字代換，

Response fields

Field	Description
ProductId	商品編號 (string) Mall給每一個商品的唯一商品編號
SuccessList	成功的規格列表
Spec	商品規格
@Id	商品規格編號
FailList	失敗的規格列表
Spec	商品規格
@Name	傳入的第n個商品規格
ErrorCode	錯誤代碼 (string)
ErrorParameter	錯誤參數 (string)
ErrorMsg	錯誤訊息 (string)

Sample response

JSON sample

{
  "Response": {
    "@Status": "ok",
    "ProductId": "p094948102",
    "SuccessList": {
      "Spec": [
        {
          "@Id": 1
        },
        {
          "@Id": 2
        }
      ]
    },
    "FailList": [

    ]
  }
}

Errors

ErrorCode	ErrorMessage
1374	商品規格編號不存在
1375	期待完成後的商品庫存量不正確

其它錯誤請參閱共用錯誤表

/v1/Product/UpdateSpec

更新商品規格

Attribute	Value
API Name	更新商品規格 (/Product/UpdateSpec)
API Desc	更新特定單一商品規格
Version	1
Request URI	https://tw.ews.mall.yahooapis.com/stauth/v1/Product/UpdateSpec OR https://tw.ews.mall.yahooapis.com/oauth/v1/Product/UpdateSpec
Change Log	*

Request parameters

Parameter	Value	Description
ProductId	string (16/Require)	商品編號
SpecId	number (3/Require)	商品規格編號
CustomizedProductId	string (90/Optional)	自訂貨號，當要刪除該筆自訂貨號時，請將 CustomizedProductId 設定為 -
BarCode	string (8 or 13/Optional)	商品條碼，當要刪除該筆商品條碼時，請將 BarCode 設定為 -

Sample Request：

https://tw.ews.mall.yahooapis.com/stauth/v1/Product/UpdateSpec?ProductId=p0740162400890&SpecId=1&CustomizedProductId=%E8%87%AA%E8%A8%82%E8%B2%A8%E8%99%9F0613&BarCode=4990012585847&Format=json

Response fields

Field	Description
ProductId	商品編號 (string) Mall給每一個商品的唯一商品編號
SpecId	商品規格編號
ErrorMsgList	包含此商品verify的error message list
ErrorCode	錯誤代碼 (string)
ErrorParameter	錯誤參數 (string)
ErrorMsg	錯誤訊息 (string)

Sample response

JSON sample

{
  "Response": {
    "@Status": "ok",
    "ProductId": "p094911467",
    "SpecId": 5
  }
}

Errors

ErrorCode	ErrorMessage
1374	商品規格編號不存在
1384	商品編號不是主商品

其它錯誤請參閱共用錯誤表

/v1/Product/UpdateMultiSpec

批次更新商品規格

Attribute	Value
API Name	批次更新商品規格 (/Product/UpdateMultiSpec)
API Desc	批次更新多筆商品規格 (自訂貨號)
Version	1
Request URI	https://tw.ews.mall.yahooapis.com/stauth/v1/Product/UpdateMultiSpec OR https://tw.ews.mall.yahooapis.com/oauth/v1/Product/UpdateMultiSpec
Change Log	2011/08 - Init Version.

Request parameters

Parameter	Value	Description
ProductId	string (16/Require)	商品編號
Spec.n.Id	int (3/Require)	規格編號
Spec.n.CustomizedProductId	string (30/Required )	自訂貨號，當要刪除該筆自訂貨號時，請將 Spec.n.CustomizedProductId 設定為 -
Spec.n.BarCode	string (8 or 13/Required )	商品條碼，當要刪除該筆商品條碼時，請將 Spec.n.BarCode 設定為 -

Sample Request：

https://tw.ews.mall.yahooapis.com/stauth/v1/Product/UpdateMultiSpec?ProductId=p0740162419939&Spec.1.Id=1&Spec.1.CustomizedProductId=%E8%A6%8F%E6%A0%BC1%E8%87%AA%E8%A8%82%E8%B2%A8%E8%99%9F0613%28%E9%BB%91%29&Spec.1.BarCode=4990012585847&Spec.2.Id=2&Spec.2.CustomizedProductId=%E8%A6%8F%E6%A0%BC2%E8%87%AA%E8%A8%82%E8%B2%A8%E8%99%9F0613%28%E9%8A%80%29&Spec.2.BarCode=4990012585847&Spec.3.Id=3&Spec.3.CustomizedProductId=%E8%A6%8F%E6%A0%BC3%E8%87%AA%E8%A8%82%E8%B2%A8%E8%99%9F0613%28%E9%87%91%29&Spec.3.BarCode=4990012585847&Format=json

Response fields

Field	Description
ProductId	商品編號 (string) Mall給每一個商品的唯一商品編號
SuccessList	成功的規格列表
Spec	商品規格
@Id	商品規格編號
FailList	失敗的規格列表
Spec	商品規格
@Name	傳入的第n個商品規格
ErrorCode	錯誤代碼 (string)
ErrorParameter	錯誤參數 (string)
ErrorMsg	錯誤訊息 (string)

Sample response

JSON sample

{
  "Response": {
    "@Status": "ok",
    "ProductId": "p094948102",
    "SuccessList": {
      "Spec": [
        {
          "@Id": 1
        },
        {
          "@Id": 2
        }
      ]
    },
    "FailList": [

    ]
  }
}

Errors

ErrorCode	ErrorMessage
1374	商品規格編號不存在
1375	期待完成後的商品庫存量不正確

其它錯誤請參閱共用錯誤表

/v2/Product/AddSpecDimension

新增商品規格

Attribute	Value
API Name	新增商品規格 (/Product/AddSpecDimension)
API Desc	可以新增一階層或是二階層的商品規格, 取代舊有 /Product/AddSpec 功能
Version	2
Request URI	http://tw.ews.mall.yahooapis.com/stauth/v2/Product/AddSpecDimension OR http://tw.ews.mall.yahooapis.com/oauth/v2/Product/AddSpecDimension
Change Log	2011/09 - Init Version.

Request parameters

Parameter

Value

Description

ProductId

string (16/Require)

商品編號

SpecDimension1Description

string (64/Optional)

第一階商品規格名稱描述編號，可新增多筆，最多 40 筆。

例如：SpecDimension1Description=L&SpecDimension1Description=M

SpecDimension2Description

string (64/Optional)

第二階商品規格名稱描述編號，可新增多筆，最多 40 筆。

例如：SpecDimension2Description=White&SpecDimension2Description=Yellow

注意：所有商品展開後，商品規格總數不得超過 60 種。

Response fields

Field	Description
ProductId	商品編號 (string) Mall給每一個商品的唯一商品編號
SpecDimensionList	商品規格名稱編號
ErrorMsgList	包含此商品verify的error message list
ErrorCode	錯誤代碼 (string)
ErrorParameter	錯誤參數 (string)
ErrorMsg	錯誤訊息 (string)

Sample response

JSON sample

{
  "Response": {
    "@Status": "ok", 
    "Product": {
      "@Id": "p09491457373", 
      "SpecDimensionList": {
        "SpecDimension": [
          {
            "@Id": 1, 
            "DescriptionList": {
              "Description": [
                {
                  "@Id": 3, 
                  "_Name": "\u6a58\u8272"
                }
              ]
            }
          }, 
          {
            "@Id": 2, 
            "DescriptionList": {
              "Description": [
                {
                  "@Id": 2, 
                  "_Name": "XL"
                }
              ]
            }
          }
        ]
      }, 
      "SpecList": {
        "Spec": [
          {
            "@Id": 3, 
            "CurrentStock": 0, 
            "CustomizedProductId": "", 
            "DimensionList": {
              "Dimension": [
                {
                  "@Id": 1, 
                  "Description": {
                    "@Id": 1
                  }
                }, 
                {
                  "@Id": 2, 
                  "Description": {
                    "@Id": 2
                  }
                }
              ]
            }, 
            "SaftyStock": 1, 
            "_SpecDescription": "\u7d05\u8272/XL"
          }, 
          {
            "@Id": 4, 
            "CurrentStock": 0, 
            "CustomizedProductId": "", 
            "DimensionList": {
              "Dimension": [
                {
                  "@Id": 1, 
                  "Description": {
                    "@Id": 2
                  }
                }, 
                {
                  "@Id": 2, 
                  "Description": {
                    "@Id": 2
                  }
                }
              ]
            }, 
            "SaftyStock": 1, 
            "_SpecDescription": "\u9ec3\u8272/XL"
          }, 
          {
            "@Id": 5, 
            "CurrentStock": 0, 
            "CustomizedProductId": "", 
            "DimensionList": {
              "Dimension": [
                {
                  "@Id": 1, 
                  "Description": {
                    "@Id": 3
                  }
                }, 
                {
                  "@Id": 2, 
                  "Description": {
                    "@Id": 1
                  }
                }
              ]
            }, 
            "SaftyStock": 1, 
            "_SpecDescription": "\u6a58\u8272/L"
          }, 
          {
            "@Id": 6, 
            "CurrentStock": 0, 
            "CustomizedProductId": "", 
            "DimensionList": {
              "Dimension": [
                {
                  "@Id": 1, 
                  "Description": {
                    "@Id": 3
                  }
                }, 
                {
                  "@Id": 2, 
                  "Description": {
                    "@Id": 2
                  }
                }
              ]
            }, 
            "SaftyStock": 1, 
            "_SpecDescription": "\u6a58\u8272/XL"
          }
        ]
      }
    }
  }
}

Errors

ErrorCode	ErrorMessage
1374	商品規格編號不存在
1377	不能刪除自訂貨號不相符或內定的規格
1378	商品規格數量必須大於0

其它錯誤請參閱共用錯誤表

/v1/Product/DeleteSpecDimension

刪除商品規格

Attribute	Value
API Name	刪除商品規格 (/Product/DeleteSpecDimension)
API Desc	刪除商品第一階或是第二階的規格, 取代 /Product/DeleteSpec
Version	1
Request URI	http://tw.ews.mall.yahooapis.com/stauth/v1/Product/DeleteSpecDimension OR http://tw.ews.mall.yahooapis.com/oauth/v1/Product/DeleteSpecDimension
Change Log	2011/08 - Init Version.

Request parameters

Parameter

Value

Description

ProductId

string (16/Require)

商品編號

SpecDimension1DescriptionId

number (3/Optional)

第一階商品規格名稱描述編號，可刪除多筆。

例如：SpecDimension1DescriptionId=1&SpecDimension1DescriptionId=2

SpecDimension2DescriptionId

number (3/Optional)

第二階商品規格名稱描述編號，可刪除多筆。

例如：SpecDimension2DescriptionId=1&SpecDimension2DescriptionId=2

Sample response

JSON sample

{
  "Response": {
    "@Status": "ok",
    "ProductId": "p094911467"
  }
}

Errors

ErrorCode	ErrorMessage
1374	商品規格編號不存在
1377	不能刪除自訂貨號不相符或內定的規格
1378	商品規格數量必須大於0

其它錯誤請參閱共用錯誤表

/v1/Product/Online

商品上架

Attribute	Value
API Name	商品上架 (/Product/Online)
API Desc	將單一商品上架
Version	1
Request URI	http://tw.ews.mall.yahooapis.com/stauth/v1/Product/Online OR http://tw.ews.mall.yahooapis.com/oauth/v1/Product/Online
Change Log	*

Request parameters

Parameter

Value

Description

ProductId

string (16/Require)

商品編號 ,可接受多筆

ex1.ProductId=p123456&ProductId=12345676,

ex2.ProductId=p123456&ProductId=12345676&ProductId=12345788,

每次limit=50

Response fields

Field	Description
SuccessList	成功的規格列表
Product	商品
@Id	商品編號
FailList	失敗的規格列表
Product	商品
@Id	商品編號
ErrorCode	錯誤代碼 (string)
ErrorParameter	錯誤參數 (string)
ErrorMsg	錯誤訊息 (string)

Sample response

JSON sample

{
  "Response": {
    "@Status": "ok",
    "SuccessList": {
      "Product": [
        {
          "@Id": "p094948743"
        },
        {
          "@Id": "p094948744"
        },
        {
          "@Id": "p094948745"
        },
        {
          "@Id": "p094948746"
        },
        {
          "@Id": "p094948747"
        }
      ]
    },
    "FailList": [

    ]
  }
}

Errors

ErrorCode	ErrorMessage
1381	不能上架狀態為 PDB_PRODUCT_STOCK_NOSTOCK, PDB_PRODUCT_STATUS _CCBLOCK, PDB_PRODUCT_STATUS_ONLINE 及出貨日期有問題的商品

其它錯誤請參閱共用錯誤表

/v1/Product/Offline

下架商品

Attribute	Value
API Name	下架商品 (/Product/Offline)
API Desc	將單一商品下架
Version	1
Request URI	http://tw.ews.mall.yahooapis.com/stauth/v1/Product/Offline OR http://tw.ews.mall.yahooapis.com/oauth/v1/Product/Offline
Change Log	*

Request parameters

Parameter

Value

Description

ProductId

string (16/Require)

商品編號 ,可接受多筆

ex1.ProductId=p123456&ProductId=12345676,

ex2.ProductId=p123456&ProductId=12345676&ProductId=12345788,

每次limit=50

Response fields

Field	Description
SuccessList	成功的規格列表
Product	商品
@Id	商品編號
FailList	失敗的規格列表
Product	商品
@Id	商品編號
ErrorCode	錯誤代碼 (string)
ErrorParameter	錯誤參數 (string)
ErrorMsg	錯誤訊息 (string)

Sample response

JSON sample

{
  "Response": {
    "@Status": "ok",
    "SuccessList": {
      "Product": [
        {
          "@Id": "p094948743"
        },
        {
          "@Id": "p094948744"
        },
        {
          "@Id": "p094948745"
        },
        {
          "@Id": "p094948746"
        },
        {
          "@Id": "p094948747"
        }
      ]
    },
    "FailList": [

    ]
  }
}

Errors

ErrorCode	ErrorMessage
1382	不能下架不是上架狀態的商品

其它錯誤請參閱共用錯誤表

/v1/Product/Delete

刪除商品

Attribute	Value
API Name	刪除商品 (/Product/Delete)
API Desc	刪除單一商品
Version	1
Request URI	http://tw.ews.mall.yahooapis.com/stauth/v1/Product/Delete OR http://tw.ews.mall.yahooapis.com/oauth/v1/Product/Delete
Change Log	*

Request parameters

Parameter

Value

Description

ProductId

string (16/Require)

商品編號 ,可接受多筆

ex1.ProductId=p123456&ProductId=12345676,

ex2.ProductId=p123456&ProductId=12345676&ProductId=12345788,

每次limit=50

Response fields

Field	Description
SuccessList	成功的規格列表
Product	商品
@Id	商品編號
FailList	失敗的規格列表
Product	商品
@Id	商品編號
ErrorCode	錯誤代碼 (string)
ErrorParameter	錯誤參數 (string)
ErrorMsg	錯誤訊息 (string)

Sample response

JSON sample

{
  "Response": {
    "@Status": "ok",
    "SuccessList": {
      "Product": [
        {
          "@Id": "p094948743"
        },
        {
          "@Id": "p094948744"
        },
        {
          "@Id": "p094948745"
        },
        {
          "@Id": "p094948746"
        },
        {
          "@Id": "p094948747"
        }
      ]
    },
    "FailList": [

    ]
  }
}

Errors

ErrorCode	ErrorMessage
1374	商品規格編號不存在
1376	下能刪除不是未上架或下架狀態的商品
1379	上架的商品不能刪除
1380	此商品已刪除過
1383	超過批次更新的最大量

其它錯誤請參閱共用錯誤表

/v1/Product/UpdateImage

更新商品圖片

Attribute	Value
API Name	更新圖片 (/Product/UpdateImage)
API Desc	更新商品圖片
Version	1
Request URI	http://tw.ews.mall.yahooapis.com/stauth/v1/Product/UpdateImage OR http://tw.ews.mall.yahooapis.com/oauth/v1/Product/UpdateImage
Change Log	*

Request parameters

Parameter	Value	Description
ProductId	string(16/Required)	商品編號
ImageNamen	string(255/Required)	Image Name n: 1~10 由UploadImage的API 得到的圖片檔名
ImageFilen	string(Required)	Image Filename n: 1~10 主商品:10張加購品:1 張贈品: 1張此參數不加入簽章(Signature)運算
MainImage	string(11/Optional)	商品主圖的ImageFile Image Filename: ImageFile1~ImageFile10 主商品:1~10 加購品:1 (default value) 贈品: 1 (default value)

Sample Request：

https://tw.ews.mall.yahooapis.com/stauth/v1/Product/UpdateImage?ProductId=p0740162419939&ImageName1=p0740162419939-item-76e7xf4x1200x1600-m.jpg&MainImage=ImageFile1&Format=json

Response fields

Field	Description
SuccessList	成功的圖片列表
Image	成功圖片資訊（Name: 圖片名稱；IsMainImage: 是否為商品主圖；FileName: 上傳後的圖檔檔名）
FailList	上傳失敗列表
Image	失敗圖片資訊（Name: 圖片名稱）
PicList	上傳後的商品圖列表
ImageName	上傳後的圖檔檔名
ErrorCode	錯誤代碼
ErrorMessage	錯誤訊息

Sample response

JSON sample

{
  "Response": {
    "@Status": "ok",
    "SuccessList": {
      "Image": [
        {
          "@Name": "ImageFile1",
          "@IsMainImage": "true",
          "@FileName": "p094917019-item-8661xf2x0600x0366-m.jpg"
        },
        {
          "@Name": "ImageFile2",
          "@IsMainImage": "false",
          "@FileName": "p094917019-item-1217xf2x0600x0366-m.jpg"
        }
      ]
    },
    "FailList": [

    ],
    "PicList": {
      "ImageName": [
        "p094917019-item-5351xf2x0600x0366-m.jpg",
        "p094917019-item-1217xf2x0600x0366-m.jpg"
      ]
    }
  }
}

Errors

ErrorCode	ErrorMessage
1101	無上傳檔案
1156	圖片檔案大小太大{max size} bytes
1157	圖片寬度太大。最大為 {max size}
1158	圖片高度太大。最大為 {max size}
1159	圖片格式錯誤
1160	圖片格式不支援
1161	檔案編號取得失敗
1162	縮圖製作失敗
1163	系統錯誤(權限問題)
1164	系統錯誤(未知的錯誤)
1171	超過圖片上傳數量
1172	不存在的圖檔檔名

其它錯誤請參閱共用錯誤表

/v1/Product/SetMainImage

設定商品主圖

Attribute	Value
API Name	設定商品主圖 (/Product/SetMainImage)
API Desc	設定某張圖片為商品主圖片
Version	1
Request URI	http://tw.ews.mall.yahooapis.com/stauth/v1/Product/SetMainImage OR http://tw.ews.mall.yahooapis.com/oauth/v1/Product/SetMainImage
Change Log	*

Request parameters

Parameter

Value

Description

ProductId

string(16/Required)

商品編號

ImageName

string(255/Required)

由UploadImage的API

得到的圖片檔名

IsMainImage

string(5/Optional)

true:是商品主圖

false:不是商品主圖

Response fields

Field	Description
ErrorMsgList	包含此商品verify的error message list
ErrorMsg	包含一組error message
ErrorCode	錯誤代碼 (string)
ErrorParameter	錯誤參數 (string)
ErrorMsg	錯誤訊息 (string)

Sample response

JSON sample

{
  "Response": {
    "@Status": "ok"

   }
}

Errors

ErrorCode	ErrorMessage
1172	不存在的圖檔檔名

其它錯誤請參閱共用錯誤表

/v1/Product/DeleteImage

刪除商品圖

Attribute	Value
API Name	刪除圖片 (/Product/DeleteImage)
API Desc	刪除商品中的某張圖片
Version	1
Request URI	http://tw.ews.mall.yahooapis.com/stauth/v1/Product/DeleteImage OR http://tw.ews.mall.yahooapis.com/oauth/v1/Product/DeleteImage
Change Log	*

Request parameters

Parameter

Value

Description

ProductId

string(16/Required)

商品編號

ImageName

string(255/Required)

由UploadImage的API

得到的圖片檔名

Response fields

Field	Description
SuccessList	成功的規格列表
Image	商品
@ImageName	商品編號
FailList	失敗的規格列表
Image	商品
@ImageName	商品編號
ErrorCode	錯誤代碼 (string)
ErrorParameter	錯誤參數 (string)
ErrorMsg	錯誤訊息 (string)

Sample response

JSON sample

{
  "Response": {
    "@Status": "ok",
    "SuccessList": {
      "Image": [
        {
          "@ImageName": "p094917081-item-9781xf1x0600x0366-m.jpg"
        },
        {
          "@ImageName": "p094917081-item-2217xf1x0600x0366-m.jpg"
        }
      ]
    },
    "FailList": [

    ]
  }
}

Errors

ErrorCode	ErrorMessage
1172	不存在的圖檔檔名

其它錯誤請參閱共用錯誤表

/v1/Product/SetupReserve

設定預約上下架時間

Attribute	Value
API Name	設定預約上下架時間 (/Product/SetupReserve)
API Desc	設定預約商品上下架時間
Version	1
Request URI	http://tw.ews.mall.yahooapis.com/stauth/v1/Product/SetupReserve OR http://tw.ews.mall.yahooapis.com/oauth/v1/Product/SetupReserve
Change Log	*

Request parameters

Parameter	Value	Description
ProductId	string(16/Required)	商品編號
ReserveOnlineTime	date(Optional)	預約上架時間
ReserveOfflineTime	date(Optional)	預約下架時間

Response fields

Parameter	Description
ProductId	商品編號
ErrorCode	錯誤代碼
ErrorMessage	錯誤訊息

Sample response

JSON sample

{   
  "Response": {      
    "@Status":"ok",      
    "ProductId":"p094950028"   
  }
}

Errors

ErrorCode	ErrorMessage
1901	缺少時間參數
1902	不正確的時間格式
1903	預約上架時間必須早於預約下架時間
1904	目前產品狀態不可設定預約功能
1905	已上架產品不可修改預約上架時間
1906	上架中產品不可設定預約上下架
1907	預約上架時間不可為空白
1908	預約上架時間必須早於商品出貨時間

其他錯誤請參閱共用錯誤表

/v1/Product/CancelReserve

取消預約上下架

Attribute	Value
API Name	取消預約上下架 (/Product/CancelReserve)
API Desc	取消預約商品上下架
Version	1
Request URI	http://tw.ews.mall.yahooapis.com/stauth/v1/Product/CancelReserve OR http://tw.ews.mall.yahooapis.com/oauth/v1/Product/CancelReserve
Change Log	*

Request parameters

Parameter

Value

Description

ProductId

string(16/Required)

商品編號，可接受多筆

ex1.ProductId=p123456&ProductId=12345676

每次limit=50

Response fields

Field	Description
SuccessList	成功的規格列表
Product	產品
＠Id	產品編號
FailList	失敗的規格列表
Product	產品
@Id	產品編號
ErrorCode	錯誤代碼
ErrorMessage	錯誤訊息

Sample response

JSON sample

{
  "Response":{
    "@Status":"ok",
    "SuccessList": {
      "Product":[
        {"@Id":"p094950028"},
        {"@Id":"p094950029"}
      ]
    },
    "FailList":[]
  }
}

Errors

ErrorCode	ErrorMessage
1951	目前的產品狀態無法取消
1952	產品尚未設定預約時間

其他錯誤請參閱共用錯誤表