文档中心 > 开发文档

商品业务对接说明

更新时间:2020/03/06 访问次数:16658

对接流程

商家ERP与中间件,以及与ReX中台的交互流程如下图所示:

表结构说明

表结构关系

  1. 商品业务中各个表结构之间的关系如下图所示

  1. 业务说明:
    • 商家商品表的操作支持:add(新增商品),update(更新商品),updateMoreBarCode(一品多码),updateCategory(更新类目)。通过设置wdk_merchant_sku的op_type来决定具体操作类型。
    • 门店商品表支持的操作:add(新增门店商品),update(更新门店商品),updatePrice(更新价格,可以更新原价和会员价),updateStatus(修改门店商品的状态,支持商品状态的任意转换)。通过设置wdk_merchant_store_sku表的op_type来决定具体操作类型。
    • 商品类目表和商品品牌表中间件会在每天的凌晨把昨天的全量数据同步到数据库中,ERP可以用最新的ReX支持的品牌和类目。
    • wdk_item_barcode(一品多码表):会通过商家商品表中的sku_code和org_code来查找多个码,然后上传到ReX后台。如果商品不需要一品多码了,那么在一品多码表中删除掉数据,然后修改商家商品表的op_type= updateMoreBarCode,就会删除掉。
    • 商品条码barcode说明:
      标品的条码为商品标签上的条码;
      称重品的商品标签上的条码:商品条码+重量+金额等规则生成的。
      称重品解码规则(具体商家规则可能不同):
      13位条码且24开头,取1-7位(共7位)为barcode,8-12位(共5位)为主计价单位,13为校验位;
      18位条码且23开头,取1-7位(共7位)为barcode,8-12位(共5位)为金额,13-17位为重量或个数,18位为校验位;
    • 商品属性机构编码(org_code)说明
      org_code可以是商家编码,也可以是子公司编码,但不能是门店编码;
      互斥条件:商家已经包含该商品,那么子公司不能新增该商品;子公司已经包含该商品,商家不能创建该商品;同一个机构内,商品不能重复,不同子公司之间,商品可以重复;
      机构编码如果填商家编码,那就直接创建不同的门店商品,门店商品的机构编码也需要填商家编码;如果填子公司编码,那么每个子公司用到这个商品就要创建一次机构商品(同一个skucode第一次创建商品主档时,带机构为子公司A1,然后可以再调一次接口创建商品,带机构为子公司A2,此时为共用一个主档,创建不同机构商品),门店商品的机构编码需要填对应的子公司编码;

表结构字段

商家商品表:wdk_merchant_sku 

字段名称 字段简称 是否必填 类型 长度 是否可修改 注意事项 线上销售时才有意义的字段 所属层级 示例1 示例2 字段说明
id 数据库自增主键 int 10 运营不看 318607 308065 数据库自增主键
merchant_code 商家编码 必填 varchar 64 分配 QINGKELONG QINGKELONG 商家编码(此字段不能修改);由勤叶创建并提供,一般是商家名称大写全拼
sku_code 商品编码 必填 varchar 64 不可修改 商品主档 301447 000084 商品编码(此字段不能修改),商品在商家的唯一编码,传商家本地ERP一致的商品编码(货号),一般是7位数字
sku_name 商品名称 必填 varchar 200 商品主档 鲜活中华鲟 雪碧汽水1.25L/瓶

商品名称;最多60个字符,显示在手机APP商品详情页,对商品直观的描述,通常包含了品牌、规格等信息。商品名称也会显示在pos小票上。

附:淘鲜达系统的商品品名禁止出现“军用”,“专供”,“特供”,“聚划算”字样。

