企业-门店绑定授权

1 背景介绍

在商米数字店铺体系中,存在企业和门店的组织架构设计。

企业是用户使用数字店铺的基础组织,所有的数据,设备和服务都是隶属于企业的。在一个企业下,用户可以创建一到多级的门店组织结构。

所有设备和数据都是基于门店聚合的,也就是说所有设备都是“绑定”在指定门店上的,用户每次对于设备和数据的操作也是基于门店的。

第三方软件如果需要接入商米设备和服务,先要建立双方企业或门店的对应关系,然后再基于这种绑定关系进行数据的打通。

2 企业-门店 绑定授权方式

2.1 完全通过接口创建企业并自动绑定授权

这种绑定方式需要申请一个商米用户作为管理员,中国大陆为手机号码,其他地区为邮箱地址。用户可以在商米助手APP或者商米数字店铺网页( https://store.sunmi.com )上进行注册,也可以通过用户接口进行注册。

具体接口列表如下:

/user/register: 【商米数字店铺开放平台/组织门店与用户/用户接口/5.3.1  注册用户】

/company/create: 【商米数字店铺开放平台/组织门店与用户/企业接口/3.3.1 创建企业】

/shop/create: 【商米数字店铺开放平台/组织门店与用户/门店接口/4.3.4 创建门店】

2.2 商米数字店铺页面创建企业-门店,通过接口绑定授权

开发者也可以选择通过商米数字店铺平台(商米助手APP或商米数字店铺web)创建用户,企业和门店,然后再通过接口进行绑定授权。如果需要对某家门店进行授权,可以参考下图:

具体接口列表如下:

/shop/bind: 【商米数字店铺开放平台/组织门店与用户/门店接口/4.3.1 绑定授权商米门店】

获取门店对接凭证的路径如下:

如果需要对企业下多家门店进行授权,除了通过接口对每一家门店进行绑定外,商米数字店铺平台还支持页面直接录入第三方的门店对接信息。如果要采用这种方式进行授权,需要预先绑定企业。

具体接口列表如下:

/company/bind: 【商米数字店铺开放平台/组织门店与用户/企业接口/3.3.4 绑定授权商米企业】

获取企业对接凭证的路径如下:

在完成第三方平台商户/企业授权之后,就可以针对每个门店直接录入对应的第三方平台的门店信息,如下图所示: