淘宝开放平台

登录
文档中心 > 淘寶台灣開放平台

商品API補充說明

更新时间：2020/09/18 访问次数：562

壹、 UpdateProduct

 

  • 接口路徑：/product/update
  • 接口版本：2
  • 接口名稱：com.taobao.sellglobal.client.service.api.ProductService
  • 接口方法：updateProductV2
  • 入參：
參數名稱 參數類型 是否必填 描述
AuthDO com.alibaba.normandie.gateway.client.domain.lazop.AuthDO 是 詳見下面AuthDO
ApiRequest com.taobao.sellglobal.client.model.ApiRequest 是 詳見下面ApiRequest

 

AuthDO：

參數名稱 參數類型 是否必填 描述
userId Long 是  
userEmail String 是  
sellerId Long 是 賣家ID

 

ApiRequest：

參數名稱 參數類型 是否必填 描述
catId String 否 類目
updateItemId String 否 更新商品的ID
attributes JSON 是 詳見下面attributes
skuList Array 是 詳見下面skuList

 

attributes：

參數名稱 參數類型 是否必填 描述
brand String 否 品牌
name String 是 名稱
short description String 是 短描
description String 否 描述
warranty type String 否 保固類型，根據類目選填，传id
1879916309：無保修
2000004004：當地供應商保修
4890910859：國際製造商保修
4890912097：國際賣家保修
4890912100：當地製造商保修
warranty String 否 保固期，根據下方類目屬性選填，传id
61356472 : 1 Month
1878244503: 2 Months
66256336: 3 Months
84080222: 4 Months
88687276: 5 Months
87865024: 6 Months
1520237840: 7 Months
717374871: 8 Months
155652810: 9 Months
1878243078: 10 Months
842392822: 11 Months
4890912112: Life Time Warranty
54411378: 1 Year
74317991: 2 Years
62405572: 3 Years
153291299: 4 Years
149360996: 5 Years
137903252: 6 Years
111062392: 7 Years
130075703: 8 Years
792262005: 9 Years
50070493: 10 Years
84151124: 18 Months
150823067: 15 Years
141662757: 20 Years
product warranty String 否 保固政策
Hazmat String 否

根據類目選填，多個值用逗號隔開，传id

"帶電池", value: 9390368
"易燃", value: 790268265
"液體", value: 6223181
"None", value: 3270618
deliveryPeriod String 是 備貨期，1~30之間的數字選填
pickupPoint JSON 否 商超取貨，詳見下面pickupPoint
sellerSelfDelivery JSON 否 賣家自有物流，詳見下面sellerSelfDelivery
localLogisticDelivery JSON 否 官方宅配，詳見下面localLogisticDelivery
       

 

localLogisticDelivery

參數名稱 參數類型 是否必填 描述
value String 是 僅支持：home

 

sellerSelfDelivery

參數名稱 參數類型 是否必填 描述
value String 是 僅支持seller
input Long 是 運費

 

pickupPoint

參數名稱 參數類型 是否必填 描述
supportCod boolean 是  
value String 是 只支持以下三種
FAMILY_MART：全家
SEVEN_11：711便利店
HI_LIFE：萊爾富

 

skuList

參數名稱 參數類型 是否必填 描述
skuId Long 是  
SellerSku String 是  
package_weight Double 否  
package_length Double 否  
package_width Double 否  
package_height Double 否  
color family String 否 根據類目選填
size String 否 尺碼，根據類目選填，多個值用逗號隔開
quantity Long 否 庫存
Available Long 否 可銷售庫存
package_content String 否  
package_content Array 否 圖片地址，字符串數組
price Double 否 價格
special price Double 否 促銷價
special from date Date 否 促銷價開始日期  YYYY-MM-DD HH:mm:ss
special to date Date 否 促銷價結束日期  YYYY-MM-DD HH:mm:ss
lossThresholdPrice Double 否 止損價
Status String 否 商品狀態
acitve：上架
all：全部
live 在線
inactive下架
deleted 已刪除
image-missing 圖片缺失
pending 審核中
rejected 審核拒絕
sold-out  已賣空

 

  • 返回參數：
參數名稱 參數類型 描述
success boolean 表示請求是否成功
errorCode String 錯誤碼
errorMsg String 錯誤信息
data Object 返回結果對象

 

data：

參數名稱 參數類型 描述
itemId Long  
skus Array sku信息，詳見下面skus

 

skus：

參數名稱 參數類型 描述
SkuId String  
SellerSku String  

 

