商品API

@
1、賣家如何透過api 取得自己店鋪中所有商品？
呼叫 taobao.items.onsale.get（店鋪出售中商品） 和taobao.items.inventory.get （商店倉庫中商品）即可取得。

2、介面taobao.items.onsale.get 無法按seller_cids 查詢商品是什麼原因？
以這種方式取得自訂類別目下的商品，有一個前提條件：即在呼叫介面taobao.sellercats.list.get取得自訂類別目時，類別目的類型必須是手動分類（即type=manual_type）。如非手動分類的，則無法查詢對應類目下商品。

3、介面taobao.items.inventory.get 為什麼無法取得所有倉庫中商品？
此api 預設並非查詢倉庫中所有商品，如需查詢所有商品，必須入參banner （所有類型都輸入）。詳細可看該api中有關banner欄位的說明。

4、集市賣家為什麼taobao.products.get無法搜尋商品？
這個是搜尋產品的api ，不是搜尋商品的，集市賣家是無產品概念的，只有天貓商家發布商品前發布產品時才需要用到。

5、為什麼頁面上顯示sku 顏色 淡藍色，但透過taobao.item.get（fields返回sku）取到確實藍色？
頁面展示的是別名，對應api中 property_alias 這個欄位 。並非sku中的 properties_name 欄位。

6、taobao.item.add 新增商品時cid、props 屬性參數從那取得？
透過類別目相關api taobao.itemcats.get 和taobao.itemprops.get 取得。另 屬性工具 也可獲取，開發測試時可以配合api使用，以便於理解。
 
7、使用sdk，新增商品時如何透過image新增圖片？
依下列格式新增圖片，其中「fileLocation」為本機圖片檔案路徑。
java: FileItem fItem = new FileItem(new File("fileLocation"));  req.setImage(fItem);
PHP:  $req->setImage(@fileLocation);
.NET:  $req->setImage(@fileLocation);
.NET:  FileItemItem fItem = new FileItem("fileLocation");
注意：如果未使用sdk，則需將圖片轉換成二進位流的方式新增。建議使用sdk以簡化api 呼叫過程。 8、上傳商品時只能新增商品主圖，如何為商品添加其它圖片？

呼叫taobao.item.img.upload 添加即可
9、taobao.item.update 修改商品時是否所有欄位都需要填寫，如果沒有填寫的欄位是否會被修改？  
 
不是所有欄位都需要填寫，沒有填寫的將不會更新。
10、呼叫介面 taobao.item.update 出現這個錯誤，isv.invalid-parameter:desc 是什麼一回事嗎? 
   ###desc描述建議不要太長，不然封包傳送到伺服器上丟包可能性很大，導致簽章出錯。

11、刪除商品詳情後，但頁面仍顯示什麼原因？
一般是商家在商品詳情裡引用了旺鋪裝修模版導致，需商家自行操作取消。

12、系統自動上下架商品，是否影響商品的櫥窗推薦狀態？訊息服務是否推播訊息？
不影響 。不推播訊息。

13、taobao.item.update.listing 上架商品，提示如下錯誤，如何處理？
“Remote service error“流行款式名稱”屬性出錯:類別目屬性在標準屬性中不存在:流行款式名稱”
這個是商品“流行款式名稱” 這個屬性沒有加導致上架報錯，該屬性是必選屬性，請到頁面編輯增加這個屬性後，再嘗試用api 修改。介面上架是全量校驗的，如果商品某個屬性有錯，就會上架失敗，並拋出提示。

14、呼叫taobao.item.get ，出現下面報錯是什麼原因？

<br> 錯誤回報：<code>7</code><msg>App Call Limited</msg><sub_code>accesscontrol.limited-by-app-api-access<sub_code>accesscontrol.limited-by-app-api-access<sub_code>accesscontrol.limited-by-app-api-access<sub_code>accesscontrol.limited-by-app-api-access -count</sub_code><sub_msg>This ban will last for 23452 more seconds</sub_msg>

應用正式環境測試階段，除5000/天的流量限制外。針對個別API 還做了流量限制，如taobao.item.get 調用不能超過10次，否則會提示“This ban will last for 23452 more seconds” ，且出錯後即無法再調用，需等23452秒後才能繼續調用。更詳細說明可參考http://dev.open.taobao.com/bbs/read.php?tid=24648 的說明

15、如何透過taobao.item.add介面新增寶貝無線詳情？
此介面不支援寶貝無線詳情添加，可使用schema接口，schema接口使用方法可參考//open.taobao.com/doc/detail.htm?spm=a219a.7386797.1998343897.4.dPcIAf&id= 102602

16、如何透過api 新增一個商品？
新增商品需先呼叫類目api 取得商品類目及屬性等信息，再呼叫新增商品taobao.item.add 進行新增。詳細可參考//open.taobao.com/doc/detail.htm?id=121

交易API

