商家小程序开发指引

1. 小程序申请B2b类目

登录小程序管理后台，找到“设置-基本设置-服务类目”，添加【商家自营-B2b(商品批发/门店管理)】类目

2. 小程序开通门店助手

在小程序管理后台，左侧导航栏【行业能力】下找到【B2b门店助手】，在页面点击【开通】后，填写小程序基本信息，点击【提交】即可完成开通

3. 小程序引用门店助手插件

3.1 申请添加插件

方式1：小程序后台页面申请
登录小程序管理后台，点击左下方头像，“账号设置-第三方设置-插件管理-添加插件”，搜索“小程序门店助手”并申请添加

方式2：开发者工具引用
使用开发者工具运行小程序，并引入插件，在调试器中会提示“添加插件”，点击添加插件，前往小程序管理后台确认即可。

3.2 配置插件

在小程序app.json中配置
重要提醒：version可以填写具体版本号，建议直接填写latest以自动获取最新版插件
注意：“自定义插件名”代表之后使用时需要配置的，文档中使用了”bb-plugin”作为演示。 还需要添加 permission 字段来允许使用定位信息，才可以选择门店地址。

{
  "pages": [
    "pages/index/index"
  ],
  "plugins": {
    "自定义插件名": {
      "version": "latest",
      "provider": "wx69b7451feb427f0e"
    }
  },
  "sitemapLocation": "sitemap.json",
  "permission": {
    "scope.userLocation": {
      "desc": "你的位置信息将用于小程序定位"
    }
  }
}

3.3 代码中添加插件入口

页面中会出现“打开插件”的导航，点击可跳转门店认证插件。

示例中的“bb-plugin”就是在app.json里面配置的自定义的插件名。

<!--index.wxml-->
<navigator url="plugin://bb-plugin/info-regist">
  打开插件
</navigator>

3.4 获取插件授权信息

备注：若用户未向该小程序授权门店认证信息，则会返回错误信息“门店未对品牌授权”。

const plugin = requirePlugin("bb-plugin"); // 引入插件

Page({
  data: {

  },
  onShow(){
    plugin.getRetailInfo({
      success: (value) => {
        console.log(value)
      }
    })
  }
});

// value 结构如下
{
    "status": true,
    "errorMsg": "成功",
    "data": {
        "isEnableUsePlugin": true,
        "isGrantRetailInfo": true,
        "phone": "18888888888",
        "retailName": "测试门店名称 A"
        "storeType": "超市",
        "storeAddress": "广东省广州市海珠区创意大道",
        "businessName": "测试企业名称 B",
        "businessId": "223345jjj123445C",
        "managerName": "路人甲",
        "openid": "ooo999=ssssdxdf",
        "managerAuditStatus": 4
    }
}

3.5 插件返回的授权信息

返回结构体字段：

返回数据字段：

4. 小程序调起支付

门店已认证时，需使用专用接口调起微信官方支付，详见“小程序调起支付”所述；若门店未认证，则无法成功调起该支付接口。

5. 服务商授权

商户小程序管理员点击我司发送的“授权链接”，将小程序门店助手授权至我司（权限集158）。