达尔文商品管理

什么是达尔文

     达尔文是一套全新的商品管理体系，它不同于淘宝原来的分类法（基于类目属性体系）的管理思路，而是以最细粒度的产品节点（CSPU）为核心，使用系统+运营机制的方式维护一套丰富、准确的产品库，通过产品实现聚合、管控商品，以确保商品信息的确定性。 （概括：商品标准化）

为什么要实行达尔文

    在实行达尔文体系之前，天猫商品管理存在以下问题：

    1. 最细粒度产品模型的缺失； 

    2. 存在大量重复SPU，SPU信息不准确；

以Apple iPhone 4为例，产品库中存在大量重复的SPU。

同时，也容易出现SPU信息不准确的问题。

    3. SKU信息混乱，且缺乏有效监管的途径。

达尔文做了哪些事情解决问题

    为了解决现有的商品管理的问题，达尔文提供了以下方案解决问题。

    1. 增加最细粒度的产品模型 —— CSPU；

    2. 通过天猫、商家、品牌商多方参与共建一个准确有效的天猫产品库；

    3. 通过品牌归一、型号归一等解决现存的重复SPU的问题。

达尔文与原有体系的变化

新的管理模型

    达尔文提出了新的商品管理模型。

    新的商品管理体系增加了CSPU维度，SPU将与Item一一映射，而CSPU将与SKU一一映射；

新的入库机制

    达尔文改变了原有的产品入库流程，主要变化有：

    1. 增加产品审核流程，商家发布的新产品将需要通过小二审核之后才能够用于商品发布； 

    2. 提供用户纠错与举报机制，以维护SPU数据的准确性。

组合商品机制

    为了解决套装商品的确定性，提供了组合商品机制。

达尔文的进展

    2012年以手机、厨电和美妆三个类目作为首期试点，以品牌为维度，对商品发布体系进行升级；目前已参与类目推：厨房用具类目；运动鞋类目；大家电类目；美发护发类目；数码相机类目；尿片类目；奶粉类目；美容护肤类目；厨房电器类目；手机类目；

    更多信息请见：http://zhaoshang.mall.taobao.com/portalmessage/vane.htm?spm=3.2221445.0.0.FLkGRu&chn=evo

开放平台如何适应达尔文？

    目前开放平台API已经能够支持对达尔文体系商品进行发布与挂靠操作。

发布流程

挂靠流程 

达尔文商品发布

涉及API

    商品管理整体流程中主要涉及的API列表：

序号	API名称	说明
1	taobao.user.bseller.get	查询商家信息
2	taobao.itemcats.authorize.get	查询天猫授权商家的类目和品牌
3	taobao.itemcats.get	查询商品后台类目
4	taobao.itemprops.get	查询商品类目属性
5	tmall.brandcat.control.get	查询天猫管控的品牌与类目
6	tmall.brandcat.salepro.get	查询天猫管控的销售属性
7	tmall.brandcat.suiteconf.get	查询天猫授权可发布套装的类目及套装的配置要求
8	tmall.product.template.get	查询产品模板
9	taobao.products.search	产品搜索
10	taobao.product.get	查询单个产品信息
11	taobao.product.add	发布产品
12	tmall.product.specs.get	查询产品下所有规格
13	tmall.product.spec.add	上传规格
14	tmall.product.spec.pic.upload	上传规格资质图片
15	tmall.product.specs.ticket.get	查询规格审核状态
16	taobao.item.add	发布商品

1. 判断商家类型 

    调用taobao.user.bseller.get接口在field中入参type查询商家类型，如果type返回为B,则说明该卖家为天猫商家。

2. 类目属性初始化

    a. 获取商家可发布商品的品牌和类目

    由于天猫商家发布的品牌和类目需要天猫授权才能发布，因此，需要先查询当前商家获得天猫授权可发布的品牌与类目，通过调用接口taobao.itemcats.authorize.get可以获取商家可发布的品牌和一级类目。

    b. 获取叶子类目和类目属性    

    发布商品时选择的类目必须为叶子类目，在获取到天猫商家授权的一级类目之后，调用taobao.itemcats.get接口轮循可获取叶子类目，通过返回值中的is_parent=false可以判断类目为叶子类目。

    调用taobao.itemprops.get接口入参叶子类目id，获取发布当前叶子类目下商品需要的所有类目属性及属性值列表。需要关注一点，入口参数中必须入参type=2保证获取的类目属性为天猫市场所需要的。

    由于在下文发布产品时涉及到对不同类型的类目属性在传入参数时的不同处理，针对taobao.itemprops.get的几个重要返回值单独解释一下：

