1. 订单相关
开放接口文档
  • 校内专送接口
    • 前言
      • 接入说明
      • 签名生成规则
    • 接口文档
      • 订单相关
        • 发外部单入校内专送
        • 订单询价
        • 获取订单详情
        • 获取订单进程
        • 撤销订单
        • 配送订单状态变更回调
        • 外单发单预检查接口
  1. 订单相关

配送订单状态变更回调

简要描述:
配送订单状态变更回调
重要说明:
当配送订单状态发生变化(如配送员接单、取单、送达或撤销)时,本系统会主动向第三方系统发起回调,通知订单最新状态。
回调时,会请求第三方系统在发单接口中传入的(callback_url)地址进行通知(如果未填写回调地址则不回调)。
开发者后台配置url时会验证url正确性,返回 success 即可通过验证。
请求方式:
POST
请求参数:
参数名类型(必选)说明示例值
trade_nostring(必选)第三方订单号26030610215500113
stateint(必选)配送状态码6
courierstring(必选)骑手名称lhl
telstring(必选)骑手手机13399990000
courier_lngstring(必选)经度121.516325
courier_latstring(必选)纬度31.075762
photosarray<string>(可选)骑手上传的照片地址列表,按状态返回:9 到店返回到店照、5 配送中返回取餐照、6 送达返回送达照、4 接单不返回;无照片时不返回该字段["https://u2.0xiao.com/0xiao/user/infoOrder/image/a.png"]
signstring(必选)密钥签名,生成规则请参考2f1c4fbda84d518b6676e36b6bcaad4e
响应示例:
{
"trade_no": "26030610215500113",
"state": 6,
"courier": "lhl",
"tel": "13399990000",
"courier_lng": "121.516325",
"courier_lat": "31.075762",
"photos": [
"https://u2.0xiao.com/0xiao/user/infoOrder/image/a.png"
],
"sign": "2f1c4fbda84d518b6676e36b6bcaad4e"
}
订单状态码说明:
状态码说明
4接单:发往配送的订单被骑手抢单
9到店:骑手的到店状态
5配送中:骑手已从取件处领取货物,准备送往收件人
6送达:骑手已将货物送达到收件人
签名说明(photos 字段):
photos 为数组,参与签名时需先序列化为 JSON 字符串,再与其他参数一起按 key 字典序拼接。例如 state=9 时的签名原串为:
courier=lhl&courier_lat=31.075762&courier_lng=121.516325&photos=["https://u2.0xiao.com/0xiao/user/infoOrder/image/a.png"]&state=9&tel=13399990000&trade_no=26030610215500113{appkey}
JSON 序列化需使用默认格式(斜杠转义为 \/),与报文中的数组序列化保持一致
该状态无照片时,photos 不出现在报文中,也不参与签名
修改于 2026-11-03 07:07:14
上一页
撤销订单
下一页
外单发单预检查接口
Built with