sub_title 商品卖点 varchar 150 1 机构商品 商品卖点;商品副标题,显示在APP商品详情页的标题下方。如可口可乐商品的副标题可以是“夏日必备 解暑神器”。不超过80个字符。双方业务沟通一下,是否生鲜商品要定为必填
handling_flag 是否加工 必填 int 10 不可修改 商品主档 0 0 是否加工商品,是否加工(此字段一经录入不能修改);与存货性质(goods_nature)组合构成商品类型,商品类型有5种:耗材、原材料、加工半成品、加工产成品、普通商品。耗材、原材料、普通商品的是否加工字段传否。 1: 是 0:否(默认0)
allow_app_sale 是否APP可售 int 10 1 机构商品 0 1 商品是否适合在app销售,机构商品层级为总控,此字段为总开关,控制所有门店的是否APP可见,商品本身不可售,则app可售必须关闭。App可售关闭,则门店商品维度的app可见不允许打开。1:是  0:否
big_flag 是否大件 int 10 废弃 0 0 是否大件,是否大件商品;废弃,淘鲜达商家默认传0,  1:是  0:否
purchase_spec 采购规格 必填 decimal 8 机构商品 1 1 一个采购单位等于多少个库存单位,淘鲜达合作商家默认填1
purchase_unit 采购单位 必填 varchar 64 机构商品 kg 商品针对供应商订货时,对应的单位;淘鲜达合作商家默认填与库存单位一致的值
inventory_unit 库存单位 必填 varchar 64 商品主档 kg

库存单位(此字段一经录入不能修改),存储的最小单位,从计量单位表中选择,如果没有对应的单位,可以由运营联系淘鲜达的运营新增单位。填写下列单位选项:毫升、升、加仑、屉、批、面、刀、幅、册、口、床、捆、壶、版、平方米、米、厘米、毫米、笼、坛、节、筒、半只、卡、板、双、粒、令、筐、碗、排、盘、顶、本、封、颗、付、辆、台、次、张、g、盆、组、扎、只、支、提、套、束、片、枚、篮、棵、卷、听、罐、根、副、份、朵、对、袋、打、串、杯、把、kg、件、箱、块、条、瓶、桶、包、盒、个。若新增的单位需要支持小数点库存,联系飞观。

手机淘宝中淘鲜达价格展示是用的库存单位。商家在填写商品库存单位时,应注意此单位展示合理性;在库存和销售单位实际不一致的情况(例如某类商品库存使用kg,销售使用g)之外,建议商品库存单位和销售单位一致。

