查询电子面单使用的物流服务

查看 Markdown

最后一次编辑于 2026-11-04

接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南。

接口英文名:getserviceresult

查询电子面单使用的物流服务及其服务结果

1. 调用方式

HTTPS 调用

POST https://api.weixin.qq.com/channels/ec/logistics/ewaybill/service/get?access_token=ACCESS_TOKEN

云调用

  • 本接口不支持云调用。

第三方调用

2. 请求参数

查询参数 Query String Parameters

参数名类型必填示例说明
access_tokenstring是ACCESS_TOKEN接口调用凭证,可使用 access_token(微信小店商家)、authorizer_access_token(服务商代调用)

请求体 Request Payload

参数名类型必填说明
waybill_idstring是运单号
delivery_idstring否快递公司 ID,配合运单号精确定位面单

3. 返回参数

返回体 Response Payload

参数名类型说明
errcodenumber错误码,0 表示成功
errmsgstring错误信息
service_listobjarray服务列表,无增值服务时为空

Res.service_list(Array) Object Payload

服务列表,无增值服务时为空

参数名类型说明
service_typestring服务类型,如 device_activation(当面激活)
service_namestring服务中文名,如 当面激活
service_valuestring服务参数 JSON,含 SN/IMEI 等核验信息
service_statusnumber服务状态:0=未开始 1=已完成
attach_listobjarray附件列表

Res.service_list(Array).attach_list<Array> Object Payload

附件列表

参数名类型说明
urlstring附件 URL
typenumber附件类型:1=激活核验图片
create_timenumber附件生成时间戳

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. 适用范围

本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明,均不可调用。