商品API

@
1、賣家如何通過api 獲取自己店鋪中所有商品？
調(diào)用 taobao.items.onsale.get（店鋪出售中商品） 和taobao.items.inventory.get （店鋪倉庫中商品）即可獲取。

2、接口taobao.items.onsale.get 無法按seller_cids 查詢商品是什么原因？
通過這種方式獲取自定義類目下的商品，有一個前提條件：即在調(diào)用接口taobao.sellercats.list.get獲取自定義類目時，類目的類型必須是手動分類（即type=manual_type）。如非手動分類的，則無法查詢對應(yīng)類目下商品。

3、接口taobao.items.inventory.get 為什么無法獲取所有倉庫中商品？
該api 默認并不是查詢倉庫中所有商品，如需查詢所有商品，必須入?yún)anner （所有類型都輸入）。詳細可看該api中有關(guān)banner字段的說明。

4、集市賣家為什么taobao.products.get無法搜索商品？
這個是搜索產(chǎn)品的api ，不是搜索商品的，集市賣家是無產(chǎn)品概念的，只有天貓商家發(fā)布商品前發(fā)布產(chǎn)品時才需要用到。

5、為什么頁面上顯示sku 顏色 淡藍色，但通過taobao.item.get（fields返回sku）取到確實藍色？
頁面展示的是別名，對應(yīng)api中 property_alias 這個字段 。并非sku中的 properties_name 字段。

6、taobao.item.add 添加商品時cid、props 屬性參數(shù)從那獲?。?/strong>
通過類目相關(guān)api taobao.itemcats.get 和taobao.itemprops.get 獲取。另 屬性工具 也可獲取，開發(fā)測試時可以配合api使用，以便于理解。
 
7、使用sdk，添加商品時如何通過image添加圖片？
按如下格式添加圖片，其中“fileLocation”為本地圖片文件路徑。
java: FileItem fItem = new FileItem(new File("fileLocation"));  req.setImage(fItem);
PHP:  $req->setImage(@fileLocation);
.NET:  FileItem fItem = new FileItem("fileLocation");
注：如果未使用sdk，則需將圖片轉(zhuǎn)成二進制流的方式添加。建議使用sdk以簡化api 調(diào)用過程。
8、上傳商品時只能添加商品主圖，如何給商品添加其它圖片？
調(diào)用taobao.item.img.upload 添加即可

9、taobao.item.update 修改商品時是否所有字段都需要填寫，如果沒有填寫的字段是否會被修改？    
不是所有字段都需要填寫，沒有填寫的將不會被更新。

10、調(diào)用接口 taobao.item.update 出現(xiàn)這個錯誤， isv.invalid-parameter:desc 是什么回事嗎?    
desc描述建議不要太長，不然數(shù)據(jù)包發(fā)送到服務(wù)器上丟包可能性很大，導(dǎo)致簽名出錯。

11、刪除商品詳情后，但頁面仍顯示什么原因？
一般是商家在商品詳情里引用了旺鋪裝修模版導(dǎo)致，需商家自己操作取消。

12、系統(tǒng)自動上下架商品，是否影響商品的櫥窗推薦狀態(tài)？消息服務(wù)是否推送消息？
不影響 。不推送消息。

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

14、調(diào)用taobao.item.get ，出現(xiàn)下面報錯是什么原因？

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

應(yīng)用正式環(huán)境測試階段，除5000/天的流量限制外。針對個別API 還做了流量限制，如 taobao.item.get 調(diào)用不能超過10次，否則會提示“This ban will last for 23452 more seconds” ，且出錯后即無法再調(diào)用，需等23452秒 后才能繼續(xù)調(diào)用。更詳細說明可參考 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 添加一個商品？
添加商品需先調(diào)用類目api 獲取商品類目及屬性等信息，再調(diào)用添加商品taobao.item.add 進行添加。詳細可參考//open.taobao.com/doc/detail.htm?id=121

交易API

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

