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

配送订单状态变更回调

简要描述:
配送订单状态变更回调
重要说明:
当快跑者配送订单的配送状态发生变更时(包括:配送员接单、取单、送达订单或撤销订单),快跑者会向第三方系统进行回调。
回调时,快跑者会请求第三方系统在 快跑者开放平台 中填写的回调地址(如果未填写回调地址则不回调)。
第三方系统接收到回调请求,并处理好业务逻辑之后请返回 success 字符串,否则快跑者系统将认定本次回调请求失败,于是将会向第三方系统进行重复多次回调
开发者后台配置url时会验证url正确性,参数中note会携带"testurl",此刻开发者返回"success"即可正常
请求方式:
POST
请求参数:
参数名类型说明
expire_timestring请求的过期时间,时间戳格式,如:1477483702
signstring加密密钥,按支付宝密钥排序,可参考签名与验签说明,主要用于验证请求权限
trade_nostring状态发生改变的配送订单的订单单号
order_nostring订单单号,上游的运单号/订单单号
statestring配送订单状态码,可选值为 4,5,6,7,具体参考下面的订单状态码说明表
notestring创建订单时传递自定义参数 note
courierstring配送员的名字
longitudestring配送员坐标经度
latitudestring配送员坐标纬度
telstring配送员的电话号码
update_timestring配送订单状态的改变时间,如:2017-01-01 01:01:01
参数示例:
{
    "trade_no": "17060711244400001",
    "order_no": "25041411555500034",
    "state": "6",
    "tel": "18280094727",
    "update_time": "2017-06-07 11:36:14",
    "expire_time": "1496806651",
    "courier": "徐哈哈1",
    "latitude": "30.71490499025135", 
    "longitude": "104.01535454330507",
    "note": "",
    "sign": "8cd619d3271e204d1e2d80babad78fd3"
}
订单状态码说明:
状态码说明说明
3待接单(待指派/待抢单/待接单)发往团队后待接单状态
4取单中(已接单/已抢单)发往配送群的订单被配送员抢单,或发往配送员的订单被配送员接单
5送单中(已取单)配送员已从取件处领取货物,准备送往收件人
6(已送达)配送员已将货物送达到收件人
7(已撤销)商户或团队撤销订单
9(骑手到店)骑手的到店状态
上一页
解除拉黑骑手
下一页
常见问题
Built with