sale_unit 售卖单位 必填 varchar 64 商品主档 g 商品销售时的单位;建议与库存单位保持一致。若库存单位是kg,售卖单位可以是g。此时均重、预扣款重量填0.001。APP最小起购量、APP购买步长填正整数。比如香蕉的库存单位是kg,销售单位是g,APP最小起购量、APP购买步长填500,表示在APP最少购买一斤,每加一档是加一斤。均重、预扣款重量填0.001的作用是,当用户购买500g,乘以0.001系数后=0.5kg,所以扣库存0.5kg。
returned_flag 是否可退供应商 int 10 机构商品 0 0 商品针对该供应商是否可以退货;因为淘鲜达商家不使用ReX的采配功能,建议传默认值, 1:是  0:否
sale_spec 销售规格描述 必填 varchar 64 1 机构商品 称重 1 商品销售单位对应的含量表达;APP展示重要字段,体现售卖单位中含有的商品数量,通常描述为“550g/份”等样式。填字符串。
lowest_price 最低售价 bigint 19 0 0 最低售价;建议淘鲜达商家填写采购进价(成本价),如果没有则传0
processing_unit 加工单位 varchar 64 机构商品 kg 每一组加工生产的单位,加工商品必填,仅当商品为加工品的时候,才能填写。从计量单位表中选择;淘鲜达合作商家默认填与库存单位一致的值
procs_exchange_rate 加工换算率 decimal 9 机构商品 1 1 一组加工单位对应多少个库存单位商品;加工商品必填,每一个加工单位对应的存储单位数量。为了简化BOM的使用,建议淘鲜达商家填默认值1。
cost_exchange_rate 成本换算率 decimal 9 机构商品 1 1 一个库存单位对应多少个成本单位,原料加工的成本单位和存储单位之间的换算。因为淘鲜达暂不涉及成本计算,建议淘鲜达商家填默认值1
mass_output_rate 出料率 decimal 9 机构商品 1 1 商品中对于加工可用的比例占整个商品的百分比;从原料到加工可用的原料之间的转化率。为了简化BOM的使用,建议淘鲜达商家填默认值1。
cost_unit 成本单位 varchar 64 机构商品 kg 商品作为原料时对应的单位;淘鲜达合作商家默认填与库存单位一致的值
cost_tax_price 考核成本价(含税) decimal 9 机构商品 0 0 商品加工所消耗的直接原料成本,加工商品必填,加工品按照原料的消耗估算出的成本。因为淘鲜达暂不涉及成本计算,建议淘鲜达商家填默认值1
cost_no_price 考核成本价(不含税) decimal 9 机构商品 0 0 商品加工所消耗的直接原料成本;加工商品必填,加工品按照原料的消耗估算出的成本。因为淘鲜达暂不涉及成本计算,建议淘鲜达商家填默认值1
label_style_type 标价签类型 必填 varchar 64 机构商品 无价签 无价签 标价签类型;商品在门店陈列时,采用的售价标签类型。因不采用电子价签,建议淘鲜达商家填默认值“无价签”
sku_label_type 商品标签类型 必填 varchar 64 机构商品 商品标签类型;打印张贴在商品上的标签中,需要包含的元素。建议淘鲜达商家填默认值“无”。(1 大标签;2 小标签+保质期+追溯;3 小标签+日期+追溯;4 小标签无日期;5 无;6 大标签+上市日期 B2C类型)
minimum 最小起订量 必填 int 10 机构商品 1 1 商品向供应商订货时最少的订货库存单位数量,淘鲜达合作商家建议填0
purchase_price 采购单价 必填 decimal 20 机构商品 40 4.4 采购单价;淘鲜达合作商家填默认值0
overload_rate 超收比例 必填 decimal 20 机构商品 0 0 商品收货时可以超过订货梳理多少百分比进行收货;非标品供应商送货入库时,允许超收的比例。淘鲜达合作商家填默认值0
forbid_receive_days 禁收时限 必填 int 10 机构商品 0 165 禁收时限;当商品保质期超过对应天数时,不允许收货。建议淘鲜达商家填默认值0。或按进口商品保质期天数的2/3、非进口商品的1/2填写
forbid_sales_days 禁售时限 必填 int 10 机构商品 0 30 禁售时限;当商品保质期超过对应天数时,商品不允许售卖。建议淘鲜达商家填默认值0。或填写商品保质期天数。
warn_days 保质期天数预警 必填 int 10 机构商品 0 220 库存监控报表中,剩余天数少于该天数时需要预警;当商品保质期超过对应天数时,系统进行预警。建议淘鲜达商家填默认值0
goods_nature 存货性质 必填 varchar 64 不可修改 商品主档 成品 成品 存货性质(此字段一经录入不能修改);此字段可传:原材料、办公品、服务项目、成品、半成品。与是否加工字段组合成商品类型字段。商品类型有5种:耗材、原材料、加工半成品、加工产成品、普通商品。若存货性质是成品,是否加工为是,则商品类型为“加工产成品”;若存货性质是成品,是否加工为否,则商品类型为“普通商品”;若存货性质是半成品,是否加工为是,则商品性质为“加工半成品”
fixed_flag 是否定制品 必填 int 10 商品主档 0 0 商品是否是供应商为企业进行定制;淘鲜达合作商家填默认值0, 0 否  1 是
delivery_unit 配货单位 必填 varchar 64 机构商品 kg 大仓向门店配货的单位;淘鲜达合作商家默认填与库存单位一致的值
delivery_spec 配货规格 必填 decimal 20 机构商品 1 1 一个配货单位等于多少个库存单位;淘鲜达合作商家填默认值1
pick_float_rate 浮动拣货比例 必填 decimal 20 0 0 商品拣货时可以超拣的比例,针对非标品。建议淘鲜达商家填默认值0
avg_weight 均重 必填 decimal 8 1 机构商品 0.001 1 一个售卖单位平均为多少个库存单位。计算库存发布时会以库存数量/均重来进行转换;建议与库存单位保持一致。若库存单位是kg,售卖单位可以是g。此时均重、预扣款重量填0.001。APP最小起购量、APP购买步长填正整数。比如香蕉的库存单位是kg,销售单位是g,APP最小起购量、APP购买步长填500,表示在APP最少购买一斤,每加一档是加一斤。均重、预扣款重量填0.001的作用是,当用户购买500g,乘以0.001系数后=0.5kg,所以扣库存0.5kg。
pre_minus_weight 预扣款重量 必填 decimal 8 1 机构商品 0.001 1 购买一个售卖单位按照多少个库存单位来扣款。计算金额时,按照购买的售卖单位数量/预扣款重量*售价 来计算;非称重品填1。若库存单位是kg,销售单位是g,填0.001
step_quantity APP购买步长 必填 int 10 1 机构商品 2000 1 app购买时每增加一次购买数量至少要增加多少个售卖单位。;非称重品填1。称重品根据实际货品情况填写。步长除了是加购物车的数量之外还承载了最小售卖数量的意义。
purchase_quantity APP最小起订量 必填 int 10 1 机构商品 2000 1 app购买时最少要购买多少个售卖单位。最小起订量必须是步长的整数倍。(目前最大不能过10000;否则商品中心未发布,此问题7.26号商品中心考滤做上限调整)
barcode 条码 必填 varchar 64 商品主档 2301447 6953392510371 包含商品包装上已经与预印刷的条码,这些条码是由生产厂商向;也包含企业内部的自编条码用于打印在食品包装上
short_title 商品简称 必填 varchar 64 商品主档 活中华鲟 雪碧汽水1.25L/瓶 对于商品的描述进行简化的表达,以便在拣货、标签等页面上能够进行直接展示;最多40个字符,会显示在pos屏幕上
weight_flag 是否称重 必填 int 10 不可修改 商品主档 1 0 是否称重(此字段一经录入不能修改);若库存单位是kg,或g,此字段填是,其他的填否 1:是  0:否(默认为0)
content 净含量 必填 varchar 64 1 商品主档 称重 1 商品包装规格的描述,建议跟销售规格描述填写一致;商品为称重品时,此值默认填  称重
import_flag 是否进口 必填 int 10 商品主档 0 0 是否进口,是否进口;原产地非中国,都填是 1:是  0:否(默认为0)
storage 存储条件 必填 varchar 64 1 商品主档 常温 常温 存储条件;填常温、冷藏、冷冻、热链、鲜活
back_cat_code ReX类目编码   varchar 64 可条件内修改 商品主档 1901001 3201006

