淘宝开放平台

商家商品表wdk_merchant_sku新增字段：商品经营类型2

发布于: 2018-08-16 15:16:05

开发文档/开发指南/中间件接入（首推）/商品业务对接说明，商家商品表wdk_merchant_sku，新增1字段:item_type_v2(商品经营类型2)

商家商品表：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	商品针对该供应商是否可以退货；因为淘鲜达商家不使用盒马的采配功能，建议传默认值， 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	盒马类目ID	必填	varchar	64	不可修改（目前支持3、4级类目修改）			商品主档	1901001	3201006	需要商家把自己的类目对应到盒马的类目上，填写盒马类目ID，此字段暂时只能支持3、4级类目修改
accounting_category	财务分类编码	必填	varchar	64				商品主档	21	10	财务分类编码是对于多部门商家，用来按照部门做商品管理用的，接下来勤叶会和商家一起梳理商家分类和部门对应关系，就填商品所在管理部门对应的分类，是商家系统里的分类编码；
brand_name	品牌名称		varchar	100			1	商品主档	无	无	商品的品牌名字，需要先在淘鲜达提供的品牌库中匹配，如果匹配不上的直接传ERP中的品牌值
invoice_content	开票内容	必填	varchar	100				商品主档	其它-0%	其它-0%	如果使用开电子发票功能，则需要填写，填写下面这些选项：食品-17%、食品-11%、蔬菜-0%、日用品-17%、办公用品-17%、其它-17%、肉类-0%、蛋类-0%、其它-0%、餐饮-6%、烟-17%、酒-17%、服务-6%、其它-11%、食品-0%、宠物-11%、家电-17%、日用品-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（更新类目）。通过设置wdk_merchant_sku的op_type来决定具体操作类型
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内容
title2	卖点2名称		varchar	64			1	商品主档	丝滑甘醇		卖点2名称
sub_title2	卖点2内容		varchar	64			1	商品主档	萦绕唇齿		卖点2内容
weight	重量		int	11			1	商品主档	100		重量（单位为克）
item_type_v2	商品经营类型2		int	11				商品主档	1001		商品经营类型（1001-普通商品， 2001-加工成品，2002-加工半成品，3001-原材料，4001-耗材，6001-组合商品）；注意：该字段有值时，无需填写handling_flag、 goods_nature这两个字段。
merchant_cat_code	商家类目编码		varchar	64				商品主档			商家ERP本身的商品类目编码

最新公告

商家商品表wdk_merchant_sku新增字段：商品经营类型2