二、 CreateProduct

 

  • 接口路徑：/product/create
  • 接口版本：2
  • 接口名稱：com.taobao.sellglobal.client.service.api.ProductService
  • 接口方法：createProductV2
  • 入參：
參數名稱 參數類型 是否必填 描述
AuthDO com.alibaba.normandie.gateway.client.domain.lazop.AuthDO 是 詳見下面AuthDO
ApiRequest com.taobao.sellglobal.client.model.ApiRequest 是 詳見下面ApiRequest

 

AuthDO：

參數名稱 參數類型 是否必填 描述
userId Long 是  
userEmail String 是  
sellerId Long 是 賣家ID

 

ApiRequest：

參數名稱 參數類型 是否必填 描述
catId String 否 類目
updateItemId String 否 更新商品的ID
attributes JSON 是 詳見下面attributes
skuList Array 是 詳見下面skuList

 

attributes：

參數名稱 參數類型 是否必填 描述
brand String 否 品牌
name String 是 名稱
short description String 是 短描
description String 否 描述
warranty type String 否 保固類型，根據類目選填
1879916309：無保修
2000004004：當地供應商保修
4890910859：國際製造商保修
4890912097：國際賣家保修
4890912100：當地製造商保修
warranty String 否 保固期，根據下方類目屬性選填
61356472 : 1 Month
1878244503: 2 Months
66256336: 3 Months
84080222: 4 Months
88687276: 5 Months
87865024: 6 Months
1520237840: 7 Months
717374871: 8 Months
155652810: 9 Months
1878243078: 10 Months
842392822: 11 Months
4890912112: Life Time Warranty
54411378: 1 Year
74317991: 2 Years
62405572: 3 Years
153291299: 4 Years
149360996: 5 Years
137903252: 6 Years
111062392: 7 Years
130075703: 8 Years
792262005: 9 Years
50070493: 10 Years
84151124: 18 Months
150823067: 15 Years
141662757: 20 Years
product warranty String 否 保固政策
Hazmat String 否 根據類目選填，多個值用逗號隔開
deliveryPeriod String 是 備貨期，1~30之間的數字選填
pickupPoint JSON 否 商超取貨，詳見下面pickupPoint
sellerSelfDelivery JSON 否 賣家自有物流，詳見下面sellerSelfDelivery
localLogisticDelivery JSON 否 官方宅配，詳見下面localLogisticDelivery
logisticWay

 

 String 否

跨境賣家必填，

"空運"：

"OFFICIAL_AIR_TRANSPORT"，

"海運"：

"OFFICIAL_OCEAN_SHIPPING"

 

 

localLogisticDelivery

參數名稱 參數類型 是否必填 描述
value String 是 僅支持home

 

sellerSelfDelivery

參數名稱 參數類型 是否必填 描述
value String 是 僅支持seller
input Long 是 運費

 

pickupPoint

參數名稱 參數類型 是否必填 描述
supportCod boolean 是  
value String 是 只支持以下三種
FAMILY_MART：全家
SEVEN_11：711便利店
HI_LIFE：萊爾富

 

skuList

參數名稱 參數類型 是否必填 描述
skuId Long 是  
SellerSku String 是  
package_weight Double 否  
package_length Double 否  
package_width Double 否  
package_height Double 否  
color family String 否 根據類目選填
size String 否 尺碼，根據類目選填，多個值用逗號隔開
quantity Long 否 庫存
Available Long 否 可銷售庫存
package_content String 否  
package_content Array 否 圖片地址，字符串數組
price Double 否 價格
special price Double 否 促銷價
special from date Date 否 促銷價開始日期  YYYY-MM-DD HH:mm:ss
special to date Date 否 促銷價結束日期  YYYY-MM-DD HH:mm:ss
lossThresholdPrice Double 否 止損價
Status String 否 商品狀態
acitve：上架
all：全部
live 在線
inactive下架
deleted 已刪除
image-missing 圖片缺失
pending 審核中
rejected 審核拒絕
sold-out  已賣空

 

  • 返回參數：
參數名稱 參數類型 描述
success boolean 表示請求是否成功
errorCode String 錯誤碼
errorMsg String 錯誤信息
data Object 返回結果對象

 

data：

參數名稱 參數類型 描述
itemId Long  
skus Array sku信息，詳見下面skus

 

skus：

參數名稱 參數類型 描述
SkuId String  
SellerSku String  

 

三、 GetProduct

 

  • 接口路徑：/product/item/get_list
  • 接口版本：2
  • 接口名稱：com.taobao.sellglobal.client.service.api.ProductService
  • 接口方法：getProductsV2
  • 入參：
