云打印机对接说明

7. 需要了解的其他FAQ

a) 对接流程逻辑上如何保证打印机一定能够接到订单?

答:商米云打印机有如下流程来保证:

1、打印机接入商米云MQTT服务器,该服务器采用集群架构,由商米运维团队进行维护,具有多年百万量级的商米设备接入经验打磨而成,保证了订单消息的触发和推送。

2、打印机接到订单以后,会发起HTTP订单列表请求,而且将订单限制在5条以内,有效避免了高峰时期大量订单拥挤到打印机端,从而导致丢单的问题。

3、打印机获取订单列表以后,会按列表顺序一张一张订单拉取详情进行打印,而且只有在上一张打印完毕以后,才会打印下一张订单。

4、订单打印完毕以后,打印机还会上报打印结果给服务器,让服务器实时了解订单是否已经打印完成。未上报打印完成状态的订单还可以被再次拉取打印。

5、打印中途,如果因为纸用完了,在重新装纸以后,订单会从头再打印一遍,避免了内容缺失。

6、打印中途,如果因为断电,在重新开机以后,会主动到服务器上重新拉取未打印的订单来打印。

7、打印中途,如果因为断网,只有拉取完整的订单才会打印出来,拉取一半的订单是不会打印出来的。

8、打印途中,如果因为卡纸等故障,导致打印不完整。商家可以通过按键重打最后一张订单,免去操作软件的过程。

9、如果确实由于网络因素,打印机请求多次也没有拉取到新订单数据,可以在接收到第二个新订单消息时,还是会将第一个订单拉取并打印出来。

10、打印机采用弱网切换,可以自动寻找连接顺畅的网络进行连接,网络切换时间只需20秒。

11、打印机是否断网,云指示灯会提示目前服务器是否正常连接。

12、商家怀疑网络不好时,可以通过按键自检网络状态,打印机会打印出一张检测报告,告诉你哪里出了问题。

13、打印机网络真的出现短时间无法修复问题时,还可以使用商家手机版接单,然后通过手机蓝牙向打印机发送订单,利用蓝牙将订单打印出来。

b) 打印过程缺纸,订单会不会丢失?

答:当出现打印过程缺纸时,只要重新装好纸卷,未完成的票据将会自动完整的重新打印出来;

c) 打印过程卡纸了,订单打印不完整怎么办?

答:打印机提供按键重打功能,只要双击键就可以重新打印最后一张订单;

d) 如何进行打印机wifi配网?

答:商米云打印机采用的是蓝牙配网方式,这种方式可以有效避免手机和打印机不在同一个Wifi路由器环境下的跨网段配网问题。商米已经为开发者准备了3套蓝牙配网SDK,一套是用于安卓下的配网SDK,一套是用于苹果手机的配网SDK,还有一套是用于微信小程序的配网SDK。使用这三套SDK的基础原理都是让开发者很方便的调用蓝牙进行通讯,避免各种因为通讯异常造成的重连机制开发难度。

e) 店铺WIFI网络不好导致丢单怎么办?

答:网络状态因为影响因素众多,目前还没有终极的解决方案,所以购买WIFI+GPRS版本的打印机将自动带有弱网切换功能。在平时打印机将使用WIFI联网进行通讯,如果WIFI网络通讯不稳定时,打印机就会自动切换的GPRS网络进行通讯,等待WIFI恢复正常时再切换回来,避免了因此造成的订单无法接收的问题。因为GPRS的速率受限,接单体验上没有WIFI那么快,但因为GPRS属于备用通道,保证订单不丢失才是首要考虑的。

f) 打印机网络异常了,但手机上还能收到单,怎么打印出来?

答:商米云打印机支持云、USB、蓝牙事务打印模式,允许在连接网络打印的情况下,仍然可以通过USB和BT接收来自收银机和手机的数据进行打印。所以如果手机上有订单,可以让手机蓝牙连接打印机,将票据内容通过蓝牙发送给打印机打印即可。

g) 网络异常了,如何快速查找问题点?

答:网络状态因为影响因素众多,目前还没有终极的解决方案,所以打印机带有网络自检功能,只要双击键,稍等几秒就会有一张网络自检票据打印出来,从票据中的FAIL项就可以分析网络目前处于何种故障,将故障信息提供给技术人员解决;

