# 物流查询插件

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

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

组件权限开通：小程序MP-功能-物流服务-申请开通「查询组件」 。

开通权限后，按照下面的使用说明接入，在你的小程序中引入「物流查询组件」即可实现。使用过程中如遇到问题，可在微信开放社区发帖交流。

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

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

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

频次限制

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

监管及处罚

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

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

# 二、插件引入说明

当服务商调用时请使用获取授权账号调用令牌以调用接口。

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

在小程序的app.json中声明

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

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

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

插件API 名： openWaybillTracking

参数为 waybillToken：通过传运单返回的 waybill_token（开发者进行存储，后续用这个token来进行查询物流单）

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

调用示例：

var plugin = requirePlugin("logisticsPlugin")

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

# 三、后台API 接口说明

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