• 开发者平台
  • >
  • 餐饮文档中心

菜品精确查询收费

(下行接口)合作方调用此接口,根据门店ID与门店菜ID获取门店菜品信息

授权方式:门店授权

请求描述

HTTP请求方式:POST
HTTP请求头类型:Content-Type=application/json
URI:   /open/v1/cater/dish/dishMenuByIds

请求参数

1.公共参数

详情可查看【公共说明】中的公共参数模块

2.业务参数

参数名 类型 是否必填 参数描述
shopIdenty long 客如云门店ID
ids List<Long> 门店菜品ID,可同时查询多个菜品(可通过菜品分页查询获取)

业务示例(JSON)

{
   "shopIdenty":247900001,
   "ids":[266582035542376448,248921597135188992]
}

响应参数

参数名 类型 是否必填 参数描述
code int 错误码;0:成功;其他详见错误码
message string 错误说明
messageUuid string 消息uuid
result object 返回业务参数 code !=0的情况下不返回业务参数

result

参数名 类型 是否必填 参数描述
shopIdenty Long 门店ID
name String 菜品名称
aliasName String 菜品别名
brandDishId Long 品牌菜ID
id Long 菜品id
dishCode string 菜品编号
uuid String 菜品UUID
type int 菜品类型 : 菜品种类 0:单菜 ,1:套餐,2:加料
unit String 菜品单位(如斤,份,杯,盘…)
saleType int 销售类型:1:称重销售 ,2:非销售称重
upc String 条码
price int 菜品价格(原价,基础价),单位:分
rank int 菜品排序,若商户后台未设置,默认是0
minOrderNum Double 起卖份数,默认1
residueTotal Double 剩余可售数量, 默认0表示无限量
saleTotal Double 每日售卖限额,默认0表示无限量
saleTotalWechat Double 外卖可售数量,默认0表示无限量
boxQty int 餐盒数量,默认1,商户后台可设置
imgUrl string 菜品图片,多图使用英文逗号分隔,像素:640x480
desc String 菜品描述
categorys List<category> 菜品分类,数组,见下category
saleTimes List<saleTimes> 可售时间,可能为组合时间段,见下saleTimes
attrs List<attr> 菜品属性,如规格,口味做法,备注等,见下attr
supplyCondiments supplyCondiments 配料,见supplyCondiments
clearStatus Integer 估清 1-在售,2-售罄

菜品分类:category

参数名 类型 是否必填 参数描述
categoryId Long 菜品分类id
categoryName String 菜品分类名称
rank int 菜品分类排序

可售时间:saleTimes

参数名 类型 是否必填 参数描述
start String 可售卖开始时间
end String 结束时间

菜品属性:attr

参数名 类型 是否必填 参数描述
groupId Long 做法组id
groupName String 做法组名称
id Long 菜品属性ID
type int 属性类型(1-口味做法,2-标签,3-备注,4-规格属性等)
name String 菜品属性
uuid String 菜品属性唯一标识UUID
reprice Int 变价, 单位:分,正数加价,负数减价

配料:supplyCondiments

参数名 类型 是否必填 参数描述
id Long 配料ID
name String 配料名称
marketPrice Long 加价

响应示例(JSON)

{
    "result": [
        {
            "shopIdenty": 810094162,
            "name": "a单规格套餐",
            "aliasName": "",
            "id": 344855050821482496,
            "dishCode": "SKU1456",
            "uuid": "632d0ab81d284d7a8a28baa3d7b6d893",
            "type": 1,
            "unit": "套",
            "unitId": 305716374740448256,
            "saleType": 2,
            "upc": null,
            "clearStatus": 1,
            "price": 12311,
            "rank": 0,
            "minOrderNum": 1.0,
            "residueTotal": 1000.0,
            "saleTotal": 1000.0,
            "boxQty": 1,
            "imgUrl": "https://img-static.keruyun.com/kry-dir/rc-upload-1586414383543-89.jpg?x-oss-process=image/resize,w_640,h_480,https://img-static.keruyun.com/kry-dir/rc-upload-1586414383543-93.jpg?x-oss-process=image/resize,w_640,h_480,https://img-static.keruyun.com/kry-dir/rc-upload-1586414383543-95.jpg?x-oss-process=image/resize,w_640,h_480",
            "desc": "a单规格套餐",
            "categorys": [
                {
                    "categoryId": 344558134170671104,
                    "categoryName": "单规格套餐"
                }
            ],
            "saleTimes": [
                {
                    "start": "00:00:00",
                    "end": "00:00:00"
                }
            ],
            "attrs": [
                {
                    "id": 236114201746463744,
                    "groupId": null,
                    "groupName": null,
                    "type": 2,
                    "name": "TOP",
                    "uuid": "f3d5b59e4ad241c2997ed821f767d2dd",
                    "reprice": 0
                }
            ],
            "dishTaxes": null,
            "brandDishId": 344855050762762240,
            "barcode": null,
            "supplyCondiments": null,
            "saleTotalWechat": 1000.0,
            "dishQty": null,
            "brandDishUuid": "b10e05acd4c4423d8e87da734009fd2b"
        }
    ],
    "code": 0,
    "message": "成功[OK]",
    "messageUuid": "433abbd6253a4a319e65125ed7c74933",
    "apiMessage": null
}
目录