微信小程序 小程序使用·testUpdateOrder
作者: --时间: 2022-09-29
阅读量：
使用微信小程序的testUpdateOrder接口模拟订单状态更新
对于快递公司而言，订单状态更新是非常重要的事情。微信小程序提供了一个测试用接口，名为logistics.testUpdateOrder，让企业可以简单地模拟订单状态的变化，并在自己的小程序中进行测试。
1. 如何调用接口
在调用这个接口之前，需要先获得一个access_token作为接口调用凭证。由于这个接口是在服务器端调用，因此本文不会讲述如何获取access_token。更多关于access_token的内容参见服务端API。
请求地址为POST https://api.weixin.qq.com/cgi-bin/express/business/test_update_order?access_token=ACCESS_TOKEN
该接口有多个必填参数，包括biz_id、order_id、delivery_id、waybill_id、action_time、action_type、和action_msg。具体详见请求参数表格。
2. 请求参数
以下表格详细列出了各种请求参数及其说明。其中，最重要的参数是action_type，它代表了轨迹变化类型。
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | 接口调用凭证 | |
| biz_id | string | 是 | 商户id,需填test_biz_id | |
| order_id | string | 是 | 订单号 | |
| delivery_id | string | 是 | 快递公司id,需填TEST | |
| waybill_id | string | 是 | 运单号 | |
| action_time | number | 是 | 轨迹变化 Unix 时间戳 | |
| action_type | number | 是 | 轨迹变化类型 | |
| action_msg | string | 是 | 轨迹变化具体信息说明,使用UTF-8编码 |
2.1 action_type 的合法值
以下表格列出了action_type参数的合法取值及其含义。
| 值 | 说明 | 最低版本 |
|---|---|---|
| 100001 | 揽件阶段-揽件成功 | |
| 100002 | 揽件阶段-揽件失败 | |
| 100003 | 揽件阶段-分配业务员 | |
| 200001 | 运输阶段-更新运输轨迹 | |
| 300002 | 派送阶段-开始派送 | |
| 300003 | 派送阶段-签收成功 | |
| 300004 | 派送阶段-签收失败 | |
| 400001 | 异常阶
|
