文档中心 > 基础技术

基础技术

新版schema重点改造项目

更新时间：2024/05/09 访问次数：21328

尊敬开发者:

您好！

为了提升消费者在平台购物体验，平台将对图文编辑器、发货合约、食品类目、颜色发布、分类销售属性 、尺码及尺码表进行升级改造，请各位开发者在8月30日前完成升级。

一、图文编辑器改造

1.1 改造说明

此次图文编辑器升级，目的是接入新版图文编辑器。新版图文编辑器，不再区分电脑端和手机端，只需装修一份图文，分别在电脑端和手机端展示。通过旺铺编辑器装修的简单模块，支持ISV编辑；复杂模块，支持ISV删除和调整顺序。后续官方和三方平台新发商品，都默认使用该编辑器。对于存量商品，后续官方会逐步迁移到新版。迁移完成后将只有新版图文编辑器，在此之前旧版编辑器仍需保留。

1.2 适用群体

此次改造涉及淘宝市场。

1.3 涉及接口

（1）商品发布查询schema：alibaba.item.publish.schema.get；

（2）商品发布提交：alibaba.item.publish.submit；

（3）商品编辑查询schema：alibaba.item.edit.schema.get；

（4）商品编辑提交：alibaba.item.edit.submit；

（5）商品快速编辑提交：alibaba.item.edit.fastupdate；

1.4 改造内容

升级前

升级后

图文编辑器分为电脑端和手机端，分别通过desc和wirelessDesc字段支持，旺铺编辑器编辑过的商品的图文不支持ISV查询和编辑。内容格式如下。

只装修一份图文，分别在电脑端和手机端展示。废弃原desc字段，保留并升级wirelessDesc字段。内容格式如下。

desc

wirelessDesc

desc

wirelessDesc

废弃

1.5 流程说明

1.5.1 新发商品

1.5.2 编辑商品

1.6 字段说明

?wirelessDesc (2).txt


字段名称

字段说明

version

图文编辑器版本号。

通过版本号值识别是否是新版图文编辑器。新版版本号为1.0.0。

image_hot_area

图片热区模块。

支持图片以及在图片上添加热区、自定义跳转链接。

unsupported

暂不支持ISV编辑的模块。


二、发货合约

为了提升消费者在平台购物时的物流体验，平台将规范淘宝商家发货时间的设置，淘宝商家在发布商品时需要设置发货时间，淘宝开放平台的商品发布、编辑接口将做以下升级（接口已完成升级）。

2.1适用群体

此次改造主要涉及淘宝市场（天猫市场保留原有逻辑）。

2.2 改造涉及接口

以下接口将新增发货合约字段

（1）商品发布：alibaba.item.publish.submit；

（2）商品编辑提交schema信息：alibaba.item.edit.submit；

（3）获取商品发布规则信息：alibaba.item.publish.schema.get；

（4）商品编辑获取schema信息：alibaba.item.edit.schema.get；

发货合约字段定义如下

字段名

字段类型

是否必填

字段描述

重要说明

deliveryTimeType

Number

是

发货时间类型，可选范围

0：48小时内发货

2：全款预售

3：24小时发货

无

tbDeliveryTime

Number

否

全款预售时间，根据类目输出不同选项。

示例：女装连衣裙类目，可选范围是：3,5,7,10,15,20,30,45，如选5，则表示该商品为全款预售、且承诺付款后5天内发货。

1.deliveryTimeType选2【全款预售】时，该值必填；

2.deliveryTimeType选0或3时【非全款预售】，该值可选，传值不生效。

deliveryTimeSetBySku

Number

否

按宝贝规格设置发货时间：

0：商品级设置(默认值为0)

1：按SKU设置

1.deliveryTimeType选2【全款预售】时，该值可选，默认值为0；

2.deliveryTimeType选0或3时【非全款预售】，该值可选，传值不生效。

skuDeliveryTime

Number

否

按照宝贝规格自定义发货时间，根据类目输出不同选项，同时SKU维度额外支持按24小时、48小时设置；

示例：女装连衣裙类目，可选范围是：1,2,3,5,7,10,15,20,30,45。比如选2，则表示该商品为全款预售、且该SKU承诺付款后48小时内发货。

