2.推送外卖订单
### candao.order.pushOrder
>小程序将订单信息提交到餐道
官方文档:[http://open-api.can-dao.com/#/documents?page_code=30-14](http://open-api.can-dao.com/#/documents?page_code=30-14)
#### 注意事项
- 餐品信息无需维护,需传容错字段【==ftType==】
- extOrderId 平台订单id,指的是第三方==自己的订单号==,每次提交订单都需要更变订单id,订单ID不可重复
- longitude与latitude 经纬度,此字段使用的是高德经度,非堂食订单时必传
- fromType 订单来源,第三方提交订单时建议传此字段便于区分订单渠道,订单来源可参见fromType枚举
- orderStatus订单状态,第三方提交订单时应传状态7:商家待接单,可参见枚举类orderStatus
- 当提交的订单业务类型(orderType)为自取时,会区分是即时自取还是预约自取单,若是即时自取单时,则无需传预送达时间-sendTime,若是预约自取单,则需传预送达时间-sendTime。==暂无自取==。
- 此接口为同步返回,会返回==orderId==,**后续接口使用 orderId 或 extOrderId二选一皆可,它们绑定关系,指同一个订单**
### 业务数据
#### 必传字段
- extOrderId:平台订单id,==即我们的订单号==
- ~~extOrderNo:平台订单号,可以与平台订单ID 相同,用平台订单ID~~
- thirdSn: 平台流水号,==即我们取餐号==
- longitude、latitude:==送餐地址经纬度?== 高德坐标,外卖必传。
- storeName(可选):门店名称,我们传入
- subStoreId:供应商侧门店 ID
- name:收货人
- phone:收货人电话
- address:送餐地址
- orderType:业务类型,参见枚举类orderType,==我们为1(外卖)==
- book(可选):是否预约单(1:即时,2:预约,0:不区分,默认),预留,以后用到
- orderTime:下单时间
- fromType(可选):订单来源,可传入微信小程序或支付宝小程序。
- payType:支付类型,==我们传2(在线支付)==;支付类型,1:线下付款 2:在线支付
- orderStatus:订单状态,==固定传7:商家待接单==
- isPayed:是否支付
- isInvoice:是否开票
- isThirdDistribute(可选):供应商必传,传 ==false==
- price:订单支付总金额
- deliveryFee(可选):配送费,这是商户收收餐人的,不是骑手费用。
- mealFee(可选):餐盒费,==即我们打包费==
- discountPrice(可选):优惠金额
- merchantBearPrice(可选):商家承担的优惠金额,传优惠金额
- thirdPlatformBearPrice(可选):第三方平台承担的优惠金额,传0
- agentBearPrice(可选):代理商承担的,传0
- merchantPrice:商家实收金额,==同订单支付总金额==
- originPrice(可选):订单原价,优惠前
- ftType:订单容错类型,不传默认均不支持容错,==【必传】==
- emptyProductId:支持餐品id为0
- productAberrant:支持餐品状态异常
- storeAberrant:支持门店状态异常
- products:餐品集合,对象数组
- pid:餐品 ID,==容错统一传0?==
- name:名称
- num:数量
- price:单价
- boxNum:餐盒数量
- boxPrice:餐盒单价
### 请求示例:
```JSON
{
"data":{
"extOrderId":"71636551195320",
"thirdSn":"001",
"longitude":"117.36068",
"latitude":"32.920284",
"subStoreId":"46489361",
"extStoreName":"两粒米智慧餐饮",
"name":"张女士",
"phone":"13689845346_0843",
"address":"九州家园272号恒顺公寓",
"orderType":1,
"orderTime":"2021-11-10 22:18:45",
"payType":2,
"orderStatus":7,
"isPayed":true,
"isInvoice":false,
"isThirdDistribute":false,
"price":34.5,
"deliveryFee":5,
"mealFee":2.5,
"discountPrice":0,
"merchantBearPrice":0,
"thirdPlatformBearPrice":0,
"merchantPrice":25.07,
"ftType":{
"emptyProductId":true,
"productAberrant":true,
"storeAberrant":true
},
"products":[
{
"pid":"26233377",
"name":"韩式泡菜",
"price":5,
"num":1,
"boxNum":1,
"boxPrice":0.5
},
{
"pid":"26233346",
"name":"招牌特制牛肉饭",
"price":22,
"num":1,
"boxNum":1,
"boxPrice":2
}
]
},
"accessKey":"185a4bd62df35dc8",
"actionName":"candao.order.pushOrder",
"timestamp":1636553925286,
"ticket":"99fcc5af-f6d8-4254-a51a-8833ff964e59",
"sign":"bc63c76869c959f76a8afa415284dbc5",
"serviceType":"pos",
"vendor":""
}
```
### 返回示例
```JSON
{
"status": 1,
"msg": "操作成功",
"logId": "215c113d-ef05-f57d-deba-9859-f931a984",
"data": {
"orderId": "78768885"
},
"serverTime": 1636554134021,
"ticket": "99fcc5af-f6d8-4254-a51a-8833ff964e59"
}
```
返回示例,重复订单
```JSON
{
"status": 6,
"msg": "重复订单",
"logId": "a197274f-f56f-a2de-208f-23a9-3c90b563",
"data": {
"orderId": "78768885"
},
"serverTime": 1636554366802,
"ticket": "99fcc5af-f6d8-4254-a51a-8833ff964e59"
}
```