检测信息信息说明故障解决
Current Network目前正在业务通讯的是WIFI网络还是GPRS网络。如若未配置WIFI,请忽略此异常。如果一直处于GPRS网络,说明WIFI通路有问题,就需要检查一下打印机WIFI配置是否正确,或者路由器是否工作正常。如若未配置WIFI,请忽略此异常。
Link=>SSID:目前连接的WIFI路由器SSID名称是什么,并且连接是否正常。连接上PASS,断开中FAIL。没有SSID名称就说明打印机并没有配置WIFI,需要重新执行WIFI配网过程。如果有SSID名称,那就需要检查该SSID名称的WIFI路由器工作是否正常,或者打印机重新进行WIFI配网。
Link=>GPRS目前的GPRS通道连接是否正常。连接上PASS,断开中FAILGPRS信号差,请将设备远离金属和多层墙壁的位置后,再次尝试。另GPRS连接速度比较慢,打印机刚开机还未连接上基站也会导致测试失败,稍等几分钟再测试一遍即可。
Check=>DHCP Conflict检查网络环境中是否存在多个DHCP情况,多个DHCP或没有DHCP会导致网络连接异常。只有一个DHCP时PASS,有多个DHCP时Warn,没有DHCP为FAIL本项依赖Link测试项为PASS情况下,FAIL的故障分析才有意义,否则请忽略以下分析内容。如若Link=>SSID项未FAIL,请先确保其为Pass。
Warn表示网络中私搭的WIFI路由器导致DHCP冲突,请检查网络中是否存在多个路由器开启了DHCP模式。如果是请关闭多余的DHCP,只保留一个可以连接外网的即可。
FAIL表示网络中没有配置DHCP服务器,打印机无法获得IP地址。请检查网络中的DHCP服务器是否故障。
Check=>IP Conflict检查网络环境中是否存在IP地址重复,多个IP地址相同会导致网络通讯异常。没有重复IP时PASS,有多个重复IP时FAIL本项依赖Link测试项为PASS情况下,FAIL的故障分析才有意义,否则请忽略以下分析内容。如若Link=>SSID项未FAIL,请先确保其为Pass。
网络中的多个DHCP服务冲突或者手工给设备配置IP地址时,就会引起IP地址冲突。请关闭多余的DHCP服务,或者找到冲突的IP地址设备,修改IP地址为使用DHCP分配。
Ping=>GW检查设备与网关之间的链路,从而判断内网连接是否正常。返回值是延迟值,通过延迟值判断网络的速率是否达标,如果网关不通时FAIL本项依赖Check测试项为PASS情况下,FAIL的故障分析才有意义,否则请忽略以下分析内容。如若Check=>DHCP Confilict项FAIL,请先确保其为Pass。
网关一般都指向了WIFI路由器或者基站本身,Ping值太高或者FAIL就需要检查WIFI路由器是否工作正常,或者移动基站信号不好。
Ping=>DNS检查设备与公网根DNS之间的链路,从而判断是否已经连接上外网。返回值是延迟值,通过延迟值判断网络的速率是否达标,如果网关不通时FAIL本项依赖Ping=>GW测试项为PASS情况下,FAIL的故障分析才有意义,否则请忽略以下分析内容。如若Link=>GPRS、Ping=>GW项均为FAIL,请先确保其为Pass。
DNS根服务器是互联网上的主节点,能Ping通说明打印机已经连上了互联网。Ping值太高或者FAIL就需要检查WIFI路由器是否工作正常,或者移动基站信号不好。
Ping=>MQTT Server检查设备与MQTT服务器的链路,从而判断是否已经连接上业务服务器。返回值是延迟值,通过延迟值判断网络的速率是否达标,如果网关不通时FAIL本项依赖Ping=>GW、Ping=>DNS测试项为PASS情况下,FAIL的故障分析才有意义,否则请忽略以下分析内容。如若Link=>GPRS、Ping=>GW项均为FAIL,请先确保其为Pass。
MQTT是订单推送服务器,能Ping通说明订单推送服务器链路正常。Ping值太高或者FAIL就需要咨询设备厂商客服人员进行检查。
Ping=>HTTP Server检查设备与HTTP服务器的链路,从而判断是否已经连接上业务服务器。返回值是延迟值,通过延迟值判断网络的速率是否达标,如果网关不通时FAIL本项依赖Ping=>GW、Ping=>DNS测试项为PASS情况下,FAIL的故障分析才有意义,否则请忽略以下分析内容。如若Link=>GPRS、Ping=>GW项均为FAIL,请先确保其为Pass。
HTTP是订单内容服务器,能Ping通说明订单服务器链路正常。Ping值太高或者FAIL就需要咨询设备厂商客服人员进行检查。
MQTT=>Check Config打印机通讯主要靠MQTT,所以会自动检查服务器信息是否正确,是否可以接收来自云的订单消息。信息正确时PASS,信息错误时FAIL本项依赖Ping=>HTTP测试项为PASS情况下,FAIL的故障分析才有意义,否则请忽略以下分析内容。如若Ping=>HTTPServer项为FAIL,请先确保其为Pass。
如果接入MQTT服务器的信息出现错误,就需要咨询设备厂商客服人员进行检查。
MQTT=>Connect打印机通讯主要靠MQTT,检查MQTT目前是否连接着,是否可以接收来自云的订单消息。连接上PASS,断开中FAIL本项依赖MQTT=>MQTT config测试项为PASS情况下,FAIL的故障分析才有意义,否则请忽略以下分析内容。如若MQTT=>Check Config项为FAIL,请先确保其为Pass。
如果接入MQTT连接出现错误,就需要咨询设备厂商客服人员进行检查。
MQTT=>R&W打印机通讯主要靠MQTT,检查MQTT通讯数据是否正常,是否可以接收来自云的订单消息。可以通讯PASS,无法通讯FAIL本项依赖MQTT=>MQTT Link测试项为PASS情况下,FAIL的故障分析才有意义,否则请忽略以下分析内容。如若MQTT=>Connect项为FAIL,请先确保其为Pass。
如果接入MQTT服务器的信息出现错误,就需要咨询设备厂商客服人员进行检查。

