# 接入指引

# 1.申请使用组件

申请接入组件前,需要拥有一个小程序,如果你已经有小程序,则不需要重复注册。小程序的注册流程可以参照小程序注册流程

符合标准版交易组件类目准入要求的小程序可以登陆微信公众平台官网,在左边菜单栏选择标准版交易组件,点击开通功能。


审核通过后,在微信公众平台左边菜单栏点击标准版交易组件,选择去管理,进入到小商店后台;


跳转到小商店开店任务页面后,填写相关资料及上传相关证件提交审核,完成开店任务;

# 2.【标准版交易组件】如何引入

版本限制 :基础库版本2.11.1及以上,否则无法使用客服功能。

需要在项目中引入【标准版交易组件】,编辑项目根目录的 app.json 文件,示例代码如下:

 "plugins": {

      "mini-shop-plugin": {

			"version": "1.1.0", // 必须是标准版交易组件最新版本号,微信开发者工具调试时可获取最新版本号(复制时请去掉注释)

      "provider": "wx34345ae5855f892d"  // 必须填标准版交易组件appid,不要修改(复制时请去掉注释)

        }

		}

使用标准版交易组件的功能,需要进行组件初始化。编辑项目根目录的app.js文件,调用组件提供的initApp方法,传入指定参数。实例代码如下:

const miniShopPlugin = requirePlugin('mini-shop-plugin');

App({
  onLaunch() {
    miniShopPlugin.initApp(this, wx);
  },
});

# 3.【标准版交易组件】如何使用

按第1步的方法把组件代码包配置引入后,即可直接通过链接地址跳转到标准版交易组件页面(即为店铺内的页面)

示例如何跳转到特定的商品详情页,代码如下:

(1) 使用 navigator 组件跳转进入商品详情页

index.js

const productId = [商品id] // 填写具体的商品Id

index.wxml

<navigator url="plugin-private://wx34345ae5855f892d/pages/productDetail/productDetail?productId={{productId}}"></navigator>

    // 其中wx34345ae5855f892d是标准版交易组件appid不能修改

(2)使用 navigateTo 方法跳转进入商品详情页

index.js

const productId = [商品id] // 填写具体的商品Id

    wx.navigateTo({

          url: `plugin-private://wx34345ae5855f892d/pages/productDetail/productDetail?productId=${productId}`,

    });

    // 其中wx34345ae5855f892d是标准版交易组件appid不能修改`



示例效果图如下:

# 4.标准版交易组件和接口


# 【组件接口】

通过在项目中引入标准版交易组件,开发者可以很方便的将项目融合进入小商店,快捷实现商品详情展示、商品下单、订单详情等功能。

  • 商品详情productDetail:用户点击相关商品后,跳转至小商店商品详情页。
  • 购物袋shoppingCart:控制用户跳转到小商店购物袋页。
  • 订单列表orderList:控制用户跳转到小商店订单列表页,默认激活“全部”标签,展示全部订单数据,可设置为激活“待付款”、“待收货”、“退款/售后”标签。
  • 订单详情orderDetail:控制用户跳转到小商店订单详情页中。
  • 售后单详情refundDetail:控制用户跳转到小商店售后单详情页中。

# 【服务端接口】

服务端接口包含SPU(标准产品单位)接口、SKU(库存量单位)接口、订单接口、物流接口、优惠券接口、店铺接口、客服接口以及直播接口。

  • 服务商接口是小商店提供给服务商用于登陆服务市场、管理商家的接口能力。开发者可以进行市场登陆验证、获取用户购买有效期内的服务列表、获取用户购买服务订单列表等。
  • SPU(标准产品单位)接口是小商店提供给开发者对商品SPU进行批量操作的接口能力。开发者可以批量添加商品、删除商品、更新商品、上下架商品等。
  • SKU(库存量单位)接口是小商店提供给开发者对商品SKU进行批量操作的接口能力。开发者可以批量添加SKU、删除SKU、更新信息、价格、库存等操作。
  • 订单接口是小商店提供给开发者对订单情况进行管理的接口能力,开发者可以获取订单列表、详情等信息。
  • 物流接口是小商店提供给开发者对物流情况进行管理的接口能力,开发者可以获取快递公司列表、获取订单发货状态等信息。
  • 优惠券接口是小商店提供给开发者对优惠券进行管理的接口能力,开发者可以获取优惠券情况、发放优惠券等操作。
  • 店铺接口是小商店提供给开发者对店铺信息进行管理的接口能力,开发者可以获取店铺基本信息。
  • 客服接口是小商店提供给开发者对客服进行管理的接口能力,开发者可以获取客服消息内的临时素材、发送客服消息给用户、下发客服当前输入状态给用户、把媒体文件上传到微信服务器等操作。
  • 直播接口是小商店提供给开发者对直播进行管理的接口能力,开发者可以创建直播间、获取回放源视频、获取直播间列表、对直播间商品进行添加、删除、更新等操作。