需要商家把自己的类目对应到ReX的类目上,填写ReX类目编码。可以参考wdk_item_category.category_no

附:此字段暂时只能支持3、4级类目修改

说明:可结合商家商品类目综合理解

若商家类目上传,则ReX类目字段可以不填; 主档参数和类目表关系如下:

ReX类目  back_cat_code=wdk_item_category.category_no
商家类目  merchant_cat_code=wdk_sku_category.code

accounting_category 财务分类编码   varchar 64 商品主档 21 10 财务分类编码是对于多部门商家,用来按照部门做商品管理用的,接下来勤叶会和商家一起梳理商家分类和部门对应关系,就填商品所在管理部门对应的分类,是商家系统里的分类编码;目前该字段已停用
brand_name 品牌名称 varchar 100 1 商品主档 商品的品牌名字,需要先在淘鲜达提供的品牌库中匹配,如果匹配不上的直接传ERP中的品牌值
invoice_content 开票内容 必填 varchar 100 商品主档 其它-0% 其它-0% 如果使用开电子发票功能,则需要填写,填写下面这些选项:食品-13%、食品-9%、蔬菜-0%、日用品-13%、办公用品-13%、其它-13%、肉类-0%、蛋类-0%、其它-0%、餐饮-6%、烟-13%、酒-13%、服务-6%、食品-9%、其它-9%、食品-0%、宠物-9%、家电-13%、日用品-0%。如没有建议淘鲜达合作商家填默认值“其它-0%”。
period 保质天数 必填 int 10 商品主档 15 330 维护商品具体的保质天数,必须为整数,0代表不管理保质期
item_type 商品经营类型 必填 int 10 1 商品主档 1 1 1-普通商品 2-预售商品,预售商品不是立即发货,一般线上销售才会有
producer_place 产地 必填 varchar 200 1 商品主档 中国|辽宁省|大连市 中国|黑龙江省|哈尔滨市 需要传淘鲜达产地库中的值;国内产地传值格式:中国|省|市。若不能确定产地,可以传“见产品外包装”(按商家支持,需要提前通知技术配置)。国外产地只需要传国家名
org_code 机构编码 必填 varchar 100 分配 QKLDQZGS005 QKLDQZGS005 机构编码,由勤叶分配
org_name 机构名称 必填 varchar 100 分配 庆客隆香榭丽店 庆客隆香榭丽店 机构名称,由勤叶分配
op_type 操作类型 必填 varchar 64 运营不看 update add 操作类型:add(新增商品),update(更新商品),updateMoreBarCode(一品多码),updateCategory(更新商品ReX类目)。通过设置wdk_merchant_sku的op_type来决定具体操作类型: PS:如果更新商品的商家ERP类目请使用update
status 处理结果 必填 int 10 运营不看 1 -1 处理的结果,0未处理,1处理成功,-1处理失败
err_msg 处理失败原因 varchar 4096 运营不看 100128,商家商品已经存在,不能重复新增 处理失败的时候的原因
gmt_create 创建时间 datetime 23 运营不看 2017/11/23  15:31:40 2017/11/23  15:31:40 创建时间
gmt_modified 修改时间 datetime 23 运营不看 2017/11/23  15:31:40 2017/11/23  15:31:40 修改时间,更新的时候更新一下这个字段,便于排查问题
sku_pic_urls 图片地址 varchar(MAX) -1 1 商品主档 https://img.alicdn.com/imgextra/i1/2680068332/TB26V7TddzJ8KJjSspkXXbF7VXa_!!2680068332.png https://img.alicdn.com/imgextra/i1/2680068332/TB26V7TddzJ8KJjSspkXXbF7VXa_!!2680068332.png,https://img.alicdn.com/imgextra/i1/2680068332/TB26V7TddzJ8KJjSspkXXbF7VXa_!!2680068332.png 显示在app上的商品图片,图片的淘宝cdn地址,https开头,多个图片用英文逗号切割。第一张图片会作为主图
rich_txt 商品的富文本描述 varchar(MAX) -1 1 商品主档

