# 1. 接入准备
# 1.1 联系商务
联系商户,了解产品特性,沟通合作方式。
# 1.2 申请接入
在与简单购达成合作协议后,我方会线下给合作方提供merchant_code和secret_key信息,用于请求的认证.
merchant_code开放平台商户唯一标示secret_key开放平台密钥
# 1.3 提交回调通知地址
平台会将相关内容通过HTTP回调的方式通知第三方系统,请参看2.1.2 HTTP异步通知
# 1.4 主流程说明
本流程为API调用核心步骤,需按顺序执行,确保各环节衔接顺畅。
# 1.4.1 基础配置:初始化设备与商品信息
完成前置准备后,依次调用以下接口完成核心要素配置:
- 调用
2.2.2.1 设备激活:完成设备激活,为自贩机设置名称等基础信息(设备未激活将无法执行后续操作)。 - 调用
2.2.1.2 商品列表:获取商品数据,如预备售卖商品不存在,可使用2.2.1.6 新品申请添加商品。 - 调用
2.2.3.2 变更售卖规划:配置设备内售卖商品。
# 1.4.2 购物流程:设备控制与结果同步
简单购系统仅负责设备控制与订单识别,交易结算需在第三方系统完成。
- 调用
2.2.3.3 请求开门, 打开自贩机门锁,此时进入购物/补货流程。 - 获取开关门状态:支持两种方式确认状态,可根据业务场景自行选择。
- 主动查询:调用
2.2.3.4 查询开门结果,实时获取开门/关门状态。 - 被动接收:监听
2.2.3.5 开关门异步通知,系统将主动推送开门/关门状态。
- 主动查询:调用
- 订单识别完成后,本系统将推送识别结果至第三方系统,请参考
2.2.3.7 订单结算通知。 - 第三方系统接收结果后,在自身系统内完成结算等后续流程。
# 1.4.3 其他
- 支持设备广告管理,包括素材添加以及广告上下架,请参考
2.2.4 广告管理, - 支持对自贩机温度\音量\压缩机的控制,请参考
2.2.2.7 设备控制。 - 支持设备报修,请参考
2.2.5 设备报修。 - 开关门通知、结算通知等,需第三方系统接收通知,具体请参考
2.2 HTTP SPI 异步通知,接收地址需联系对接人进行配置。