开放平台
  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
Kfc

请求参数

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>
归属企业用户父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 
退款时间
可选
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 
可选
取餐二维码的值，多个用空格分开
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,肯德基;

2:MDL,麦当劳;

4:XBK,星巴克;

8:NXDC,奈雪的茶;

16:RXKF,瑞幸咖啡;

32:XC,喜茶;

64:KD,库迪;
枚举值:
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",
    "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",
    "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"
    }
  }
}
上一页
订单列表
下一页
订单上传文件列表
Built with