# 连接器接入指引

# 连接器简介

# 项目背景

商家经营离不开小程序与各类企业管理软件（ERP/OMS/SCRM等）的高效连通。由于微信小程序的巨大开放性，不同小程序的数据出口高度离散，导致小程序与企业管理软件的数据接口打通工作低效繁复。 基于此，微信团队推出小程序连接器，提供全平台统一的商品订单等接口，帮助高效的对接，最终实现“一次接入，多次复用”的效果。

# 能力梗概

1. 标准化商品、库存、订单、售后、物流接口 不关注业务本身的逻辑，如下单扣减库存或者加购物车扣减库存等，由服务商根据业务本身的实际情况进行数据调试
2. 标准字段之外，连接器具备自定义字段的空间 不同业务具备一定的差异性，连接器有自定义字段，如在标准字段外还有其他需求，可通过自定义字段来实现。使用了自定义字段，需要跟上下游共识好字段意义
3. 一次接入，多次复用 通过一次对接，后续每新增商城/ERP，均可以只关注数据准确性。由于连接器无法保证数据理解符合业务理解，因此在接入后，需要使用对应商城/ERP时，可根据具体的定义进行数据验证

# 商业应用

1. 小程序服务商接入连接器后，如客户需要使用某款ERP，可指引客户通过微信搜索「微信服务市场」小程序进行选购，主要场景： ● 小程序服务商在转化客户时，客户要求接通ERP后才付费小程序 ● 小程序服务商在服务客户过程中提出使用ERP需求
2. 小程序服务商和ERP服务商之间，可以进行客户引流，主要场景： ● 小程序服务商在销售过程中，可搭配ERP一同售卖 ● ERP服务商在销售过程中，可搭配小程序一同售卖

以上两种情况，微信服务市场提供渠道码能力，通过渠道码完成的交易将有报表体现，服务商可以根据商业合作协议获取分佣。 服务市场将在后续提供直接分佣能力，如有需求可联系微信服务市场客服，联系路径为：微信搜索「微信服务市场」小程序-点击“我的”-点击“平台客服”

# 服务商接入指南

# 名词解释

1. 第三方：服务商接入连接器时，需要有第三方账号，第三方账号是根据企业主页的企业主体名称拉取同主体下的第三方账号。相关数据将会回调到该第三方的服务器地址。
2. 权限集：连接器将会使用到小程序107权限集，小程序服务商和ERP服务商均需要向客户获取该权限集的授权。
3. 应用：根据服务商自己的后台设计，平台建议一个第三方对应一个应用，如“xx微商城”为一个应用，应用的概念处于第三方和小程序之间，具有较大的自由度。
4. env_id：即为环境id，每一个小程序应用与每一个ERP应用之间存在一个env_id，ID具有唯一性，小程序appid归属于某个env_id后即可进行数据交互
5. 调试指南：ERP服务商接入成功后需要提供调试指南，包括不仅限于在ERP中创建店铺、形成授权、操作发货/更新流程，便于每个小程序服务商接入过程中可根据调试指南进行数据调试

# 小程序服务商接入指引

1. 接口方面 接口分为推送接口/接收接口。当前推送接口有“推送订单”、“推送售后”两个主要接口，其他接口均为ERP回传接口。

2. 接入流程 小程序服务商接入接口后，可以进入「可对接列表」中找到需要对接的ERP，并点击「调试指南」，在ERP中验证数据。 在接入过程中，如遇到需要共同解决的问题，可通过微信搜索「微信服务市场」小程序-点击“我的”-点击“平台客服”，平台客服可帮助建联

3. 小程序使用流程

4. 详细接入流程参考左边侧边栏接入指引。

ERP服务商接入指引

1. 接口方面 除“推送订单”、“推送售后”两个接口为小程序服务商的推送接口，其他接口均为ERP作为调用方发起调用。

2. 接入流程 ERP服务商可以使用“微信小商店”作为调试对象，可以通过自助获取微信小商店的107权限集授权，调试完成之后需要上传调试指南。 调试指南是为了帮助小程序服务商自助完成ERP的数据验证，降低ERP的人力对接工作，因此建议ERP服务商将指南补充详细。

3. 小程序使用流程 由于小程序添加后会向ERP推送消息确认是否同意该小程序使用，建议ERP可以设置为自动通过该消息确认。

4. 详细接入流程参考左边侧边栏接入指引。