开放平台
  1. 点餐接口
开放平台
  • App/H5对接流程：
  • API开放接口对接流程
  • 小程序对接流程v1.1
  • 数据推送说明
  • 基础信息
    • 获取接口访问令牌
      POST
    • 更改密码
      POST
    • 企业用户信息 v1.1
      GET
    • 获取会员token
      POST
  • 电影票接口
    • 电影票回调通知
    • 获取城市列表
      GET
    • 热映电影（pageIndex从0开始）
      GET
    • 即将上映电影
      GET
    • 获取影院列表
      GET
    • 获取影院过滤列表(获取城市影院品牌和区域信息)
      GET
    • 获取电影的影院列表
      GET
    • 获取电影详情
      GET
    • 获取影院某个电影的排片列表
      GET
    • 获取电影场次（座位）详情
      GET
    • 创建订单
      POST
    • 订单简要信息(字段较简洁，用于发起订单支付)
      GET
    • 支付订单(用户付款成功后调用)
      GET
    • 订单列表(管理)
      POST
    • 订单详情
      GET
    • 返回所有电影
      GET
    • 获取广告列表
      GET
  • 卡券接口
    • GiftCard
      • 卡券商品分类列表
      • 卡券商品列表
      • 商品详情
      • 下单(自己做产品展示，才需要下单接口)
      • 订单支付通知
      • 订单列表
      • 订单详情
      • 卡券商品按类别列表(共二级分类)
  • 点餐接口
    • 点餐回调通知
    • 城市列表
      GET
    • 平台店铺列表
      GET
    • 店铺详情，如果传了经纬度，返回距离
      GET
    • 菜单
      GET
    • 商品详情(不同品牌商品详情会有所不同)
      GET
    • 创建订单(不同品牌的商品详情下单的参数会有所不同)
      POST
    • 订单支付通知(用户付款成功后调用)
      GET
    • 订单列表
      POST
    • 订单详情
      GET
    • 订单上传文件列表
      GET
  1. 点餐接口

订单详情

GET
/api/kfc/order_detail

请求参数

Query 参数
id
string 
订单ID
必需

返回响应

🟢200Success
application/json
Body
code
integer <int32>
code
可选
message
string  | null 
message
可选
data
object (KfcOrderChannelDto) 
可选
id
string <uuid>
可选
epUserId
string <uuid>
归属企业用户id
可选
epParentId
string <uuid> | null 
归属企业用户父id
可选
userId
string <uuid>
用户ID
可选
shopId
string <uuid>
店铺ID
可选
shopCode
string  | null 
店铺code
可选
shopName
string  | null 
店铺
可选
cityId
integer <int32>
城市id
可选
cityName
string  | null 
城市名称
可选
platformCityId
string  | null 
平台城市id
可选
orderName
string  | null 
订单名称
可选
eatType
enum<integer> <int32>
可选

0:eatin,堂食;

1:takeout,打包;

2:delivery,外卖; 目前外卖产品api对接的方式正在开发当中，上线后另行通知
枚举值:
012
eatTypeName
string  | null 
只读可选
orderSign
string  | null 
订单签名
可选
userMobile
string  | null 
用户手机
可选
userName
string  | null 
用户姓名
可选
avatarUrl
string  | null 
用户头像
可选
productsInfo
string  | null 
可选
产品信息（json字符串，对应下单提交的products数据，使用字段与refundProducts一致）
refundProducts
array[object (KfcOrderProduct) {19}]  | null 
可选
退款产品（如退款订单此字段为空，则退款信息在productsInfo）
remark
string  | null 
备注
可选
originPrice
number <double>
订单原价（市场价）
可选
totalDistributionPrice
number <double>
可选
分销商总价（非分销模式为0）
epParentCommission
number <double>
可选
上级代理佣金（无上级代理为0）
epCommission
number <double>
本订单佣金
可选
refundAmount
number <double>
退款金额
可选
refundTime
string <date-time> | null 
退款时间
可选
totalEpPrice
string 
企业总价
必需
epRefundAmount
string 
企业退款总额
必需
imageUrl
string  | null 
图片地址
可选
info
string  | null 
订单说明
可选
totalUserPrice
number <double>
可选
订单用户总价（以建议销售价计算）
epCostPrice
number 
必需
企业成本（结算价格）
costMode
string 
必需
企业成本模式 ：浮动模式0，固定模式1
orderState
enum<integer> <int32>
可选

