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

文档中心 > 基础技术

天猫商品发布编辑示例

更新时间:2019/03/08 访问次数:4334

一、商品新发案例说明


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

获取类目

发布商品kindle paperwhite 3(标类达尔文商品)

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

1 产品匹配规则获取

涉及APItmall.product.match.schema.get

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

入参:category_id = 50010731;

出参:规则xml

2 产品匹配

涉及APItmall.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

涉及APItmall.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 商品发布

涉及APItmall.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值

image.png | left | 747x308

提交的商品张图rule值

image.png | left | 747x94

注意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 商品发布

涉及APItmall.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值

image.png | left | 747x308

提交的商品张图rule值

image.png | left | 747x94

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

注意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通常由颜色、尺码组成,如下图:

image | left

SKU=CSPU+价格+库存

达尔文SKU区分(标类)

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

达尔文SKU field 字段id

image.png | left | 747x33

非达尔文SKU field 字段id

image.png | left | 747x30

达尔文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就拼接完成了

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

image.png | left | 747x312

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

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