# 更新配送单状态

调试工具

接口应在服务器端调用，详细说明参见服务端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	系统繁忙，此时请开发者稍候再试