序号	属性	说明
1	is_key_prop	是否关键属性。能够确认唯一"产品"的属性，可以是一个，或者多个关键属性的组合
2	is_sale_prop	是否销售属性。组成SKU\CSPU的特殊属性，它会影响买家的购买和卖家的库存管理，如服装的”颜色"、"套餐"和"尺码"
3	is_color_prop	是否颜色属性。
4	is_enum_prop	是否是可枚举属性。类目属性的值是否为枚举值
5	must	发布产品或商品时是否为必选属性。
6	multi	发布产品或商品时是否可以多选。
7	status	状态。可选值:normal(正常),deleted(删除)
8	child_template	子属性的模板（卖家自行输入属性时需要用到）
9	is_allow_alias	是否允许别名。可选值：true（是），false（否）
10	is_input_prop	在is_enum_prop是true的前提下，是否是卖家可以自行输入的属性（注：如果is_enum_prop返回false，该参数统一返回false）。可选值:true(是),false(否)。对于品牌和型号属性（包括子属性）：如果用户是C卖家，则可自定义属性；如果是B卖家，则不可自定义属性，而必须要授权的属性。

    c. 获取商家切入达尔文商品体系的授权类目、品牌列表以及对应类目下的受管控的销售属性。

    达尔文商品体系是按照类目和品牌的交集进行切换的，可以通过调用tmall.brandcat.control.get接口可以查询到当前商家授权的品牌和类目中有哪些已经切换到达尔文商品体系，接口返回的类目为叶子类目。该接口还返回一个重要信息certified_data，即发布规格时，需要提交小二审核的资质图片要求列表。

    达尔文商品体系对于销售属性也做管控，以期解决SKU信息混乱的问题，但是需要关注的是，部分类目存在多个销售属性的情况时，达尔文管控可能不覆盖所有销售属性，这类不在达尔文管控下的销售属性也被称之为营销属性。通过tmall.brandcat.salepro.get接口可以获取到这些受管控的销售属性信息。

3. 产品检索

    天猫商品发布必须依托于一个已有的产品，因此，在发布商品前，需要检索当前商品是否已存在一个有效的产品，TOP提供产品检索接口taobao.products.search进行检索，在调用此接口时，需要特别注意几点：

    a. 必须入参market_id=2，用于查询天猫市场内的产品

    b. field中入参cspu_feature查询当前产品状态，cspu_feature为空时说明当前产品不为达尔文体系内的新产品

    c. 如果通过cid+关键属性的方式搜索，需要注意，关键属性中枚举属性入参于props中，而关键参数中的商家自行输入的属性入参到customer_props中，以篮球鞋类目new balance MRL996AG为例，关键属性为品牌和型号，品牌为可枚举属性，而型号为商家自行输入的属性，所以在检查时，cid参数入参篮球鞋的类目id(cid=50012031)，props参数中传入篮球鞋品牌的品牌属性id和属性值id，以key:value的方式传入(props=20000:20584)，而customer_props中则传入型号的属性id和商家自行输入的属性值，同样以key:value的方式传入(customer_props=13021751:MRL996AG)p。

    通过检索接口如果能够查询不到天猫体系的达尔文产品，则需要全新发布一个产品。如果能够检索到产品，则需要调用规格列表查询接口去查询规格，产品和规格均存在有效的即可发布商品。

4. 产品发布

    达尔文产品发布与普通的天猫产品发布方式一致，调用taobao.product.add根据类目属性组织参数发布即可。props中只传入关键属性中的枚举属性值k:v；customer_props传入所有属性值为商家自行输入的属性k:v；bind_props传入非关键属性中的枚举属性值k:v。

    对于无关键属性的类目，必须传入产品模板ID，通过tmall.product.template.get可以获取；

    对于套装产品的发布，需要传入is_pub_suite为true，suite_items_str传入需要组成套装的产品规格及数量；通过tmall.brandcat.suiteconf.get接口可以查询哪些类目支持发布发布套装，并且对组成套装的产品规格的数量要求。通过tmall.product.specs.get接口可以查询组成套装的产品规格。

5. 规格查询与发布

    达尔文商品体系中，一个产品必须由产品和规格组成。当调用taobao.product.add发布产品后，即可调用tmall.product.spec.add接口发布规格。

    发布规格时，需要注意几点：

    a. 规格资质图片参数certified_pic_str调用tmall.product.spec.pic.upload上传可以获取到资质图片链接。当前类目的产品规格需要哪些资质图片，通过tmall.brandcat.control.get可以获取资质图片要求列表及对应编号。

    b. 规格属性spec_props中入参的属性只能为tmall.brandcat.salepro.get接口中受管控的销售属性。

    c. 对于无管控销售属性的类目，也需要上传一个没有规格属性的spec。

    调用tmall.product.spects.get接口可以查询当前天猫达尔文产品下的所有规格，status为1时，说明该规格可用于商品发布，为3时需要等待小二审核，不同类目的审核时间由各类目规则把控；

    发布新的规格之后，由于需要等待小二审核，通过tmall.product.specs.ticket.get接口可以查询当前规格对应的审核状态，如果审核不通过，则会返回拒绝理由。

6. 发布商品  

    调用taobao.item.add发布商品，需要保证商品对应的产品有效且SKU对应的规格为审核通过的。

    tips：

    sku与规格的匹配建议可以通过条形码来匹配，特别是对于运动鞋类目。

达尔文商品挂靠 

涉及API

序号	API名称	说明
1	taobao.products.search	产品搜索
2	taobao.product.get	查询单个产品信息
3	taobao.product.add	发布产品
4	tmall.product.specs.get	查询产品下所有规格
5	tmall.product.spec.add	上传规格
6	tmall.product.spec.pic.upload	上传规格资质图片
7	tmall.product.specs.ticket.get	查询规格审核状态
8	taobao.items.onsale.get	查询在售商品
9	taobao.items.inventory.get	查询库存中的商品
10	taobao.item.cspu.move	达尔文商品挂接

1. 查询需要挂靠的达尔文体系商品 

    达尔文商品体系不段的推进中，会出现部分类目历史商品未关联到达尔文商品体系下，通过taobao.items.onsale.get和taobao.items.inventory.get接口入参is_cspu=false可以查询在售商品和库存中的商品的未挂靠列表。

2. 挂靠达尔文商品体系

    调用taobao.item.cspu.move接口可以将商品挂靠到达尔文商品体系中。