创建订单(不同品牌的商品详情下单的参数会有所不同)

不同品牌（肯德基、麦当劳、星巴克、瑞幸、奈雪、库迪）下单提交参数会有所不同，获取最新示例请前往下面releases页面下载或联系技术对接人员
https://gitee.com/Surr/kfc-order-example-1.2

请求参数

Body 参数application/json

appId

string

appid

必需

entPara

string | null

可选

自定义参数（可以传入自定义id或其他标识，订单详情、回调会包含此参数）

cityId

integer <int32>

城市id

可选

shopId

string <uuid>

店铺id

必需

eatType

enum<integer> <int32>

必需

0:eatin,堂食;

1:takeout,打包;

2:delivery,外卖; 目前外卖产品api对接的方式正在开发当中，上线后另行通知

枚举值:

012

phone

string | null

手机号

可选

remark

string | null

备注

可选

mealTime

integer <int32>

可选

取餐时间:0 0分钟，1 10分钟 2 20分钟 3 30分钟

tableWare

boolean

是否需要餐具

可选

products

array [object {18}]

购买的餐品列表

必需

pId

string | null

可选

产品id（多规格里面的上级产品id，非多规格留空）

productId

string

产品id

必需

linkId

string | null

可选

quantity

integer <int32>

数量

必需

nameCn

string | null

产品名称

可选

imageUrl

string | null

产品图片

可选

priceHead

number <double>

必需

单品建议销售价单品必传

oPrice

number <double>

可选

市场价格（对应店铺菜单数据price）单品和套餐必传

price

number <double>

必需

市场价格（对应店铺菜单数据price）单品必传

selPrice

number <double>

可选

套餐建议售价套餐必传

hasRefund

boolean

可选

refundAmount

number <double>

退款金额

可选

refundCount

number <double>

退款数量

可选

selected

array [object {2}] | null

套餐必传

可选

orderId

string | null

平台订单号

可选

orderSn

string | null

有票订单号

可选

spec

string | null

可选

index

integer <int32>

可选

recAddr

object (RecAddrDto)

外卖订单必传

可选

string <uuid>

可选

userId

string <uuid>

可选

contact

string

联系人

必需

gender

string

性别

必需

phone

string

联系电话

必需

addr

string | null

地址

可选

number

string | null

门牌号

可选

lat

number <double>

维度

必需

lon

number <double>

经度

必需

createTime

string <date-time>

可选

pushUrl

string

可选

回调推送地址（如果有值，订单相关回调我方将推送到这个地址）

示例

//下单示例文档地址：https://gitee.com/Surr/kfc-order-example/releases 有不清楚联系技术对接人员

返回响应

🟢200Success

application/json

code=0为成功，非0为失败，具体错误原因参看message文本描述。
code=96代表对接方预存余额不足，请尽快联系我方对接充值。接口返回提示信息 message=“系统升级中，请稍后再试”，此提示用于隐藏具体原因，以免用户直接看到余额不足的状态；请尽快联系我方对接人员充值，以确保服务恢复正常。

Body

code

integer <int32>

code

可选

message

string | null

message

可选

data

object (KfcOrderResult)

可选

payAmount

number <double>

可选

支付总价注：包含了配送费用

deliveryPrice

number <double>

配送费

可选

orderCustomId

string | null

订单号

可选

orderId

string <uuid>

订单id

可选

payUrl

string | null

支付跳转地址

可选

示例

{
  "code": 0,
  "message": "string",
  "data": {
    "payAmount": 0,
    "deliveryPrice": 0,
    "orderCustomId": "string",
    "orderId": "b3e1eced-f2bd-4d8c-9765-fbc9d1d222d5",
    "payUrl": "string"
  }
}