1.deliveryTimeType选2【全款预售】、且deliveryTimeSetBySku选1时，则表示按SKU维度设置发货时间，商品级tbDeliveryTime不再生效；

2.deliveryTimeType选0或3时【非全款预售】，该值可选，传值不生效。

3.deliveryTimeSetBySku选0时，该值可选，传值不生效。

三、食品类目改造

3.1 适用群体

此次改造涉及天猫/淘宝市场。

涉及的类目：食品相关类目。

3.2 改造涉及接口

以下接口将新增食品改造相关字段

天猫/淘宝接口：

（1）商品发布：alibaba.item.publish.submit；

（2）商品编辑提交schema信息：alibaba.item.edit.submit；

（3）获取商品发布规则信息：alibaba.item.publish.schema.get；

（4）商品编辑获取schema信息：alibaba.item.edit.schema.get；

食品相关字段定义如下


字段名

字段类型

是否必填

字段描述

父组件字段ID：food_images

子组件字段ID映射：

1.营养成分图片->item_image_0；

2.外包装信息图片->item_image_1；

3.条形码图片->item_image_2；

可在schema规则获取

新增组件

1.营养成分图片

2.外包装信息图片

3.条形码图片

图片示例：

父组件字段ID：food_security.food_nutrition_table

子组件字段ID映射：

1.声明->multiple；

2.计量单位->

  a）单位->unit；

  b）每份单位->partUnit；

  c）每份含量->partAmount；

3.营养成分项->p-xxxxxxxx；

新增组件

1.声明：营养成分表-本商品含有多种口味或包装，本营养成分表为其中一个 （singleCheck）


  a）选项：是/否；


2.计量单位：营养成分表-计量单位 （singleCheck）


  a）unit：每100毫升/每100克/每份；

  b）当选择 每100毫升或每100克时，不需要填写 “每份含量”（partAmount）和“每份计量单位”（partUnit）；

  c）当选择每份时，“每份含量”（partAmount）和“每份计量单位”（partUnit）为必填；


3.营养成分项：拆分为N个成分项：


  a）其中 五大营养成分项为必填（如下）：

    ①营养成分表-能量(kJ)；

    ②营养成分表-蛋白质(g)；

    ③营养成分表-脂肪(g)；

    ④营养成分表-碳水化合物(g)；

    ⑤营养成分表-钠(mg)；

  b）rules中小数点位数，必填要求；

有机食品：food_security.organic_food；

有机证书编号

food_security.organic_certification；

新增组件

1.有机食品（是否为有机食品）

  a）默认值为否；

2.有机证书编号

  a）选择有机食品为是时，有机证书编号为必填；

绿色食品：food_security.is_green_food；

绿色食品等级：food_security.green_food_level；

绿色产品编号：food_security.green_food_produce_number；

新增组件

1.绿色食品（是否为有机食品）

  a）默认值为否；

2.绿色食品等级

  a）选择绿色食品为是时，绿色食品等级为必填；

3.绿色产品编号

  a）选择绿色食品为是时，绿色产品编号为必填；

四、颜色发布接口调整改造

为了解决之前颜色分类别名+基础色情况繁多，导致商家填写和理解成本高的情况，我们对颜色分类的schema协议进行了一点优化升级。

4.1 适用群体

此次改造涉及天猫/淘宝市场。

4.2 改造涉及接口

天猫/淘宝接口

（1）商品发布：alibaba.item.publish.submit；

（2）商品编辑提交schema信息：alibaba.item.edit.submit；

（3）获取商品发布规则信息：alibaba.item.publish.schema.get；

（4）商品编辑获取schema信息：alibaba.item.edit.schema.get；

4.3 改造内容

改造前

改造后

颜色分类通过alias_name别名字段来传达可输入信息。

如果当前颜色分类支持可输入则新增in_prop_1627207，商家可以把自定义的颜色属性值写入到in_prop_1627207中。新版颜色不再有basecolor和alias_name field。

4.4 补充信息


改造前

改造后

基础色

属性别名

新版颜色分类(枚举+可输入)--新上线

  • 主要是支持颜色自定义情况，增加了input类型节点，去掉老版颜色别名的field。属性图片和备注填写规则和老板颜色保持一致。
  • 后期会组件用新版颜色分类替代属性别名和基础色情况。

五、自选销售属性改造

