# 小程序连接小店指引
# 基础能力
# 1. 插入商品:
a) 整体规则:不限制小程序和小店的关系,均可以进行跳转。
b) 默认商品展示
i) 基础库3.7.0支持:整体展示不允许调整任何大小和元素
ii) 基础库3.7.1支持:元素不可改变,但是可以修改背景颜色,文字颜色,卡片大小,按钮颜色和大小等
c) 自定义商品展示:基础库3.7.2支持:除组件底部需要有小店标记外,其余部分可自定义
# 2. 插入小店首页:
store-home | 微信开放文档 整体规则:不限制小程序和小店的关系,均可以进行跳转。
# 3. 插入订单详情:
wx.openStoreOrderDetail(Object object) | 微信开放文档
a) 整体规则:不限制小程序和小店的关系,均可以进行跳转,但是跳转时会有校验:
i) 校验订单是否来自该小程序
ii) 校验订单是否属于该点击跳转的用户
iii) 校验订单是否属于目标小店
b) 从基础库3.7.1开始,支持小程序跳转到小店订单详情页
# 4. 定制信息传递:
从基础库3.7.1开始,支持小程序定制,上传定制文件后,小店获取文件内容,然后下载并履约:
i) 用户前往小程序,对商品进行定制,定制后,调用上传资料 | 微信开放文档接口,获取定制文件media_id;
ii) 小程序调用小店商品卡,并且在用户下单的时候,将media_id塞入商品卡参数中store-product | 微信开放文档;
iii) 小店商家获得订单,并且通过获取文件下载链接 | 微信开放文档将订单中的media_id文件下载下来;
iv) 小店完成商品的定制和履约。
# 5. 插入优惠券:
从基础库 3.8.3 开始,可将微信小店优惠券插入小程序页面。此功能对关联关系没有要求,所有小店的优惠券均可在任意小程序调用。接口文档 store-coupon | 微信开放文档
a) 默认券组件
i) 传入小店 appid 和券 id 即可使用,组件宽度会根据屏幕自适应。
ii) 组件包括:优惠券信息和领取按钮。点“领取”会在小程序内完成领券,之后按钮变成“去使用”,点击打开优惠券详情页。
iii) 优惠券详情页会展示所有适用的商品,点击即可进入商品详情页。页面头部也可以直接访问店铺主页。
b) 颜色自定义的券组件
i) 在默认组件的基础上,可以自定义组件的宽度、所有文字的颜色、背景色,方便适配小程序页面的视觉风格。
ii) 不可以删除或增加页面元素,只能调整颜色。
c) 跳转优惠券详情页的接口
i) 基础库3.8.4起可用
ii) 不调用券组件,而是通过接口直接跳转优惠券详情页。举例:开发者在外层实现按钮“去领券”,用户点击后打开券详情页,自行完成券的领取和使用
iii) 此能力只能打开详情页,不支持打开详情页并领券。
# 6. 插入礼物:
从基础库3.8.10开始,可将礼物组件插入小程序页面。此功能前置依赖小程序与小店做帐号关联并需要商家对指定的小程序创建一个礼物活动,做礼物配置。开发能力参考:store-gift | 微信开放文档| 微信小店发放免费活动礼物给小程序送礼接口 | 微信开放文档
a)在合作店铺的微信小店完成小程序帐号授权:选择帐号管理 - 小程序 - 去关联
b)小程序送礼授权:设置可送的商品+份数,用于小程序礼物创建
c)展示默认礼物组件
i)获取小程序关联的小店 ii) 根据微信小店获取小店配置的礼物活动列表 iii)根据活动id获取活动详情:有哪些商品sku、份数是多少 iv)根据小程序需要(如直接发放,玩一个小游戏,前置条件小程序自己判断),输入活动id、商品id创建礼物订单 v)传入礼物订单id和收礼人openid,展示礼物组件
vi)自定义礼物组件,在默认组件基础上,礼物组件的可以由小程序自定义礼物领取入口(即不展示默认礼物卡片样式做领取)和祝福语文本信息。组件宽度、内容暂不支持自定义
d)展示礼物订单,根据小程序需要,通过查询列表&订单展示礼物订单信息
更多详细小程序能力,可参考:微信小店:微信小店「小程序连接小店」功能指引
# 数据互通能力
订单数据互通:依赖小店合作账号的订单数据打通
a) 前提:小店在PC后台 > 店铺管理 > 账号管理 > 合作账号中邀请对应小程序成为合作账号
b) 规则:一个小程序可以绑定无数个小店的合作账号,一个小店可以绑定100个小程序账号
c) 小程序调用API接口获取带给合作小店的订单获取合作店铺订单 | 微信开放文档
d) 小程序还可以使用小店列表、商品列表等接口对合作小店进行管理