mescloud/docs/PDAGP12检查接口说明.md

PDA GP12 检查接口说明

模块：MesProductGp12Controller
服务地址示例：http://127.0.0.1:8980
返回格式：submit 为 JeeSite renderResult；pdaCheckItems、pdaQueryBySn 为 CommonResp（result / message / data）
说明：后台在「工件类型」中维护 GP12 检查项。员工用 PDA 扫工件码后，按该工件类型展示检查项并提交。

---

后台维护

1. 打开 工件类型管理
2. 对应类型操作列点击 GP12检查项
3. 新增检查项：名称、输入类型（选择框/输入框）、排序、最小值/最大值（输入框时）

检查项表：mes_product_gp12_check，通过 cate_sn 关联 mes_product_cate.sn。

---

1. 按工件码查询工件信息

请求URL

• /js/a/mes/mesProductRecord/pdaQueryBySn

请求方式

• POST

参数

参数名	必选	类型	说明
sn	是	string	工件码

返回字段说明

字段路径	类型	中文说明
data.sn	string	工件码
data.cate	string	原字段，工件 cate 去掉末尾 2 位
data.cateSn	string	工件完整类型编号（mes_product.cate）
data.title	string	工件名称
data.oprno	string	固定 GP12

---

2. 查询 GP12 检查项

扫码后调用本接口，展示该工件类型下已启用的检查项。

请求URL

• /js/a/mes/mesProductGp12/pdaCheckItems

请求方式

• POST / GET

参数

参数名	必选	类型	说明
sn	是	string	工件码，优先用此参数匹配检查项
cateSn	否	string	工件类型编号，无工件码时可用

参数示例

curl --location --request POST "http://127.0.0.1:8980/js/a/mes/mesProductGp12/pdaCheckItems?sn=工件码"

返回示例

{
    "result": "true",
    "message": "成功",
    "data": {
        "sn": "工件码",
        "cateSn": "HEVXT",
        "oprno": "GP12",
        "title": "工件名称",
        "cate": "HEVXT",
        "needImage": true,
        "remarkRequired": false,
        "list": [
            {
                "id": "检查项ID",
                "title": "外观检查",
                "cateSn": "HEVXT",
                "input": "1",
                "inputName": "选择框",
                "minValue": null,
                "maxValue": null,
                "sort": 1,
                "needImage": true
            },
            {
                "id": "检查项ID2",
                "title": "尺寸",
                "cateSn": "HEVXT",
                "input": "2",
                "inputName": "输入框",
                "minValue": "1.000",
                "maxValue": "2.000",
                "sort": 2
            }
        ]
    }
}

返回字段说明

字段路径	类型	中文说明
data.list[].id	string	检查项ID，提交时回传
data.list[].title	string	检查项名称
data.list[].input	string	1 选择框，2 输入框
data.list[].minValue / maxValue	string	输入框上下限，选择框可为空
data.list[].needImage	boolean	该项必须上传照片
data.needImage	boolean	每一项都必须上传照片
data.remarkRequired	boolean	false，备注选填

---

3. 提交 GP12 检查

原接口不变：无检查项模板时，仍只提交 sn / oprno / lineSn / 照片。

该工件类型已维护检查项时，必须带 checkList，提交全部检查项，且每一项必须上传照片。备注为选填。

请求URL

• /js/a/mes/mesProductGp12/submit

请求方式

• POST

参数

参数名	必选	类型	说明
sn	是	string	工件码
oprno	是	string	工位号，一般为 GP12
lineSn	是	string	产线编号
remark	否	string	备注，选填
ucode	否	string	PDA 账号，写入创建人
mesProductGp12_image	否	string	整单照片文件ID，先调 /js/a/file/upload
checkList	按模板	string	JSON 数组，见下

checkList 单项

参数名	必选	类型	说明
id / checkId	是	string	检查项ID，来自接口 2
content	是	string	选择框：true/false；输入框：数值
mesProductGp12Items_image / image	是	string	该项照片文件ID，多个用逗号分隔

参数示例

curl --location --request POST "http://127.0.0.1:8980/js/a/mes/mesProductGp12/submit" ^
  --form "sn=工件码" ^
  --form "oprno=GP12" ^
  --form "lineSn=HEVXT" ^
  --form "ucode=zhangsan" ^
  --form "remark=选填备注" ^
  --form "checkList=[{\"id\":\"检查项ID\",\"content\":\"true\",\"image\":\"文件ID1\"},{\"id\":\"检查项ID2\",\"content\":\"1.5\",\"image\":\"文件ID2\"}]"

说明

• 同一工件码已有 GP12 记录时，仍返回「该记录已存在」
• 有检查项时，整单 result 由各项汇总：全部 OK 为 OK，否则 NG
• 选择框：true / 1 / OK / 是 / 合格 为 OK
• 输入框：在最小~最大值范围内为 OK
• 每一项都必须先上传照片，缺一张即整单失败，返回「请为每一项上传照片」
• 照片上传与点检相同：先 POST /js/a/file/upload，bizType=mesProductGp12Items_image，uploadType=image，再把文件 ID 写入检查项
• 备注为选填，写入 GP12 记录的 remark