商家对接需要把erp中的商品资料同步到ReX平台,用于在手机淘宝端展示售卖;目前erp需要对接商品的字段较多,商品模块会详细说明需要的字段。
(1)商品新增
商品接口和类目是搭配使用的,接商品必须接类目接口
新增商品 alibaba.wdk.sku.add
为了将erp中的商品资料同步到ReX平台,需要erp对接商品新增接口(alibaba.wdk.sku.add):
| 字段名称 | 参数类型/SDK类型 | 是否必须 | 示例值 | 描述 |
| param_list | SkuDo[] | 必须 | 商品列表(最大列表长度:20):20个商品明细 | |
| └ barcodes | String | 必须 | 693132017440 | 条码,支持一品多码,多个条码以半角逗号分隔;商品最小规格条码 |
| └ brand_name | String | 必须 | 帝皇鲜 | 品牌名称;支持商家ERP自定义 |
| └ height | String | 可选 | 3 | 高度(高)单位:厘米; |
| └ length | String | 可选 | 10 | 长度(深); |
| └ width | String | 可选 | 3 | 宽度(宽); |
| └ tax_rate | String | 必须 | 0.13 | 销项税率;跟财务场景相关按照国家标准税率:0.13;0.09;0.06 |
| └ inventory_unit | String | 必须 | 个 | 库存单位; 商品单位库介绍:https://hema.open.taobao.com/doc?docId=108436&docType=1 |
| └ producer_place | String | 必须 | 中国|辽宁省|大连市 | 产地,商品生产地点的描述,用于APP和电子价签展示,如果是可售,则必填;商品地址库:https://hema.open.taobao.com/doc?docId=108437&docType=1 按照实例格式传,如果没有维护可默认传:见产品外包装 |
| └ sku_code | String | 必须 | 1.901E+11 | 商品唯一编码(仅支持数字形式,不支持字母或特殊字符)商品编码sku |
| └ sku_name | String | 必须 | 小龙虾 30-40g/只 称重 | 商品名称,对商品直观的描述,通常包含了品牌、规格等信息 |
| └ weight | String | 必须 | 30 | 单个商品重量 单位为克/g,必须为整数 |
| └ ou_code | String | 必须 | TCCSMD | 仓编码(仓编码和门店编码值相同)商家在阿里侧店仓编码TCCSMD |
| └ import_flag | Number | 必须 | 0 | 是否进口,是否进口;原产地非中国,都填是 1:是 0:否(默认为0) |
| └ sale_unit | String | 必须 | 个 | 销售单位;商品销售时的单位;标品建议与库存单位保持一致。 |
| └ storage | String | 必须 | 常温 | 存储条件;填常温、冷藏、热链、鲜活 |
| └ sku_price | String | 必须 | 9.9 | 门店商品售价(同字段sale_price),单位:元;优先使用本字段 |
| └ period | Number | 必须 | 450 | 商品的保质期天数必须为整数,不能为空,不能传0 |
| └ merchant_cat_code | String | 必须 | 10086 | 商家后台类目编码,优先使用本字段。(创建商家类目接口的类目编码 code ) |
| └ sku_pic_urls | String | 必须 | https://img.alicdn.com/imgextra/i3/ | 在app上显示的商品图片cdn地址(同字段main_pic_urls和detail_pic_urls),https开头,多个图片用英文逗号切割。第一张图片会作为主图;优先使用本字段 |
| └ rich_text | String | 必须 | <p><img align=\"absmiddle\" src=\"https://img.alicdn.com | 文描 |
| └ delivery_storage | String | 必须 | 常温 | 配送条件;填常温、冷藏; 这个指拣货之后到消费者手中需要的配送条件 |
| └ product_identity | String | 必须 | 123 | 产品聚合码,程序会把聚合码相同的sku聚合到一起;比如衣服有大中小号3中sku,通过聚合码聚合到一起;该字段在同城零售发布场景才能使用;20字符以内 |
| └ biz_type | String | 必须 | shareStore | 业务类型:txd淘鲜达,elm饿了么,shareStore共享库存,同城零售商家统一值shareStore |
| channel_props |
ChannelProp[] | 必须 | 以下为本次新增参数 | 渠道属性, |
| └channel_type | String | 必须 | shareStore | 渠道类型:txd淘鲜达,shareStore共享库存,同城零售商家统一值shareStore |
| └props | PropField[] | 必须 | 渠道对应的属性,为key-value键值对形式, | |
| └value | String | 必须 | 1 | 可售状态:1代表可售 0 代表不可售 |
| └key | String | 必须 | ONE_HOUR_STATUS | 渠道属性key, 取值为"ONE_HOUR_STATUS" 小时达 ;"WAVE_ARRIVE_STATUS" 波次达 ; |
2)商品更新
为保证erp中商品资料信息变更及时同步到ReX平台,需要对接商品更新接口(alibaba.wdk.sku.update( 更新商品 ))
3)商品发品
商家通过ERP对接共享零售提供商品发品接口把商品信息发布到同城零售商家后台,商家补充共享库存所需必备属性后,发布商品到天猫超市商品后台,天猫超市商品运营小二审核后把商品发布到天猫超市