商品API

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

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

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

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

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

6、taobao.item.add 添加商品時(shí)cid、props 屬性參數(shù)從那獲取？
通過(guò)類(lèi)目相關(guān)api taobao.itemcats.get 和taobao.itemprops.get 獲取。另 屬性工具 也可獲取，開(kāi)發(fā)測(cè)試時(shí)可以配合api使用，以便于理解。
 
7、使用sdk，添加商品時(shí)如何通過(guò)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)成二進(jìn)制流的方式添加。建議使用sdk以簡(jiǎn)化api 調(diào)用過(guò)程。
8、上傳商品時(shí)只能添加商品主圖，如何給商品添加其它圖片？
調(diào)用taobao.item.img.upload 添加即可

9、taobao.item.update 修改商品時(shí)是否所有字段都需要填寫(xiě)，如果沒(méi)有填寫(xiě)的字段是否會(huì)被修改？    
不是所有字段都需要填寫(xiě)，沒(méi)有填寫(xiě)的將不會(huì)被更新。

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

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

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

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

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

<br> 報(bào)錯(cuò)：<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)境測(cè)試階段，除5000/天的流量限制外。針對(duì)個(gè)別API 還做了流量限制，如 taobao.item.get 調(diào)用不能超過(guò)10次，否則會(huì)提示“This ban will last for 23452 more seconds” ，且出錯(cuò)后即無(wú)法再調(diào)用，需等23452秒 后才能繼續(xù)調(diào)用。更詳細(xì)說(shuō)明可參考 http://dev.open.taobao.com/bbs/read.php?tid=24648 的說(shuō)明

15、如何通過(guò)taobao.item.add接口添加寶貝無(wú)線詳情？
該接口不支持寶貝無(wú)線詳情添加，可使用schema接口，schema接口使用方法可參考 //open.taobao.com/doc/detail.htm?spm=a219a.7386797.1998343897.4.dPcIAf&id=102602

16、如何通過(guò)api 添加一個(gè)商品？
添加商品需先調(diào)用類(lèi)目api 獲取商品類(lèi)目及屬性等信息，再調(diào)用添加商品taobao.item.add 進(jìn)行添加。詳細(xì)可參考//open.taobao.com/doc/detail.htm?id=121

交易API

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

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

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

4、為何taobao.trades.sold.get 中無(wú)法獲取訂單中買(mǎi)家留言信息？
該接口僅提供訂單部分字段的獲取，其中不包含買(mǎi)家留言。在查詢時(shí)，可通過(guò)該接口的字段has_buyer_message 判斷是否有買(mǎi)家留言，若為true （表示買(mǎi)家有留言），則配合taobao.trade.fullinfo.get 接口獲取買(mǎi)家留言

5、批量獲取訂單接口如taobao.trades.sold.get 是否可獲取3個(gè)月前的訂單？
無(wú)法獲取，僅提供近3個(gè)月訂單的獲取。

6、taobao.trades.sold.get 接口不能按RATE_UNSELLER 查到未評(píng)價(jià)的訂單？
不需賣(mài)家評(píng)價(jià)訂單，不存在賣(mài)家未評(píng)價(jià)的狀態(tài)，是不能按未評(píng)價(jià)狀態(tài)查詢的。

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

8、貨到付款相關(guān)字段說(shuō)明
buyer_cod_fee：買(mǎi)家貨到付款服務(wù)費(fèi)，由買(mǎi)家支付給物流公司。
seller_cod_fee：賣(mài)家貨到付款服務(wù)費(fèi)，由賣(mài)家支付給物流公司 。
cod_fee：貨到付款服務(wù)費(fèi)，不同的物流公司不同 。如果是買(mǎi)家支付服務(wù)費(fèi)，則buyer_cod_fee=cod_fee ；如果是賣(mài)家支付，則seller_cod_fee=cod_fee；
若是買(mǎi)家、賣(mài)家共同支付則是兩者之和。賣(mài)家可設(shè)置貨到付款服務(wù)費(fèi)由誰(shuí)支付。
貨到付款服務(wù)介紹參考：http://service.taobao.com/support/knowledge-847852.htm?spm=0.0.0.41.XRGCJF&dkey=searchview 

9、天貓國(guó)際的訂單使用以下接口（taobao.trades.sold.get）無(wú)法獲取，如何處理？
查詢時(shí)type 傳人tmall_i18n 才返回天貓國(guó)際訂單。type 不傳默認(rèn)查詢，是不包含天貓國(guó)際訂單的 ，api文檔有說(shuō)明。另 taobao.trades.sold.increment.get 接口查詢時(shí)，也是同樣情況

10、調(diào)用交易備注接口，如何實(shí)現(xiàn)對(duì)已經(jīng)有備注的訂單，在其后面追加備注？
沒(méi)法實(shí)現(xiàn)。備注修改是覆蓋的，新的備注內(nèi)容會(huì)覆蓋原來(lái)老的備注。

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

物流API

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

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

3、確認(rèn)發(fā)貨接口 taobao.logistics.online.confirm 有什么作用？
在用在線下單接口 taobao.logistics.online.send 發(fā)貨時(shí)，如果發(fā)貨時(shí)未輸入運(yùn)單號(hào)，則需要配合該接口進(jìn)行確認(rèn)發(fā)貨。

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

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

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

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

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

9、Remote service error地址庫(kù)信息不存在isv.logistics-offline-service-error:B101
地址庫(kù)信息被刪除，導(dǎo)致發(fā)貨時(shí)取不到賣(mài)家的退發(fā)貨地址?？傻健百u(mài)家中心--物流工具”頁(yè)面把地址補(bǔ)上重試 。

10、是否可將不同子訂單的運(yùn)單號(hào)修改成相同運(yùn)單號(hào)     
不可以，修改時(shí)，各子訂單對(duì)應(yīng)的運(yùn)單號(hào)必須不同。

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

評(píng)價(jià)API

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

2、新增評(píng)價(jià)接口是否可用于天貓商家？
不可以，暫只支持集市賣(mài)家

3、taobao.traderate.add 和taobao.traderate.list.add 什么差別？
前者是新增單個(gè)評(píng)價(jià)，后者是新增批量評(píng)價(jià)。如有交易有3個(gè)子訂單，則taobao.traderate.add需評(píng)價(jià)3次，而taobao.traderate.list.add 則只需評(píng)價(jià)1次。

4、評(píng)價(jià)時(shí)，提示“主訂單不可”評(píng)價(jià)是什么原因？如何處理
I： 確認(rèn)是否滿足評(píng)價(jià)條件(交易成功、未評(píng)價(jià)、未超過(guò)評(píng)價(jià)時(shí)間)
II： 確認(rèn)是否特殊類(lèi)目商品("其他”類(lèi)目，通過(guò)tid 查到cid ，再用類(lèi)目接口查cid是否其它類(lèi)目，該類(lèi)目包含“訂單、贈(zèng)品、定金、新品預(yù)覽、郵費(fèi)、搭配套餐” 6個(gè)子類(lèi)目)
III： trade 中有退款子訂單，不能用 taobao.traderate.list.add 評(píng)價(jià)(報(bào)不可評(píng)價(jià)錯(cuò)誤)

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

退款A(yù)PI

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

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

旺旺API

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

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

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

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

用戶API

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

FAQ

開(kāi)發(fā)中常見(jiàn)問(wèn)題是否有解決文檔