一、商品新发案例说明

---

背景：小A是一个商家的技术人员，自家商品特别多，需要开发一个商品的管理系统，负责商品的上新，更新，价格更新，上下架等工作，查看淘宝开放平台这些API，发现都能满足，就开始了酷（苦）毙（B）的开发历程。

获取类目

• 类目获取 taobao.itemcats.get
• 授权类目品牌获取 taobao.itemcats.authorize.get

发布商品kindle paperwhite 3（标类达尔文商品）

类目：电子词典/电纸书/文化用品>>电子阅览器/电纸书

1 产品匹配规则获取

涉及API：tmall.product.match.schema.get

参考示例：//open.taobao.com/api.htm?source=search&docId=23258&docType=2

入参：category_id = 50010731；

出参：规则xml

2 产品匹配

涉及API：tmall.product.schema.match

参考示例：//open.taobao.com/api.htm?source=search&docId=23259&docType=2

入参：category_id = 50010731；propvalues = xml_data（示例XML如下）

<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

参考示例：//open.taobao.com/api.htm?docId=23257&docType=2

入参：category_id = 50010731 ； brand_id = 13525264

出参：规则xml

4产品发布,根据规则组装xml

涉及API： tmall.product.schema.add

参考示例：//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

参考示例：//open.taobao.com/api.htm?docId=23256&docType=2

入参：category_id = 50010731 ；product_id = 337259102

出参：
download: item.get.xml

6 商品发布

涉及API： tmall.item.schema.add

参考示例： //open.taobao.com/api.htm?docId=23255&docType=2

入参：category_id = 50010731 ；product_id = 337259102; xml_data （示例xml如下）

download: item.add.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。

发布商品羽绒服

类目：女装/女士精品>>裤子>>棉裤/羽绒裤

对于没有关键属性的类目，不需要发布产品，直接发布商品

1 商品发布规则获取

涉及API： tmall.item.add.schema.get

参考示例：//open.taobao.com/api.htm?docId=23256&docType=2

入参：category_id = 50026651 ；product_id = 0 （因为不需要产品，直接写0）

出参：

download: get.xml

2 商品发布

涉及API： tmall.item.schema.add

参考示例： //open.taobao.com/api.htm?docId=23255&docType=2

入参：category_id = 50026651 ；product_id = 0 ； xml_data （示例xml如下）

download: add.xml

出参：商品id

注意1：发布规则获取（tmall.item.add.schema.get）得到的default-value 值，需要把default去掉，改成value，加到入参中，default-value 服务端是不认的。

如：get到的商品状态rule值

提交的商品张图rule值

恭喜！你终于成功发布了一个非标商品！

注意2：xml_data 根据上一步获得的的xml出参xml拼接，对于里面必填的rule需要全部填写，对于sku等参数也需要填写ok。

二、商品编辑

---

商品编辑更新

更新分类

• 全量更新（除局部更新外的均需要走全量更新）
• 局部更新（局部更新API）

增量更新API

• 商品和sku价格编辑 建议使用 tmall.item.price.update
• 商品库存同步 taobao.item.quantity.update/taobao.skus.quantity.update
• 商品标题等信息增量更新 （支持元素如下）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商品图片)

增量更新过程

• 增量更新规则获取 tmall.item.increment.update.schema.get（注意：这里也是一个xml，如果只修改标题，则xml中update_fields的value就只设置title；如果需要更新多个，则设置多个value）
• 根据规则拼接xml
• 调用增量更新接口 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视频和图片，则可以只上传3：4视频或图片来更新，其他情况下需要同时传3：4视频和图片。

增量编辑还是很方便的，可以减少全量的多问题，只更改某些字段

1 价格编辑

涉及API：tmall.item.price.update

参考示例：//open.taobao.com/api.htm?docId=24249&docType=2

2 库存编辑

涉及API：
taobao.item.quantity.update
taobao.skus.quantity.update

参考示例：
//open.taobao.com/api.htm?docId=10591&docType=2
//open.taobao.com/api.htm?docId=21169&docType=2

注意：如果商品关联了后端货品，那么库存不能使用这两个接口，需要使用库存的接口 taobao.inventory.adjust.trade

3 商品标题等信息增量更新

3.1 商品增量更新规则获取

涉及API： tmall.item.increment.update.schema.get

参考示例：//open.taobao.com/api.htm?docId=23781&docType=2

入参：item_id=xxxx; xml_data (可选，这里可以单独需要更新字段的规则，不填则获取全部)

