注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > 基础技术

商品发布FAQ

更新时间:2019/07/30 访问次数:6814

1、top 接口与web端支持编辑的字段完全一样吗?如果不一样,差别在哪

答:部分不一样,有些不支持top编辑

差别字段:
1. 新尺码的编辑不支持
1. 不支持电子凭证的编辑

2、 调用tmall.item.schema.add , 或者 tmall.item.schema.update ,尤其是更新接口, 有些字段没有,如返回错误为 “ 适用人群”为必填项,不能为空;“适用场景”为必填项,不能为空, ”,但我通过tmall.item.add.schema.get 获取的字段并没有 适用人群 字段?

答:对于这种先看商家是天猫还是淘宝,天猫都是基于达尔文产品来的,每个商品都需要挂靠在产品上面,添加商品前先添加产品,如果商品上面没有的字段,一般都是在产品的字段上,先通过tmall.product.add.schema.get接口获取产品发布涉及的规则,然后使用tmall.product.schema.update 更新产品。更新完成之后再去更新商品,因为产品的一些字段可能会有小二操作变更,以最新get 的规则为准。

3、接口: taobao.item.update 某些类目接口调用更新一些字段,返回成功,但字段没有更新成功

答:淘宝的**某些管控类目**的商品也是跟产品匹配的,发布或者更改商品的时候,会自动匹配产品,并合并到商品中,字段以产品的为准

4、 属性别名,明明单个别名没有超过规则的长度,为什么报超长

答:针对属性别名字段,会有个总长度限制,在1200左右,如果单个的没超过规则长度,需要排查下总长度是否超出

5、使用增量接口更新卖点应该怎么提示更新字段列表不能为空

答:检查传入的xml中的update_fields中是否传入了通过get接口获取的规则xml中的对应卖点的option,所有value的范围必须根据规则xml中进行获取

6、属性出错问题

描述:
[msg] => Remote service error
[sub_code] => isv.item-add-service-error:ITEM_PROPERTIES_ERROR
[sub_msg] => “帐底材质、外帐材质”属性出错:类目属性在标准属性中不存在:帐底材质, 外帐材质

答:一般为行业小二对类目的属性进行了调整,不管在商品发布还是在更新的情况下遇到此情况时,如果是天猫商品,调用tmall.product.update.schema.get接口获取产品更新规则后,根据规则更新一下产品,再进行商品更新和商品发布;如果是集市商品,直接获取最新的规则xml后再进行商品更新或者发布。

7、类目未授权,品牌未授权等

描述
{“error_response”:{“code”:15,“msg”:“Remote service error”,“sub_code”:“isv.invalid-parameter:cid”,“sub_msg”:“商品类目未授权,请重新选择类目”,“request_id”:“9wy7rnl2x7k7”}}

答:一般出现于天猫商家,天猫对于商家能够发布的商品类目和品牌有管控,开发者可以通过调用tmall.brandcat.control.get接口去获取当前商家允许发布的类目,控制schema中接口的类目id的入参范围。

8、 经常遇到属性报错问题,属性别名,属性自定义,库存等等(这个大家反馈的问题最多)

答:销售属性的传值,也就是颜色属性,尺码属性,需要跟sku库存的相对应
** 三剑客(颜色,尺码,sku)**
** 三剑客(颜色,尺码,sku)**
** 三剑客(颜色,尺码,sku)**
重要的事情说三遍,这些基本都是拼接问题,具体可以查看,天猫和淘宝的发布示例看下具体拼接的步骤

天猫发布示例://open.taobao.com/doc.htm?docId=108955&docType=1
淘宝发布示例://open.taobao.com/doc.htm?docId=108956&docType=1

9、卖家如何通过api 获取自己店铺中所有商品?

调用 taobao.items.onsale.get(店铺出售中商品) 和taobao.items.inventory.get (店铺仓库中商品)即可获取。

10、接口taobao.items.onsale.get 无法按seller_cids 查询商品是什么原因?

通过这种方式获取自定义类目下的商品,有一个前提条件:即在调用接口taobao.sellercats.list.get获取自定义类目时,类目的类型必须是手动分类(即type=manual_type)。如非手动分类的,则无法查询对应类目下商品。

