PCB-PCBA序列号绑定接口规范

接口列表汇总

接口编号	接口名	接口描述
1	m.pms.tool.order.element.sn.bind	上位机主子多 sn 绑定(上位机)
2	m.pms.tool.order.element.query.by.mastersn	上位机根据主 sn 查下工具端绑定的子 sn(上位机)
3	m.pms.tool.order.element.sn.exchange.bind	上位机主子 sn 换绑(上位机)
4	m.pms.tool.material.category.get.bymaterielcode	根据物料码查询类目信息(上位机)
5	s.pt.dev.production.station.status.batchcommit	批量站位提交

上位机主子多 sn 绑定(上位机)

接口	版本	接口类型	所属应用	备注
m.pms.tool.order.element.sn.bind	1.0	Atop	Hebe	新接口

relationTypeCode 字段参考：

关系类型ID	采集信息	采集节点	上报方
1	PCB 批次和 PCB SN 关系	PCB 镭雕	MES
2	工单号和 PCB SN 关系	PCB 上板扫码	MES
3	PCB SN 和贴片物料批次关系	高速贴片	MES
4	PCB SN 和插件物料批次关系	插件	MES
5	PCB SN 和 PCBA SN 关系	分板	涂鸦工具端(目前用贴标方式)镭雕方式由 MES按工单维度镭雕完成时就上报,镭雕涉及内部 pms改动比较大，sn替换等
6	PCBA SN 和物料批次关系	预加工	MES
7	整机 SN 和 PCBA SN、物料SN 关系	装配	涂鸦工具端
8	整机 SN 和 PCBA SN 关系	整机测试	涂鸦工具端
9	工单号和生产线、员工 id 关系	-	MES

masterDataType 参考：

枚举 Code	枚举名称
sn	序列号
lotno	批次号

orderPeriod 参考：

枚举 Code	枚举名称
production	成品（整机）
pcba	半成品
smt	贴片

inputJson JSON 字符串
一个工单的数据放在同一个数组默认都必传，只有标了非必传的才可以不传。
入参：
{“inputJson”:“{
“orderSnBindVOList”: [
{
“orderCode”: “NJSGB14LF”,
“masterMaterialCode”: “1.02.03.44”,
“relationTypeCode”: 7,
“masterId”: “sn00001”,
“masterDataType”: “sn”,
“orderPeriod”: “”,
“origin”: “tuyaTool”,
“remark”: “”,
“snRelVOList”: [
{
“relMaterialCode”: “2.01.03.01”,
“relId”: “sn00008”,
“relDataType”: “sn”
},
{
“relMaterialCode”: “2.01.03.01”,
“relId”: “sn00008”,
“relDataType”: “sn”
}
]
}
]
}”
}
返回：
{
“errorCode”: “BD001”,
“errorMsg”:“grant_type params range invalid”,
“success”:false,
“t”:1668653657791,
“tid”:“20c1bf5f662311edbdda167745f25358”
}

上位机根据主 sn 查下工具端绑定的子 sn(上位机)

接口	版本	接口类型	所属应用	备注
m.pms.tool.order.element.query.by.mastersn	1.0	atop	Hebe	新接口

入参：
{
“inputJson”:
“{“orderCode”:“MO2205090060”,
“masterId”:“456456456456456”,
“origin”:“tuyaTool”}”
}
返回：
{
“result”: {
“masterMaterialCode”:“1.02.03.44”,//主料类目(成品，半成品，原材料)
“relationTypeCode”:7,//关联类型
“masterId”:“sn00001”,//主 sn 值
“masterDataType”:“sn”,//主料类型
“snRelVOList”:
[
{

“relMaterialCode”:“2.01.03.234”,
“relId”:“sn00008”,
“relDataType”:“sn”,
},
{
“relMaterialCode”:“2.01.02.123”,
“relId”:“sn00002”,
“relDataType”:“sn”,
}
]
},
“t”: 1740970541,
“success”: true
}

上位机主子 sn 换绑(上位机)

接口	版本	接口类型	所属应用	备注
m.pms.tool.order.element.sn.exchange.bind	1.0	atop	Hebe	新接口

入参：
{“inputJson”:“{
“operateType”:“exchangeBind”,//“unBind"预留解绑
“orderCode”:“NJSGB14LF”,
“masterId”: “456456456456456”,
“masterMaterialCode”:“1.02.03.44”,//主 sn 物料编码，非必传 后端获取
“relationTypeCode”:7,//关联类型
“masterDataType”:“sn”,//主料类型
“orderPeriod”:””,//生产阶段
“origin”:“tuyaTool”,
“snRelVOList”:[
{
“oldRelMaterialCode”:“2.01.03”,
“oldRelId”:“sn00008”,
“oldRelDataType”:“sn”,
“relMaterialCode”:“2.01.03”,
“relId”:“sn00008”,
“relDataType”:“sn”

},
{
“oldRleMaterialCode”:“2.01.04”,
“oldRelId”:“sn00004”,
“oldRelDataType”:“sn”,
“relMaterialCode”:“2.01.02”,
“relId”:“sn00002”,
“relDataType”:“sn”

}
]

}"
}
返回：
{
“result”: {
true
},
“t”: 1740970541,
“success”: true
}

根据物料码查询类目信息(上位机)

接口	版本	接口类型	所属应用	备注
m.pms.tool.material.category.get.bymaterielcode	1.0	atop	Hebe	新接口

入参：
{
“inputJson”:“[‘2.01.345’,‘2.02.346’]”//物料编码可 1 个或多个
}
返回：
{
“errorCode”: null,
“errorMsg”: null,
“data”:
[
{
“code”: “01”,
“name”: “模块”,
“fullPath”: “2.01”
},
{
“code”: “02”,
“name”: “转接板”,
“fullPath”: “2.02”
}
],
“success”: true
}

批量站位提交

接口	版本	接口类型	所属应用	备注
s.pt.dev.production.station.status.batchcommit	1.0	atop	Hebe	新接口

字段	类型	是否必须	描述
requestId	String	是	请求id
orderCode	String	是	工单编码
stationCode	String	是	站位编码
status	String	是	状态
sns	String	是	sn(多个使用 “,” 分割)

入参：
{
“sn”: “XHCXXXXXXXXXX010D,XHCXXXXXXXXXX010E”,
“stationCode”: “secondTest”,
“requestId”: “XHCXXXXXXXXXX010D_1713161265393”,
“status”: 1,
“orderCode”: “XHXXXXXXXXXX15”
}

出参：
{
“result”: 891,
“t”: 1713161266,
“success”: true
}