云打印机对接说明

特别声明:

商米云打印机对接通道为更好的保护合作伙伴的数据隐私,又能实现完整的订单打印过程,特订立以下对接规范,并需要商米与合作伙伴双方共同努力才能实现打印通道业务。

1. 了解一下对接流程

1.1 方案一:回调方式

  • ①在 https://partner.sunmi.com/ 注册一个合作伙伴平台账户,并获得账户;开通商米云打印机通道服务,并获得服务APP_ID、APP_KEY,用于接口API调用时使用;待合作伙伴接口开发上线后,还需要提供一个合作伙伴云URL给到商米云服务,用于让打印机回调合作伙伴API接口完成打印业务;
  • ②合作伙伴业务APP中,“商米配网SDK”提供了一个简单易用的蓝牙配置WIFI联网开发过程,简单调用就可以让打印机连接上云端;
  • ③SDK配网过程会自动获得打印机设备SN号,这个SN是设备的唯一标识符,利用它就可以绑定对应的商家账号完成业务通讯;
  • ④合作伙伴业务APP中,使用SN号去合作伙伴云建立设备与商家店铺的关联关系;
  • ⑤合作伙伴业务APP中,使用SN号调用商米云API绑定接口,建立设备SN与合作伙伴ID、商铺ID的关联关系;
  • ⑥合作伙伴云对接商米订单推送、声音推送等API接口,建立起消息通讯通道;
  • ⑦商米云在接收到推送消息以后,会自动向打印机下发业务消息 (仅新订单消息,非具体业务内容) ;
  • ⑧打印机在收到触发消息以后,使用之前提供的合作伙伴云URL去回调API接口获取订单的打印内容,并打印出来;
  • ⑨打印业务对接完成以后,如果还需要进一步管理设备时,可以在合作伙伴业务APP中直接调用商米“设备管理页面”进行打印管理。更多的打印机设置内容将不断的完善,让商家可以获得更好的体验。

1.2 方案二:直推方式

  • ①在 https://partner.sunmi.com/ 注册一个合作伙伴平台账户,并获得账户;开通商米云打印机通道服务,并获得服务APP_ID、APP_KEY,用于接口API调用时使用;
  • ②合作伙伴业务APP中,“商米配网SDK”提供了一个简单易用的蓝牙配置WIFI联网开发过程,简单调用就可以让打印机连接上云端;
  • ③SDK配网过程会自动获得打印机设备SN号,这个SN是设备的唯一标识符,利用它就可以绑定对应的商家账号完成业务通讯;
  • ④合作伙伴业务APP中,使用SN号去合作伙伴云建立设备与商家店铺的关联关系;
  • ⑤合作伙伴业务APP中,使用SN号调用商米云API绑定接口,建立设备SN与合作伙伴ID、商铺ID的关联关系;
  • ⑥合作伙伴云对接商米订单推送、声音推送等API接口,建立起消息通讯通道,推送打印、语音数据;
  • ⑦商米云在接收到推送消息以后,会自动向打印机下发业务消息;
  • ⑧打印业务对接完成以后,如果还需要进一步管理设备时,可以在合作伙伴业务APP中直接调用商米“设备管理页面”进行打印管理。更多的打印机设置内容将不断的完善,让商家可以获得更好的体验。