11、接口taobao.items.inventory.get 为什么无法获取所有仓库中商品?

该api 默认并不是查询仓库中所有商品,如需查询所有商品,必须入参banner (所有类型都输入)。详细可看该api中有关banner字段的说明。

12、为什么页面上显示sku 颜色 淡蓝色,但通过taobao.item.get(fields返回sku)取到确实蓝色?

页面展示的是别名,对应api中 property_alias 这个字段 。并非sku中的 properties_name 字段。

13、taobao.item.add 添加商品时cid、props 属性参数从那获取?

通过类目相关api taobao.itemcats.get 和taobao.itemprops.get 获取。另 属性工具 也可获取,开发测试时可以配合api使用,以便于理解。

14、使用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 调用过程。

15、上传商品时只能添加商品主图,如何给商品添加其它图片?

调用taobao.item.img.upload 添加即可

16、taobao.item.update 修改商品时是否所有字段都需要填写,如果没有填写的字段是否会被修改?

不是所有字段都需要填写,没有填写的将不会被更新。

17、调用接口 taobao.item.update 出现这个错误, isv.invalid-parameter:desc 是什么回事吗?

desc描述建议不要太长,不然数据包发送到服务器上丢包可能性很大,导致签名出错。

18、删除商品详情后,但页面仍显示什么原因?

一般是商家在商品详情里引用了旺铺装修模版导致,需商家自己操作取消。

19、taobao.item.update.listing 上架商品,提示如下错误,如何处理?

“Remote service error“流行款式名称”属性出错:类目属性在标准属性中不存在:流行款式名称”
这个是商品“流行款式名称” 这个属性没有加导致上架报错,该属性是必选属性,请到页面编辑增加这个属性后,再尝试用api 修改。接口上架是全量校验的,如果商品某个属性有错,就会上架失败,并抛出提示。

20、调用接口出现 App Call Limited,是什么原因?


报错:7 App Call Limited accesscontrol.limited-by-app-api-access-count This ban will last for 23452 more seconds

应用正式环境测试阶段,除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 的说明

21、 IC_SKU_PROPERTY_VALUE_NOT_IN_FOREST_OR_INPUT

此报错说明sku的销售属性值入参有问题,传入了不在类目属性的枚举值,此时应该重新获取类目属性,对于不在枚举值列表的,请以自定义输入传入入参。

22、图片报错问题

先按以下自查,如果确定都没问题,提工单反馈
* 样式问题,如加了自定义的样式,alt=“我是图片.jpg”,这种就会报错,会提示盗图
* 图片为空,检查下是否空白图
* 白底图校验,是否不是白底图
* 图片的尺寸不符合要求,按照要求来更正即可

23、报错 system_busy

减少调用的频率,为了防止滥用,加了限制,请降低频率即可

24、淘宝的竖图传值

taobao.item.joint.img 这个接口来关联,position 传值为5,就是第六张图,也就是竖图
taobao.item.img.upload 这个来传,position 传值为5,就是第六张图,也就是竖图

25、taobao.item.add;taobao.item.update 自定义销售属性的sku添加没有报错,但也不生效

目前淘宝的两个接口仅支持颜色、尺码两个销售属性的自定义输入pv对;支持除这两个外的其他销售属性值的枚举值
暂时不支持除颜色、尺码外的自定义销售属性PV对。

26、材质成分获取接口以及传值

请使用 API:taobao.itemprops.get ,fields字段里,is_material,material_do 即可以获取材质成分属性的数据。

27、 淘宝TOP接口的一些字段长度限制?

  • 类目属性输入文本最大长度 默认32字节;
  • 销售属性输入文本最大长度 默认30字节;
  • 销售属性别名,备注可输入最大长度 默认30字节;
  • 自定义值的最大个数 默认24个;
  • 特殊情况不能一一列举

28、 淘宝的资质接口如何传参数? taobao.item.update和taobao.item.add 的qualification 这个如何传?

请使用 taobao.item.qualification.display.get 获取规则

