JOYZL SCADA Scanner

接口

扫码端(JOYZL SCADA Scanner)支持配置工号校验，工件校验，提交换批和，报告故障接口，用于与其他系统（例如 MES 或 ERP 等管理系统）交互。扫码端(JOYZL SCADA Scanner) 通过 HTTP POST 方式请求这些接口，数据接收方不应对扫码端接口设置登录和权限验证前提，对于安全方面的要求，可通过限制来源地址等其它方式实现。

工号校验

扫码端(JOYZL SCADA Scanner)每次读取到工号编码（条形码或二维码）时会立即请求 工号校验 接口验证工号是否有效员工，如果有效应返回员工名称。扫码端(JOYZL SCADA Scanner)以 POST 方式发送请求键值对参数，接收方验证编码后以 HTTP Status 200 OK 状态码返回成功，响应内容为员工名称；其它状态码均表示无效，响应内容为无效原因。

响应内容应为有效的 UTF-8 编码字符串，最多允许 64 个字符（不是字节数），如果超过最大长度，多余字符将被静默截断。

校验方系统通常为 MES 或 ERP 系统，应确保快速校验并响应，如果长时间等待会降低扫码端操作效率，并引发用户抱怨。工号无效的可能性有：工号不存在、员工状态冲突等。

未配置此接口时，不执行工号校验，只要工号符合设定字符长度，默认为员工有效。

请求示例

POST /scanner/employee HTTP/1.1
ContentType: application/x-www-form-urlencoded
ContentLength: 30

employee=10001&equipment=GT001

示例中的 /scanner/employee 表示接口提供方指定的路径。 employee为员工工号（必要）； equipment为机台编号（必要）。

响应示例

HTTP/1.1 200 OK
Content-Type: text/plain; charset=UTF-8
Content-Length: 4

小陈

HTTP/1.1 404 Not Found
Content-Type: text/plain; charset=UTF-8
Content-Length: 8

无效工号

工件校验

扫码端(JOYZL SCADA Scanner)每次读取到产品工件编码（条形码或二维码）时会立即请求 工件校验 接口验证编码是否有效，如果有效应返回对应的产品名称。扫码端(JOYZL SCADA Scanner)以 POST 方式发送请求键值对参数，接收方验证编码后以 HTTP Status 200 OK 状态码返回成功，响应内容为产品名称；其它状态码均表示无效，响应内容为无效原因。

响应内容应为有效的 UTF-8 编码字符串，最多允许 64 个字符（不是字节数），如果超过最大长度，多余字符将被静默截断。

校验方系统通常为 MES 或 ERP 系统，应确保快速校验并响应，如果长时间等待会降低扫码端操作效率，并引发用户抱怨。用于加工环节扫码，产品编码无效的可能性有：系统中不存在、已入库、未出库等。

未配置此接口时，不执行工件编号校验，只要当前批次未重复，默认为工件有效。

请求示例

POST /scanner/check HTTP/1.1
ContentType: application/x-www-form-urlencoded
ContentLength: 56

code=JOYZL-20251217-09876&equipment=GT001&employee=10001

示例中的 /scanner/check 表示接口提供方指定的路径。 code为读取的产品或工件编码（必要）； equipment为机台编号（可选）； employee为员工工号（可选）。

响应示例

HTTP/1.1 200 OK
Content-Type: text/plain; charset=UTF-8
Content-Length: 8

JOYZL M02-01

HTTP/1.1 404 Not Found
Content-Type: text/plain; charset=UTF-8
Content-Length: 8

批次未登记

提交换批

扫码端(JOYZL SCADA Scanner)可将扫入的多个工件加工记录批量提交给管理系统。当作业人员执行换批操作时，扫码端以 POST 方式发送 JSON 内容，接收方收取成功后以 HTTP Status 200 OK 状态码表示成功，其它状态码均表示失败，均无须提供任何响应内容。

接收方系统通常为 MES 或 ERP 系统。如果提交失败，扫码端(JOYZL SCADA Scanner) 将稍后重试。

未配置此接口时，换批仅作本地处理。

请求示例

POST /scanner/post HTTP/1.1
Content-Type: application/json; charset=UTF-8
Content-Length: 282

{
	// 批次编号（必要），由扫码端生成
	"Number":"20260714-55756",
	"Pieces":[
		{
			// 工件编码（可选）
			"Code":"1234567890",
			// 员工编号（可选）
			"Employee":"1234",
			// 工装编号（可选）
			"Tooling": "MOLD001",
			// 机台标识（必要）
			"EquipmentId":317353539056580,
			// 机台编号（必要）
			"EquipmentNumber":"F3",
			// 工件扫码时间（可选）
			"Scan":"2026-07-14 15:29:32",
			// 工件开始加工时间（可选）
			"Begin":"2026-07-14 15:30:01",
			// 工件结束加工时间（可选）
			"End":"2026-07-14 15:32:30",
			// 检验结果（可选）
			"Verdict":{
				"Name":"UN",
				"Value":0
			}
		},
		{
			"Code":"0987654321",
			"Employee":"1234",
			"Tooling": "MOLD001",
			"EquipmentId":317353539056580,
			"EquipmentNumber":"F3",
			"Scan":"2026-07-14 15:29:35",
			"Begin":"2026-07-14 15:33:01",
			"End":"2026-07-14 15:35:30",
			"Verdict":{
				"Name":"EX",
				"Text":"异常",
				"Value":2
			}
		}
	]
}

工装编号(Tooling) 表示当前机台加工时所用的工具，例如：刀具、模具、砂轮、夹具或检具等。可通过扫码端(JOYZL SCADA Scanner)扫描工具的条形码或二维码来登记，如果有多个工具时，将由逗号作为分隔符拼接编号。

工件加工开始和结束时间(Begin, End) 依赖机台提供的作业状态信号，如果机台未能提供可用于数据采集监测的状态信号，则没有工件加工开始和结束时间。

检验结果(Verdict) 的值有：UN（0 未知）、OK（1 合格）、EX（2 异常）和 NG（3 不良），默认值为 UN。 OK 和 NG 值在配合产品检验设备时才会出现，其结果值由检验设备提供的数据决定。 EX 值在扫码端(JOYZL SCADA Scanner)配置了加工过程监测功能时才会出现，表示产品加工过程中监测到了异常。

响应示例

HTTP/1.1 200 OK
Content-Length: 0

HTTP/1.1 404 Not Found
Content-Length: 0

报告故障/恢复

扫码端(JOYZL SCADA Scanner)支持由作业人员报告机台故障（或恢复生产）给管理系统。扫码端(JOYZL SCADA Scanner)以 POST 方式发送请求键值对参数，接收方验证编码后以 HTTP Status 200 OK 状态码返回成功，其它状态码均表示失败，均无须提供任何响应内容。

接收方系统通常为 MES 或 ERP 系统。如果提交失败，扫码端(JOYZL SCADA Scanner) 将稍后重试。

未配置此接口时，报告故障仅做本地提示，此时将无法继续扫码，直至恢复生产。

请求示例

POST /scanner/report HTTP/1.1
ContentType: application/x-www-form-urlencoded
ContentLength: 27

equipment=GT001&state=FAULT

示例中的 /scanner/report 表示接口提供方指定的路径。 equipment为机台编号（必要）； state为机台状态（必要），值可为 FAULT 或 NORMAL 分别表示故障和正常。

响应示例

HTTP/1.1 200 OK
Content-Type: text/plain; charset=UTF-8
Content-Length: 0

HTTP/1.1 404 Not Found
Content-Type: text/plain; charset=UTF-8
Content-Length: 0