0:ReadyToPay,等待支付;

1:Paid,订单已付;

2:WaitCode,等待出码;

3:Success,订单成功;

4:Failed,订单失败;

5:Canceled,订单取消;

6:Refunded,订单退款;

7:NopayCancel,未付取消;

8:PartRefunded,订单成功(部分退款);

9:Locked,订单锁定;

10:WaitCustomer,客服处理中;

11:WaitDelivery,等待配送;

12:Deliverying,配送中;

13:WaitKfc,正在出餐;
枚举值:
012345678910111213
orderStateName
string  | null 
订单状态
只读可选
createTime
string <date-time>
创建时间
可选
updateTime
string <date-time> | null 
更新时间
可选
paidTime
string <date-time> | null 
支付时间
可选
successTime
string <date-time> | null 
订单成功时间
可选
platformOrderId
string  | null 
平台订单ID
可选
codes
string  | null 
可选
取餐码，多个用空格分开，如(A3301 A3302)
qrCodes
string  | null 
可选
取餐二维码的值，多个用空格分开
takeFoodMobile
string 
取餐手机号
必需
payType
integer <int32>
支付方式
可选
isChannelPay
boolean 
是否渠道收款
可选
orderPayId
string  | null 
外部平台支付凭证号
可选
payTranId
string  | null 
外部平台支付流水号
可选
orderCustomId
string  | null 
数字格式订单号
可选
appId
string  | null 
所属APPId
可选
payAppId
string  | null 
支付APPId
可选
count
integer <int32>
可选
购买数量（这个是订单明细的数量，不是商品的数量）
address
string  | null 
门店地址
可选
lat
number <double>
Lat
可选
lon
number <double>
Lon
可选
recAddress
string  | null 
外卖配送地址
可选
pushUrl
string  | null 
可选
entPara
string  | null 
可选
自定义参数（创建订单接口传入，这里原样返回）
entUserId
string  | null 
可选
payUrl
string  | null 
可选
epUserName
string  | null 
可选
mealTime
integer <int32>
可选
取餐时间:0 0分钟，1 10分钟 2 20分钟 3 30分钟
tableWare
boolean 
是否需要餐具
可选
offsetPrice
number <double>
可选
waitTime
integer <int32> | null 
等待时间(分钟)
可选
queueSize
integer <int32> | null 
等待单数
可选
supplierId
string <uuid> | null 
供应商Id
可选
biddingEndTime
string <date-time> | null 
竞价截止时间
可选
biddingCount
integer <int32>
竞价次数
可选
orderType
enum<integer> <int32>
可选
点餐订单类型

1:Kfc,K记;

2:MDL,麦记;

4:XBK,星爸爸;

8:NXDC,奈雪的茶;

16:RXKF,瑞辛;

32:XC,喜小茶;

64:KD,酷迪;

