小程序
取消
开发
中文
EN
取消
  • 服务端

    • # 更新配送单状态

    调试工具

    接口应在服务器端调用，详细说明参见服务端API。

    # 接口说明

    # 接口英文名

    updateOrder

    # 功能描述

    该接口用于配送公司更新配送单状态。

    # 调用方式

    # HTTPS 调用

    
POST https://api.weixin.qq.com/cgi-bin/express/local/delivery/update_order?access_token=ACCESS_TOKEN

    # 请求参数

    属性 类型 必填说明
    access_token string 是 接口调用凭证，该参数为 URL 参数，非 Body 参数。使用getAccessToken
    wx_token string 是 下单事件中推送的wx_token字段
    order_status number 是 订单状态，枚举值，下附枚举值列表及说明
    waybill_id string 是 配送单id
    action_msg string 否 附加信息
    action_time number 是 状态变更时间点，Unix秒级时间戳
    agent object 否 骑手信息, 骑手接单时需返回
    属性 类型 必填 说明
    name string 是 骑手姓名
    phone string 是 骑手电话
    is_phone_encrypted number 否 电话是否加密。默认是0不加密，1表示加密。
    shopid string 是 商家id， 由配送公司分配，可以是dev_id或者appkey
    shop_order_id string 是 唯一标识订单的 ID，由商户生成
    shop_no string 否 商家门店编号， 在配送公司侧登记
    wxa_path string 是 配送公司小程序跳转路径，用于用户收到消息会间接跳转到这个页面
    expected_delivery_time number 否 预计送达时间戳， 骑手接单时需返回

    # 返回参数

    属性 类型 说明
    resultcode number 错误码
    resultmsg string 错误描述

    # 调用示例

    示例说明: HTTPS调用

    # 请求数据示例

    
{"wx_token":"","shopid":0,
"shop_order_id":"C1638702836167U4v252",
"shop_no":"6261889268017",
"waybill_id":"3436608931550646273",
"action_time":1638703215,
"order_status":202,
"action_msg":"",
"agent":{
"name":"李x利",
"phone":"1358xxxx",
"lng":112.2248390000000029,
"lat":22.690728000000000009
},
"wxa_path":"pages\/index\/index",
"expected_delivery_time":1638705236
}

    # 返回数据示例

    
{
  "resultcode": 0,
  "resultmsg": "ok"
}

    # 错误码

    错误码 错误码取值 解决方案
    -1 system error 系统繁忙，此时请开发者稍候再试