店铺绑定授权

1 背景介绍

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

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

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

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

2 商户/店铺绑定授权

2.1 接口创建商户门店并自动绑定授权

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

拥有账号之后,通过接口【创建商户】和【创建门店】在对接软件中完成商户门店的创建,返回的sunmi_company_no和sunmi_shop_no可作为后续所有接口唯一的商户和门店标识。

2.2 页面创建商户/门店,通过接口绑定授权

这种绑定方式需要用户在商米助手APP或者 https://store.sunmi.com 上进行注册商米账号,并创建商户和门店。

在完成对接的开发(使用商米提供的app_id、secret_key),并且创建了门店之后,用户可以在【基础数据/组织管理/组织详情】中获取sunmi_shop_no 和 sunmi_shop_key,为了保证信息的有效性和安全性,对接凭证的有效期为24小时,过期之后可以重新获取。

关于shop_id 和 sunmi_shop_no的说明:

在当前版本的接口中,推荐使用sunmi_shop_no替代shop_id作为唯一标识,可以保证门店唯一性,便于数据汇总。以前版本接口中的shop_id仍然可以使用。

shop_id 和 sunmi_shop_no的对应关系,可以由通过获取对接软件门店绑定状态接口获取。