商品的富文本描述,显示在app商品详情页,格式例如:<p>
<img align="absmiddle" src="https://img.alicdn.com/imgextra/i4/2680068332/TB2lZJ6nXXXXXbFXpXXXXXXXXXX_!!2680068332.jpg" />
<img align="absmiddle" src="https://img.alicdn.com/imgextra/i2/2680068332/TB2s3J1nXXXXXcdXpXXXXXXXXXX_!!2680068332.jpg" />
</p>

附:图片不要传 gif 图片,可以是jpg或者png,建议jpg

title1 卖点1名称 varchar 64 1 商品主档 水中贵族 卖点1名称
sub_title1 卖点1内容 varchar 64 1 商品主档 天然纯净 卖点1内容(卖点1内容不能超过6个汉字或12个字符)
title2 卖点2名称 varchar 64 1 商品主档 丝滑甘醇 卖点2名称
sub_title2 卖点2内容 varchar 64 1 商品主档 萦绕唇齿 卖点2内容
weight 重量 int 11 1 商品主档 100 重量(单位统一为g)。称重品(weight_flag为1)该字段不填。
item_type_v2 商品经营类型2   int 11       商品主档  1001  

商品经营类型(1001-普通商品, 2001-加工成品,2002-加工半成品,3001-原材料,4001-耗材,6001-组合商品);

