故障状态回调

最后更新:2026-09-22 15:55:50

故障状态回调,用于实时回调给第三方平台设备故障预警信息,便于第三方及时做出解决方案。

说明:

  • 发生故障报警之后,机器不能继续打印,不能继续下单,请先解决和修复故障之后,才能继续下单走打印。
  • 适配机型:三通道自助机,进出料结构硬件部分采用我们公司的机器,可以使用上下料、红外线、库存缺货等故障和告警状态,不采用我们公司的上下料结构的硬件,不适用这些部分状态,只能使用和打印机相关的状态:打印故障、打印通信故障、废墨报警、系统故障等状态。
  • 故障状态需要解除:发送解除故障事件 {"event":"020"},服务端返回 {"event":"'020","code":"0","msg":"成功"},解除故障之后,查询设备状态是就绪状态,可以下单打印。

接口信息

参数名 参数值 参数说明
IP 192.168.127.11 局域网内使用对应的 IP
端口 63333 固定的端口
连接方式 TCP 采用 TCP 的长连接方式
编码格式 UTF8 收发数据全部采用 UTF8 编码
数据格式 json 数据发送与接收都采用 Json 格式

回调示例

{"event":"019","status":"43","msg":"打印机通信故障","notice_time":"2026-05-15 12:00:00"}

返回结果

参数名 参数值(示例) 数据类型 参数说明
event 019 string 019 故障状态回调事件
status 43 string 故障状态码,取值见下方「错误代码」表
msg 完成打印 string 故障信息提示
notice_time 2026/5/15 12:00:00 string 状态反馈时间,时间格式 yyyy-MM-dd HH:mm:ss

注:返回结果示例中 msg 值为「完成打印」,与故障语境不符,如实保留。

错误代码

状态码 描述
41 系统故障,TCP 打印机服务软件发生异常错误,这种异常错误会影响打印流程的执行
42 机器故障,打印机器(包括打印机和上下料硬件)发生故障,会影响正常上下料和喷墨,无法正常打印,打印停止
43 打印机通信故障,将无法和打印机正常通信,打印停止,无法打印
44 串口通信故障,上下料使用串口通信,报故障之后,上下料无法执行,打印停止
45 打印机打印 Y 轴无法复位,打印停止
46 机器上料(进货)故障,无法上料打印,打印停止
47 机器下料(出货)故障,无法正常出货,打印停止
48 出货机构归位故障,打印完成之后,推出物料,但是无法自动归位到原点,出于安全考虑,请立即停止打印
49 红外线报警,上下料的时候,物料挡住了红外线对射,出于安全考虑,立即停止打印
50 打印机打印故障,打印机正在打印过程中,因为硬件或者内部软件异常,无法继续打印,打印停止
51 废墨报警,废墨已满,立即停止打印,否则将会洒墨
40 其他故障,没有给出特定故障的其他故障状态,也是要停止打印,检查和恢复

若设备在调试过程中遇到不能解决问题,可以联系云打印负责人排除问题,找到解决的方法。联系方法如下:

  • 电 话:137-5177-4454【微信同号】
  • 邮 箱:info@ColorPark.cn