获取签收单接口
接口说明
接口地址: /api/inspection/v1.0/signinBill/getList?projectId=1458773&beginTimestamp=20160319101010000
请求方式: GET
请求参数: projectId、beginTimestamp，hasPicture
重点说明：
- 时间过滤条件是数据库每条记录的时间戳，不是应用报告的生成时间。
- 每次查询默认查出满足条件的前200条数据，如果第201条及之后的数据的时间戳与第200条相同，则一同查出，一次查询一般是200条数据
- 取下一页数据时需要将上一次请求返回的数据中的maxTimestamp的值给下一次请求链接中的beginTimestamp。
- 数据不包含开始时间但包含结束时间。
最佳实践
由于云端数据量较大，三方系统在通过接口请求数据时，我们建议项目ID(projectId)尽量传值，以项目为单位去请求数据。项目ID获取方式详见“获取集成项目接口协议”。
请求参数属性说明
| 参数名称 | 类型 | 必须 | 取值范围 | 默认值 | 描述 |
|---|---|---|---|---|---|
| projectId | Long | N | 项目ID，可为空；若使用租户层授权文件时，projectId为空查询全部项目数据，不为空时只查询对应项目的数据；若使用项目层授权文件时，为空则查询授权文件所属项目及下属拌合站的数据；不为空时只查询对应项目的数据；此项目ID获取方式详见获取集成项目 | ||
| beginTimestamp | String | Y | 开始时间, 字符串,时间包含毫秒，格式为yyyyMMddHHmmssSSS, 不能为空，如 20160319101010000，2016年3月19号10点10分10秒000毫秒 | ||
| hasPicture | Boolean | N | false | 是否返回签收单的图片地址 |
请求参数附加在url上。
返回结果格式
{
"code": 200, --请求状态码
"data": {
"size": 2, --返回集合的条数
"maxTimestamp": "20200319152537000", --最大时间戳
"bills": [ --签收单集合
{
"attachments": [ --附件图片信息
{
"description": "签收单", --图片描述
"extensionName": ".jpg", --图片后缀
"id": 357858387620864, --图片行id
"key": "DYD/04BD6CEE-BB5D-466F-91CC-4D887D2D8884.jpg", --图片的sso地址
"signinId": 357858387567616, --所属签收单id
}
],
"carNum": "京A99999", --车牌号
"controlName": "设计控制量", --控制量名称
"controlQuantity": 1221.0, --控制量
"discard": true, --是否作废
"guid": "guid1584587413091", --签收单guid
"id": 357858387567616, --物料签收单行id
"materials": [ --签收单对应的材料信息集合
{
"deliveryQuantity": 20.0, --运单数量
"id": 357858387567616, --签收单材料行id
"materialId": 341952512184832, --物料材料id
"materialName": "圆钢(Q235)", --材料名称
"materialSpec": "Φ22", --规格型号
"materialUnitId": "5e531145-a431-42db-ab42-65eb234036fa", --材料第三方id
"signinAccumulation": 38.0, --累计签收量
"signinQuantity": 19.0, --本次签收量
"requisitionQuantity":10, --本次申请量
"unit": "吨" --材料单位
}
],
"mixId":714686399130112, --拌合站项目id
"mixName":"A#搅拌站A1", --拌合站名称
"note": "备注", --备注
"operatorId": 324914403611136, --操作人id
"operatorName": "物料验收材料字典测试租户管理员", --操作人名称
"positionId": 325296073531904, --物料部位id
"positionName": "沪昆客专2临建拌合站1#站", --部位名称
"projectId": 324915713847808, --项目id
"projectName": "银西铁路项目部", --项目名称
"syncCode": "YXTLXMB", --项目同步编码
"positionUnitId":"1111--22-", --部位第三方id
"requisitionFinished": false, --申请单是否签收完成
"requisitionId": 357858364978176, --申请单id
"requisitionNo": "SQ2020-03-19-002", --申请单编号
"signinCountNo": 1, --签收车次
"signinSerialNo": "QS2020-03-19-001", --签收单编号
"signinTime": "2020-03-19 11:10:00.0", --签收时间
"teamId": 325295232946688, --用料单位id
"teamName": "gys其他合作单位031", -- 用料单位名称
"vendorUnitId":"sssss", --用料单位第三方id
"timestamp": "2020-03-19 11:23:44.0",
"userId": 324914403611136, --签收用户Id
"userName": "物料验收材料字典测试租户管理员", --签收用户名称
"subcontractUnitId":786897870639617, --分包单元物料系统id
"subcontractUnitName":"分包单元A", --分包单元名称
"subcontractUnitSyncId":"1171" --分包单元三方id
},
{
"attachments": [
{
"description": "签收单",
"extensionName": ".jpg",
"id": 357917171560448,
"key": "DYD/04BD6CEE-BB5D-466F-91CC-4D887D2D8884.jpg",
"order": 1,
"projectId": 0,
"signinId": 357917171523584,
"size": 0.0,
"tenantId": 0
}
],
"carNum": "京A99999",
"controlName": "设计控制量",
"controlQuantity": 1221.0,
"discard": true,
"guid": "guid1584602937319",
"id": 357917171523584,
"materials": [
{
"deliveryQuantity": 20.0,
"id": 357917171523584,
"materialId": 341952512184832,
"materialName": "圆钢(Q235)",
"materialSpec": "Φ22",
"materialUnitId": "5e531145-a431-42db-ab42-65eb234036fa",
"signinAccumulation": 38.0,
"signinQuantity": 19.0,
"requisitionQuantity":10, --本次申请量
"unit": "吨"
}
],
"mixId":714686399130112, --拌合站项目id
"mixName":"A#搅拌站A1", --拌合站名称
"note": "备注",
"operatorId": 324914403611136,
"operatorName": "物料验收材料字典测试租户管理员",
"positionId": 325296073531904,
"positionName": "沪昆客专2临建拌合站1#站",
"projectId": 324915713843334, --项目id
"projectName": "银西铁路项目部", --项目名称
"syncCode": "YXTLXMB", --项目同步编码
"requisitionFinished": false,
"requisitionId": 357917167157248,
"requisitionNo": "SQ2020-03-19-002",
"signinAccumulation": 38.0,
"signinCountNo": 1,
"signinQuantity": 19.0,
"signinSerialNo": "QS2020-03-19-002",
"signinTime": "2020-03-19 15:28:00.0",
"teamId": 325295232946688,
"teamName": "gys其他合作单位031",
"timestamp": "2020-03-19 15:22:55.0",
"userId": 324914403611136,
"userName": "物料验收材料字典测试租户管理员",
"subcontractUnitId":786897870639617, --分包单元物料系统id
"subcontractUnitName":"分包单元A", --分包单元名称
"subcontractUnitSyncId":"1171" --分包单元三方id
}
]
},
"message": "操作成功",
"success": true
}