为提升销售属性填写的规范率及平台对商品的识别准确率，平台将上线自选销售属性功能，对部分类目的销售属性内容进行结构化采集，请服务商充分了解功能的影响，并根据商品发布需求进行必要性改造。具体的调整情况如下。

5.1 适用群体

此次改造涉及天猫/淘宝市场。

5.2 改造涉及接口

天猫/淘宝接口

（1）商品发布：alibaba.item.publish.submit；

（2）商品编辑提交schema信息：alibaba.item.edit.submit；

（3）获取商品发布规则信息：alibaba.item.publish.schema.get；

（4）商品编辑获取schema信息：alibaba.item.edit.schema.get；

天猫产品发布接口

（1）tmall.product.add.schema.get；

（2）tmall.product.schema.add；

天猫产品编辑接口

（1）tmall.product.update.schema.get；

（2）tmall.product.schema.update；

5.3 改造内容

天猫


改造前

改造后

调整内容说明

以属性“款式”举例，top不支持自选销售属性之前该属性不会在sku中展示

1.sku属性数据结构变化

自选销售属性在sku中透出

多个自选属性会在sku中完整排列但是不会做必填校验。

若需要修改属性值，在sku中同步进行修改。（举例：“款式1” 修改成 “款式2”）：

删除已经存在的自选销售属性

删除sku中的自选属性值即可

举例说明，款式属性值删除即可


淘宝

改造前

改造后

调整内容说明

自选销售属性不会在销售属性中透出

1.销售属性结构新增了自选销售属性

2.sku中会展示自选销售属性

多个自选属性会在销售属性和sku中完整排列。

若需要修改属性值，需要在sku和销售属性中同步进行修改。（举例：容量 修改成 “2.1L”）：

删除已经存在的自选销售属性

删除sku中的自选属性值和销售属性值即可

举例说明，“容量”属性值删除即可

六、 新版尺码、尺码表改造

找不到尺码成为消费者服饰行业购物核心痛点；通过尺码升级让消费者可更高效地定位标准尺码信息、快速地找到所需商品，提升消费者导购体验；商家可以通过标准化尺码描述，补充尺码参数信息（如L码对应身高/体重/肩宽/胸围/腰围等信息），增加商品曝光机会以及降低退款。

6.1 使用群体

此次改造涉及天猫/淘宝市场。

6.2 改造涉及接口

天猫/淘宝接口

（1）商品发布：alibaba.item.publish.submit；

（2）商品编辑提交schema信息：alibaba.item.edit.submit；

（3）获取商品发布规则信息：alibaba.item.publish.schema.get；

（4）商品编辑获取schema信息：alibaba.item.edit.schema.get；

6.3 改造内容


改造前

改造后

调整内容说明

1、尺码属性跟普通属性透出格式保持一致。比如：

1、新版尺码支持尺码分组和尺码表，并且两个都需要商家填写。

1）在sku field中会透出所有尺码分组下尺码值填写规范：


2）透出当前类目下所有的尺码分组列表，以及当前选中的分组。


3）尺码表扩展

尺码表中所有的字段信息，以及每个字段的规则(是否必填、区间等)

尺码值是挂在分组下的，所有分组信息必须要填写。并且在sku、std_size_group(尺码分组)、

std_size_group(尺码扩展)中，分组信息填写的需要保持一致。

七、支持电子凭证

1. 改造说明

新增电子凭证支持Schema能力，商家在发布、编辑商品时，可以通过接口调用方式，来构建电子凭证相关参数。

2. 适用群体

此次改造适用于千千惠生活、维京团购大连企业店、联联周边游商城三家店铺下，购物提货券(50026555) >> 代金券/提货券(50170003)商品的发布、编辑流程中。

3. 涉及接口

（1）商品发布：alibaba.item.publish.submit；

（2）商品编辑提交schema信息：alibaba.item.edit.submit；

（3）获取商品发布规则信息：alibaba.item.publish.schema.get；

（4）商品编辑获取schema信息：alibaba.item.edit.schema.get；

4. 字段说明

a. 整体结构

  • multiComplexetc
    • complexexpireDate
      • inputexpireDateType
      • inputstartEndDate
      • inputendDate
      • inputvalidDays
    • complexattributeSetting
      • inputwriteoff
      • inputrefundValue
      • inputfullRefundValue
    • inputselectedPackageId
    • inputselectedStoreId

