# 模拟更新配送单状态
接口应在服务器端调用,详细说明参见服务端API。
# 接口说明
# 接口英文名
realMockUpdateOrder
# 功能描述
该接口用于模拟配送公司更新配送单状态,可进行测试账户下的单,将请求转发到运力测试环境。
# 注意事项
- 该接口只能用于测试,请求会转发到运力测试环境, 目前支持顺丰同城和达达。
1、顺丰同城测试号
- shopid: 1534713176
- appsecret: d80400f91e156f63b38886e616d84590
- shopno: 3243279847393
- 支持变更状态: 102 202 202 302
2、达达测试号
- shopid: dadaaee18818d97e236
- appsecret: 1c6f40492d6d89caaad80b85f7d31670
- shopno: 77071-47913
- 支持变更状态: 102 201 202 301 302 304 305
# 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/cgi-bin/express/local/business/realmock_update_order?access_token=ACCESS_TOKEN
# 第三方调用
调用方式以及出入参和HTTPS相同,仅是调用的token不同
该接口所属的权限集id为:51、71
服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用
# 请求参数
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用access_token或者authorizer_access_token |
shopid | string | 是 | 商家id |
shop_order_id | string | 是 | 唯一标识订单的 ID,由商户生成 |
order_status | number | 是 | 配送状态,详见order_status 枚举值 |
action_time | number | 是 | 状态变更时间点,Unix秒级时间戳 |
action_msg | string | 否 | 附加信息 |
delivery_sign | string | 是 | 用配送公司提供的appSecret加密的校验串说明 |
# 返回参数
属性 | 类型 | 说明 |
---|---|---|
resultcode | number | 运力返回的错误码 |
resultmsg | string | 运力返回的错误描述 |
# 调用示例
示例说明: HTTPS调用
# 请求数据示例
{
"shopid": "xxxxxxx",
"shop_order_id": "xxxxxxxxxxx",
"action_time": 1584145981,
"order_status": 101,
"action_msg": "",
"delivery_sign": "xxxxxxx",
}
# 返回数据示例
{
"resultcode": 0,
"resultmsg": "ok"
}
# 错误码
错误码 | 错误码取值 | 解决方案 |
---|---|---|
-1 | system error | 系统繁忙,此时请开发者稍候再试 |