导入项目申请单接口
接口说明
接口地址: /gys/inspection-micro-service-web-api/requisition/batchAdd
接口用途: 项目层用料申请单导入接口
请求方式: POST
请求参数: JSON格式字符串
注意事项:单次请求条数不超过100条,大于100条,请分批次推送
HTTP请求方式
POST
请求参数
参数 | 类型 | 必须 | 取值范围 | 默认值 | 描述 |
---|---|---|---|---|---|
jsonStr | String | Y | json对象 详细格式见下 |
请求参数各项属性说明
申请单主表属性
参数 | 类型 | 必须 | 取值范围(字符长度) | 默认值 | 描述 |
---|---|---|---|---|---|
syncCode | String | Y | 0-255 | 项目同步编码 | |
unitId | String | Y | 0-255 | 第三方唯一主表id | |
requisitionNo | String | Y | 0-50 | 申请单编号 | |
positionId | Long | Y | 0-20 | 部位id(物料部位id,如果没值传-1) | |
positionName | String | Y | 0-255 | 部位全名称(施工位置) | |
teamId | Long | Y | 0-20 | 用料单位id(物料用料单位id,如果没值传-1) | |
teamName | String | Y | 0-255 | 用料单位名称 | |
vendorUnitId | String | Y | 255 | 用料单位第三方id | |
proposerId | Long | Y | 0-20 | 申请人id(如果没值传-1) | |
proposer | String | Y | 0-255 | 申请人名称 | |
useTime | String | Y | 计划用料时间(格式:”yyyy-mm-dd hh:mm:ss”) | ||
projectName | String | N | 0-255 | 项目名称 | |
itemType | String | N | 0-255 | 用料单位类型(Vendor:其它合作单位 Team:施工队伍) | |
positionUnitId | String | N | 0-255 | 部位三方id(如果部位和平台集成,部位三方id为平台部位主键id) | |
requisitionTime | String | N | 当前时间 | 申请时间 (格式:”yyyy-mm-dd hh:mm:ss”) | |
remark | String | N | 0-255 | 其他信息 | |
isSign | Integer | N | 0或者1 | 是否签收(1 签收 0未签收) | |
providerCode | String | N | 0-255 | 用料单位编码 | |
providerCreditCode | String | N | 0-255 | 用料单位统一信用代码 | |
supplyType | String | N | 0-255 | 1 | 供应类型(1:表示采购 6:表示甲供),该字段为非必填字段,缺省默认为1 |
extend | String | N | 扩展字段,json |
申请单材料materials属性
参数 | 类型 | 必须 | 取值范围(字符长度) | 默认值 | 描述 |
---|---|---|---|---|---|
unitId | String | Y | 0-255 | 第三方唯一细表id | |
materialId | Long | Y | 255 | 材料id(物料材料id,如果没有传-1) | |
materialUnitId | String | Y | 0-255 | 材料第三方id | |
materialName | String | Y | 255 | 材料名称 | |
unit | String | Y | 0-45 | 单位 | |
requisitionQuantity | Number | Y | 0-12 | 申请量 | |
controlName | String | Y | 255 | 控制量名称(设计控制量 或者 施工优化量 ) | |
controlQuantity | Number | Y | 0-12 | 控制量(保留三位小数,如果没值可传-1) | |
unitPid | String | N | 0-255 | 所属申请单第三方主表id | |
materialSpec | String | N | 255 | 规格型号 | |
materialCode | String | N | 0-255 | 材料编码 | |
drawQuantity | Number | N | 0-12 | 0 | 图纸量(保留三位小数) |
lossRatio | Number | N | 0-12 | 0 | 合理损耗系数(保留两位小数) |
sumQuantity | Number | N | 0-12 | 0 | 累计申请量(保留三位小数) |
materialCode | String | N | 0-255 | 材料编码 | |
positionUnitId | String | N | 0-255 | 材料部位三方id | |
positionId | Long | N | 0-20 | 材料部位id(物料材料部位id,如果没值传-1) | |
positionName | String | N | 0-255 | 材料部位全名称(施工位置) | |
extend | String | N | 扩展字段,json | ||
acceptanceProcessStatus | Number | N | 0-12 | 0 | 材料验收状态(0:表示执行中, 1表示已完成), 该字段为非必填字段,缺省默认为0 |
请求参数jsonStr具体格式
[
{
"requisitionNo": "SQD2019030800196ab", --申请单编号
"unitId": "78945", --申请单第三方id
"syncCode": "JZTL1#D", --同步编码
"projectName": '测试申请单项目', --项目名称
"positionId": 52001, --部位id
"positionName": "25#13层L户型123", --部位名称
"positionUnitId": "abc", --部位三方id
"teamId": 12333, --用料单位idid
"teamName": "架子一队", --用料单位名称
"itemType": "施工队伍", --用料单位类型
"vendorUnitId": "-1", --用料单位第三方id
"proposerId": 6200, --申请人id
"proposer": "何三", --申请人名称
"useTime": "2019-01-24 10:04:38", --计划用料时间
"remark": "", --其他信息,例如备注
"isSign": 1, --是否签收
"optFlag": 0, --操作类型
"supplyType":"6", --供应类型
"extend": "0", --扩展字段,json
"materials": [ --申请单材料信息
{
"unitId": "123", --第三方唯一细表id
"unitPid": "78945", --所属申请单第三方主表id
"materialId": -1, --材料id
"materialName": "圆钢(Q235)", --材料名称
"materialUnitId": "-1", --材料第三方id
"materialSpec": "", --规格型号
"unit": "吨", --单位
"requisitionQuantity": 30, --申请量
"controlName": "", --控制量名称
"controlQuantity": 0, --控制量数量
"drawQuantity": 0, -- 图纸量数量
"positionId": -1, --材料部位id
"positionName": "24#13层L户型123", --材料部位名称
"positionUnitId": "bcd", --材料部位三方id
"extend": "0", --扩展字段,json
"lossRatio": 0 --合理损耗系数
}
]
},
{
"requisitionNo": "SQD2019030800197ab",
"unitId": "789477",
"syncCode": "JZTL1#D",
"projectName": '测试申请单项目',
"positionId": 52003,
"positionName": "20#13层L户型123",
"positionUnitId": "cde",
"teamId": 12333,
"teamName": "架子一队",
"itemType": "施工队伍",
"vendorUnitId": "-1",
"proposerId": 6200,
"proposer": "何三",
"useTime": "2019-01-28 10:04:38",
"remark": "",
"supplyType":"1",
"isSign": 1,
"optFlag": 0,
"materials": [
{
"unitId": "1234",
"unitPid": "789477",
"materialId": -1,
"materialName": "圆钢(Q235)",
"materialUnitId": "-1",
"materialSpec": "",
"unit": "吨",
"requisitionQuantity": 37,
"controlName": "",
"controlQuantity": 0,
"drawQuantity": 0,
"lossRatio": 0,
"positionId": 52004,
"positionName": "19#13层L户型123",
"positionUnitId": "def"
}
]
}
]
返回结果:
{
"data": {
"successList": [ --处理成功的数据
{
"teamName": "架子一队",
"itemType": "施工队伍",
"proposer": "何三",
"requisitionTime": "2020-06-11 17:20:33",
"syncCode": "JZTL1#D",
"proposerId": 6200,
"remark": "",
"isSign": 1,
"positionName": "20#13层L户型123",
"positionId": 52001,
"positionUnitId": "cde",
"createTime": "2020-06-11 17:20:33",
"supplyType":"",
"materials": [
{
"sumQuantity": 0.0,
"proposer": "何三",
"materialSpec": "",
"controlName": "",
"controlQuantity": 0.0,
"proposerId": 6200,
"materialId": -1,
"unitPid": "789477",
"drawQuantity": 0.0,
"requisitionId": 387671730683904,
"materialName": "圆钢(Q235)",
"unit": "吨",
"lossRatio": 0.0,
"materialUnitId": "-1",
"positionId": 52001,
"requisitionQuantity": 37.0,
"unitId": "1234",
"requisitionNo": "SQD2019030800197ab",
"id": 387671730683905,
"isPreplanMaterial": false,
"positionId": 52004,
"positionName": "19#13层L户型123",
"positionUnitId": "def"
}
],
"teamId": 12333,
"guid": "58e0f899-5d93-42b4-a8db-c4778d0d2e0b",
"unitId": "789477",
"useTime": "2019-01-28 10:04:38",
"requisitionNo": "SQD2019030800197ab",
"id": 387671730683904,
"projectName": "测试申请单项目",
"vendorUnitId": "-1",
"projectId": 356868178702848,
"status": 0
}
],
"errorList": [ --处理失败的数据
{
"errMsg": "申请编号不允许为空!", --失败原因
"isSign": 1,
"itemType": "施工队伍",
"materials": [
{
"controlName": "",
"controlQuantity": 0.0,
"drawQuantity": 0.0,
"isPreplanMaterial": false,
"lossRatio": 0.0,
"materialId": -1,
"materialName": "圆钢(Q235)",
"materialSpec": "",
"materialUnitId": "-1",
"requisitionQuantity": 30.0,
"unit": "吨",
"unitId": "123",
"unitPid": "78945",
"positionId": -1,
"positionName": "24#13层L户型123",
"positionUnitId": "bcd"
}
],
"positionId": 52001,
"positionName": "25#13层L户型123",
"positionUnitId": "abc",
"projectName": "测试申请单项目",
"proposer": "何三",
"proposerId": 6200,
"remark": "",
"syncCode": "JZTL1#D",
"teamId": 12333,
"teamName": "架子一队",
"unitId": "78945",
"useTime": "2019-01-24 10:04:38",
"vendorUnitId": "-1",
"supplyType":"甲供"
}
],
"message": "成功:1条,失败:1条"
},
"success": true -- 状态
}