16384:BSK,披萨客
枚举值:
1248163264128
orderTypeName
string  | null 
订单类型
只读可选
mode
integer <int32>
可选
订单模式 0自动 1人工
supplierRemark
string  | null 
供应商备注
可选
supplierName
string  | null 
昵称
可选
supplierAvatarUrl
string  | null 
头像地址
可选
makeMealSeconds
integer 
可选
出餐时间（单位：秒）
deliveryPrice
number <double>
可选
外卖配送费用（totalUserPrice总价已经包含此金额）
courierLocationH5
string 
可选
外卖订单骑手位置（H5页面URL）
recAddr
object (RecAddr) 
外卖订单收货地址
必需
示例
{
    "code": 0,
    "message": "string",
    "data": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "epUserId": "f6922f56-2635-4dc5-9821-536548cc4172",
        "epParentId": "c45a9505-bd3e-4c6a-becf-eae1056d362d",
        "userId": "2c4a230c-5085-4924-a3e1-25fb4fc5965b",
        "shopId": "70542939-296f-4335-b0b1-f4e5a2513ef7",
        "shopCode": "string",
        "shopName": "string",
        "cityId": 0,
        "cityName": "string",
        "platformCityId": "string",
        "orderName": "string",
        "eatType": 0,
        "eatTypeName": "string",
        "orderSign": "string",
        "userMobile": "string",
        "userName": "string",
        "avatarUrl": "string",
        "productsInfo": "string",
        "refundProducts": [
            {
                "pId": "string",
                "productId": "string",
                "linkId": "string",
                "quantity": 0,
                "nameCn": "string",
                "imageUrl": "string",
                "selPrice": 0,
                "orgPrice": 0,
                "settlePrice": 0,
                "channelPrice": 0,
                "ChannelCostMode": 0,
                "hasRefund": true,
                "refundAmount": 0,
                "refundCount": 0,
                "selected": [
                    {
                        "round": 0,
                        "products": [
                            {
                                "productId": "string",
                                "linkId": "string",
                                "quantity": 0
                            }
                        ]
                    }
                ],
                "orderId": "string",
                "orderSn": "string",
                "spec": "string",
                "index": 0
            }
        ],
        "remark": "string",
        "originPrice": 0,
        "totalDistributionPrice": 0,
        "epParentCommission": 0,
        "epCommission": 0,
        "refundAmount": 0,
        "refundTime": "2019-08-24T14:15:22Z",
        "totalEpPrice": "string",
        "epRefundAmount": "string",
        "imageUrl": "string",
        "info": "string",
        "totalUserPrice": 0,
        "epCostPrice": 0,
        "costMode": "string",
        "orderState": 0,
        "orderStateName": "string",
        "createTime": "2019-08-24T14:15:22Z",
        "updateTime": "2019-08-24T14:15:22Z",
        "paidTime": "2019-08-24T14:15:22Z",
        "successTime": "2019-08-24T14:15:22Z",
        "platformOrderId": "string",
        "codes": "string",
        "qrCodes": "string",
        "takeFoodMobile": "string",
        "payType": 0,
        "isChannelPay": true,
        "orderPayId": "string",
        "payTranId": "string",
        "orderCustomId": "string",
        "appId": "string",
        "payAppId": "string",
        "count": 0,
        "address": "string",
        "lat": 0,
        "lon": 0,
        "recAddress": "string",
        "pushUrl": "string",
        "entPara": "string",
        "entUserId": "string",
        "payUrl": "string",
        "epUserName": "string",
        "mealTime": 0,
        "tableWare": true,
        "offsetPrice": 0,
        "waitTime": 0,
        "queueSize": 0,
        "supplierId": "e01eb4c4-8eb9-4fb7-b625-61f58c6148db",
        "biddingEndTime": "2019-08-24T14:15:22Z",
        "biddingCount": 0,
        "orderType": 1,
        "orderTypeName": "string",
        "mode": 0,
        "supplierRemark": "string",
        "supplierName": "string",
        "supplierAvatarUrl": "string",
        "makeMealSeconds": 0,
        "deliveryPrice": 0,
        "courierLocationH5": "string",
        "recAddr": {
            "orderId": "string",
            "userId": "string",
            "contact": "string",
            "gender": "string",
            "phone": "string",
            "addr": "string",
            "number": "string",
            "lat": 0,
            "lon": 0,
            "createTime": "string",
            "id": "string"
        }
    }
}
修改于 2024-12-17 03:00:09
上一页
订单列表
下一页
订单上传文件列表
Built with