创建订单 - 开发接口文档

简要描述：

创建快跑者配送订单

备注： 创建订单时，快跑者将会将订单分配到对应发单区域下的城市的运力团队进行配送

请求URL：

https://open.keloop.cn/open/order/createOrder

请求方式：

POST

请求参数：

参数名	必选	类型	说明
`version`	是	`string`	版本号，固定为：`2`
`timestamp`	是	`string`	当前时间戳
`ticket`	是	`string`	唯一标识符
`team_token`	否	`string`	团队Token
`dev_key`	是	`string`	开发者中心的开发密钥
`sign`	是	`string`	参数签名，生成规则请参考
`body`	是	`string`	请求方法所需要的参数`json字符串`

body 所需参数：

参数名	必选	类型	说明
`shop_id`	`是`	`bigint`	第三方系统中的商户 ID
`shop_name`	`是`	`string`	第三方系统中的商户名称
`shop_tel`	`是`	`string`	第三方系统中的商户电话
`shop_address`	`是`	`string`	第三方系统中的商户地址
`shop_tag`	`是`	`string`	第三方系统中的商户坐标`火星坐标`,如：`116.459226,40.007126`,`经度`在前，`纬度`在后
`store_id`	`否`	`int`	第三方系统中商户下的门店 ID
`order_content`	否	`string`	订单订单内容 `6000字符长度，超过会自动截取`
`order_note`	否	`string`	订单备注
`order_mark`	否	`string`	订单标识
`order_from`	否	`string`	订单来源
`order_time`	否	`string`	订单下单时间格式 `YY-mm-dd HH:ii:ss`
`order_photo`	否	`string`	订单图片路径
`note`	否	`string`	自定义参数，快跑者系统调用回调地址时会带上该参数
`customer_name`	否	`string`	订单客户`对应配送订单的收单人`
`customer_tel`	是	`string`	订单客户电话隐私号通过,传递如：`13034412140,7106`
`customer_address`	是	`string`	订单客户地址
`customer_tag`	是	`string`	订单客户坐标`火星坐标`,如：`116.459226,40.007126`,`经度`在前，`纬度`在后
`order_no`	`是`	`string`	订单单号，请使用`string`类型，否则长数字将会自动转换成科学计数法
`order_price`	否	`float`	订单的总价
`order_origin_price`	否	`float`	订单的原始价格
`pay_status`	`是`	`int`	订单支付方式：0 表示已支付、1 表示货到付款
`pay_fee`	否	`float`	订单的原配送费
`tip`	否	`float`	订单的小费
`pre_times`	否	`int`	预计送达时间的时间戳（10 位）
`is_calc_fee`	否	`int`	是否收取商户配送费：0 需要快跑者计算商户`配送费`、1 快跑者将不计算商户`配送费`
`contact_tel`	`否`	`string`	第三方系统中的实际取单电话
`distance`	`否`	`string`	第三方系统中的距离单位`km` 最小值`0.01km`,若传了该值，计算配送费将以该值为准
`weight`	`否`	`float`	重量单位`kg`
`pre_deliver_times`	`否`	`int`	第三方预计送达时间时间戳（10 位) `用于展示第三方系统预计的送达时间`
`merchant_code`	`否`	`int`	商户类型 1:美食,2:甜品奶茶,3:烘焙蛋糕,4:鲜花绿植,5:生鲜果蔬,6:超市百货,7:酒水茶饮,8:数码家电,9:医药健康,0:其他

body 参数示例：

{
    "shop_id": 1,
    "shop_name": "一家餐馆",
    "shop_tel": "18215675751",
    "shop_address": "成都市金牛区金卉院",
    "shop_tag": "104.181909,30.679741",

    "order_content": "2份烧白开(100x1),2份拉面(18x1)",
    "order_note": "不要太辣了",
    "order_mark": "12",
    "order_from": "美团外卖",
    "order_time": "2016-12-31 23:59:59",
    "order_photo": "http://a4.att.hudong.com/38/47/19300001391844134804474917734_950.png",
    "note": 1527150940,

    "customer_name": "张三丰",
    "customer_tel": "18288888888",
    "customer_address": "成都市金牛区蓝海天地1栋421",
    "customer_tag": "104.081909,30.779741",

    "order_no": 1527150940,
    "order_price": 99.99,
    "order_origin_price": 100.00,
    "pay_status": 1,
    "pay_fee": 1.66,
    "tip": 6.66,
    "pre_times": 1527151940，
    "is_calc_fee":0,
    "contact_tel":18215675751,
}

返回示例

调用成功示例

{
    "code": 200,
    "message": "订单创建成功",
    "data": {
        "trade_no": "16120709314700002",
        "pay_fee": "0.01"
    }
}

调用失败示例

{
    "code": 204,
    "message": "该订单已存在，请勿重复提交",
    "data": []
}

调用成功返回参数说明：

返回参数名	类型	说明
`trade_no`	`string`	配送订单的订单单号，可使用单号查询订单状态及撤销配送订单
`pay_fee`	`string`	配送订单的发单配送费

备注：

order_content 参数如果符合正则规则：/(.*\([\d\.]+x[\d\.]+\),)+/，则在订单详情页面会自动以表格的形式展示，如：五块钱的麻辣烫(5x1),七块钱的麻辣烫(7x1),八块钱的麻辣烫(8x1)

order_no 参数表示订单单号，该参数在第三方系统中必须唯一，创建配送订单时，快跑者系统会对其进行查重避免重复发单。

customer_tel 参数表示顾客号码，支持座机/手机号,如果是隐私号，通过英文,连接，如：13034412140,7106。

快跑者配送订单中的商户坐标和客户坐标使用的是火星坐标，所以，如果第三方系统使用的是百度坐标，请在调用接口之前先进行坐标转换