示例:
第一步
首先输入类目id,或者商品id(非必须)
类目ID 50024678
入参:category_id:50024678
出参:

<item_qualification_display_get_response>
<display_conf>
<model>%7B%22triggered%22%3Atrue%2C%22index%22%3A1%2C%22confs%22%3A%5B%7B%22apiUrl%22%3A%22%2Fauction%2Fjson%2FgetQualificationDisplayConf.do%3Fcat_id%5Cu003d50024678%5Cu0026_input_charset%5Cu003dutf-8%5Cu0026_output_charset%5Cu003dutf-8%22%2C%22fillApiUrl%22%3A%22%2Fauction%2Fjson%2FgetQualificationFillData.do%3Fcat_id%5Cu003d50024678%5Cu0026_input_charset%5Cu003dutf-8%5Cu0026_output_charset%5Cu003dutf-8%22%2C%22topTitle%22%3A%22%22%2C%22triggersList%22%3A%5B%5B%7B%22name%22%3A%2221299%22%2C%22blist%22%3A%5B%5D%7D%2C%7B%22name%22%3A%228369595%22%2C%22blist%22%3A%5B%5D%7D%5D%2C%5B%7B%22name%22%3A%228369595%22%2C%22blist%22%3A%5B%5D%7D%5D%5D%2C%22fillConfList%22%3A%5B%5D%2C%22toggleItems%22%3A%5B%5D%2C%22type%22%3A%22DEFAULT_CONF_50024678%22%2C%22triggers%22%3A%5B%7B%22name%22%3A%2221299%22%2C%22wlist%22%3A%5B%2227772%22%5D%7D%2C%7B%22name%22%3A%228369595%22%2C%22wlist%22%3A%5B%221431636782%22%2C%221431647543%22%2C%221431668039%22%2C%221431670018%22%5D%7D%5D%2C%22checked%22%3Atrue%2C%22required%22%3Afalse%7D%5D%2C%22catID%22%3A50024678%7D</model>
<result>true</result>
</display_conf>
<request_id>xxxxx</request_id>
</item_qualification_display_get_response>
<!--top011008075211.na61-->

对model进行urldecode

{"triggered":true,"index":1,"confs":[{"apiUrl":"/auction/json/getQualificationDisplayConf.do?cat_id=50024678&_input_charset=utf-8&_output_charset=utf-8","fillApiUrl":"/auction/json/getQualificationFillData.do?cat_id=50024678&_input_charset=utf-8&_output_charset=utf-8","topTitle":"","triggersList":[[{"name":"21299","blist":[]},{"name":"8369595","blist":[]}],[{"name":"8369595","blist":[]}]],"fillConfList":[],"toggleItems":[],"type":"DEFAULT_CONF_50024678","triggers":[{"name":"21299","wlist":["27772"]},{"name":"8369595","wlist":["1431636782","1431647543","1431668039","1431670018"]}],"checked":true,"required":false}],"catID":50024678}

第二步 对上一步的出参进行urldecode后,获取触发资质的属性id和属性值,然后用你要使用的属性id和属性值再次调用此接口
比如:传入21299:27772 和 8369595:1431636782
入参:
param: {“21299”:“27772”,“8369595”:“1431636782”}
category_id:50024678
出参:urlencode 后的json

