淘宝开放平台开发文档 / API相关问题

API相关问题

商品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、ta
obao.refunds.receive.get 接口是否可查询售后退款订单?

售后退款接口取不到,接口暂不支持获取。

2、退款时,店铺优惠券如何处理
未发货:整个交易订单取消关闭或申请全额退款成功,店铺优惠券会返回给买家,使用有效期不变,若退还时已过有效期,优惠券将作废;
已发货:产生交易纠纷,按实际付款金额算,店铺优惠券不做处理。

旺旺API

@
1、tao
bao.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

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