商品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:  FileItem 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-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

开发中常见问题是否有解决文档