开发接口文档
  1. 订单相关接口
开发接口文档
  • 快跑者开放接口文档
    • 前言
      • 文档说明
      • 订单创建商户映射逻辑
      • 签名生成规则
    • 订单相关接口
      • 计算配送费
      • 创建订单
      • 获取订单详情
      • 获取订单进程
      • 获取订单配送员坐标
      • 订单增加小费功能
      • 配送订单出餐
      • 撤销订单
      • 评论配送员
      • 拉黑骑手
    • 联盟订单相关接口
      • 计算配送费
      • 创建订单
    • 团队相关接口
      • 获取团队信息
    • 商户相关接口
      • 获取所有商户
      • 解绑授权商户
      • 设置商家名称
      • 创建关联快跑者商户
      • 获取商家储备金余额及充值链接
      • 获取指定团队是否存在相关商户
    • 门店相关接口
      • 获取门店列表
      • 修改门店
      • 删除门店
      • 关联门店
    • 配送员相关接口
      • 获取所有配送员
      • 获取指定范围配送员
      • 解除拉黑骑手
    • 回调通知
      • 配送订单状态变更回调
    • 其他
      • 常见问题
      • 微盛小程序对接快跑者
  1. 订单相关接口

获取订单详情

简要描述:
根据配送单号获取配送订单的详细信息
请求URL:
https://open.keloop.cn/open/order/getOrderInfo
请求方式:
GET
请求参数:
参数名必选类型说明
version是string版本号,固定为:1
timestamp是string当前时间戳
ticket是string唯一标识符
team_token是string团队Token
dev_key是string开发者中心的开发密钥
sign是string参数签名,生成规则请参考
body是string请求方法所需要的参数json字符串
body 所需参数:
参数名必选类型说明
trade_no是string快跑者订单交易号创建订单成功会返回
返回示例
调用成功示例
{
    "code": 200,
    "message": "",
    "data": {
        "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",
        "customer_name": "张三丰",
        "customer_tel": "18288888888",
        "customer_address": "成都市金牛区蓝海天地1栋421",
        "customer_tag": "104.081909,30.779741",
        "get_name": "一家餐馆",
        "get_address": "成都市金牛区金卉院",
        "get_tel": "18215675751",
        "get_tag": "104.181909,30.679741",
        "note": "1527150940",
        "fee_detail": [
            "原始计价:¥ 1.66(暂未设置计价方案,以原始配送费为准)"
        ],
        "order_no": "1527150940",
        "order_price": "99.99",
        "order_origin_price": "100",
        "pay_status": "1",
        "origin_pay_fee": "1.66",
        "merchant_pay_fee": "1.7",
		"primary_merchant_pay_fee": "1.7",
		"coupon_amount": "0",
        "distance": "19.7",
        "pay_fee": "0",
        "tip": "0",
        "send_time": "2018-05-24 16:35:40",
        "send_times": "1527150940",
        "delivery_times": "0",
        "receive_times": "0",
        "arrive_times": "0",
        "leave_times": "0",
        "over_times": "0",
        "pre_times": "1527154540",
		"picture_proof": "",
        "status": "1",
        "trade_no": "18052116414400001",
        "courier_name": "",
        "courier_tel": "",
        "team_name": "本地团队-徐",
        "team_tel": "18280094727"
    }
}
调用失败示例
{
    "code": 204,
    "message": "该订单不存在",
    "data": [ ]
}
调用成功返回参数说明:
返回参数名类型说明
order_contentstring订单内容
order_notestring订单备注
order_markstring订单标识
order_fromstring订单来源
order_timestring第三方订单下单时间
order_photostring订单图片路径
customer_namestring订单客户(对应配送订单的收单人)名字
customer_addressstring订单客户地址
customer_tagstring订单客户坐标
customer_telstring订单客户电话
get_namestring取单名字
get_addressstring取单地址
get_telstring取单电话
get_tagstring取单坐标
notestring回调时带上的参数
fee_detailarray商户配送费的计费明细
order_nostring第三方订单单号
order_pricestring订单实收价
order_origin_pricestring订单原价
pay_statusstring第三方订单的支付状态,0 表示已经支付,1 表示货到付款
origin_pay_feestring订单原配送费
merchant_pay_feestring商户配送费(若使用优惠券,则为优惠后配送费)
primary_merchant_pay_feestring商户优惠前配送费
coupon_amountstring优惠券抵扣金额
distancestring距离
pay_feestring配送员配送费
tipstring订单小费
send_timestring配送订单的发单时间
delivery_timesstring订单分发的时间戳
receive_timesstring接单的时间戳
arrive_timesstring到店的时间戳
leave_timesstring离店的时间戳
over_timesstring送达的时间戳
pre_timesstring预订单时间的时间戳
pre_deliver_timesstring预计送达时间的时间戳
statusstring配送订单状态:1:待发单,2:待抢单,3:待接单,4:取单中,5:送单中,6:已送达,7:已撤销
trade_nostring配送订单单号
courier_namestring接单配送员的名字
courier_telstring接单配送员的电话
team_namestring配送团队名字
team_telstring配送团队电话
picture_proofstring送达凭证,配送员送到订单后的图片凭证(json字符串)
备注:
开发者可根据配送订单单号拼接一个固定格式的 url 地址来快捷访问配送订单信息及订单进程状态。
为让快跑者开放接口更为简便易用,第三方系统可使用直接跳转 URL 的方式来展示订单详情及相关信息,开发者调用下单接口后,快跑者会返回订单的单号(如:18052116414400001),使用该单号可拼接一个固定格式的 URL 链接(如:https://www.keloop.cn/show_order/18052116414400001),直接访问该链接即可查看该订单的详情和进程。
上一页
创建订单
下一页
获取订单进程
Built with