b. 填写说明

字段名

字段类型

字段描述

是否必填

etc

multiComplex

电子交易凭证根模块

无需填写

expireDate

complex

设置有效期

无需填写

expireDateType

input

过期时间类型

必填

startEndDate

input

填写起止日期

expireDateType值为1时填写

endDate

input

失效日期

expireDateType值为2时填写

validDays

input

有效天数

expireDateType值为3时填写

attributeSetting

complex

属性设置

无需填写

writeoff

input

是否支持核销打款

当前类目默认支持，不可修改

refundValue

input

过期退款比例

若支持过期退款, 请填写过期退款比例(%); 不支持请勿填写。

fullRefundValue

input

售中自动退款比例

若支持售中自动退款, 请填写售中退款比例(%); 不支持请勿填写。

selectedPackageId

input

选择的核销库id

必填

selectedStoreId

input

选择的门店库id

当前核销库未绑定门店库时，会透出模块，需要填写;

c. 填写说明

<field id="tbExtractWay" name="提取方式" type="complex">
  <complex-value>
    <field id="template" name="运费模板" type="input"/>
    <field id="etc" name="电子交易凭证" type="multiComplex">
      <complex-values>
        <field id="attributeSetting" name="属性设置" type="complex">
          <complex-value>
            <field id="writeoff" name="是否支持核销打款" type="input">
              <value>1</value>
            </field>
            <field id="refundValue" name="过期退款比例" type="input">
              <value>50</value>
            </field>
            <field id="fullRefundValue" name="售中自动退款比例" type="input">
              <value>50</value>
            </field>
          </complex-value>
        </field>
        <field id="selectedStoreId" name="选择的门店库id" type="input">
          <value>14222820</value>
        </field>
        <field id="expireDate" name="设置有效期" type="complex">
          <complex-value>
            <field id="endDate" name="失效日期" type="input"/>
            <field id="expireDateType" name="过期时间类型" type="input">
              <value>1</value>
            </field>
            <field id="startEndDate" name="起止日期" type="input">
              <value>2023-11-23|2023-11-26</value>
            </field>
            <field id="validDays" name="有效天数" type="input"/>
          </complex-value>
        </field>
        <field id="selectedPackageId" name="选择的核销库id" type="input">
          <value>29725251</value>
        </field>
      </complex-values>
    </field>
  </complex-value>
  <fields>
    <field id="template" name="运费模板" type="input"/>
    <field id="etc" name="电子交易凭证" type="multiComplex">
      <fields>
        <field id="expireDate" name="设置有效期" type="complex">
          <fields>
            <field id="expireDateType" name="过期时间类型" type="input"/>
            <field id="startEndDate" name="起止日期" type="input"/>
            <field id="endDate" name="失效日期" type="input"/>
            <field id="validDays" name="有效天数" type="input"/>
          </fields>
        </field>
        <field id="attributeSetting" name="属性设置" type="complex">
          <fields>
            <field id="writeoff" name="是否支持核销打款" type="input"/>
            <field id="refundValue" name="过期退款比例" type="input"/>
            <field id="fullRefundValue" name="售中自动退款比例" type="input"/>
          </fields>
        </field>
        <field id="selectedPackageId" name="选择的核销库id" type="input"/>
      </fields>
    </field>
  </fields>
</field>


FAQ

关于此文档暂时还没有FAQ
有用(0) 我要提问
文档标签:
schema
返回
顶部
阿里巴巴集团 | 淘宝网 | 天猫 | 聚划算 | 全球速卖通 | 阿里巴巴国际交易市场 | 1688 | 阿里妈妈 | 阿里旅行·去啊 | 阿里云计算 | YunOS | 阿里通信 | 万网 | 高德 | 优视 | 友盟 | 酷盘 | 虾米 | 天天动听 | 来往 | 钉钉 | 11Main | 支付宝
关于淘宝 合作伙伴 营销中心 联系客服 开放平台 诚征英才 联系我们 网站地图 法律声明 © 2016 Taobao.com 版权所有
网络文化经营许可证：文网文[2010]040号 | 增值电信业务经营许可证：浙B2-20080224-1 | 信息网络传播视听节目许可证：1109364号