注意:该字段有值时,无需填写handling_flag、 goods_nature这两个字段。

PS: 可售(1001-普通商品, 2001-加工成品,6001-组合商品,1000-MALL服务商品);不可售:(2002-加工半成品,3001-原材料,4001-耗材,)

merchant_cat_code  商家类目编码   varchar  64       商品主档       商家ERP本身的商品类目编码 ( 如果没有启用商家类目编码,不需要填写值;如果启用填写商家自己的类目编码;)

================================================================================================

 

门店商品表:wdk_merchant_store_sku 

字段名称 字段简称 是否必填 类型 长度 是否可修改 注意事项 线上销售时才有意义的字段 所属层级 示例1 示例2 字段说明
id 数据库自增主键 bigint 19 运营不看   419392 419418 数据库自增主键
merchant_code 商家编码 必填 varchar 64 分配 QINGKELONG QINGKELONG 商家编码(此字段不能修改);由勤叶创建并提供,一般是商家名称大写全拼
store_id 实体店code 必填 varchar 64 分配 QKLDQ0050066 QKLDQ0050066 实体店code,由勤叶创建并提供
sku_code 商品编码 必填 varchar 64 商品主档 072414 013584 商品编码(此字段不能修改);传商家本地ERP一致的商品编码(货号),一般是7位数字
org_code 机构编码 必填 varchar 64 分配 QKLDQZGS005 QKLDQZGS005 机构编码(此字段不能修改);由勤叶创建并提供,一般是商家名称大写全拼
life_status 商品状态 必填 varchar 64 门店商品 A A 商品在机构内的生命周期,商品状态;A-正常、T-暂时停购、C-淘汰出清、R-清退、D-删除封挡,传ATCRD
online_sale_flag 是否app可见 必填 int 10 1 门店商品 1 1 门店来控制本门店是否在app上让该商品可见,  1可见  0不可见
sku_price 门店商品售价 必填 bigint 19 门店商品 2580 3290 商品一个库存单位的售卖价格,2位小数,因为历史原因,部分接口的单位不一致(改价接口是分,剩下的是元)
member_price 门店商品会员售价 bigint 19 门店商品 0 0 会员正常购买该商品的售价,2位小数
supplier_no 供应商ID varchar 64 分配 282103945 282103945 供应商ID;淘鲜达合作商家填虚拟供应商ID,一共2个(自营、联营),由淘鲜达运营帮忙创建,联营商品需填写联营供应商ID,该商品可以通过联营供应商RF枪扫码入库库存
delivery_way 配送方式 必填 varchar 64 门店商品 2 2 商品到本仓的来源;淘鲜达商家填默认值“直配”(1:统配,2:直配,3:越库,4:自产;5:调拨), 基于采配链路的要求,加工品是不能够做直配的物流模式的,必须维护自产或者统配,目前包了一层逻辑“针对加工成品和加工半成品,如果是直配就转成自产”
sku_name 商品名称 varchar 200 商品主档 鲜猪后丘精肉 雀巢中老年配方麦片500g/袋 对商品直观的描述,通常包含了品牌、规格等信息
purchase_flag 是否可采  int 10 废弃 1 1 是否可采 ,是否可采;废弃 0:否  1:是
sale_flag 是否可售 int 10 废弃 1 1 是否可销售,是否可售;废弃  1:是  0:否(默认为1)
front_display_flag 是否前场陈列 必填 int 10 门店商品 1 1 商品在门店是否在前场陈列;淘鲜达合作商家用不到, 0:否  1:是
logistics 配送物流 varchar 64 门店商品 配送物流,配送物流;配送方式是直配,此项不填(输入物流中心编码)
delivery_warehouse 配货仓 varchar 64 门店商品 配出仓,配货仓;配送方式是直配,此项不填(输入仓库编码)
return_warehouse 退货仓 varchar 64 门店商品 退货仓,退货仓;配送方式是直配,此项不填(输入仓库编码)
lightning_delivery_flag 是否极速达 int 10 废弃 0 0 废弃;淘鲜达合作商家用不到,不传,1-极速达,0-非极速达
op_type 操作类型 必填 varchar 64 运营不看 update update 操作类型:add(新增门店商品),update(更新门店商品),updatePrice(更新价格,可以更新原价和会员价),updateStatus(修改门店商品的状态,支持商品状态的任意转换),cleanMemberPrice(清空会员价)。其他的值不做处理
status 处理结果 必填 int 10 运营不看 1 1 处理的结果,0未处理,1处理成功,-1处理失败
err_msg 处理失败原因 varchar 4096 运营不看 处理失败的原因
gmt_create 记录创建时间 datetime 23 运营不看 2017-11-23 15:31:40.000 2017-11-23 15:31:39.753 这条记录的创建时间
gmt_modified 记录更新时间 datetime 23 运营不看 2017-11-23 15:31:41.393 2017-11-23 15:31:45.446 记录的更新时间,在更新记录的时候设置成当前时间,用于排查问题
avg_weight 均重 必填 decimal 8 1 机构商品 0.001 1 一个售卖单位平均为多少个库存单位。计算库存发布时会以库存数量/均重来进行转换;建议与库存单位保持一致。若库存单位是kg,售卖单位可以是g。此时均重、预扣款重量填0.001。APP最小起购量、APP购买步长填正整数。比如香蕉的库存单位是kg,销售单位是g,APP最小起购量、APP购买步长填500,表示在APP最少购买一斤,每加一档是加一斤。均重、预扣款重量填0.001的作用是,当用户购买500g,乘以0.001系数后=0.5kg,所以扣库存0.5kg。
pre_minus_weight 预扣款重量 必填 decimal 8 1 机构商品 0.001 1 购买一个售卖单位按照多少个库存单位来扣款。计算金额时,按照购买的售卖单位数量*预扣款重量*售价 来计算;非称重品填1。若库存单位是kg,销售单位是g,填0.001
step_quantity APP购买步长 必填 int 10 1 机构商品 2000 1 app购买时每增加一次购买数量至少要增加多少个售卖单位。;非称重品填1。称重品根据实际货品情况填写
purchase_quantity APP最小起订量 必填 int 10 1 机构商品 2000 1 app购买时最少要购买多少个售卖单位
channel_type_code 渠道类目编码   varchar  64        门店商品  1  2 -1: 非法  1:淘点点  2: 美团  3: 饿了么  4: 自有渠道(淘宝) 5: 百度外卖 6: 微信  18: 飞牛优鲜  19: 欧尚 多个值用英文逗号分隔'; 

 ================================================================================================