2、taobao.trades.sold.get 或taobao.trades.sold.increment.get 接口無法獲取到訂單是什么原因？
一般均為查詢訂單時type沒加導(dǎo)致的（注意查看api文檔上該字段說明），默認只查其中幾種類型的訂單，如果需要查詢所有類型訂單，需把type 全部傳人(如查詢天貓國際訂單，需要入?yún)ype=tmall_i18n)。除此，還應(yīng)注意查詢訂單的時間段，確認被查詢訂單在查詢時間范圍內(nèi)。

3、交易接口中是否提供淘金幣相關(guān)、積分寶、紅包相關(guān)字段？
未提供相關(guān)字段。

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 查到未評價的訂單？
不需賣家評價訂單，不存在賣家未評價的狀態(tài)，是不能按未評價狀態(tài)查詢的。

7、sku_properties_name不完整，少了一部分，什么原因？   
現(xiàn)在訂單中的skuid和sku描述都是用“|”分隔的，把“|”放入sku描述中，“|”后面的sku描述就取不到了，建議不要使用“|”來描述sku

8、貨到付款相關(guān)字段說明
buyer_cod_fee：買家貨到付款服務(wù)費，由買家支付給物流公司。
seller_cod_fee：賣家貨到付款服務(wù)費，由賣家支付給物流公司 。
cod_fee：貨到付款服務(wù)費，不同的物流公司不同 。如果是買家支付服務(wù)費，則buyer_cod_fee=cod_fee ；如果是賣家支付，則seller_cod_fee=cod_fee；
若是買家、賣家共同支付則是兩者之和。賣家可設(shè)置貨到付款服務(wù)費由誰支付。
貨到付款服務(wù)介紹參考：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、調(diào)用交易備注接口，如何實現(xiàn)對已經(jīng)有備注的訂單，在其后面追加備注？
沒法實現(xiàn)。備注修改是覆蓋的，新的備注內(nèi)容會覆蓋原來老的備注。

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

物流API

@
1、如何通過api同步訂單狀態(tài)到淘寶？
使用物流發(fā)貨api 即可完成同步。如 taobao.logistics.offline.send 或 taobao.logistics.online.send

2、自己聯(lián)系接口（api）和在線下單接口有什么差別？
只是發(fā)貨方式的不同，自己聯(lián)系指賣家（商家）自己電話聯(lián)系物流公司上門攬貨；而在線下單則是指通過在線系統(tǒng)直接下單通知物流公司上門攬貨。

3、確認發(fā)貨接口 taobao.logistics.online.confirm 有什么作用？
在用在線下單接口 taobao.logistics.online.send 發(fā)貨時，如果發(fā)貨時未輸入運單號，則需要配合該接口進行確認發(fā)貨。

4、如何拆單發(fā)貨？
在使用物流接口發(fā)貨時，在原有入?yún)ⅲㄓ唵翁杢id 、運單號out_sid 、物流公司代碼company_code ）基礎(chǔ)上，加上 sub_tid 和is_split兩個參數(shù)即可完成拆單，  sub_tid 表示交易的子訂單號即oid，is_split則表示是否拆單。
更多拆單相關(guān)說明可參考：//open.taobao.com/doc/detail.htm?id=101521

5、交易關(guān)閉是否有物流信息？
買家未付款直接關(guān)閉交易的，是沒有物流訂單信息的；買家付款后再關(guān)閉交易的則有物流訂單信息。

6、倉內(nèi)和流轉(zhuǎn)信息推送接口推送后，淘寶后臺頁面不顯示內(nèi)容是什么原因？
該推送接口，只有發(fā)貨時使用“其它（自己的物流公司名稱）”物流公司發(fā)貨時才有效。如果是淘寶合作的物流公司，則是無效的，頁面不顯示。另如發(fā)貨時的物流公司 和 推送時的物流公司未完全一致，頁面也不顯示推送的內(nèi)容taobao.logistics.orderstore.push 物流訂單倉內(nèi)信息推送接口 （僅支持其他-其他 這個下面要自己輸入的推送）

