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" } ```