背景:小A是一个商家的技术人员,自家商品特别多,需要开发一个商品的管理系统,负责商品的上新,更新,价格更新,上下架等工作,查看淘宝开放平台这些API,发现都能满足,就开始了的开发历程。
类目:电子词典/电纸书/文化用品>>电子阅览器/电纸书。
入参:category_id=50010731;
出参:规则xml;
入参:category_id=50010731;propvalues=xml_data(示例XML如下)
出参:产品idproductid=337259102;因为这一步直接获得了产品id,可以直接到5添加商品。
入参:category_id=50010731;brand_id=13525264;
涉及API:tmall.product.schema.add;
入参:category_id=50010731;brand_id=13525264;xml_data;
出参:产品idproduct_id;
注意:部分产品发布后需要审核通过后才可使用,所以需要等待产品状态可用后再发布商品;
入参:category_id=50010731;product_id=337259102;
入参:category_id=50010731;product_id=337259102;xml_data(示例xml如下);
出参:商品id;
如:get到的商品状态rule值。
提交的商品张图rule值。
注意2:xml_data根据上一步获得的的xml出参xml拼接,对于里面必填的rule(requiredRule)需要全部填写,对于sku等参数也需要填写ok。
类目:女装/女士精品>>裤子>>棉裤/羽绒裤。
对于没有关键属性的类目,不需要发布产品,直接发布商品。
入参:category_id=50026651;product_id=0(因为不需要产品,直接写0);
入参:category_id=50026651;product_id=0;xml_data(示例xml如下)
恭喜!你终于成功发布了一个非标商品!
注意1:xml_data根据上一步获得的的xml出参xml拼接,对于里面必填的rule需要全部填写,对于sku等参数也需要填写ok。
a.全量更新(除局部更新外的均需要走全量更新);
b.局部更新(局部更新API);
a.商品和sku价格编辑建议使用tmall.item.price.update;
b.商品库存同步taobao.item.quantity.update/taobao.skus.quantity.update;
c.商品标题等信息增量更新(支持元素如下)Schema增量;
①TITLE(标题)
②SUBTITLE(子标题,即卖点)
③SHOW_TITLE(展示标题)
④SHORT_TITLE(无线短标题)
⑤DESC(PC描述)
⑥WAP_DESC(无线描述)
⑦WIRELESS_DESC(新版无线描述字段)
⑧VERTICAL_IMAGE(竖图)
⑨WHITE_BG_IMAGE(白底图)
⑩LARGE_SCREEN_IMAGE(电子大屏图)
①①SHOP_CATEGORY(店铺类目)
①②ITEM_IMAGE(主图)
①③ITEM_WIRELESS_IMAGES(无线主图)
①④POSTAGE_ID_INCREMENT(运费模板ID)
①⑤IMAGE_VIDEO_TYPE(主图视频比例类型)
①⑥MAIN_VIDEO(主图视频)
①⑦THREE_TO_FOUR_IMAGES(3:4商品图片)
a.增量更新规则获取tmall.item.increment.update.schema.get(注意:这里也是一个xml,如果只修改标题,则xml中update_fields的value就只设置title;如果需要更新多个,则设置多个value);
b.根据规则拼接xml;
c.调用增量更新接口tmall.item.schema.increment.update(注意:获取的规则中的所有field都需要将default-value拼装上并回传回来);
TIPS1:由于增量更新支持的元素可能会进行扩展,建议用户可以每天调用tmall.item.increment.update.schema.get接口仅入参item_id获取当前商品所属类目支持增量更新的元素。
TIPS2:建议开发者将增量接口支持的每个元素独立封装,这样性能上更优越,报错也会更少。
TIPS3:关于主图视频,目前商品已经支持3:4主图视频,并且支持3:4商品主图图片更新,建议三个字段为一个组件来使用:
①如果IMAGE_VIDEO_TYPE选择1:1或者16:9类型,那么MAIN_VIDEO需要传值1:1或者16:9类型的视频,此时THREE_TO_FOUR_IMAGES这个字段,不管你传值与否,都不会生效。
②如果IMAGE_VIDEO_TYPE选择3:4类型,那么MAIN_VIDEO需要传值3:4类型视频,且需要同时传3:4视频和图片。
增量编辑还是很方便的,可以减少全量的多问题,只更改某些字段。
涉及API:
参考示例:
入参:item_id=xxxx;xml_data(可选,这里可以单独需要更新字段的规则,不填则获取全部);
入参:item_id=xxxx;xml_data选择3.1步骤中获取的规则,把字段拼接回去(注意:如果某个字段需要更改,default-value标签需要改成value来更新);
出参:更新结果;
组成SKU的特殊属性,它会影响买家的购买和卖家的库存管理,如服装的"颜色"、"套餐"和"尺码"。当颜色在特定类目下是销售属性时,卖家发布宝贝的时候上传了颜色图片,则颜色属性值直接显示图片.否则显示属性值别名或属性值名。
spu=standardproductunit标准化产品单元;spu相当于一个产品,可详见产品定义。
CSPU=SPU+销售属性
sku=stockkeepinguint(库存量单位),为保存库存控制的最小可用单位,例如一件T恤中一个SKU通常由颜色、尺码组成,如下图:
SKU=CSPU+价格+库存
1)如果是非达尔文商品,有两种情况如下:
①没有SPU:这种是没有关键属性(如关键属性“品牌”)的就没有spu,发布商品时无需发布产品,直接发布商品即可。
②有SPU:这种是有关键属性,只有spu的,那么获取到的规则就没有CSPUID。
2)如果是达尔文商品,同时有SPU+CSPU,那么获取到的SKU规则是有CSPUID的。
达尔文SKUfield字段id:
非达尔文SKUfield字段id:
从darwin_sku的multiComplex可以看到,我们需要拼接一个complex-values。
①因为是标类产品,需要带上cspuId,可以从获取的规则里面取一个;
②销售属性有套餐类型,可以自定义的,我们从中选官方标配;
③苹果的销售属性-颜色已经合并到CSPU,可以直接使用,不要再单独写到SKu;
④再加上SKU属性(价格+库存数量),一个sku就拼接完成了;
注意:编辑商品的时候注意下不要把系统回带最外层的回传,请把这个全部去掉。否则提交会清除sku。
拼接好的darwin_sku:
示例类目:女装/女士精品>>裤子>>棉裤/羽绒裤。
商品是非标,非达尔文,也就没有cspu,sku里面也不用填写这些cspu,衣服一般都有两个销售属性,颜色+尺码。同样sku也是complex-values。
销售属性自定义是需要拼接的。
①颜色分类,必选,单选,选择28341黑色;
②别名,非必选,可以不写;
③属性图片,必选,写一个图片url;
④色系,非必选,多选的,注意值是这种;
这样一个颜色的销售属性拼接完成,可以有多个颜色。
新版尺码操作可以从get到的rule查看,我们可以选择自定义尺码分组,截图来自web后台,我们可以选择已有的尺码模板,也可以自定义尺码表,比如只应用于当前的商品。
从图中可以看到,一个尺码,是有很多方面的,比如身高,体重,裤长等,这些构成了一个尺码。
①尺码分组(std_size_group)可以选一个,也可以选择自定义,选择自定义后既可以自定义尺码扩展;
②尺码扩展(std_size_extends_20509)开始拼接;
③尺码id(std_size_prop_20509_-1),size_mapping可以选择体重和身高等,我们选择体重和身高两个来自定义,结果如下:
sku拼接就是把所有的销售属性的个数做个乘法,比如颜色1个,尺码5个,那么就需要写1*5=5个sku,比如3个颜色,10个尺码,那么sku则需要写3*10=30个。