# 物流查询插件

物流查询组件是微信官方提供的商家经营工具。

通过调用该组件，商家可以在小程序中展示订单物流信息，当物流状态发生改变时，给用户下发消息通知。

组件权限开通：[小程序MP](https://mp.weixin.qq.com)-功能-物流服务-申请开通「查询组件」 。

开通权限后，按照下面的使用说明接入，在你的小程序中引入「物流查询组件」即可实现。使用过程中如遇到问题，可在[微信开放社区](https://developers.weixin.qq.com/community/minihome/mixflow/1792207662500118536)发帖交流。

![](https://res.wx.qq.com/op_res/npZfdmJ2eb4zSxvY2TuYUhlYWxhTEcYPHWJgeGA817Yi0kWM3NdbG96Ud39C_xE5h2BOjq1iem9iKMkRqQCRsQ)

## 一、申请资质及监管处罚

满足以下所有条件的小程序才可进行申请使用：

1. 需要开通了微信支付的小程序
2. 过去30 天有交易
3. 类目（内测暂不需要）

频次限制

1. 一个 appid 最多调用10w 次/日
2. 一个用户最多调用 100次/日

监管及处罚

1. 仅支持查询「引用查询组件的小程序」产生的购物订单的物流运单。  
2. 仅支持给「已订阅微信快递服务」且订单实际购买者下发消息。

若违反监管条理，进行相应处罚，包括但不限于降低调用频次、禁用插件能力等。

## 二、插件引入说明

当服务商调用时请使用[获取授权账号调用令牌](/doc/oplatform/openApi/ticket-token/api_getauthorizeraccesstoken.md)以调用接口。

### 1. 「物流查询插件」如何引入

在小程序的app.json中声明

```json
{
    "logisticsPlugin": {
        "version": "2.1.5",
        "provider": "wx9ad912bf20548d92"
    }
}
```

### 2. 「物流查询插件」如何使用

然后在需要使用插件api的js文件中引入插件包，如 `test.js`

插件API 名： `openWaybillTracking`

参数为 `waybillToken`：通过[传运单](/miniprogram/dev/server/API/weixin-express/express-search/api_trace_waybill.md)返回的 waybill_token（开发者进行存储，后续用这个token来进行查询物流单）

必须用预览才能测试这个功能，无法在工具端模拟

调用示例：

```js
var plugin = requirePlugin("logisticsPlugin")

Page({
  data:{
    waybillToken: '', //通过后台接口获取到的值
  },
  searchDetail:(){
    const {waybillToken} = this.data;
      // 在此通过调用api来查询微信快递服务详情
      //必须用预览才能测试这个功能，无法在工具端模拟
      plugin.openWaybillTracking({
        waybillToken: waybillToken
      });
  }
})
```

## 三、后台 API 接口说明

已引用「物流查询」插件的商家，才可调用后台 API。

| 接口名称 | 请求路径 | 描述 |
| --- | --- | --- |
| [查询运单](/miniprogram/dev/server/API/weixin-express/express-search/api_query_trace.md) | /cgi-bin/express/delivery/open_msg/query_trace | 商户在调用完trace_waybill接口后，可以使用本接口查询到对应运单的详情信息 |
| [获取运力id列表](/miniprogram/dev/server/API/weixin-express/express-msg/api_get_delivery_list.md) | /cgi-bin/express/delivery/open_msg/get_delivery_list | 商户使用此接口获取所有运力id的列表 |
| [传运单](/miniprogram/dev/server/API/weixin-express/express-search/api_trace_waybill.md) | /cgi-bin/express/delivery/open_msg/trace_waybill | 商户使用此接口向微信提供某交易单号对应的运单号 |
| [更新物流信息](/miniprogram/dev/server/API/weixin-express/express-search/api_update_waybill_goods.md) | /cgi-bin/express/delivery/open_msg/update_waybill_goods | 该接口用于更新物品信息 |