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

菜品分类查询收费

(下行接口)合作方调用此接口,根据菜品分类id获取菜品列表

授权方式:门店授权

请求描述

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

请求参数

1.公共参数

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

2.业务参数

参数名 类型 是否必填 参数描述
dishTypeId long 菜品分类Id(可通过菜品分类信息查询接口获取)

业务示例(JSON)

{
   "dishTypeId":261813213542561792
}

响应参数

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

DishList

参数名 类型 是否必填 参数描述
dishList List<DishListVo> 菜品列表

DishListVo

参数名 类型 是否必填 参数描述
aliasName String 菜品别名
boxQty Integer 餐盒数量,若商户后台未设置,默认为1
brandDishId Long 品牌菜品id
clearStatus Integer 估清 : 1:在售 ,2:卖光
currRemainTotal Long 当前可售数量,NULL代表没有限制
dishDesc String 菜品描述
dishIncreaseUnit BigDecimal 起卖份数
dishQty BigDecimal 菜品数量
dishCode string 菜品编号
dishTypeId Long 菜品分类id
id Long 菜品id
marketPrice BigDecimal 原价
name String 菜品名称
residueTotal BigDecimal 剩余数量
residueTotalWechat BigDecimal 外卖剩余数量
richDesc String 菜品详情描述
saleTotal Integer 每日售卖总数
saleTotalWechat Integer 外卖可售数量
saleType Integer 销售类型 : 1 称重销售,2 非称重销售
stepNum BigDecimal 增量设置
type Integer 菜品类型 : 菜品种类 0:单菜 1:套餐 2:加料
unitId Long 单位id
unitName String 单位名称
videoUrl String 视频地址
dishSetmealGroups List<DishSetmealGroupVo> 套餐分组信息
dishIngredientInfoVo List<DishIngredientInfoVo> 加料信息
dishPropertyTypeInfos List<DishPropertyTypeInfoVo> 做法,菜品属性信息
largeImgList List<String> 大图
smallImgUrls List<String> 小图
productId Long 通过此字段判断菜品是否属于同一个spu
enabledFlag Integer 上下架标示 1:启用;2:停用

DishSetmealGroupVo

参数名 类型 是否必填 参数描述
id Long 套餐分组id
orderMax BigDecimal 最多选几份
orderMin BigDecimal 最少选几份
sort Integer 排序
dishSetmealGroupChildInfos List<DishSetmealGroupChildInfoVo> 子菜信息

DishSetmealGroupChildInfoVo

参数名 类型 是否必填 参数描述
id Long 门店菜id
boxQty Integer 餐盒数量
brandDishId Long 品牌菜ID
clearStatus Integer 估清 : 1:在售 ,2:卖光
dishQty BigDecimal 菜品数量
isDefault Integer 是否默认 : 是否默认 1 是 2否
isMulti Integer 单位是否复选 : 是否复选 1是 2否
isReplace Integer 是否必选 : 1必点,2选点
leastCellNum BigDecimal 起卖份数
marketPrice BigDecimal 原价
price BigDecimal 变价
name String 菜品名称
residueTotal BigDecimal 剩余数量
residueTotalWechat BigDecimal 外卖剩余数量
saleTotal BigDecimal 每日售卖总数
saleTotalWechat BigDecimal 外卖可售数量
saleType Integer 销售类型 : 1 称重销售,2 非称重销售
sort Integer 排序
unitName String 单位名称
uuid String 菜品UUID
dishIngredientInfoVo List<DishIngredientInfoVo> 加料信息
dishPropertyTypeInfos List<DishPropertyTypeInfoVo> 做法,菜品属性信息
imageUrls List<String> 图片

DishIngredientInfoVo

参数名 类型 是否必填 参数描述
id Long 门店菜id
name String 加料名称
sort Integer 排序

DishPropertyTypeInfoVo

参数名 类型 是否必填 参数描述
id Long 属性类型id
dishBrandId Long 品牌菜id
name String 属性类别名称
properties List<DishPropertyVo> 属性
type Integer 属性类型 : 1:口味,做法 4:菜品属性

DishPropertyVo

参数名 类型 是否必填 参数描述
id Long 属性id
name String 属性名称
reprice BigDecimal 属性变价
sort Integer 排序

响应示例(JSON)

