开发文档
商品业务
1.2.1 场景介绍
商家对接需要把erp中的商品资料同步到ReX平台，用于在手机淘宝端展示售卖；目前erp需要对接商品的字段较少，商品模块会详细说明需要的字段，其他商品信息通过极速发布工具来维护，大大减少了商家对商品数据的维护成本，提高接入效率；
商品同步范围可参考：选择ERP里最近1年内有动销及最近3个月新增、状态正常的商品传到ReX平台.
1.2.2 商品新增
1.2.2.1 业务流程
1.2.2.2 接口说明
（1）商品新增
为了将erp中的商品资料同步到ReX平台，需要erp对接商品新增接口（alibaba.wdk.sku.add），必要字段列表如下（其他商品字段通过工作台极速发布工具配置，如需其他字段通过接口传输，需要与ReX平台项目PM沟通确认后进行添加）：
| 商品字段 |
字段描述 |
说明 |
新增必须 |
修改必须 |
| merchant_cat_code |
商家类目编码 |
读取ERP值 |
是 |
|
| sku_code |
商品编码 |
读取ERP值 |
是 |
是 |
| item_type_new |
商品类型 |
1:普通商品、2:加工半成品、3:加工成品、4:原材料、5:耗材； |
是 |
|
| sku_name |
商家商品名称 |
读取ERP值 |
是 |
|
| inventory_unit |
库存单位 |
读取ERP值，最小售卖单位 |
是 |
|
| sale_unit |
售卖单位 |
如果库存单位是kg，则售卖单位传g 库存单位非kg，和库存单位一致 |
是 |
|
| barcodes |
条码 |
读erp值，称重品只支持数量码；一品多码，ReX平台不支持多码多价，同SKU不同条码只存在规格上的不同。推荐只同步最小单位条码，规格为1 |
是 |
|
| supplier_no |
供应商ID |
自营ID、联营ID |
是 |
|
| Weight_flag |
是否称重 |
1：是，0：否 |
是 |
|
| life_status |
商品状态 |
A-正常 E-停售 |
是 |
|
| ou_code |
实体店code |
ReX平台分配 |
是 |
是 |
| member_price |
门店商品会员售价 |
读取ERP值 |
是 |
|
| sku_price |
门店商品售价 |
读取ERP值 |
是 |
|
| avg_weight |
均重 |
如果库存单位kg，售卖单位g，传0.001；其它传1 |
是 |
|
| pre_minus_weight |
预扣款重量 |
如果库存单位kg，售卖单位g，传0.001；其它传1 |
是 |
|
| Weight |
商品重量 |
可选；单位g；如果weight_fla为1，则不填。超重收运费时使用 |
否 |
|
| clean_sku_member_price |
是否清空会员价 |
可选； 1：是，0：否 |
否 |
|
如果库存单位非kg，ReX平台会校验库存单位取值，库存单位说明：
https://hema.open.taobao.com/doc?docId=108436&docType=1
（2）商品更新
为保证erp中商品资料信息变更及时同步到ReX平台，需要对接商品更新接口（alibaba.wdk.sku.update( 更新商品 )），商品更新支持修改商品所属类目、名称、条码、商品状态、门店售价、会员价以及清空会员价等，均需要erp发起修改动作来触发响应属性的修改；
商品价格一般情况下需要erp来同步，但如果商家希望个别商品的线上和线下价格不一样，可通过Portal后台门店商品页面提供的批量修改商品售价来修改线上商品的价格
注意：商品新增表格基本商品字段数值发生变化需要自动同步到ReX平台。
对于一品多码的更新操作说明，包括（a）多码一规格，规格为1；(b)多码多规格，不同条码对应规格不同；
情况a：修改方式需要对barcode_update_type字段来组合使用，具体说明如下：
1、新增barcodes指定了新的主条码barcode3,会将原主条码barcde1改为非主条码
2、删除barcodes对应条码，除了主条码
3、替换主条码 则会将现有主条码删除,新增指定主条码,只认barcodes中第一个条码
4、除主条码外,所有条码替换为指定barcodes,不支持主条码修改。
举例：当erp不知道ReX平台当前的商品条码是哪些时，erp商品A有主条码111，副条码222，333，444 执行如下组合。
barcode_update_type=2，barcodes=222，333，444，111
barcode_update_type=3，barcodes=111
barcode_update_type=4，barcodes=111，222，333，444
如此顺序和参数组合调用3次更新接口，即可实现将erp的最终的条码覆盖到ReX平台商品资料。
情况b：需要对接单独的接口：商品一品多码维护操作alibaba.wdk.item.morebarcode.ops，可以指定不同条码对应不同的规格。
1.2.2.3 使用说明
商品资料上传完成后可在ReX平台工作后台查看。
目录：总部视角->资料管理->商品管理\门店商品管理。如下图：
主档商品主要包含字段：商家类目编码，商品编码，商品类型，商家商品名称，库存单位，售卖单位，条码，是否称重，商品重量
门店商品主要包含字段：商品状态，实体店code，门店商品会员售价，门店商品售价及控制APP可见开关