@
1、取得訂單一般步驟如何，需用那幾個api？
一般是交易取得訂單3個介面搭配使用，詳細如下：
I：先用taobao.trades.sold.get - 取得三個月內已賣出的線上訂單，適用於用戶初始化的時候使用，ISV不應該用此介面來取得增量訂單。不建議使用或盡量少用此介面。
II：再用taobao.trades.sold.increment.get – 取得增量訂單，適用於使用者初始化後，增量同步發生變更的訂單，ISV不應該用此介面取得三個月內的訂單。
III：以上兩個批量獲取訂單接口，均只返回訂單部分字段，如需獲取訂單所有字段，則需配合 taobao.trade.fullinfo.get（獲取單筆訂單詳情） 使用。
更多詳細說明參考：//open.taobao.com/doc/detail.htm?id=1029

2、taobao.trades.sold.get 或taobao.trades.sold .increment.get 介面無法取得到訂單是什麼原因？
一般均為查詢訂單時type沒加導致的（注意查看api文檔上該字段說明），默認只查其中幾種類型的訂單，如果需要查詢所有類型訂單，需把type 全部傳人(如查詢天貓國際訂單，需入參type=tmall_i18n)。除此，還應注意查詢訂單的時間段，確認被查詢訂單在查詢時間範圍內。

3、交易介面中是否提供淘金幣相關、積分寶、紅包相關欄位？
未提供相關欄位。

4、為何taobao.trades.sold.get 中無法取得訂單中買家留言資訊？
此介面僅提供訂單部分欄位的獲取，其中不包含買家留言。查詢時，可透過該介面的欄位has_buyer_message 判斷是否有買家留言，若為true （表示買家有留言），則配合taobao.trade.fullinfo.get 介面取得買家留言

5、大量取得訂單介面如taobao.trades.sold.get 是否可取得3個月前的訂單？
無法獲取，僅提供近3個月訂單的獲取。

6、taobao.trades.sold.get 介面不能按RATE_UNSELLER 查到未評價的訂單？
不需賣家評價訂單，不存在賣家未評價的狀態，是不能依未評價狀態查詢的。

7、sku_properties_name不完整，少了一部分，什麼原因？
現在訂單中的skuid和sku描述都是用「|」分隔的，把「|」放入sku描述中，「|」後面的sku描述就取不到了，建議不要使用「| 」來描述sku

8、貨到付款相關欄位說明
buyer_cod_fee：買家貨到付款服務費，由買家支付給物流公司。
seller_cod_fee：賣家貨到付款服務費，由賣家支付給物流公司 。
cod_fee：貨到付款服務費，不同的物流公司不同 。如果是買家支付服務費，則buyer_cod_fee=cod_fee ；如果是賣家支付，則seller_cod_fee=cod_fee;
若是買家、賣家共同支付則是兩者之和。賣家可設定貨到付款服務費由誰支付。
貨到付款服務介紹參考：http://service.taobao.com/support/knowledge-847852.htm?spm=0.0.0.41.XRGCJF&dkey=searchview 

#9、天貓國際的訂單使用以下介面（taobao.trades.sold.get）無法獲取，如何處理？
查詢時type 傳人tmall_i18n 才回傳天貓國際訂單。 type 不傳預設查詢，是不包含天貓國際訂單的 ，api文檔有說明。另 taobao.trades.sold.increment.get 接口查詢時，也是同樣情況

10、調用交易備註接口，如何實現對已經有備註的訂單，在其後面追加備註？
沒辦法實作。備註修改是涵蓋的，新的備註內容會覆蓋原來老的備註。

11、交易介面taobao.trade.get 為什麼取得不了buyer_memo,buyer_message？
buyer_memo 是買家備註，僅買家能看到，賣家不能查看（包括使用api）。
buyer_message 僅訂單詳情介面有提供，如買家下單時有留言，請用taobao.trade.fullinfo.get 取得

物流API

@
1、如何透過api同步訂單狀態到淘寶？
使用物流出貨api 即可完成同步。如 taobao.logistics.offline.send 或 taobao.logistics.online.send

2、自己聯絡介面（api）和線上下單介面有何差別？
只是出貨方式的不同，自己聯絡指賣家（商家）自己電話聯絡物流公司上門攬貨；而線上下單則是指透過線上系統直接下單通知物流公司上門攬貨。

3、確認出貨介面 taobao.logistics.online.confirm 有什麼作用？
在使用線上下單介面 taobao.logistics.online.send 出貨時，如果出貨時未輸入運單號，則需要配合此介面進行確認出貨。

4、如何拆單出貨？
在使用物流介面出貨時，在原有入參（訂單號tid 、運單號out_sid 、物流公司代碼company_code ）基礎上，加上sub_tid 和is_split兩個參數即可完成拆單， sub_tid 表示交易的子訂單號碼即oid，is_split則表示是否拆單。
更多拆單相關說明可參考：//open.taobao.com/doc/detail.htm?id=101521

5、交易關閉是否有物流資訊？
買家未付款直接關閉交易的，是沒有物流訂單資訊的；買家付款後再關閉交易的則有物流訂單資訊。