參數名稱 參數類型 是否必填 描述
AuthDO com.alibaba.normandie.gateway.client.domain.lazop.AuthDO 是 詳見下面AuthDO
QueryParam com.taobao.sellglobal.client.service.api.QueryParam 是 詳見下面QueryParam
body String 否  

 

AuthDO：

參數名稱 參數類型 是否必填 描述
userId Long 是  
userEmail String 是  
sellerId Long 是 賣家ID

 

QueryParam：

參數名稱 參數類型 是否必填 描述
limit String 否 每壹頁的數量，1~100之中選填，默認20，
options String 否  
offset String 是 從第幾個開始查詢
createBefore String 是 商品最大創建時間
createAfter String 否 商品最小創建時間
updateBefore String 否 商品最大更新時間
updateAfter String 是 商品最小更新時間
search String 是 商品名稱或者outerId
filter String 否 商品狀態
all：全部
live 在線
inactive下架
deleted 已刪除
image-missing 圖片缺失
pending 審核中
rejected 審核拒絕
sold-out  已賣空
skuSellerList String 否 sellerSku

 

  • 返回參數：
參數名稱 參數類型 描述
success boolean 表示請求是否成功
errorCode String 錯誤碼
errorMsg String 錯誤信息
data Object 返回結果對象

 

data：

參數名稱 參數類型 描述
totalProducts int 總數
Products Array 商品詳情，詳見下面Products

 

Products：

參數名稱 參數類型 描述
primaryCategory Long  
itemId Long  
attributes JSON 詳見下面attributes
skus Array 詳見下面skus
approveStatus int  

 

attributes：

參數名稱 參數類型 描述
brand String 品牌
name String 名稱
short description String 短描
description String 描述
warranty type String 否
warranty String 否
product warranty String 否
Hazmat String 否
deliveryPeriod String 否
pickupPoint JSON 商超取貨，詳見下面pickupPoint
sellerSelfDelivery JSON 賣家自有物流，詳見下面sellerSelfDelivery
localLogisticDelivery JSON 官方宅配，詳見下面localLogisticDelivery

 

localLogisticDelivery

參數名稱 參數類型 描述
value String 僅支持home

 

sellerSelfDelivery

參數名稱 參數類型 描述
value String 僅支持seller
input Long 運費

 

pickupPoint

參數名稱 參數類型 描述
supportCod boolean  
value String 只支持以下三種
FAMILY_MART：全家
SEVEN_11：711便利店
HI_LIFE：萊爾富

 

skus

參數名稱 參數類型 描述
skuId Long  
SellerSku String  
package_weight Double  
package_length Double  
package_width Double  
package_height Double  
color family String 根據類目選填
size String 尺碼，根據類目選填，多個值用逗號隔開
quantity Long 庫存
Available Long 可銷售庫存
package_content String  
package_content Array 圖片地址，字符串數組
price Double 價格
special price Double 促銷價
special from date Date 促銷價開始日期  YYYY-MM-DD HH:mm:ss
special to date Date 促銷價結束日期  YYYY-MM-DD HH:mm:ss
lossThresholdPrice Double 止損價
Status String 商品狀態
acitve：上架
all：全部
live 在線
inactive下架
deleted 已刪除
image-missing 圖片缺失
pending 審核中
rejected 審核拒絕
sold-out  已賣空

 

四、 DeleteProduct

 

  • 接口路徑：/product/delete
  • 接口版本：1
  • 接口名稱：com.taobao.sellglobal.client.service.api.ProductService
  • 接口方法：deleteProductItem
  • 入參：
參數名稱 參數類型 是否必填 描述
AuthDO com.alibaba.normandie.gateway.client.domain.lazop.AuthDO 是 詳見下面AuthDO
QueryItemParam com.taobao.sellglobal.client.req.QueryItemParam 是 詳見下面QueryItemParam

 

AuthDO：

參數名稱 參數類型 是否必填 描述
userId Long 是  
userEmail String 是  
sellerId Long 是 賣家ID

 

QueryItemParam：

參數名稱 參數類型 是否必填 描述
itemId Long 是  
sellerSku String 是  
skuId Long 是  

 

  • 返回參數：
參數名稱 參數類型 描述
success boolean 表示請求是否成功
errorCode String 錯誤碼
errorMsg String 錯誤信息

FAQ

关于此文档暂时还没有FAQ
有用(0) 我要提问
返回
顶部