7、為什么返回的“湖北-仙桃市”返回的type類型是4？
仙桃市屬湖北省直轄縣級市，區(qū)域類型和縣是一樣的 。

8、獲取的部分地級市無下轄區(qū)、縣，如廣東中山市 ，如何處理？
用中山市的地址區(qū)域代碼入?yún)⒓纯?。如使用taobao.logistics.partners.get 查詢時，地區(qū)碼字段（source_id、target_id ）直接傳人中山市的地區(qū)碼。

9、Remote service error地址庫信息不存在isv.logistics-offline-service-error:B101
地址庫信息被刪除，導(dǎo)致發(fā)貨時取不到賣家的退發(fā)貨地址。可到“賣家中心--物流工具”頁面把地址補上重試 。

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

11、待發(fā)貨訂單使用taobao.logistics.online.send 發(fā)貨，提示重復(fù)發(fā)貨什么原因？
應(yīng)是重復(fù)發(fā)貨導(dǎo)致的（首次沒輸入運單號），沒輸入運單號進行發(fā)貨，該接口會返回成功，但訂單狀態(tài)不會改變，仍是等待發(fā)貨，此時要用 taobao.logistics.online.confirm 確認發(fā)貨，而不能用taobao.logistics.online.send 再發(fā)一次，否則接口會提示重復(fù)發(fā)貨。

評價API

@
1、買家已評價，接口獲取不到評價數(shù)據(jù)什么原因？
評價需買、賣雙方互評后才能看到，買家評價后若賣家未回評，則無法查到買家的評價信息（好評、中評、差評）

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是否其它類目，該類目包含“訂單、贈品、定金、新品預(yù)覽、郵費、搭配套餐” 6個子類目)
III： trade 中有退款子訂單，不能用 taobao.traderate.list.add 評價(報不可評價錯誤)

5、交易接口中，顯示訂單未評價，但評價接口可以查到買家評價是什么原因？
如果買家評價時，未提交評分，那此時評價是未完成的，就會出現(xiàn)可以看到評價內(nèi)容，但訂單評價狀態(tài)仍是待評價的問題。

退款A(yù)PI

@
1、taobao.refunds.receive.get 接口是否可查詢售后退款訂單？
售后退款接口取不到，接口暫不支持獲取。

2、退款時，店鋪優(yōu)惠券如何處理？
未發(fā)貨：整個交易訂單取消關(guān)閉或申請全額退款成功，店鋪優(yōu)惠券會返回給買家，使用有效期不變，若退還時已過有效期，優(yōu)惠券將作廢；
已發(fā)貨：產(chǎn)生交易糾紛，按實際付款金額算，店鋪優(yōu)惠券不做處理。

旺旺API

@
1、taobao.wangwang.abstract.logquery 查詢聊天記錄報錯，什么原因？
<msg>Remote service error</msg><sub_code>isp.api-srv-error</sub_code>
沒有初始化查詢聊天接口導(dǎo)致，調(diào)用前先用 taobao.wangwang.abstract.initialize 初始化（只需初始化一次）

2、taobao.wangwang.eservice.loginlogs.get 是否可獲取手機旺旺的登錄日志？
不能，僅支持獲取pc端用戶的登錄日志

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

4、調(diào)用旺旺接口，報以下錯誤，什么原因，如何處理？
Exception in thread "main" java.lang.IllegalArgumentException: expected value at column 1
改下返回數(shù)據(jù)的格式，改成xml 。不要用默認的json ，旺旺接口無法支持json 返回。

用戶API

@
1、使用在線訂購應(yīng)用，調(diào)用taobao.user.buyerer.get報如下錯誤，什么原因？
11 Insufficient isv permissionsisv.permission-api-package-limits
報錯提示沒有api 權(quán)限，不能調(diào)用。賣家類應(yīng)用（如商品管理）不能調(diào)買家類api（taobao.user.buyerer.get） ，這個是給買家應(yīng)用使用的。如需獲取賣家相關(guān)信息，請調(diào)用taobao.user.seller.get

FAQ

開發(fā)中常見問題是否有解決文檔