{
    "result": {
        "dishList": [
            {
                "aliasName": "",
                "boxQty": 1,
                "brandDishId": 344855050762762240,
                "clearStatus": 1,
                "currRemainTotal": null,
                "dishDesc": "a单规格套餐",
                "dishIncreaseUnit": 1.00,
                "dishQty": 1.000,
                "dishTypeId": 344558134170671104,
                "productId": null,
                "id": 344855050821482496,
                "marketPrice": 123.11,
                "name": "a单规格套餐",
                "residueTotal": 1000.00,
                "residueTotalWechat": 1000.00,
                "richDesc": null,
                "uuid": "632d0ab81d284d7a8a28baa3d7b6d893",
                "saleTotal": 1000.00,
                "saleTotalWechat": 1000.00,
                "saleType": 2,
                "stepNum": 1.00,
                "type": 1,
                "unitId": 305716374740448256,
                "unitName": "套",
                "videoUrl": "",
                "dishSetmealGroups": [
                    {
                        "dishSetmealGroupChildInfos": [
                            {
                                "boxQty": 1,
                                "brandDishId": 344853255009253376,
                                "clearStatus": 1,
                                "dishQty": 1.000,
                                "id": 344853255109916672,
                                "isDefault": 2,
                                "isMulti": 1,
                                "isReplace": 2,
                                "leastCellNum": 120.00,
                                "marketPrice": 4.00,
                                "name": "b单规格有起卖份数-称重",
                                "residueTotal": 1000.00,
                                "residueTotalWechat": 1000.00,
                                "saleTotal": 1000.00,
                                "saleTotalWechat": 1000.00,
                                "saleType": 2,
                                "sort": 0,
                                "unitName": "套",
                                "dishIngredientInfoVo": null,
                                "dishPropertyTypeInfos": [],
                                "imageUrls": null,
                                "price": 0.00
                            },
                            {
                                "boxQty": 1,
                                "brandDishId": 344853255009253377,
                                "clearStatus": 1,
                                "dishQty": 1.000,
                                "id": 344853255109916673,
                                "isDefault": 2,
                                "isMulti": 1,
                                "isReplace": 1,
                                "leastCellNum": 0.11,
                                "marketPrice": 2.00,
                                "name": "b单规格有菜品图片",
                                "residueTotal": 1000.00,
                                "residueTotalWechat": 1000.00,
                                "saleTotal": 1000.00,
                                "saleTotalWechat": 1000.00,
                                "saleType": 2,
                                "sort": 0,
                                "unitName": "套",
                                "dishIngredientInfoVo": null,
                                "dishPropertyTypeInfos": [],
                                "imageUrls": null,
                                "price": 0.00
                            },
                            {
                                "boxQty": 1,
                                "brandDishId": 344853255009253378,
                                "clearStatus": 1,
                                "dishQty": 1.000,
                                "id": 344853255109916674,
                                "isDefault": 2,
                                "isMulti": 1,
                                "isReplace": 1,
                                "leastCellNum": 14.00,
                                "marketPrice": 5.00,
                                "name": "b单规格有菜品描述",
                                "residueTotal": 1000.00,
                                "residueTotalWechat": 1000.00,
                                "saleTotal": 1000.00,
                                "saleTotalWechat": 1000.00,
                                "saleType": 2,
                                "sort": 0,
                                "unitName": "套",
                                "dishIngredientInfoVo": null,
                                "dishPropertyTypeInfos": [],
                                "imageUrls": null,
                                "price": 0.00
                            },
                            {
                                "boxQty": 1,
                                "brandDishId": 344853255009253379,
                                "clearStatus": 1,
                                "dishQty": 1.000,
                                "id": 344853255109916675,
                                "isDefault": 2,
                                "isMulti": 1,
                                "isReplace": 2,
                                "leastCellNum": 120.00,
                                "marketPrice": 3.51,
                                "name": "b单规格有起卖份数-非称重",
                                "residueTotal": 1000.00,
                                "residueTotalWechat": 1000.00,
                                "saleTotal": 1000.00,
                                "saleTotalWechat": 1000.00,
                                "saleType": 2,
                                "sort": 0,
                                "unitName": "套",
                                "dishIngredientInfoVo": null,
                                "dishPropertyTypeInfos": [],
                                "imageUrls": null,
                                "price": 0.00
                            },
                            {
                                "boxQty": 1,
                                "brandDishId": 344853255009253380,
                                "clearStatus": 1,
                                "dishQty": 1.000,
                                "id": 344853255109916676,
                                "isDefault": 2,
                                "isMulti": 1,
                                "isReplace": 2,
                                "leastCellNum": 120.00,
                                "marketPrice": 1.00,
                                "name": "b单规格商品",
                                "residueTotal": 1000.00,
                                "residueTotalWechat": 1000.00,
                                "saleTotal": 1000.00,
                                "saleTotalWechat": 1000.00,
                                "saleType": 2,
                                "sort": 0,
                                "unitName": "套",
                                "dishIngredientInfoVo": null,
                                "dishPropertyTypeInfos": [],
                                "imageUrls": null,
                                "price": 0.00
                            }
                        ],
                        "id": 344855050905368576,
                        "name": "1",
                        "orderMax": 15.00,
                        "orderMin": 0.00,
                        "sort": 0
                    },
                    {
                        "dishSetmealGroupChildInfos": [
                            {
                                "boxQty": 1,
                                "brandDishId": 344853255009253376,
                                "clearStatus": 1,
                                "dishQty": 1.000,
                                "id": 344853255109916672,
                                "isDefault": 2,
                                "isMulti": 1,
                                "isReplace": 1,
                                "leastCellNum": 1.00,
                                "marketPrice": 4.00,
                                "name": "b单规格有起卖份数-称重",
                                "residueTotal": 1000.00,
                                "residueTotalWechat": 1000.00,
                                "saleTotal": 1000.00,
                                "saleTotalWechat": 1000.00,
                                "saleType": 2,
                                "sort": 0,
                                "unitName": "套",
                                "dishIngredientInfoVo": null,
                                "dishPropertyTypeInfos": [],
                                "imageUrls": null,
                                "price": 0.00
                            },
                            {
                                "boxQty": 1,
                                "brandDishId": 344853255009253377,
                                "clearStatus": 1,
                                "dishQty": 1.000,
                                "id": 344853255109916673,
                                "isDefault": 2,
                                "isMulti": 1,
                                "isReplace": 2,
                                "leastCellNum": 1.00,
                                "marketPrice": 2.00,
                                "name": "b单规格有菜品图片",
                                "residueTotal": 1000.00,
                                "residueTotalWechat": 1000.00,
                                "saleTotal": 1000.00,
                                "saleTotalWechat": 1000.00,
                                "saleType": 2,
                                "sort": 0,
                                "unitName": "套",
                                "dishIngredientInfoVo": null,
                                "dishPropertyTypeInfos": [],
                                "imageUrls": null,
                                "price": 0.00
                            },
                            {
                                "boxQty": 1,
                                "brandDishId": 344853255009253378,
                                "clearStatus": 1,
                                "dishQty": 1.000,
                                "id": 344853255109916674,
                                "isDefault": 2,
                                "isMulti": 1,
                                "isReplace": 2,
                                "leastCellNum": 1.00,
                                "marketPrice": 5.00,
                                "name": "b单规格有菜品描述",
                                "residueTotal": 1000.00,
                                "residueTotalWechat": 1000.00,
                                "saleTotal": 1000.00,
                                "saleTotalWechat": 1000.00,
                                "saleType": 2,
                                "sort": 0,
                                "unitName": "套",
                                "dishIngredientInfoVo": null,
                                "dishPropertyTypeInfos": [],
                                "imageUrls": null,
                                "price": 0.00
                            },
                            {
                                "boxQty": 1,
                                "brandDishId": 344853255009253379,
                                "clearStatus": 1,
                                "dishQty": 1.000,
                                "id": 344853255109916675,
                                "isDefault": 2,
                                "isMulti": 1,
                                "isReplace": 2,
                                "leastCellNum": 1.00,
                                "marketPrice": 3.51,
                                "name": "b单规格有起卖份数-非称重",
                                "residueTotal": 1000.00,
                                "residueTotalWechat": 1000.00,
                                "saleTotal": 1000.00,
                                "saleTotalWechat": 1000.00,
                                "saleType": 2,
                                "sort": 0,
                                "unitName": "套",
                                "dishIngredientInfoVo": null,
                                "dishPropertyTypeInfos": [],
                                "imageUrls": null,
                                "price": 0.00
                            },
                            {
                                "boxQty": 1,
                                "brandDishId": 344853255009253380,
                                "clearStatus": 1,
                                "dishQty": 1.000,
                                "id": 344853255109916676,
                                "isDefault": 2,
                                "isMulti": 1,
                                "isReplace": 2,
                                "leastCellNum": 1.00,
                                "marketPrice": 1.00,
                                "name": "b单规格商品",
                                "residueTotal": 1000.00,
                                "residueTotalWechat": 1000.00,
                                "saleTotal": 1000.00,
                                "saleTotalWechat": 1000.00,
                                "saleType": 2,
                                "sort": 0,
                                "unitName": "套",
                                "dishIngredientInfoVo": null,
                                "dishPropertyTypeInfos": [],
                                "imageUrls": null,
                                "price": 0.00
                            }
                        ],
                        "id": 344855050905368577,
                        "name": "2",
                        "orderMax": 1.00,
                        "orderMin": 0.00,
                        "sort": 1
                    }
                ],
                "dishIngredientInfoVo": null,
                "dishPropertyTypeInfos": [],
                "largeImgList": [
                    "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"
                ],
                "smallImgUrls": [
                    "https://img-static.keruyun.com/kry-dir/rc-upload-1586414383543-89.jpg?x-oss-process=image/resize,w_180,h_135",
                    "https://img-static.keruyun.com/kry-dir/rc-upload-1586414383543-93.jpg?x-oss-process=image/resize,w_180,h_135",
                    "https://img-static.keruyun.com/kry-dir/rc-upload-1586414383543-95.jpg?x-oss-process=image/resize,w_180,h_135"
                ],
                "enabledFlag": 1,
                "statusFlag": 1,
                "guaranteeDate": null,
                "guaranteeDateType": null,
                "dishCode": "SKU1456"
            },
            {
                "aliasName": "",
                "boxQty": 1,
                "brandDishId": 355728750365288448,
                "clearStatus": 1,
                "currRemainTotal": null,
                "dishDesc": "",
                "dishIncreaseUnit": 1.00,
                "dishQty": 1.000,
                "dishTypeId": 344558134170671104,
                "productId": null,
                "id": 355728792601929728,
                "marketPrice": 20.00,
                "name": "烧鹅套餐",
                "residueTotal": 1000.00,
                "residueTotalWechat": 1000.00,
                "richDesc": null,
                "uuid": "e3021a521ac74d008a9757d01b73bc6c",
                "saleTotal": 1000.00,
                "saleTotalWechat": 1000.00,
                "saleType": 2,
                "stepNum": 1.00,
                "type": 1,
                "unitId": 37930747935351808,
                "unitName": "份",
                "videoUrl": "",
                "dishSetmealGroups": [
                    {
                        "dishSetmealGroupChildInfos": [
                            {
                                "boxQty": 1,
                                "brandDishId": 218063411072732160,
                                "clearStatus": 1,
                                "dishQty": 1.000,
                                "id": 218063455586880512,
                                "isDefault": 1,
                                "isMulti": 1,
                                "isReplace": 2,
                                "leastCellNum": 1.00,
                                "marketPrice": 0.12,
                                "name": "满满鲜奶茶",
                                "residueTotal": -299.00,
                                "residueTotalWechat": 400.00,
                                "saleTotal": 1000.00,
                                "saleTotalWechat": 400.00,
                                "saleType": 2,
                                "sort": 1,
                                "unitName": "份",
                                "dishIngredientInfoVo": null,
                                "dishPropertyTypeInfos": [
                                    {
                                        "dishBrandId": 218063411072732160,
                                        "id": 123800111624990720,
                                        "name": "甜度",
                                        "properties": [
                                            {
                                                "id": 123800944504713216,
                                                "isChecked": 2,
                                                "name": "无糖",
                                                "reprice": 1.00,
                                                "sort": 0
                                            },
                                            {
                                                "id": 123800237852569600,
                                                "isChecked": 2,
                                                "name": "少糖",
                                                "reprice": 0.00,
                                                "sort": 0
                                            },
                                            {
                                                "id": 123800185813839872,
                                                "isChecked": 2,
                                                "name": "常规糖",
                                                "reprice": 0.00,
                                                "sort": 0
                                            },
                                            {
                                                "id": 123800780016693248,
                                                "isChecked": 2,
                                                "name": "半糖",
                                                "reprice": 0.00,
                                                "sort": 0
                                            }
                                        ],
                                        "type": 1
                                    },
                                    {
                                        "dishBrandId": 218063411072732160,
                                        "id": 284377835830688768,
                                        "name": "做法测试",
                                        "properties": [
                                            {
                                                "id": 284378071001119744,
                                                "isChecked": 2,
                                                "name": "小杯+奶盖",
                                                "reprice": 0.00,
                                                "sort": 0
                                            },
                                            {
                                                "id": 284377939648101376,
                                                "isChecked": 2,
                                                "name": "大杯",
                                                "reprice": 2.00,
                                                "sort": 0
                                            }
                                        ],
                                        "type": 1
                                    }
                                ],
                                "imageUrls": null,
                                "price": 1.00
                            },
                            {
                                "boxQty": 1,
                                "brandDishId": 222748246185872384,
                                "clearStatus": 1,
                                "dishQty": 1.000,
                                "id": 298129153307613184,
                                "isDefault": 1,
                                "isMulti": 1,
                                "isReplace": 2,
                                "leastCellNum": 1.00,
                                "marketPrice": 0.01,
                                "name": "芝芝莓莓",
                                "residueTotal": 997.00,
                                "residueTotalWechat": 1000.00,
                                "saleTotal": 1000.00,
                                "saleTotalWechat": 1000.00,
                                "saleType": 2,
                                "sort": 2,
                                "unitName": "份",
                                "dishIngredientInfoVo": null,
                                "dishPropertyTypeInfos": [
                                    {
                                        "dishBrandId": 222748246185872384,
                                        "id": 218048691808766976,
                                        "name": "冷热",
                                        "properties": [
                                            {
                                                "id": 218063158126840832,
                                                "isChecked": null,
                                                "name": "热",
                                                "reprice": 0.00,
                                                "sort": 0
                                            }
                                        ],
                                        "type": 1
                                    }
                                ],
                                "imageUrls": null,
                                "price": 0.00
                            },
                            {
                                "boxQty": 1,
                                "brandDishId": 313361766228304896,
                                "clearStatus": 1,
                                "dishQty": 1.000,
                                "id": 313361766576432128,
                                "isDefault": 2,
                                "isMulti": 1,
                                "isReplace": 2,
                                "leastCellNum": 1.00,
                                "marketPrice": 0.01,
                                "name": "踩踩003",
                                "residueTotal": 52.00,
                                "residueTotalWechat": 1000.00,
                                "saleTotal": 1000.00,
                                "saleTotalWechat": 1000.00,
                                "saleType": 2,
                                "sort": 0,
                                "unitName": "份",
                                "dishIngredientInfoVo": null,
                                "dishPropertyTypeInfos": [],
                                "imageUrls": null,
                                "price": 0.00
                            },
                            {
                                "boxQty": 1,
                                "brandDishId": 313720933401080832,
                                "clearStatus": 1,
                                "dishQty": 1.000,
                                "id": 313720933661127680,
                                "isDefault": 2,
                                "isMulti": 1,
                                "isReplace": 2,
                                "leastCellNum": 1.00,
                                "marketPrice": 20.00,
                                "name": "商品0316001",
                                "residueTotal": 1000.00,
                                "residueTotalWechat": 1000.00,
                                "saleTotal": 1000.00,
                                "saleTotalWechat": 1000.00,
                                "saleType": 2,
                                "sort": 0,
                                "unitName": "份",
                                "dishIngredientInfoVo": null,
                                "dishPropertyTypeInfos": [],
                                "imageUrls": null,
                                "price": 0.00
                            }
                        ],
                        "id": 355728750390454272,
                        "name": "默认分组",
                        "orderMax": 6.00,
                        "orderMin": 0.00,
                        "sort": 0
                    }
                ],
                "dishIngredientInfoVo": null,
                "dishPropertyTypeInfos": [],
                "largeImgList": null,
                "smallImgUrls": null,
                "enabledFlag": 1,
                "statusFlag": 1,
                "guaranteeDate": null,
                "guaranteeDateType": null,
                "dishCode": "SKU1647"
            }
        ]
    },
    "code": 0,
    "message": "成功[OK]",
    "messageUuid": "88d87f8da5e640bfa45893f6c8698bd8",
    "apiMessage": "成功[OK]"
}
目录