部位材料用量接口
接口说明
接口地址: /gys/material-track/positionMaterial/positionMaterialSync
接口用途:第三方部位材料用量数据导入
请求方式:POST
请求参数:JSON格式字符串
注意事项:
1、调用接口之前，一定要选择正确的“部位材料及量来源”，否则可能导致接口导入失败;
开启方式：切换到项目层，在【管控中心】-【系统设置】-【参数设置】-【部位管理】-【部位材料及量来源】选择“其他系统”。
2、同步部位材料信息之前，先同步所属部位信息;
3、为避免调用超时,请分批次传递数据,依次调用不要超过100条;
请求参数
| 参数 |
类型 |
必填 |
取值范围(字符长度) |
描述 |
| projectId |
Long |
N |
1-20 |
项目id,projectId和syncCode有且只能其一有值 |
| syncCode |
String |
N |
0-255 |
同步编码,projectId和syncCode有且只能其一有值 |
| sourceCode |
String |
Y |
0-255 |
数据来源（三方系统标示） |
| positionMaterialSyncVos |
Array |
Y |
|
部位材料用量数据集合 |
positionSyncInfos格式:
| 字段 |
类型 |
必填 |
描述 |
| unitId |
String |
Y |
部位材料用量行三方id |
| optType |
int |
Y |
操作类型,0为新增/编辑,2为删除 |
| unitPId |
String |
N |
部位材料用量行所属部位三方id，用于建立部位材料用量和部位的关系,unitPid和fullName有且只能其一有值 |
| fullName |
String |
N |
部位材料用量行所属部位的全名称，用于建立部位材料用量和部位的关系,unitPid和fullName有且只能其一有值 |
| materialId |
Long |
N |
材料id(适用场景：将项目管理平台的材料信息同步到了三方系统中)；materialId和materialUnitId有且只能其一有值 |
| materialUnitId |
String |
N |
材料三方id(适用场景：三方系统将材料信息同步到了项目管理平台)；materialId和materialUnitId有且只能其一有值 |
| drawQuantity |
double |
N |
图纸量，默认0 |
| constructionOptimization |
double |
N |
施工优化量.默认0 |
| lossRatio |
double |
N |
合理损耗率，默认0(例如：损耗率为2%，则传递：2) |
| changeQuantity |
double |
N |
变更量，默认0 |
请求参数示例格式：
{
"syncCode": "abc",
"sourceCode": "xx",
"positionMaterialSyncVos": [
{
"unitId": "1663581281019144",
"materialId": "1562949",
"fullName": "aaa",
"drawQuantity": 20,
"constructionOptimization": 123,
"lossRatio":2 ,
"changeQuantity": 20,
"optType": 0
}
]
}
成功返回值
{
"code": 200,
"data": "{\"syncFailData\":[]}",
"message": "操作成功",
"success": true
}
异常返回值说明
{
"code": 200,
"data": "{\"syncFailData\":[{\"errorMsg\":\"根据unitPid或者fullName未找到对应的部位信息\",\"unitId\":\"1663581281019144\",\"fullName\":\"aaa\",\"drawQuantity\":20,\"optType\":0}]}",
"message": "操作成功",
"success": true
}
data为导入失败数据封装后的JsonStr
内部字段解释:
-- syncFailData 封装同步失败的数据
-- 异常原因封装在 errorMsg字段中