故障状态回调,用于实时回调给第三方平台设备故障预警信息,便于第三方及时做出解决方案。
说明:
- 发生故障报警之后,机器不能继续打印,不能继续下单,请先解决和修复故障之后,才能继续下单走打印。
- 适配机型:三通道自助机,进出料结构硬件部分采用我们公司的机器,可以使用上下料、红外线、库存缺货等故障和告警状态,不采用我们公司的上下料结构的硬件,不适用这些部分状态,只能使用和打印机相关的状态:打印故障、打印通信故障、废墨报警、系统故障等状态。
- 故障状态需要解除:发送解除故障事件
{"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