开放业务&解决方案
一、商品体系简介
系统现状：目前，系统对外统一为ReX平台，商品管理流程、字段的约束条件、数据结构基本都是一样的。因此，合作商家在前期，了解ReX平台的商品管理流程、数据结构，如果有跟合作商家不匹配的地方，需要合作商家与淘鲜达的项目PM沟通，在项目前期提出，寻求解决方案。
中间件业务表结构—商品
商家主档、机构商品、门店商品，依次向上继承，商品主档挂在商家层级，门店商品挂在门店层级，机构商品可以在任意层级。
不同层级的商品会有不同属性，商品属性所属层级判断：会给到商家一份商品表字段说明，商家需要看字段所属层级是否符合自身组织架构，如果不符合实际经营场景，请尽早提出。
二、对接流程
2.1 商品资料准备：
- 商品主资料：采购填写《商品发布模板》淘鲜达商品运营同学全程配合
- 商品图片：确认拍摄商品范围+规范+命名标准
- 其他：一品多码商品清单/称重品编码规则同步/商品状态理解同步
2.2 商品信息维护方式：
三、重点内容
类目、产地、品牌
类目：会提供淘鲜达类目查询接口或excel版的淘鲜达类目，商家需要根据自身类目情况，做映射关系，如果找到不到分类，可以提出新增类目的申请，项目开展过程中会有类目运营同学辅助商家一起完成类目映射；
类目映射时一般会有三种情况（如下图）：
- 商家分类粗、淘鲜达分类细：一般会采用一定规则进行映射，例如先用商家类目映射上淘鲜达类目较粗的一层，然后默认选择叶子类目中的第一个；
- 商家分类与淘鲜达分类颗粒度一样：直接对应；
- 商家分类细、淘鲜达分类粗：把细的分类映射到粗的分类上；
产地：会给淘鲜达产地库，商家传的商品产地必须是产地库中的（中国|辽宁省|大连市），若不能确定产地，可以传“见产品外包装”；
品牌：会提供淘鲜达品牌查询接口，商品的品牌名字，需要先在淘鲜达提供的品牌库中匹配，如果匹配不上的直接传ERP中的品牌值
一品多码
一品多码功能解决同一个商品，用不同规格进行售卖的场景，目前仅支持不同条码有不同规格，不支持不同价格。
例如某瓶装矿泉水sku_code1，设置其主条码barcode1，若该矿泉水还可以12瓶售卖、24瓶售卖，则设置barcode2，一品多码规格设置为12，则设置barcode3，一品多码规格设置为24。
| 一品多码规格 （其他条码与主条码的规格倍数关系） |
||
| sku_code1 | Barcode1（主条码） | |
| barcode2 | 12 | |
| barcode3 | 24 | |
| … | … |
预扣款重量、均重、销售步长、最小起订量
| 1、牛奶，库存单位是盒，售卖单位也是盒，有库存800盒，app售卖时起购5盒，增加步长2盒，每盒售价0.5元 | 2、鱼，库存单位是kg，售卖单位是kg，库存有100kg，app售卖时5kg起购，增加步长2kg | 3、鱼，库存单位是kg，售卖单位是g，库存有100kg，app售卖时500g起购，增加步长200g | 4、鱼，库存单位是kg，按份来卖，库存有100kg，每条平均重8kg（7-9kg），app售卖时5条起购，增加步长2条 | |
| 库存单位 inventoryUnit | 盒 | Kg | Kg | Kg |
| 售卖单位 saleUnit | 盒 | Kg | g | 条 |
| 预扣款重 preMinusWeight （卖一个售卖单位等于卖多少个库存单位，用来计算商品详情页的销售单价） |
1 | 1 | 0.001 | 9 |
| 均重 avgWeight （卖一个售卖单位等于卖多少个库存单位，用来计算商品详情页的销售页面库存） |
1 | 1 | 0.001 | 8 |
| App起购 purchase_quantity（销售单位） | 6 | 6 | 600 | 6 |
| App购买步长 step_quantity（销售单位） | 2 | 2 | 200 | 2 |
商品类型
商品类型；由是否加工（坐标横轴，包含：是、否）、存货性质（坐标纵轴，包含：耗材、原材料、成品、半成品）组合而成。商品类型有5种：耗材、原材料、加工半成品、加工产成品、普通商品。
商品状态
商品类型决定这类商品可以做什么，商品状态（生命周期）决定现在能做什么
目前启用的：
ATCRD，如果有不满足需要提出，例如要某个商品变为不可售，可以将其置为R或者D
前置状态与可转状态，仅在工作台有限制，api、中间件可以不受限制
图片上传
会给到商家一份商品图片excel，商家可以获取ReX系统图片，通过条码或标题匹配，找到能够使用的图片直接使用。其余图片需要通过下面图片接口上传至阿里cdn，获取图片链接，填入相应商品的图片字段中。图片准备周期较长，请提前准备。
条码解析
商家需要提供所有条码规则，如折扣方案还没有确认，可以后续补充。条码解析规则大致如下：
merchant_code in ('XINHUADU','XHDCS')
编码规则：13位条码且24开头，1-7位（共7位）为barcode，8-12位（共5位）为主计价单位，13为校验位。其余情况按传入条码返回
四、商品表结构
在//open.taobao.com/docs/api_list.htm?spm=a219a.7629065.0.0.4BUWbL&cid=20708这个地址上根据接口名字搜索对应的接口文档
| 业务 | 子业务 | 接口名称 | |
| 商品 | 创建商家商品 | alibaba.wdk.item.merchantsku.create | |
| 修改商家商品 | alibaba.wdk.item.merchantsku.update | ||
| 一品多码 | alibaba.wdk.item.morebarcode.ops | ||
| 查询商家商品 | alibaba.wdk.item.merchantsku.query | ||
| 创建门店商品 | alibaba.wdk.item.merchantstoresku.create | ||
| 修改门店商品 | alibaba.wdk.item.merchantstoresku.update | ||
| 更新价格 | alibaba.wdk.item.memberprice.update | ||
| 修改状态 | alibaba.wdk.item.storeskustatus.update | ||
| 查询门店商品 | alibaba.wdk.item.storesku.query | ||
| 查询类目 | alibaba.wdk.item.category.query | ||
| 查询品牌 | alibaba.wdk.item.brand.query | ||
| 上传图片 | alibaba.wdk.picture.upload | ||