h) 打印机自检页如何操作?

答:需要完整查看打印机硬件信息,可以通过自检页了解,只要按下键再按下键后同时松开就可以打印出来;

i) 打印出来的票据是乱码,怎么回事?

答:商米云打印机目前支持全球字库打印,所以采用UTF8编码格式,所以传输的文字都要转码成UTF8才能打印出来。采用UTF8编码后就可以实现票据内容多语种混打,满足一些行业服务特定外国人群时的双语种打印问题。

j) 播报语音内容是否可以修改?

答:商米云打印机采用TTS语音合成技术,无论你发什么文字,都可以转换成语音播报出来。也就是说只要场景需要,票据的菜品、联系方式、备注都可以按照你的想法读出来。但由于一些多音字的存在,某些特定的语句可能无法按照你的期望正确发音,所以可以将文字替换成相同发音的非多音字来播报。

k) 如何变更wifi配置?

答:设备wifi配对以后,如果需要变更接入wifi节点,只需要重新执行配网即可,不用解除授权重新绑定。

l) 云打印机和别的外卖平台是否可以同时接单?

答:外卖平台的接入数量是依据饿了么和美团的规则而定,不是由云打印机自行决定的。饿了么允许多台打印机接入相同的账号,并且同时接单打印。而美团只允许一台打印机接入一个账号,如果授权绑定了别的平台,那原有的就会被强制解除授权。

m) GPRS版本送SIM卡吗,每个月有多少流量?

答:商米云打印机是内置eSIM,不需要另外使用插卡,是直接连接到2G网络的,没有流量限制。

n) 设备通过商米助手APP绑定了,还能解绑吗?

答:可以解绑的,在商米助手中点击设备右上角的小点,其中有删除设备。删除后可以使用另一个手机重新连接绑定。已经被绑定的就无法被另一个账号绑定的。

o) 绑定打印机时,提示“设备蓝牙连接失败”?

答:云打印机绑定时是使用蓝牙进行通讯的,提示“蓝牙连接失败”,一般是由于安卓版本的APP定位权限授权没有打开。进入 设置-应用-商米助手-权限-定位 打开。

p) 指示灯的功能?

答:云打印机有三个指示灯,第一个是绿色电源灯,只要上电就常亮;第二个是蓝色网络灯,连接上服务器就常亮,灭就表示网络不通;第三个是红色异常灯,发生缺纸、过热、异常就亮,故障排除就灭。