## 预下配送单 ### 使用场景: * 1、在用户提交外卖订单时,商家可调用本接口查询配送公司是否可接单、预计多久接单、运费预估等.预估运费可作为展示给用户的运费参考值. * 2、举个例子:商家通过预下配送单接口返回的预估运费是8元,商家可决定前端顾客下外卖单时展示给顾客看的运费是真实的8元,还是其他商家指定的金额. * 3、说明:本接口非必须调用接口,若不需要获取配送公司是否可接单、预计多久接单、运费预估等,也可不调用本接口,直接下配送单. * 4、顺丰同城可返回配送费用、配送距离、预计骑手接单时间,不支持返回delivery_token. * 5、闪送可返回配送费用、配送距离、预计骑手接单时间,不支持返回delivery_token. * 6、美团配送返回0时表示校验通过,不支持返回配送费用、配送距离、预计骑手接单时间和delivery_token. * 7、达达支持预下单查询配送费用、配送距离、预计骑手接单时间和delivery_token(有效期3分钟) ~~~[api] post:/api/customer/order/businessOrderPreAdd *string:token=默认值#顾客端登录令牌 *storeId#系统门店id *shopNo#商家门店编号,在配送公司登记,美团、闪送必填 *deliveryId#配送公司ID *openId#下单用户的openid *senderName#发件人信息姓名,最长不超过256个字符 *senderCity#发件人信息城市名称,如广州市 *senderAddress#发件人信息地址(街道、小区、大厦等,用于定位) *senderAddressDetail#发件人信息地址详情(楼号、单元号、层号) *senderPhone#发件人信息电话/手机号,最长不超过64个字符 *senderLng#发件人信息经度(火星坐标或百度坐标,和coordinateType字段配合使用,精确到小数点后6位) *senderLat#发件人信息纬度 *receiverName#收件人姓名,最长不超过256个字符 *receiverCity#收件人城市名称,如广州市 *receiverAddress#收件人地址(街道、小区、大厦等,用于定位) *receiverAddressDetail#收件人地址详情(楼号、单元号、层号) *receiverPhone#收件人电话/手机号,最长不超过64个字符 *receiverLng#收件人经度(火星坐标或百度坐标,和 coordinateType 字段配合使用,确到小数点后6位 *receiverLat#收件人纬度 *goodsValue#货物价格,单位为元,精确到小数点后两位(如果小数点后位数多于两位,则四舍五入保留两位小数),范围为(0-5000] *goodsWeight#货物重量,单位为kg,精确到小数点后两位(如果小数点后位数多于两位,则四舍五入保留两位小数),范围为(0-50] *cargoFirstClass#品类一级类目 *cargoSecondClass#品类二级类目 *wxaPath#商家小程序的路径,建议为订单页面 *imgUrl#商品缩略图url *goodsName#商品名称 *goodsCount#商品数量 appKey#商家id,由配送公司分配的appkey appSecret#用配送公司提供的appSecret加密的校验串 coordinateType=0#发件人信息坐标类型,0-火星坐标(高德,腾讯地图均采用火星坐标);1-百度坐标 goodsHeight#货物高度,单位为cm,精确到小数点后两位(如果小数点后位数多于两位,则四舍五入保留两位小数),范围为(0-45] goodsLength#货物长度,单位为cm,精确到小数点后两位(如果小数点后位数多于两位,则四舍五入保留两位小数),范围为(0-65] goodsWidth#货物宽度,单位为cm,精确到小数点后两位(如果小数点后位数多于两位,则四舍五入保留两位小数),范围为(0-50] goodsDetailArr=[]#货物详情,最长不超过10240个字符,多个['good_count'=>$good_count,//货物数量'good_name'=>$good_name,//货品名称'good_price'=>$good_price,//否,货品单价,精确到小数点后两位(如果小数点后位数多于两位,则四舍五入保留两位小数)'good_unit'=>$good_unit,//否,货品单位,最长不超过20个字符]用,连接 goodsPickupInfo#货物取货信息,用于骑手到店取货,最长不超过100个字符 goodsDeliveryInfo#货物交付信息,最长不超过100个字符 deliveryServiceCode#配送服务代码,不同配送公司自定义,顺丰和达达不填 orderType=0#订单类型:0-即时单;1-预约单,如预约单,需要设置expectedDeliveryTime或expectedFinishTime或expectedPickTime expectedDeliveryTime=0#期望派单时间(美团、达达支持,美团表示商家发单时间,达达表示系统调度时间,到那个时间才会有状态更新的回调通知) expectedFinishTime=0#期望送达时间(顺丰同城急送支持) expectedPickTime=0#期望取件时间(闪送、顺丰同城急送支持,闪送需要设置两个小时后的时间,顺丰同城急送只需传expectedFinishTime或expectedPickTime其中之一即可,同时都传则以expectedFinishTime为准) poiSeq#门店订单流水号,建议提供,方便骑手门店取货,最长不超过32个字符 note#备注,最长不超过200个字符 orderTime#用户下单付款时间 isInsured=0#是否保价:0-非保价;1-保价 declaredValue#保价金额,单位为元,精确到分 tips#小费,单位为元,下单一般不加小费 isDirectDelivery=0#是否选择直拿直送(0-不需要；1-需要.选择直拿直送后,同一时间骑手只能配送此订单至完成,配送费用也相应高一些,闪送必须选1,达达可选0或1,其余配送公司不支持直拿直送) cashOnDelivery#骑手应付金额,单位为元,精确到分 cashOnPickup#骑手应收金额,单位为元,精确到分 riderPickMethod#物流流向,1:从门店取件送至用户；2:从用户取件送至门店 isFinishCodeNeeded=0#收货码(0-不需要；1-需要.收货码的作用是:骑手必须输入收货码才能完成订单妥投) isPickupCodeNeeded=0#取货码(0-不需要；1-需要.取货码的作用是:骑手必须输入取货码才能从商家取货) wxaAppid#若结算方式为:第三方向配送公司统一结算,商户后续和第三方结算,则该参数必填；在该结算模式下,第三方用自己的开发小程序替授权商户发起下单,并将授权小程序的appid给平台,后续配送通知中可回流授权商户小程序 subBizId#子商户id,区分小程序内部多个子商户 <<< success { 'status':1, 'message':'ok', 'data':{ "resultcode": 0, //运力返回的错误码 "resultmsg": "ok", //运力返回的错误描述 "fee": 10, //实际运费(单位：元)，运费减去优惠券费用 "deliverfee": 10, //运费(单位：元) "couponfee": 0, //优惠券费用(单位：元) "tips": 0, //小费(单位：元) "insurancfee": 0, //保价费(单位：元) "distance": 1000, //配送距离(单位：米) "dispatch_duration": 300, //预计骑手接单时间，单位秒，比如5分钟，就填300, 无法预计填0 "delivery_token": "1111111" //配送公司可以返回此字段，当用户下单时候带上这个字段，保证在一段时间内运费不变 } } <<< error ~~~