出参：
download: get.xml

3.2 商品增量更新

涉及API： tmall.item.schema.increment.update

参考示例：//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

参考示例：//open.taobao.com/api.htm?docId=23435&docType=2

三、销售属性自定义案例

名词解释

销售属性

组成SKU的特殊属性，它会影响买家的购买和卖家的库存管理，如服装的"颜色"、"套餐"和"尺码"。当颜色在特定类目下是销售属性时，卖家发布宝贝的时候上传了颜色图片,则颜色属性值直接显示图片.否则显示属性值别名或属性值名

SPU

spu=standard product unit 标准化产品单元；spu相当于一个产品，可详见产品定义。

CSPU

CSPU=SPU+销售属性

###

SKU

sku=stock keeping uint(库存量单位)，为保存库存控制的最小可用单位，例如一件T恤中一个SKU通常由颜色、尺码组成，如下图：

SKU=CSPU+价格+库存

达尔文SKU区分（标类）

如果一个商品是标类，那么他就有SPU，那么获取到的SKU规则是有CSPUID的
如果一个商品是非标类，那么他就没有SPU，获取到的规则就没有CSPUID

达尔文SKU field 字段id

非达尔文SKU field 字段id

达尔文SKU组装

iPhone X 商品发布获取规则示例：

<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>

SKU拼接步骤

从darwin_sku 的 multiComplex 可以看到，我们需要拼接一个complex-values

1. 因为是标类产品，需要带上 cspuId，可以从获取的规则里面取一个
2. 销售属性有套餐类型，可以自定义的，我们从中选官方标配
3. 苹果的销售属性-颜色已经合并到CSPU，可以直接使用，不要再单独写到SKu
4. 再加上SKU属性（价格+库存数量），一个sku就拼接完成了

注意：编辑商品的时候注意下不要把系统回带最外层的 回传，请把这个全部去掉。否则提交会清除sku。

拼接好的darwin_sku

<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>

非达尔文SKU

示例类目：女装/女士精品>>裤子>>棉裤/羽绒裤

棉裤/羽绒裤获取到的规则示例：

<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="新版尺码操作指南：&lt;a href=&quot;//maowo.tmall.com/discussion.htm?spm=a220z.1000884.0.0.5fHBzq&amp;amp;id=29041&quot; target=&quot;_blank&quot; data-spm-anchor-id=&quot;a220z.1000884.0.0&quot;&gt;点击查看&lt;/a&gt;"/>
          <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="新版尺码操作指南：&lt;a href=&quot;//maowo.tmall.com/discussion.htm?spm=a220z.1000884.0.0.5fHBzq&amp;amp;id=29041&quot; target=&quot;_blank&quot; data-spm-anchor-id=&quot;a220z.1000884.0.0&quot;&gt;点击查看&lt;/a&gt;"/>
          <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="&lt;a href='https://maowo.tmall.com/discussion.htm?id=45633&amp;circleId=37' target='_blank'&gt; 查看帮助 &lt;a/&gt;"/>
          <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

SKU拼接步骤

商品是非标，非达尔文，也就没有cspu，sku里面也不用填写这些cspu，衣服一般都有两个销售属性，颜色+尺码。同样sku也是complex-values

销售属性自定义是需要拼接的

颜色拼接

1 颜色分类，必选，单选，选择 28341 黑色
2 别名，非必选，可以不写
3 属性图片，必选，写一个图片url
4 色系，非必选，多选的，注意值是 这种

这样一个颜色的销售属性拼接完成，可以有多个颜色

<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后台，我们可以选择已有的尺码模板，也可以自定义尺码表，比如只应用于当前的商品

从图中可以看到，一个尺码，是有很多方面的，比如身高，体重，裤长等，这些构成了一个尺码。

1. 尺码分组（std_size_group)可以选一个，也可以选择自定义，选择自定义后既可以自定义尺码扩展
2. 尺码扩展（std_size_extends_20509)开始拼接
3. 尺码id （std_size_prop_20509_-1），size_mapping 可以选择体重和身高等，我们选择体重和身高两个来自定义，结果如下

<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个。

1. sku带上颜色的分类
2. sku带上尺码
3. sku带上价格+库存
4. done

注意：编辑商品的时候注意下不要把系统回带最外层的 回传，请把这个全部去掉。否则提交会清除sku。

<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>

FAQ

关于此文档暂时还没有FAQ