6、倉內和串流資訊推送介面推送後，淘寶後台頁面不顯示內容是什麼原因？
該推送接口，只有在發貨時使用「其它（自己的物流公司名稱）」物流公司出貨時才有效。如果是淘寶合作的物流公司，則是無效的，頁面不顯示。另如發貨時的物流公司和推送時的物流公司未完全一致，頁面也不顯示推送的內容taobao.logistics.orderstore.push 物流訂單倉內信息推送接口（僅支持其他-其他這個下面要自己輸入的推送）

7、為什麼返回的「湖北-仙桃市」返回的type類型是4？
仙桃市屬湖北省直轄縣級市，區域類型和縣是一樣的 。

8、取得的部分地級市無下轄區、縣，如廣東中山市 ，如何處理？
用中山市的地址區域代碼入參即可。如使用taobao.logistics.partners.get 查詢時，地區碼欄位（source_id、target_id ）直接傳人中山市的地區碼。

9、Remote service error位址庫資訊不存在isv.logistics-offline-service-error:B101
位址庫資訊被刪除，導致出貨時取不到賣家的退貨地址。可到「賣家中心--物流工具」頁面把地址補上重試 。

10、是否可將不同子訂單的運單號修改成相同運單號     
不可以，且修改時，各子訂單對應的單號必須不同。

11、待出貨訂單使用taobao.logistics.online.send 出貨，提示重複出貨什麼原因？
應是重複出貨導致的（首次沒輸入運單號），沒輸入運單號進行出貨，該介面會回傳成功，但訂單狀態不會改變，仍是等待出貨，此時要用taobao.logistics.online.confirm 確認出貨，而不能用taobao.logistics.online.send 再發一次，否則介面會提示重複出貨。

評價API

@
1、買家已評價，介面取得不到評價資料什麼原因？
評價需買、賣雙方互評後才能看到，買家評價後若賣家未回評，則無法查到買家的評價資訊（好評、中評、負評）

2、新增評價介面是否可用於天貓商家？
不可以，暫只支援集市賣家

3、taobao.traderate.add 和taobao.traderate.list.add 什麼差別？
前者是新增單一評價，後者是新增大量評價。如有交易有3個子訂單，則taobao.traderate.add需評價3次，而taobao.traderate.list.add 則只需評價1次。

4、評價時，提示「主訂單不可」評價是什麼原因？如何處理
I： 確認是否符合評價條件(交易成功、未評價、未超過評價時間)
II： 確認是否特殊類目商品("其他」類目，透過tid 查到cid ，再用類目接口查cid是否其它類目，該類目包含“訂單、贈品、定金、新品預覽、郵費、搭配套餐” 6個子類目)
III： trade 中有退款子訂單，不能用taobao.traderate.list.add 評價(報不可評價錯誤)

#5、交易介面中，顯示訂單未評價，但評價介面可以查到買家評價是什麼原因？
如果買家評價時，未提交評分，那此時評價是未完成的，就會出現可以看到評價內容，但訂單評價狀態仍是待評價的問題。

退款API

@
#1、taobao.refunds.receive.get 介面是否可查詢售後退款訂單？
售後退款介面取不到，介面暫不支援取得。

2、退款時，店鋪優惠券如何處理？
未出貨：整個交易訂單取消關閉或申請全額退款成功，店舖優惠券會退還給買家，使用有效期不變，若退還時已過有效期，優惠券將作廢；
已出貨：產生交易糾紛，以實際付款金額算，店舖優惠券不做處理。

汪旺API

@
1、taobao.wangwang.abstract.logquery 查詢聊天記錄報錯，什麼原因？
<msg>Remote service error</msg><sub_code>isp.api-srv-error</sub_code>
# 沒有初始化聊天介面導致，呼叫前查詢聊天介面導致，呼叫前查詢聊天介面導致先用taobao.wangwang.abstract.initialize 初始化（只需初始化一次）

2、taobao.wangwang.eservice.loginlogs.get 是否可取得手機旺旺的登入日誌？
不能，只支援取得pc端使用者的登入日誌

3、旺旺中當日接待的客戶平均等待時長是如何計算的？
取所有客戶等待時長的平均值，具體如下：
如共N個客戶，每個客戶的等待時間是Sn秒，平均等待時長就是：(S1 S2..... .Sn)/N
等待時長規則：只有客服S1（S1可以是主帳號或子帳號）回覆了B1的1條訊息，則B1發訊息到客服S1回覆第1條訊息的時間間隔，就是S1對B1的等待時長，取整數

4、呼叫旺旺接口，報以下錯誤，什麼原因，如何處理？
Exception in thread "main" java.lang.IllegalArgumentException: expected value at column 1
改下傳回資料的格式，改成xml 。不要用預設的json ，旺旺介面無法支援json 回傳。

用戶API

@
1、使用線上訂購應用，呼叫taobao.user.buyerer.get報如下錯誤，什麼原因？
11 Insufficient isv permissionsisv.permission-api-package-limits
報錯提示沒有api 權限，無法呼叫。賣家類應用程式（如商品管理）不能調買家類api（taobao.user.buyerer.get） ，這個是給買家應用的。如需取得賣家相關信息，請呼叫taobao.user.seller.get

#FAQ

在開發中常見問題是否有解決文件