{"triggered":true,"index":1,"confs":[{"apiUrl":"/auction/json/getQualificationDisplayConf.do?cat_id\u003d50024678\u0026_input_charset\u003dutf-8\u0026_output_charset\u003dutf-8","fillApiUrl":"/auction/json/getQualificationFillData.do?cat_id\u003d50024678\u0026_input_charset\u003dutf-8\u0026_output_charset\u003dutf-8","topTitle":"请您向淘宝网备案以下信息,信息可能在PC和手淘展示","requireContent":"请如实填写商品3c证书编号信息,确保所填3c信息与所售商品一致。","triggersList":[[{"name":"21299","blist":[]},{"name":"8369595","blist":[]}],[{"name":"8369595","blist":[]}]],"fillConfList":[],"toggleItems":[],"type":"3CRenZheng-JiaZhuangZhuCai__DengJuDengShi__-JingYu__50024678","title":"请提交以下信息","storage":"item_qualification","triggers":[{"name":"21299","wlist":["27772"]},{"name":"8369595","wlist":["1431636782","1431647543","1431668039","1431670018"]}],"items":[{"name":"var_org_auth_tri_c_code","label":"3C证书编号","tips":"请填写3c证书编号","type":"text","samples":{},"dbName":"org_auth_tri_c_code","checkers":[{"type":"min","value":"1","msg":"3C证书编号必填!"},{"type":"check","value":"//upload.taobao.com/auction/json/remote_check.do?_input_charset003dUTF-8","api":"taobao.item.qualification.check","msg":"编号无效,原因请访问pinkong.bbs.taobao.com/detail.html?postId\u003d5591575,编号审核通过后方可发布商品。"}],"isShow":true}],"footerHTML":"承诺以上信息为实际售卖的商品信息,淘宝网会定期对该信息进行抽查,如发现不符会受到相应处罚,查看\u003ca href\u003d\"https://pinkong.bbs.taobao.com/detail.html?spm\u003da210m.7754828.0.0.QlVuLN\u0026postId\u003d5591575\" target\u003d\"_blank\"\u003e详细说明 \u0026gt;\u0026gt;\u003c/a\u003e","checked":true,"required":true}],"catID":50024678}

第三步:由上可知,需要的资质是 var_org_auth_tri_c_code 3c证书
那么正常的qualification 字段应该是写入
{“var_org_auth_tri_c_code”:“你的3c证书编号”}

29、 所选运费模板不支持按体积计费;所选运费模板不支持按重量计费

新版淘宝top新加的逻辑,与新版web保持一致,商品运费模板的切换,必须传入对应的体积和重量。
如果按体积,则体积 item_size 传值,重量 item_weight传0
如果按重量,重量item_weight 传值,体积item_size 传bulk:0
如果按件,则体积item_size 传bulk:0 ,重量 item_weight传0

30、 新版手机版描述入参示例,如何通过taobao.item.add,taobao.item.update接口添加编辑宝贝无线详情?

分别为摘要,图片和文字,仅支持这三个标签,其他值传入不认会报错

<?xml version="1.0" encoding="UTF-8"?>
<wapDesc><shortDesc>此处是摘要部分</shortDesc><img >https://img.alicdn.com/imgextra/i1/439948475/TB2k1ByeFXXXXX.XpXXXXXXXXXX_!!439948475.jpg</img><img >https://img.alicdn.com/imgextra/i3/439948475/O1CN012CTb7vKDoyL9PeS_!!439948475.jpg</img><txt>此处为文字描述</txt><img >https://img.alicdn.com/imgextra/i1/439948475/O1CN01E9419U2CTb8dbrENa_!!439948475.jpg</img><txt>此处为文字描述</txt></wapDesc>

31、 p-20000|CHK_CATPROP_CPV_NOT_ENUM|非枚举的属性值不合法

此报错是指此类目属性只能使用枚举值,然后现在传入了自定义值,不在类目属性值里面,p-20000 是指20000这个属性,这个是品牌,其他不同的值,代表其他不同的属性,可以直接判断哪个属性有问题。

32、部分类目商品:如化妆品等。 taobao.item.update 更新商品 title 报“功效”为必填项,不能为空"。只是更新商品标题,为什么报“功效”必填?为什么填写了还报错?为什么新发的时候不报错?

  • 商品发布接口目前对一些类目属性等基本字段是全校验的,请根据报错填写完整
  • 化妆品等类目是会进行spu匹配的,如果匹配到spu,并且spu的绑定属性功效已经被屏蔽,则编辑的时候会读取不到此功效,但此属性又是必填,所以报错

解决:因为属性是spu绑定属性,所以通过商品修改也是无法修改成功的。 建议碰到此商品后,引导卖家根据关键属性去纠错spu的这个属性值,纠错成功后即可正常使用。

FAQ

关于此文档暂时还没有FAQ
返回
顶部