商品类目表:wdk_item_category 

字段名称 字段简称 是否必填 类型 长度 是否可修改 注意事项 线上销售时才有意义的字段 所属层级 示例1 示例2 字段说明
id 数据库自增id bigint 19 2437500 2436391 数据库自增id
category_no 类目编码 varchar 64 01 0601001 主键,类目编码
name 类目名称 varchar 128 鲜花类 富士苹果 类目名称
parent_no 父类目编码 varchar 64 00 0601 父类目编码
is_leaf 是否是叶子节点 varchar 10 0 1 是否是叶子节点,1表式是,0表式不是
gmt_create 创建时间 datetime 23 2017-12-11 17:02:39.093 2017-12-11 17:02:39.093 创建时间
gmt_modified 修改时间 datetime 23 2017-12-11 17:02:39.093 2017-12-11 17:02:39.093 修改时间
forest_id 淘宝类目ID bigint 19 淘宝类目ID

================================================================================================

 

商品品牌表:wdk_item_brand 

字段名称 字段简称 是否必填 类型 长度 是否可修改 注意事项 线上销售时才有意义的字段 所属层级 示例1 示例2 字段说明
id 数据库自增主键 bigint 19 1451784 1451795 数据库自增主键
brand_id 品牌id bigint 19 20456 17286 品牌id
name 品牌名字 varchar 128 圣菲堡 伯特苏 品牌名字
gmt_create 创建时间 datetime 23 2017-12-11 17:02:37.143 2017-12-11 17:02:37.156 创建时间
gmt_modified 修改时间 datetime 23 2017-12-11 17:02:37.143 2017-12-11 17:02:37.156 修改时间

 ================================================================================================

