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

文档中心 > 基础技术

商品发布FAQ

更新时间:2023/05/22 访问次数:35108

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

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

差别字段:

1)新尺码的编辑不支持;

2)不支持电子凭证的编辑。


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、 属性别名,明明单个别名没有超过规则的长度,为什么报超长?

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


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

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


5、属性出错问题。

描述:

[msg] => Remote service error

[sub_code] => isv.item-add-service-error:ITEM_PROPERTIES_ERROR

[sub_msg] => “帐底材质、外帐材质”属性出错:类目属性在标准属性中不存在:帐底材质, 外帐材质

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


6、类目未授权,品牌未授权等。

描述

{“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的入参范围。


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

答:销售属性的传值,也就是颜色属性,尺码属性,需要跟sku库存的相对应

** 三剑客(颜色,尺码,sku)**

** 三剑客(颜色,尺码,sku)**

** 三剑客(颜色,尺码,sku)**

重要的事情说三遍,这些基本都是拼接问题,具体可以查看,天猫和淘宝的发布示例看下具体拼接的步骤

天猫发布示例:点击查看

淘宝发布示例:点击查看


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

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


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

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


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

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


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

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


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


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

答:调用taobao.item.img.upload 添加即可。


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

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


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

答:“Remote service error“流行款式名称”属性出错:类目属性在标准属性中不存在:流行款式名称”

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


16、调用接口出现 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秒 后才能继续调用。


17、IC_SKU_PROPERTY_VALUE_NOT_IN_FOREST_OR_INPUT。

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


18、图片报错问题。

答:先按以下自查,如果确定都没问题,提工单反馈。

1) 样式问题,如加了自定义的样式,alt=“我是图片.jpg”,这种就会报错,会提示盗图;

2) 图片为空,检查下是否空白图;

3)白底图校验,是否不是白底图;

4) 图片的尺寸不符合要求,按照要求来更正即可。


19、报错 system_busy。

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


20、淘宝的竖图传值。

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

taobao.item.img.upload 这个来传,position 传值为5,就是第六张图,也就是竖图。


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

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


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

答:

1)类目属性输入文本最大长度 默认32字节;

2)销售属性输入文本最大长度 默认30字节;

3)销售属性别名,备注可输入最大长度 默认30字节;

4)自定义值的最大个数 默认24个;

5)特殊情况不能一一列举。


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

答:新版淘宝top新加的逻辑,与新版web保持一致,商品运费模板的切换,必须传入对应的体积和重量。

如果按体积,则体积 item_size 传值,重量 item_weight传0;

如果按重量,重量item_weight 传值,体积item_size 传bulk:0;

如果按件,则体积item_size 传bulk:0 ,重量 item_weight传0。


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

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

FAQ

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