基础技术
一、商品新发案例说明
背景：小A是一个商家的技术人员，自家商品特别多，需要开发一个商品的管理系统，负责商品的上新，更新，价格更新，上下架等工作，查看淘宝开放平台这些API，发现都能满足，就开始了的开发历程。
1. 获取类目
1）类目获取 taobao.itemcats.get；
2）授权类目品牌获取 taobao.itemcats.authorize.get；
2. 发布商品kindle paperwhite 3（标类达尔文商品）
类目：电子词典/电纸书/文化用品>>电子阅览器/电纸书。
1）产品匹配规则获取
涉及API：tmall.product.match.schema.get；
参考示例：https://open.taobao.com/api.htm?docId=23258&docType=2；
入参：category_id = 50010731；
出参：规则xml；
2）产品匹配
涉及API：tmall.product.schema.match；
参考示例：https://open.taobao.com/api.htm?docId=23259&docType=2；
入参：category_id = 50010731；propvalues = xml_data（示例XML如下）
1 2 3 4 5 6 7 8 | <itemRule> <field id="prop_20000" name="品牌" type="singleCheck"> <value>13525264</value> </field> <field id="prop_6362646" name="型号" type="singleCheck"> <value>693238758</value> </field></itemRule> |
出参：产品id productid = 337259102 ；因为这一步直接获得了产品id，可以直接到 5 添加商品。
3）产品发布规则获取,如果上一步没有匹配到产品，需要自己添加
涉及API：tmall.product.add.schema.get；
参考示例：https://open.taobao.com/api.htm?docId=23257&docType=2；
入参：category_id = 50010731 ； brand_id = 13525264；
出参：规则xml；
4）产品发布,根据规则组装xml
涉及API： tmall.product.schema.add；
参考示例：https://open.taobao.com/api.htm?docId=23260&docType=2；
入参：category_id = 50010731 ； brand_id = 13525264 ； xml_data；
出参：产品id product_id；
注意：部分产品发布后需要审核通过后才可使用，所以需要等待产品状态可用后再发布商品；
5）商品发布规则获取
涉及API：tmall.item.add.schema.get；
参考示例：https://open.taobao.com/api.htm?docId=23256&docType=2；
入参：category_id = 50010731 ；product_id =?337259102；
6）商品发布
涉及API： tmall.item.schema.add；
参考示例： https://open.taobao.com/api.htm?docId=23255&docType=2；
入参：category_id = 50010731 ；product_id =?337259102; xml_data （示例xml如下）；
出参：商品id；
注意1：发布规则获取（tmall.item.add.schema.get）得到的default-value 值，需要把default去掉，改成value，加到入参中，default-value 服务端是不认的。
如：get到的商品状态rule值。
提交的商品张图rule值。
注意2：xml_data 根据上一步获得的的xml出参xml拼接，对于里面必填的rule(requiredRule)需要全部填写，对于sku等参数也需要填写ok。
3. 发布商品羽绒服
类目：女装/女士精品>>裤子>>棉裤/羽绒裤。
对于没有关键属性的类目，不需要发布产品，直接发布商品。
1）商品发布规则获取
涉及API： tmall.item.add.schema.get；
参考示例：https://open.taobao.com/api.htm?docId=23256&docType=2；
入参：category_id = 50026651 ；product_id = 0 （因为不需要产品，直接写0）；
2）商品发布
涉及API： tmall.item.schema.add；
参考示例： https://open.taobao.com/api.htm?docId=23255&docType=2；
入参：category_id = 50026651 ；product_id = 0 ； xml_data （示例xml如下）
出参：商品id；
注意1：发布规则获取（tmall.item.add.schema.get）得到的default-value 值，需要把default去掉，改成value，加到入参中，default-value 服务端是不认的。
如：get到的商品状态rule值。
提交的商品张图rule值。
恭喜！你终于成功发布了一个非标商品！
注意1：xml_data 根据上一步获得的的xml出参xml拼接，对于里面必填的rule需要全部填写，对于sku等参数也需要填写ok。
二、商品编辑
1. 商品编辑更新
1）更新分类
a. 全量更新（除局部更新外的均需要走全量更新）;
b. 局部更新（局部更新API）;
2）增量更新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商品图片)
3）增量更新过程
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视频和图片。
增量编辑还是很方便的，可以减少全量的多问题，只更改某些字段。
2. 商品价格及库存更新
1）价格编辑
涉及API：tmall.item.price.update；
参考示例：https://open.taobao.com/api.htm?docId=24249&docType=2；
2）库存编辑
涉及API：
参考示例：
https://open.taobao.com/api.htm?docId=10591&docType=2；
https://open.taobao.com/api.htm?docId=21169&docType=2；
注意：如果商品关联了后端货品，那么库存不能使用这两个接口，需要使用库存的接口 taobao.inventory.adjust.trade。
3. 商品标题等信息增量更新
1）商品增量更新规则获取
涉及API： tmall.item.increment.update.schema.get；
参考示例：https://open.taobao.com/api.htm?docId=23781&docType=2；
入参：item_id=xxxx; xml_data (可选，这里可以单独需要更新字段的规则，不填则获取全部)；
2）商品增量更新
涉及API： tmall.item.schema.increment.update；
参考示例：https://open.taobao.com/api.htm?docId=23782&docType=2；
入参：item_id=xxxx;xml_data 选择3.1 步骤中获取的规则，把字段拼接回去（注意：如果某个字段需要更改，default-value 标签需要改成value来更新）；
xml_data 示例(只更新标题) download: add.xml；
出参：更新结果；
4. 全量更新
涉及API： tmall.item.update.schema.get；
参考示例：https://open.taobao.com/api.htm?docId=23435&docType=2；
三、销售属性自定义案例
1. 名词解释
1）销售属性
组成SKU的特殊属性，它会影响买家的购买和卖家的库存管理，如服装的"颜色"、"套餐"和"尺码"。当颜色在特定类目下是销售属性时，卖家发布宝贝的时候上传了颜色图片,则颜色属性值直接显示图片.否则显示属性值别名或属性值名。
2）SPU
1 | spu=standard product unit 标准化产品单元；spu相当于一个产品，可详见产品定义。 |
3）CSPU
CSPU=SPU+销售属性
4）SKU
1 | sku=stock keeping uint(库存量单位)，为保存库存控制的最小可用单位，例如一件T恤中一个SKU通常由颜色、尺码组成，如下图： |
SKU=CSPU+价格+库存
2. 达尔文SKU区分（标类）
1）如果是非达尔文商品，有两种情况如下：
① 没有SPU：这种是没有关键属性（如关键属性“品牌”）的就没有spu，发布商品时无需发布产品，直接发布商品即可。
② 有SPU：这种是有关键属性，只有spu的，那么获取到的规则就没有CSPUID。
2）如果是达尔文商品，同时有SPU + CSPU，那么获取到的SKU规则是有CSPUID的。
达尔文SKU field 字段id：
非达尔文SKU field 字段id：
3. 达尔文SKU组装
1）iPhone X 商品发布获取规则示例
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 | <field id="darwin_sku" name="DARWIN_SKU" type="multiComplex"> <fields> <field id="prop_5919063" name="套餐类型" type="singleCheck"> <options> <option displayName="官方标配" value="6536025"/> <option displayName="套餐一" value="3266779"/> <option displayName="套餐二" value="3266781"/> <option displayName="套餐三" value="3266785"/> <option displayName="套餐四" value="3266786"/> <option displayName="套餐五" value="3266789"/> <option displayName="套餐六" value="3284565"/> <option displayName="套餐七" value="3284566"/> <option displayName="套餐八" value="3284567"/> </options> </field> <field id="sku_id" name="SkuId" type="input"> <rules> <rule name="valueTypeRule" value="long"/> <rule name="readOnlyRule" value="true"/> </rules> </field> <field id="cspuId" name="产品规格" type="singleCheck"> <rules> <rule name="devTipRule" value="1000022743583297-10004:709990523;1627207:28330;12304035:3222911^1000022743584321-10004:709990523;1627207:382328443;12304035:3222911^1000022743585345-10004:709990523;1627207:28330;12304035:11835346^1000022743586369-10004:709990523;1627207:382328443;12304035:11835346"/> </rules> <options> <option displayName="Apple/苹果 iPhone X 无需合约版 银色 64GB" value="1000022743583297"/> <option displayName="Apple/苹果 iPhone X 无需合约版 深空灰色 64GB" value="1000022743584321"/> <option displayName="Apple/苹果 iPhone X 无需合约版 银色 256GB" value="1000022743585345"/> <option displayName="Apple/苹果 iPhone X 无需合约版 深空灰色 256GB" value="1000022743586369"/> </options> </field> <field id="cspu" name="产品规格" type="label"> <label-group> <label-group name="1000022743583297"> <label name="条形码" value="000000000000"/> <label name="基础色" value="[28332]" desc="基础色颜色色块"/> </label-group> <label-group name="1000022743584321"> <label name="条形码" value="000000000000"/> <label name="基础色" value="[28332]" desc="基础色颜色色块"/> </label-group> <label-group name="1000022743585345"> <label name="条形码" value="000000000000"/> <label name="基础色" value="[28332]" desc="基础色颜色色块"/> </label-group> <label-group name="1000022743586369"> <label name="条形码" value="000000000000"/> <label name="基础色" value="[28332]" desc="基础色颜色色块"/> </label-group> </label-group> </field> <field id="sku_price" name="价格" type="input"> <rules> <rule name="valueTypeRule" value="decimal"/> <rule name="requiredRule" value="true"/> <rule name="maxValueRule" value="1000000000" exProperty="not include"/> </rules> </field> <field id="sku_quantity" name="库存" type="input"> <rules> <rule name="valueTypeRule" value="long"/> <rule name="requiredRule" value="true"/> <rule name="maxValueRule" value="2147483647" exProperty="not include"/> <rule name="regexRule" value="([1-9][0-9]{0,10}|[0-9])"/> </rules> </field> <field id="sku_outerId" name="商家编码" type="input"> <rules> <rule name="valueTypeRule" value="text"/> <rule name="maxLengthRule" value="64" exProperty="include" unit="byte"/> </rules> </field> <field id="sku_scProductId" name="货品Id" type="input"> <rules> <rule name="valueTypeRule" value="text"/> </rules> </field> </fields> </field> |
2）SKU拼接步骤
从darwin_sku 的 multiComplex 可以看到，我们需要拼接一个complex-values。
① 因为是标类产品，需要带上 cspuId，可以从获取的规则里面取一个；
② 销售属性有套餐类型，可以自定义的，我们从中选官方标配；
③ 苹果的销售属性-颜色已经合并到CSPU，可以直接使用，不要再单独写到SKu；
④ 再加上SKU属性（价格+库存数量），一个sku就拼接完成了；
注意：编辑商品的时候注意下不要把系统回带最外层的?回传，请把这个全部去掉。否则提交会清除sku。
拼接好的darwin_sku：
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 | <complex-values> <field id="prop_image" type="input"> </field> <field id="sku_outerId" type="input"> </field> <field id="sku_price" type="input"> <value>8888</value> </field> <field id="cspuId" type="singleCheck"> <value>1000022743583297</value> </field> <field id="sku_id" type="input"> </field> <field id="sku_quantity" type="input"> <value>3</value> </field> <field id="prop_5919063" name="套餐类型" type="singleCheck"> <value>6536025</value> </field> </complex-values> |
4. 非达尔文SKU
示例类目：女装/女士精品>>裤子>>棉裤/羽绒裤。
1）棉裤/羽绒裤获取到的规则示例
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 | <field id="prop_extend_1627207" name="颜色分类扩展" type="multiComplex"> <rules> <rule name="requiredRule" value="true"/> </rules> <fields> <field id="prop_1627207" name="颜色分类" type="singleCheck"> <rules> <rule name="requiredRule" value="true"/> </rules> <options> <option displayName="黑色" value="28341"/> <option displayName="深灰色" value="3232478"/> <option displayName="浅灰色" value="28332"/> <option displayName="深紫色" value="3232479"/> <option displayName="紫色" value="28329"/> <option displayName="紫罗兰" value="80882"/> <option displayName="酒红色" value="28327"/> <option displayName="红色" value="28326"/> <option displayName="粉红色" value="3232480"/> <option displayName="桔色" value="90554"/> <option displayName="黄色" value="28324"/> <option displayName="浅黄色" value="60092"/> <option displayName="褐色" value="132069"/> <option displayName="巧克力色" value="3232481"/> <option displayName="深卡其布色" value="3232482"/> <option displayName="军绿色" value="3232483"/> <option displayName="绿色" value="28335"/> <option displayName="浅绿色" value="30156"/> <option displayName="深蓝色" value="28340"/> <option displayName="蓝色" value="28338"/> <option displayName="天蓝色" value="3232484"/> <option displayName="花色" value="130164"/> <option displayName="透明" value="107121"/> <option displayName="白色" value="28320"/> </options> </field> <field id="alias_name" name="别名" type="input"> <rules> <rule name="valueTypeRule" value="text"/> <rule name="minLengthRule" value="0" exProperty="include" unit="byte"/> <rule name="maxLengthRule" value="60" exProperty="include" unit="byte"/> </rules> </field> <field id="prop_image" name="属性图片" type="input"> <rules> <rule name="valueTypeRule" value="url"/> <rule name="requiredRule" value="true"/> </rules> </field> <field id="basecolor" name="色系" type="multiCheck"> <rules> <rule name="minInputNumRule" value="0" exProperty="not include"/> <rule name="maxInputNumRule" value="3" exProperty="include"/> </rules> <options> <option displayName="白色" value="28320"/> <option displayName="黄色" value="28324"/> <option displayName="红色" value="28326"/> <option displayName="紫色" value="28329"/> <option displayName="灰色" value="28332"/> <option displayName="绿色" value="28335"/> <option displayName="蓝色" value="28338"/> <option displayName="黑色" value="28341"/> <option displayName="橙色" value="90554"/> <option displayName="透明" value="107121"/> <option displayName="花色" value="130164"/> <option displayName="棕色" value="132069"/> <option displayName="粉红色" value="3232480"/> </options> </field> </fields> </field> <field id="std_size_group" name="尺码分组" type="singleCheck"> <options> <option displayName="自定义" value="-1:自定义:-1"/> </options> <default-value>-1:自定义:-1</default-value> </field> <field id="std_size_extends_20509" name="尺码扩展" type="multiComplex"> <fields> <field id="std_size_prop_20509_-1" name="“自定义”尺码" type="input"> <rules> <rule name="tipRule" value="新版尺码操作指南：<a href="//maowo.tmall.com/discussion.htm?spm=a220z.1000884.0.0.5fHBzq&amp;id=29041" target="_blank" data-spm-anchor-id="a220z.1000884.0.0">点击查看</a>"/> <rule name="tipRule" value="尺码备注、自定义尺码标准均不能填写营销词或品牌词，包括不限于包邮/满减/折扣等"/> <rule name="tipRule" value="自定义尺码值只能输入以下格式：【数字/字母/数字；字母/字母，字母+数字 字母/数字；数字/字母；数字+字母；数字/数字；数字/数字/字母；字母；数字/数字+字母/字母；数字/数字+字母；数字】，并支持在上述格式前添加性别如“男/女/男童/女童”。若无支持的格式，可最多新增一个不在上述格式范围内的尺码值"/> <rule name="disableRule" value="true"> <depend-group operator="and"> <depend-express fieldId="std_size_group" value="-1:自定义:-1" symbol="!="/> </depend-group> </rule> </rules> </field> <field id="size_tip" name="尺码备注" type="input"> <rules> <rule name="minLengthRule" value="1" exProperty="include" unit="byte"/> <rule name="maxLengthRule" value="30" exProperty="include" unit="byte"/> <rule name="tipRule" value="尺码备注不能包含逗号、冒号、分号、星号、短横线等特殊符号"/> </rules> </field> <field id="size_mapping_shengao" name="身高（cm）" type="input"> <rules> <rule name="disableRule" value="true"> <depend-group operator="or"> <depend-express fieldId="std_size_prop_20509_-1" value="均码" symbol="=="/> </depend-group> </rule> </rules> </field> <field id="size_mapping_shengao_range" name="身高（cm）" type="complex"> <rules> <rule name="disableRule" value="true"> <depend-group operator="and"> <depend-express fieldId="std_size_prop_20509_-1" value="均码" symbol="!="/> </depend-group> </rule> </rules> <fields> <field id="size_mapping_shengao_from" name="最小值" type="input"/> <field id="size_mapping_shengao_to" name="最大值" type="input"/> </fields> </field> <field id="size_mapping_tizhong" name="体重（公斤）" type="input"> <rules> <rule name="disableRule" value="true"> <depend-group operator="or"> <depend-express fieldId="std_size_prop_20509_-1" value="均码" symbol="=="/> </depend-group> </rule> </rules> </field> <field id="size_mapping_tizhong_range" name="体重（公斤）" type="complex"> <rules> <rule name="disableRule" value="true"> <depend-group operator="and"> <depend-express fieldId="std_size_prop_20509_-1" value="均码" symbol="!="/> </depend-group> </rule> </rules> <fields> <field id="size_mapping_tizhong_from" name="最小值" type="input"/> <field id="size_mapping_tizhong_to" name="最大值" type="input"/> </fields> </field> <field id="size_mapping_yaowei" name="腰围（cm）" type="input"> <rules> <rule name="disableRule" value="true"> <depend-group operator="or"> <depend-express fieldId="std_size_prop_20509_-1" value="均码" symbol="=="/> </depend-group> </rule> </rules> </field> <field id="size_mapping_-1" name="尺码表自定义字段-1" type="complex"> <fields> <field id="size_mapping_-1_name" name="尺码表自定义字段-1名称" type="input"> <rules> <rule name="tipRule" value="尺码表自定义字段名称不能包含数字"/> <rule name="tipRule" value="尺码表自定义字段名称不能包含逗号、冒号、分号、星号、短横线等特殊符号"/> </rules> </field> <field id="size_mapping_-1_value" name="尺码表自定义字段-1值" type="input"> <rules> <rule name="disableRule" value="true"> <depend-group operator="or"> <depend-express fieldId="std_size_prop_20509_-1" value="均码" symbol="=="/> </depend-group> </rule> </rules> </field> <field id="size_mapping_-1_value_range" name="尺码表自定义字段-1值" type="complex"> <rules> <rule name="disableRule" value="true"> <depend-group operator="and"> <depend-express fieldId="std_size_prop_20509_-1" value="均码" symbol="!="/> </depend-group> </rule> </rules> <fields> <field id="size_mapping_-1_value_from" name="最小值" type="input"/> <field id="size_mapping_-1_value_to" name="最大值" type="input"/> </fields> </field> </fields> </field> </fields> </field> <field id="size_mapping_template_id" name="尺码表填充模板ID" type="input"> <rules> <rule name="valueTypeRule" value="long"/> <rule name="tipRule" value="尺码表模板和尺码属性值尺码表数据，二选一，尺码表模板数据优先"/> </rules> </field> <field id="sku" name="SKU" type="multiComplex"> <fields> <field id="prop_1627207" name="颜色分类" type="singleCheck"> <options> <option displayName="黑色" value="28341"/> <option displayName="深灰色" value="3232478"/> <option displayName="浅灰色" value="28332"/> <option displayName="深紫色" value="3232479"/> <option displayName="紫色" value="28329"/> <option displayName="紫罗兰" value="80882"/> <option displayName="酒红色" value="28327"/> <option displayName="红色" value="28326"/> <option displayName="粉红色" value="3232480"/> <option displayName="桔色" value="90554"/> <option displayName="黄色" value="28324"/> <option displayName="浅黄色" value="60092"/> <option displayName="褐色" value="132069"/> <option displayName="巧克力色" value="3232481"/> <option displayName="深卡其布色" value="3232482"/> <option displayName="军绿色" value="3232483"/> <option displayName="绿色" value="28335"/> <option displayName="浅绿色" value="30156"/> <option displayName="深蓝色" value="28340"/> <option displayName="蓝色" value="28338"/> <option displayName="天蓝色" value="3232484"/> <option displayName="花色" value="130164"/> <option displayName="透明" value="107121"/> <option displayName="白色" value="28320"/> </options> </field> <field id="std_size_prop_20509_-1" name="“自定义”尺码" type="input"> <rules> <rule name="tipRule" value="新版尺码操作指南：<a href="//maowo.tmall.com/discussion.htm?spm=a220z.1000884.0.0.5fHBzq&amp;id=29041" target="_blank" data-spm-anchor-id="a220z.1000884.0.0">点击查看</a>"/> <rule name="tipRule" value="尺码备注、自定义尺码标准均不能填写营销词或品牌词，包括不限于包邮/满减/折扣等"/> <rule name="tipRule" value="自定义尺码值只能输入以下格式：【数字/字母/数字；字母/字母，字母+数字 字母/数字；数字/字母；数字+字母；数字/数字；数字/数字/字母；字母；数字/数字+字母/字母；数字/数字+字母；数字】，并支持在上述格式前添加性别如“男/女/男童/女童”。若无支持的格式，可最多新增一个不在上述格式范围内的尺码值"/> <rule name="disableRule" value="true"> <depend-group operator="and"> <depend-express fieldId="std_size_group" value="-1:自定义:-1" symbol="!="/> </depend-group> </rule> </rules> </field> <field id="sku_id" name="SkuId" type="input"> <rules> <rule name="valueTypeRule" value="long"/> <rule name="readOnlyRule" value="true"/> </rules> </field> <field id="sku_price" name="价格" type="input"> <rules> <rule name="valueTypeRule" value="decimal"/> <rule name="requiredRule" value="true"/> <rule name="maxValueRule" value="1000000000" exProperty="not include"/> </rules> </field> <field id="sku_quantity" name="库存" type="input"> <rules> <rule name="valueTypeRule" value="long"/> <rule name="requiredRule" value="true"/> <rule name="maxValueRule" value="2147483647" exProperty="not include"/> <rule name="regexRule" value="([1-9][0-9]{0,10}|[0-9])"/> </rules> </field> <field id="sku_outerId" name="商家编码" type="input"> <rules> <rule name="valueTypeRule" value="text"/> <rule name="maxLengthRule" value="64" exProperty="include" unit="byte"/> </rules> </field> <field id="sku_barcode" name="条形码" type="input"> <rules> <rule name="valueTypeRule" value="text"/> <rule name="tipRule" value="<a href='https://maowo.tmall.com/discussion.htm?id=45633&circleId=37' target='_blank'> 查看帮助 <a/>"/> <rule name="maxLengthRule" value="60" exProperty="include" unit="byte"/> </rules> </field> <field id="sku_scProductId" name="货品Id" type="input"> <rules> <rule name="valueTypeRule" value="text"/> </rules> </field> </fields> </field> |
文件太大，有删减，完整示例如附件get.xml：download: get.xml；
2）SKU拼接步骤
商品是非标，非达尔文，也就没有cspu，sku里面也不用填写这些cspu，衣服一般都有两个销售属性，颜色+尺码。同样sku也是complex-values。
销售属性自定义是需要拼接的。
颜色拼接
① 颜色分类，必选，单选，选择 28341 黑色；
② 别名，非必选，可以不写；
③ 属性图片，必选，写一个图片url；
④ 色系，非必选，多选的，注意值是?这种；
这样一个颜色的销售属性拼接完成，可以有多个颜色。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 | <field id="prop_extend_1627207" name="颜色分类扩展" type="multiComplex"> <complex-values> <field id="prop_1627207" type="singleCheck"> <value>28341</value> </field> <field id="prop_image" name="属性图片" type="input"> <value>https://img.alicdn.com/bao/uploaded/i1/88591187/TB2FsEIvH9YBuNjy0FgXXcxcXXa_!!88591187.jpg</value> </field> <field id="basecolor" type="multiCheck"> <values> <value>28341</value> </values> </field> <field id="alias_name" type="input"> <value>黑色</value> </field> </complex-values> |
尺码拼接
新版尺码操作可以从get到的rule查看，我们可以选择自定义尺码分组，截图来自web后台，我们可以选择已有的尺码模板，也可以自定义尺码表，比如只应用于当前的商品。
从图中可以看到，一个尺码，是有很多方面的，比如身高，体重，裤长等，这些构成了一个尺码。
① 尺码分组（std_size_group)可以选一个，也可以选择自定义，选择自定义后既可以自定义尺码扩展；
② 尺码扩展（std_size_extends_20509)开始拼接；
③ 尺码id （std_size_prop_20509_-1），size_mapping 可以选择体重和身高等，我们选择体重和身高两个来自定义，结果如下：
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 | <field id="std_size_group" name="尺码分组" type="singleCheck"> <value>-1:自定义:-1</value> </field> <field id="std_size_extends_20509" name="尺码扩展" type="multiComplex"> <complex-values> <field id="size_mapping_tizhong" type="input"> <value>50</value> </field> <field id="size_mapping_shengao" type="input"> <value>160</value> </field> <field id="std_size_prop_20509_-1" type="input"> <value>M</value> </field> </complex-values> <complex-values> <field id="size_mapping_tizhong" type="input"> <value>55</value> </field> <field id="size_mapping_shengao" type="input"> <value>170</value> </field> <field id="std_size_prop_20509_-1" type="input"> <value>L</value> </field> </complex-values> |
SKU拼接
sku拼接就是把所有的销售属性的个数做个乘法，比如颜色1个，尺码5个，那么就需要写1*5=5个sku，比如3个颜色，10个尺码，那么sku则需要写3*10=30个。
① sku带上颜色的分类；
② sku带上尺码；
③ sku带上价格+库存；
④ done；
注意：编辑商品的时候注意下不要把系统回带最外层的?回传，请把这个全部去掉。否则提交会清除sku。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 | <field id="prop_extend_1627207" name="颜色分类扩展" type="multiComplex"> <complex-values> <field id="prop_1627207" type="singleCheck"> <value>28341</value> </field> <field id="prop_image" name="属性图片" type="input"> <value>https://img.alicdn.com/bao/uploaded/i1/88591187/TB2FsEIvH9YBuNjy0FgXXcxcXXa_!!88591187.jpg</value> </field> <field id="basecolor" type="multiCheck"> <values> <value>28341</value> </values> </field> <field id="alias_name" type="input"> <value>黑色</value> </field> </complex-values> </field> <field id="std_size_group" name="尺码分组" type="singleCheck"> <value>-1:自定义:-1</value> </field> <field id="std_size_extends_20509" name="尺码扩展" type="multiComplex"> <complex-values> <field id="size_mapping_tizhong" type="input"> <value>50</value> </field> <field id="size_mapping_shengao" type="input"> <value>160</value> </field> <field id="std_size_prop_20509_-1" type="input"> <value>M</value> </field> </complex-values> <complex-values> <field id="size_mapping_tizhong" type="input"> <value>55</value> </field> <field id="size_mapping_shengao" type="input"> <value>170</value> </field> <field id="std_size_prop_20509_-1" type="input"> <value>L</value> </field> </complex-values> <complex-values> <field id="size_mapping_tizhong" type="input"> <value>65</value> </field> <field id="size_mapping_shengao" type="input"> <value>175</value> </field> <field id="std_size_prop_20509_-1" type="input"> <value>XL</value> </field> </complex-values> <complex-values> <field id="size_mapping_tizhong" type="input"> <value>55</value> </field> <field id="size_mapping_shengao" type="input"> <value>170</value> </field> <field id="std_size_prop_20509_-1" type="input"> <value>2XL</value> </field> </complex-values> <complex-values> <field id="size_mapping_tizhong" type="input"> <value>55</value> </field> <field id="size_mapping_shengao" type="input"> <value>170</value> </field> <field id="std_size_prop_20509_-1" type="input"> <value>3XL</value> </field> </complex-values> </field> <field id="size_mapping_template_id" name="尺码表填充模板ID" type="input"> <value/> </field> <field id="sku" name="SKU" type="multiComplex"> <complex-values> <field id="sku_quantity" type="input"> <value>11</value> </field> <field id="sku_price" type="input"> <value>426.14</value> </field> <field id="prop_1627207" type="singleCheck"> <value>28341</value> </field> <field id="sku_outerId" type="input"> <value>YDL18Q3858</value> </field> <field id="std_size_prop_20509_-1" type="input"> <value>M</value> </field> </complex-values> <complex-values> <field id="sku_quantity" type="input"> <value>11</value> </field> <field id="sku_price" type="input"> <value>426.14</value> </field> <field id="prop_1627207" type="singleCheck"> <value>28341</value> </field> <field id="sku_outerId" type="input"> <value>YDL18Q3858</value> </field> <field id="std_size_prop_20509_-1" type="input"> <value>L</value> </field> </complex-values> <complex-values> <field id="sku_quantity" type="input"> <value>11</value> </field> <field id="sku_price" type="input"> <value>426.14</value> </field> <field id="prop_1627207" type="singleCheck"> <value>28341</value> </field> <field id="sku_outerId" type="input"> <value>YDL18Q3858</value> </field> <field id="std_size_prop_20509_-1" type="input"> <value>XL</value> </field> </complex-values> <complex-values> <field id="sku_quantity" type="input"> <value>11</value> </field> <field id="sku_price" type="input"> <value>426.14</value> </field> <field id="prop_1627207" type="singleCheck"> <value>28341</value> </field> <field id="sku_outerId" type="input"> <value>YDL18Q3858</value> </field> <field id="std_size_prop_20509_-1" type="input"> <value>2XL</value> </field> </complex-values> <complex-values> <field id="sku_quantity" type="input"> <value>11</value> </field> <field id="sku_price" type="input"> <value>426.14</value> </field> <field id="prop_1627207" type="singleCheck"> <value>28341</value> </field> <field id="sku_outerId" type="input"> <value>YDL18Q3858</value> </field> <field id="std_size_prop_20509_-1" type="input"> <value>3XL</value> </field> </complex-values> </field> |
