接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南。
接口英文名:getserviceresult
查询电子面单使用的物流服务及其服务结果
1. 调用方式
HTTPS 调用
POST https://api.weixin.qq.com/channels/ec/logistics/ewaybill/service/get?access_token=ACCESS_TOKEN
云调用
- 本接口不支持云调用。
第三方调用
-
本接口支持第三方平台代微信小店商家调用。第三方服务商调用模式介绍
-
该接口所属的权限集 id 为:130、159
-
服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代微信小店商家进行调用,具体可查看 第三方调用 说明文档。
2. 请求参数
查询参数 Query String Parameters
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证,可使用 access_token(微信小店商家)、authorizer_access_token(服务商代调用) |
请求体 Request Payload
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| waybill_id | string | 是 | 运单号 |
| delivery_id | string | 否 | 快递公司 ID,配合运单号精确定位面单 |
3. 返回参数
返回体 Response Payload
| 参数名 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码,0 表示成功 |
| errmsg | string | 错误信息 |
| service_list | objarray | 服务列表,无增值服务时为空 |
Res.service_list(Array) Object Payload
服务列表,无增值服务时为空
| 参数名 | 类型 | 说明 |
|---|---|---|
| service_type | string | 服务类型,如 device_activation(当面激活) |
| service_name | string | 服务中文名,如 当面激活 |
| service_value | string | 服务参数 JSON,含 SN/IMEI 等核验信息 |
| service_status | number | 服务状态:0=未开始 1=已完成 |
| attach_list | objarray | 附件列表 |
Res.service_list(Array).attach_list<Array> Object Payload
附件列表
| 参数名 | 类型 | 说明 |
|---|---|---|
| url | string | 附件 URL |
| type | number | 附件类型:1=激活核验图片 |
| create_time | number | 附件生成时间戳 |
4. 注意事项
本接口无特殊注意事项
5. 代码示例
请求示例
{
"waybill_id":"SF1234567890",
"delivery_id":"SF"
}
返回示例
{
"errcode":0,
"errmsg":"ok",
"service_list":[
{"service_type":"device_activation",
"service_name":"当面激活",
"service_value":"{\"sn\":\"1231231\"}",
"service_status":1,
"service_result":1,
"attach_list":[{"url":"https://mmbiz.qpic.cn/xxx","type":1,"create_time":1700000000}]}]
}]
}
6. 错误码
此接口没有特殊错误码,可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。
7. 适用范围
本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明,均不可调用。