# 1. 接入准备

# 1.1 联系商务

联系商户,了解产品特性,沟通合作方式。

# 1.2 申请接入

在与简单购达成合作协议后,我方会线下给合作方提供merchant_codesecret_key信息,用于请求的认证.

  • merchant_code 开放平台商户唯一标示
  • secret_key 开放平台密钥

# 1.3 提交回调通知地址

平台会将相关内容通过HTTP回调的方式通知第三方系统,请参看2.1.2 HTTP异步通知

# 1.4 主流程说明

本流程为API调用核心步骤,需按顺序执行,确保各环节衔接顺畅。

# 1.4.1 基础配置:初始化设备与商品信息

完成前置准备后,依次调用以下接口完成核心要素配置:

  1. 调用 2.2.2.1 设备激活:完成设备激活,为自贩机设置名称等基础信息(设备未激活将无法执行后续操作)。
  2. 调用 2.2.1.2 商品列表:获取商品数据,如预备售卖商品不存在,可使用2.2.1.6 新品申请 添加商品。
  3. 调用 2.2.3.2 变更售卖规划:配置设备内售卖商品。

# 1.4.2 购物流程:设备控制与结果同步

简单购系统仅负责设备控制与订单识别,交易结算需在第三方系统完成。

  1. 调用 2.2.3.3 请求开门, 打开自贩机门锁,此时进入购物/补货流程。
  2. 获取开关门状态:支持两种方式确认状态,可根据业务场景自行选择。
    • 主动查询:调用 2.2.3.4 查询开门结果,实时获取开门/关门状态。
    • 被动接收:监听 2.2.3.5 开关门异步通知,系统将主动推送开门/关门状态。
  3. 订单识别完成后,本系统将推送识别结果至第三方系统,请参考2.2.3.7 订单结算通知
  4. 第三方系统接收结果后,在自身系统内完成结算等后续流程。

# 1.4.3 其他

  1. 支持设备广告管理,包括素材添加以及广告上下架,请参考2.2.4 广告管理,
  2. 支持对自贩机温度\音量\压缩机的控制,请参考2.2.2.7 设备控制
  3. 支持设备报修,请参考2.2.5 设备报修
  4. 开关门通知、结算通知等,需第三方系统接收通知,具体请参考2.2 HTTP SPI 异步通知,接收地址需联系对接人进行配置。
Last Updated: 2/27/2026, 10:27:52 AM