商品条码表:wdk_item_barcode

字段名称 字段简称 是否必填 类型 长度 是否可修改 注意事项 线上销售时才有意义的字段 所属层级 示例1 示例2 字段说明
id 数据库自增主键 bigint 19 35090 35100 数据库自增主键
org_code 机构编码 必填 varchar 64 QKLDQZGS005 QKLDQZGS005 机构编码
sku_code 商品编码 必填 varchar 64 004232 072014 商品编码
bar_code 条码 必填 varchar 64 6927538200044 2000000720142 条形码
spu_spec 规格 必填 varchar 64 1 1 规格
gmt_create 创建时间 datetime 23 2017-11-19 02:01:05.993 2017-11-19 02:01:05.993 创建时间
gmt_modified 修改时间 datetime 23 1900-01-00 00:00:00 1900-01-00 00:00:00 修改时间

 

商家商品类目表:wdk_sku_category

字段名称 字段简称 是否必填 类型 长度 是否可修改 注意事项 线上销售时才有意义的字段 所属层级 示例1 示例2 字段说明
id 数据库自增主键 bigint 20 35090 35100 数据库自增主键
code 商家类目编码 必填 varchar 64 81 815 商家类目编码
name 商家类目名称 必填 varchar 64 食品课      冷藏分类 商家类目名称
parent_code 父类目编码   varchar 64   81 父类目编码(为空则认为是新增顶级类目)PS:如果code是顶级类目,则此项必须空。
leaf 是否是叶子节点 必填 int 10 0 0

是否是叶子节点(如果是叶子类目则不允许再添加子类目;

注意 非叶子类目不允许添加商品) 0.否1.是

PS:如果code 对应的leaf 是否叶子类目(如果是底层叶子类目下面允许添加商品,但不允许再添子类目了; 如果不是底层叶子类目,下面允许添加子类目,不允许添加商品)

category_desc 类目描述   varchar 64             商家类目描述
sort_order 类目排序值   int 10         0 0 类目排序值(按数值从小到大排序,若不传则默认按插入顺序)
op_type 操作类型 必填  varchar 64         add add 本次操作类型,是新增还是更新,新增是add,删除是delete。如果乱填写,则不进行任何操作(备注 update 只能更新名称和类目状态; delete 只能删除子类目并且类目下没有商品)
status 处理结果 必填 int 10         1 1 处理的结果,0未处理,1处理成功,-1处理失败
err_msg 错误描述   varchar 64             处理失败的时候的错误信息,用于排查错误
category_status 类目状态 必填 int 10         0 0 商家类目状态(0:正常;1:禁用,禁用后已有的商品不影响,不能新建新商品)
gmt_create 创建时间 datetime 23 2017-11-19 02:01:05.993 2017-11-19 02:01:05.993 创建时间
gmt_modified 修改时间 datetime 23 1900-01-00 00:00:00 1900-01-00 00:00:00 修改时间

 

FAQ

关于此文档暂时还没有FAQ
返回
顶部