文档中心 > 商家经营工具-开发指引

天猫商品发布编辑示例

更新时间:2024/07/31 访问次数:53918

一、商品新发案例说明


背景:小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如下)

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

出参:download: item.get.xml


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如下);

download: item.add.xml

出参:商品id;


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

如:get到的商品状态rule值。



提交的商品张图rule值。



注意2xml_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);

出参:download: get.xml


2)商品发布


涉及APItmall.item.schema.add

参考示例https://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值。



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

注意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:

taobao.item.quantity.update

taobao.skus.quantity.update

参考示例:

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 (可选,这里可以单独需要更新字段的规则,不填则获取全部);

出参:download: get.xml


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

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


3)CSPU

CSPU=SPU+销售属性


4)SKU

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 商品发布获取规则示例


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


<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)棉裤/羽绒裤获取到的规则示例


<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


2)SKU拼接步骤


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

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


颜色拼接


① 颜色分类,必选,单选,选择 28341 黑色;

② 别名,非必选,可以不写;

③ 属性图片,必选,写一个图片url;

④ 色系,非必选,多选的,注意值是?这种;

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


<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 可以选择体重和身高等,我们选择体重和身高两个来自定义,结果如下:


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


<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
返回
顶部