说明
用于初始化微信菜单使用，可多次执行，并且会根据gdsid来进行判断更新或是新增
菜品类别只在首次上传，后续只更新菜品不更新分类。门店类别更多是业务分类。线上分类更多是偏向客人点菜方便，一般都是需要上传后在线上进行分类调整。
请求地址
http://api.dc78.cn/Api/do_post_dishes
请求方式
POST
请求参数
GET参数：
replace=1，覆盖全部菜品，包括分类、菜品，但是gdsid相同的菜品会保留图片无需重复上传。
POST数据：
dish菜品JSON数据包，格式如下：
dish=[
{
"cateid": "001003",
"catename": "冷菜",
"catestate": 1,
"dishes": [
{
"gdsid": "00100301",
"gdsstate": 0,
"gdsname": "六冷碟",
"gdsprice": "68.00",
"gdsunit": "套",
"gdsqcode": "lld",
"gdsaddon": "",
"gdsinfo": "包含六冷菜",
"gdstype": "1",
"gdsaddon2": "清蒸+10,红烧",
"packfee": 3,
"mbprice1": "58.00",
"gdsaddonset2": {
"min": 0,
"max": 1
},
"gdsunits": "中份=80,大份=120"
},
{
"gdsid": "00100302",
"gdsname": "海苔花生",
"gdsprice": "28.00",
"gdsunit": "份",
"gdsqcode": "hths",
"gdsaddon": "",
"gdsinfo": ""
}
]
},
{
"cateid": "001005",
"catename": "热菜",
"dishes": [
{
"gdsid": "00100501",
"gdsname": "干捞粉丝",
"gdsprice": "26.00",
"gdsunit": "例",
"gdsqcode": "glfs",
"gdsaddon": "",
"gdsinfo": ""
},
{
"gdsid": "00100502",
"gdsname": "桂鱼",
"gdsprice": "128.00",
"gdsunit": "例",
"gdsqcode": "qzgy",
"gdsaddon": "清蒸,红烧",
"gdsaddonset": {
"min": 0,
"max": 1
},
"gdsinfo": ""
},
{
"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"
]
}
]
}
]
}
]
| 参数 | 参数名称 | 描述 | 范例 |
cateid | 类别编号 | 001005 | |
| catename | 类别名称 | 热菜 | |
| dishes | 本类别菜品列表 | ||
| gdsid | 菜品编码 | 菜品编码!重要！用于与业务系统对应的菜品编码！ | 00100501 |
| gdstype | 菜品类型 | 0=堂吃+外卖，1=堂吃，2=外卖 | |
| gdsname | 菜品名称 | 干捞粉丝 | |
| gdsprice | 菜品价格 | 26 | |
| gdsunit | 菜品单位 | 例 | |
| gdsqcode | 菜品速查码 | glfs | |
| gdsaddon | 做法名称 | 多做法用逗号分隔,做法加价时在做法后+价格的方式表示 | 酱烧＋28,清蒸＋18"，＋号请使用全角字符！ |
| gdsaddon2 | 口味名称 | 多口味用逗号分隔 | |
| gdsinfo | 菜品说明 | ||
| 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，注意一旦一个菜品需要加价，这个分组就需要按此格式定义，而不能用前一种简化格式。 另外注意：此编码菜品必须在菜品列表中存在！ | |
| noselect | noselect=1说明此分组为必选菜，用户无需选择 | ||
| order | 排序 | 对菜品进行排序 | |
tags | 菜品标识 | 对某个菜品做菜品标识 | |
| mbprice1 | 会员价 | 不传保留原来的会员价。传空或0是会员价=0，传-1是不使用会员价 | |
spicy | 辣度 | 0~4（不辣~超级辣） | |
| maxqty | 点菜份数最大限制 | 可点最大份数,0不使用 | |
| minqty | 点菜份数最小限制 | 可点最小份数，0不使用 | |
| sellingTime | 菜品销售时间段控制 | 根据菜品时间段来控制销售时间 | 格式11:00-14:00,17:00-20:00 |
| dgHits | 菜品销量 | 每日自动更新,也可手动修改 | |
| dgShowMode | 显示模式 | 0标准，1大图 |
2016-07-27，增加套餐结构
2016-08-23，类别中增加catestate，菜品中增加gdsstate,当设置为0时此类别/菜品为停用状态，1为可用。不传默认为线上当前状态。
2016-11-09，增加gdsaddonset,gdsaddonset2,用min,max分别定义做法、口味的最小、最大可选数量
2017-08-23, 增加packfee 外卖菜品打包费
2019-03-18，增加sellingTime菜品销售时间段控制
返回
{"status":1,"info":"提交成功","count":28,”update_count”:2}
count为本次提交新增的菜品数量
update_count:本次更新的菜品数量
请求方式
INI
请求参数
[action] | 描述 |
| action=do_post_dishes | |
[get] | 描述 |
| replace=1 | |
| [post] | 描述 |
| dish=array:2 | |
| [post_dish_0] | 描述 |
| cateid=001003 | |
| catename=冷菜 | |
| catestate=1 | |
| dishes=array:2 | |
| [post_dish_0_dishes_0] | 描述 |
| gdsid=00100301 | |
| gdsstate=0 | |
| gdsname=六冷碟 | |
| gdsprice=68.00 | |
| gdsunit=套 | |
| gdsqcode=lld | |
| gdsaddon= | |
| gdsinfo=包含六冷菜 | |
| gdstype=1 | |
| gdsaddon2=清蒸+10,红烧 | |
| gdsaddonset2={object} | |
| gdsunits= | |
| [post_dish_0_dishes_0_gdsaddonset2] | 描述 |
| min=0 | |
| max=1 | |
| [post_dish_0_dishes_1] | 描述 |
| gdsid=00100302 | |
| gdsname=海苔花生 | |
| gdsprice=28.00 | |
| gdsunit=份 | |
| gdsqcode=hths | |
| gdsaddon= | |
| gdsinfo= | |
| [post_dish_1] | 描述 |
| cateid=001005 | |
| catename=热菜 | |
| dishes=array:3 | |
| [post_dish_1_dishes_0] | 描述 |
| gdsid=00100501 | |
| gdsname=干捞粉丝 | |
| gdsprice=26.00 | |
| gdsunit=例 | |
| gdsqcode=glfs | |
| gdsaddon= | |
| gdsinfo= | |
| gdsaddonset={object} | |
| [post_dish_1_dishes_1_gdsaddonset] | 描述 |
| min=0 | |
| max=1 | |
| [post_dish_1_dishes_2] | 描述 |
| gdsid=00100503 | |
| gdsname=可选套餐 | |
| gdsprice=168.00 | |
| gdsunit=套 | |
| gdsqcode=kxtc | |
| gdsaddon= | |
| gdsinfo= | |
| gdsset=array:3 | |
| [post_dish_1_dishes_2_gdsset_0] | 描述 |
| name=必选菜 | |
| noselect=1 | |
| list=["000100001","000100002","000100003"] | |
| [post_dish_1_dishes_2_gdsset_1] | 描述 |
| name=冷菜三选一 | |
| min=1 | |
| max=1 | |
| list={object} | |
| [post_dish_1_dishes_2_gdsset_1_list] | 描述 |
| 000100007={object} | |
| 000100008={object} | |
| 000100009={object} | |
| [post_dish_1_dishes_2_gdsset_1_list_000100007] | 描述 |
| price=0 | |
| [post_dish_1_dishes_2_gdsset_1_list_000100008] | 描述 |
| price=8 | |
| [post_dish_1_dishes_2_gdsset_1_list_000100009] | 描述 |
| price=0 | |
| [post_dish_1_dishes_2_gdsset_2] | 描述 |
| name=热菜五选二 | |
| min=2 | |
| max=2 | |
| list=["000500011","000500012","000500013","000500014","000500015"] |
返回
[result]
status=1
info=提交成功
coun=28
update_count=2
| [result] | 描述 |
| status=1 | |
| info=提交成功 | |
| coun=28(count为本次提交新增的菜品数量) | |
| update_count=2(update_count:本次更新的菜品数量) |