3.2.1上传基础菜品

优质
小牛编辑
116浏览
2023-12-01
gdsset套餐结构说明:

如果菜品为套餐,需要增加此项。其中以列表的方式列出可选的分组,每个分组中min为此分组最少可选菜品数量(min最小0,最大<=max),max为最大可选菜品数量(max最小1,最大<=可选菜数量),固定选择数量时max=min。

list为此可选分组的菜品id列表,此id为线下菜品编码,如果选择的菜品会改变套餐价格,可以用["001","002","003"]这样的定义方式。如果需要定义选择某一菜品时需要额外加价,则需要用{"001":{"price":18},"002":{"price":0},"003":{"price":0}}这样来定义001需要加价18,注意一旦一个菜品需要加价,这个分组就需要按此格式定义,而不能用前一种简化格式。

另外注意:此编码菜品必须在菜品列表中存在!

请求参数说明

参数描述必填示例值类型最大长度
action接口参数组object
└action需要调用的接口名称do_post_dishesstring
getGET参数组,本组参数需要参与签名object
└replacereplace=1 覆盖全部菜品,包括分类、菜品,但是gdsid相同的菜品会保留图片无需重复上传。1number
postPOST参数组object
└dishlist
└└cateid类别编号001005number
└└catestate菜品类别状态:0为停用,1为可用1number
└└catename类别名称热菜string
└└order分类排序码10001string
└└rebate折扣控制,设置为100则本类不参与打折100number
└└dishes本类别菜品列表list
└└└gdsid菜品编码(菜品编码!重要!用于与业务系统对应的菜品编码!)00100502number
└└└gdsstate菜品状态:0为停用,1为可用,2为仅展示1number
└└└gdsname菜品名称桂鱼string30
└└└gdsprice菜品价格128.00number
└└└gdsunit菜品单位string5
└└└gdstype菜品类型:0=堂吃+外卖,1=堂吃,2=外卖0number
└└└order排序码(菜品与类别都支持)001number
└└└tags菜品标识推荐string
└└└mbprice1会员价(不传保留原来的会员价。传空或0是会员价=0,传-1是不使用会员价)10number
└└└spicy辣度 :0~4(不辣~超级辣)4number
└└└maxqty点菜份数最大限制(可点最大份数,0不使用)2number
└└└minqty点菜份数最小限制(可点最大份数,0不使用)0number
└└└sellingTime菜品销售时间段控制11:00-14:00,17:00-20:00string
└└└gdsrebategdsrebate=100 表示此菜品为不能打折菜品(其他数字无效例:80)100number
└└└gdsunits菜品规格中份=80,大份=120string
└└└no_allow_pt不参与积分抵扣(1=不参与积分抵扣,其他/默认=参与积分抵扣)1number
└└└no_allow_co不参与优惠券抵扣(1=不参与优惠券抵扣,其他/默认=参与优惠券抵扣)1number
└└└dgHits菜品销量100number
└└└dgShowMode显示模式:0标准,1大图0number
└└└gdsqcode菜品速查码qzgystring
└└└gdsaddon做法名称(多做法用逗号分隔,做法加价时在做法后+价格的方式表示)清蒸,红烧string
└└└gdsaddon2口味名称(多口味用逗号分隔,做法加价时在做法后+价格的方式表示)不辣,超辣string
└└└packfee外卖菜品打包费10number
└└└gdsinfo菜品说明string
└└└gdsaddonset定义做法、口味object
min最小可选数量0number
max最大可选数量1number
└└└gdsattr新自定义做法口味(当时使用gdsattr时,gdsaddon、gdsaddon2、gdsaddonset、gdsaddonset2参数不在生效)list
name属性名称做法string
min最小可选数量0number
max最大可选数量1number
itemslist
name自定义名称菜笙子煮string
add价格(0或空为不设置价格)10number

请求示例

{
	"action": {
		"action": "do_post_dishes"
	},
	"get": {
		"replace": "1"
	},
	"post": {
		"dish": [{
			"cateid": "001005",
			"catestate": "1",
			"catename": "热菜",
			"order": "10001",
			"rebate": 100,
			"dishes": [{
					"gdsid": "00100502",
					"gdsstate": "1",
					"gdsname": "桂鱼",
					"gdsprice": "128.00",
					"gdsunit": "例",
					"gdstype": "0",
					"order": "001",
					"gdsrebate": "100",
					"tags": "推荐",
					"mbprice1": "10",
					"spicy": "4",
					"maxqty": "2",
					"gdsunits": "中份=80,大份=120",
					"minqty": "0",
					"sellingTime": "11:00-14:00,17:00-20:00",
					"no_allow_pt": "1",
					"no_allow_co": "1",
					"dgHits": "100",
					"dgShowMode": "0",
					"gdsqcode": "qzgy",
					"gdsaddon": "清蒸,红烧",
					"gdsaddon2": "不辣,超辣",
					"packfee": "10",
					"gdsaddonset": {
						"min": 0,
						"max": 1
					},
					"gdsinfo": "",
					"gdsattr": [{
						"name": "做法",
						"min": 0,
						"max": 1,
						"items": [{
							"name": "菜笙子煮",
							"add": "10"
						}]
					}]
				},
				{
					"gdsid": "00100503",
					"gdsname": "可选套餐",
					"gdsprice": "168.00",
					"gdsunit": "套",
					"gdsqcode": "kxtc",
					"gdsaddon": "",
					"gdsinfo": "",
					"gdsset": [{
							"name": "必选菜",
							"noselect": 1,
							"list": [
								"000100001",
								"000100002",
								"000100003"
							]
						},
						{
							"name": "冷菜三选一",
							"min": 1,
							"max": 1,
							"list": {
								"000100007": {
									"price": 0
								},
								"000100008": {
									"price": 8
								},
								"000100009": {
									"price": 0
								}
							}
						},
						{
							"name": "热菜五选二",
							"min": 2,
							"max": 2,
							"list": [
								"000500011",
								"000500012",
								"000500013",
								"000500014",
								"000500015"
							]
						}
					]
				}
			]
		}]
	}
}

响应参数说明

参数描述必填示例值类型最大长度
status返回状态。接口成功时为1,出错为01number
info错误时会返回相应的错误信息提交成功string
count本次提交新增的菜品数量0number
update_count本次更新的菜品数量2number

响应示例

{
	"status": 1,
	"info": "提交成功",
	"count": 0,
	"update_count": 2
}