资产申借接口 ​

1. 获取资产借用申请单列表 ​

请求地址 ​

text
GET /application/borrow

参数说明 ​

参数是否必须说明
taskStatus是审批状态；0：审批中、1，2，3：已批准、9：已驳回、4：已签收

资产借用申请单查询接口支持丰富的条件过滤参数，请参见支持的查询参数附录 ​

返回结果 ​

json
{
    "offset": 0,
    "total": 0,
    "results": [
        {
            "assets": [
                {
                    "barcode": "10010002",
                    "assetName": "桌子",
                    "ownCompanyName": "测试企业",
                    "useCompanyName": "测试企业",
                    "assetTypeName": "家具用具及其他类",
                    "address": "石家庄仓库",
                    "picturePath": "/UploadImage/6a627938-4818-470a-8258-db585d145389.jpg",
                    "thumbnailPath": "/UploadImage/5b8e7c60-9e65-4989-9078-0df30e6e0a69.jpg",
                    "id": "eabc71f4-c729-45f2-af1a-d06a5943a0a2",
                    "applicationId": "33b725cb-d5fa-436b-b754-63783e33ae60",
                    "applyTime": "1564201007",
                    "assetId": 3060939,
                    "status": 1
                }
            ],
            "specifications": [
                {
                    "picturePath": "/UploadImage/dff386ab-8762-458f-8158-0ff8fdf7f1a6.jpg",
                    "thumbnailPath": "/UploadImage/2f2e3623-fc09-4a5e-aa75-70ede15306d5.jpg",
                    "id": "d6eb7256-816e-40cb-9b3d-ab3a6bab4409",
                    "assetSpecsId": 2197,
                    "quantity": 3,
                    "issueQuantity": 3,
                    "applicationId": "33b725cb-d5fa-436b-b754-63783e33ae60",
                    "applyTime": "1564201007",
                    "assetTypeName": "测试分类",
                    "assetName": "测试资产",
                    "specs": "测试型号",
                    "measureUnit": ""
                }
            ],
            "companyCode": "01",
            "companyName": "测试企业",
            "departmentCode": "1001",
            "departmentName": "测试部门",
            "applyEmployeeNo": "100001",
            "applyEmployeeName": "张三",
            "receiveEmployeeNo": "100001",
            "receiveEmployeeName": "张三",
            "receiptCount": 2,
            "pendingReceiptCount": 0,
            "approveTime": "1564201060",
            "approveRemark": "",
            "approveBy": "张三",
            "needApprove": true,
            "approveId": "83e19288-2fc6-4021-96ed-03f01a18747e",
            "applyCount": 4,
            "id": "33b725cb-d5fa-436b-b754-63783e33ae60",
            "serialNo": "BRW201907270001",
            "receiveEmployeeId": "ea6acdeb-d0ed-4de5-b4b8-070395ef2f3f",
            "receiveTime": "1564202605",
            "companyId": 45448,
            "departmentId": 243533,
            "applyEmployeeId": "ea6acdeb-d0ed-4de5-b4b8-070395ef2f3f",
            "applyTime": "1564201007",
            "applyRemark": "",
            "expectedRevertTime": "1564156800",
            "status": 4
        }
    ],
    "meta": {}
}
参数说明
offset当前结果对于首条结果的偏移量，指定分页查询时不为0
total所有符合查询条件的查询结果数量，指定需要结果记录数量时不为0
results符合查询条件的资产借用申请单详情集合
meta其他信息

2. 获取可以被借用的资产 ​

请求地址 ​

text
GET /asset

参数说明 ​

参数是否必须说明
includedInBill是是否被其他单据占用，值为空代表未被其他单据占用，传空值即可
deleted是是否返回已报废资产，1：是、0：否
assetTypeId是资产分类Id
state是资产状态，1＆6：在用、2：闲置、3：借用、4：报废、5：调拨中、7：维修中

资产查询接口支持丰富的条件过滤参数，请参见支持的查询参数附录 ​

资产查询接口是完全开放的接口，可以根据资产实体对象中的任意属性做特定查询，以下是可被借用资产的请求示例 ​

text
/asset?skip=0&take=20&include=total&includedInBill=&deleted=0&assetTypeId=2245&stateIn=1,6,2

返回结果 ​

json
{
    "offset": 0,
    "total": 0,
    "results": [
        {
            "assetTypeCode": "10",
            "assetTypeName": "家具用具及其他类",
            "useCompanyCode": "01",
            "useCompanyName": "测试企业",
            "ownCompanyCode": "01",
            "ownCompanyName": "测试企业",
            "maintainerName": "张三",
            "extensionFields": [
                {
                    "name": "品牌",
                    "value": "苹果",
                    "fieldAreaType": 1
                },
                {
                    "name": "显示器",
                    "value": "15.6",
                    "fieldAreaType": 2
                }
            ],
            "repairStatus": 0,
            "reverting": false,
            "barcode": "10010001",
            "assetTypeId": 337209,
            "name": "椅子",
            "specs": "欧尼",
            "sn": "",
            "measureUnit": "个",
            "price": 66,
            "useCompanyId": 45448,
            "districtId": 47502,
            "address": "111",
            "supervisor": "张三",
            "purchasedDate": "1564156800",
            "picturePath": "/UploadImage/6b736518-9325-43bc-a6b2-4d3d4704375a.jpg",
            "thumbnailPath": "/UploadImage/c7da9110-081e-497d-89b2-ae774c950f38.jpg",
            "comment": "",
            "createdDate": "1564196745",
            "createdBy": "46967",
            "state": 2,
            "serviceLife": 60,
            "supervisorId": 46967,
            "source": 1,
            "signatureStatus": 1,
            "signaturePicturePath": "/SignatureImage/48ef0a5f-cd0e-4e0e-a387-dc67f051a0b5.jpg",
            "deleted": false,
            "lastModifyDate": "1564156800",
            "vendor": "供应商1",
            "vendorName": "联系人1",
            "vendorContact": "联系方式1",
            "maintainer": 46967,
            "maintenanceExpiredDate": "1564934400",
            "maintenanceMemo": ""
        }
    ],
    "meta": {}
}
参数说明
offset当前结果对于首条结果的偏移量，指定分页查询时不为0
total所有符合查询条件的查询结果数量，指定需要结果记录数量时不为0
results符合查询条件的资产详情集合
meta其他信息

3. 新增资产借用申请单 ​

请求地址 ​

text
POST /application/borrow

请求示例 ​

json
{
    "addressTypeCode":"",
    "address":"",
    "applyRemark":"备注",
    "expectedRevertTime":"2019-10-08",
    "barcodes":
    [
        "2358492121","297162616"
    ],
    "specifications": 
    [
        {
            "assetSpecsId":"2197",
            "quantity":"2"
        }
    ]
}

参数说明 ​

参数是否必须说明
addressTypeCode否区域编码
address否存放地点
applyRemark否申请备注
expectedRevertTime否预计归还时间（时间戳格式）
barcodes否要领用的资产的条码集合
specifications否要借用的标准资产型号详情集合

附加信息 ​

barcodes和specifications至少要添加一项

要借用的标准资产型号详情 ​

参数是否必须说明
assetSpecsId是标准资产型号Id
quantity是申请数量，要借用该标准资产型号下多少个资产

返回结果 ​

json
{
    "serialNo": "BRW201910100001",
}

结果说明 ​

属性名称说明
serialNo申请单号

4. 获取资产借用单签字列表 ​

请求地址 ​

text
GET /receipt/borrow

参数说明 ​

参数是否必须说明
signatureStatus是签字状态，0：待签字、1：已签字

资产借用申请单查询接口支持丰富的条件过滤参数，请参见支持的查询参数附录 ​

返回结果 ​

json
{
    "offset": 0,
    "total": 0,
    "results": [
        {
            "userEmployeeNo": "100001",
            "assets": [
                {
                    "barcode": "1001010003",
                    "picturePath": "/UploadImage/dff386ab-8762-458f-8158-0ff8fdf7f1a6.jpg",
                    "thumbnailPath": "/UploadImage/2f2e3623-fc09-4a5e-aa75-70ede15306d5.jpg",
                    "name": "测试资产",
                    "specs": "测试型号",
                    "ownCompanyName": "测试企业",
                    "useCompanyName": "测试企业",
                    "address": "不好",
                    "measureUnit": "",
                    "assetType": "测试分类",
                    "borrowReceiptId": 19677,
                    "applicationSpecsId": "57699455-0da6-48e7-9c84-8f5e0612e9f6"
                }
            ],
            "serialNo": "JY201908120001",
            "applicationId": "4f2a0f1f-21e0-4a7d-83f6-ae8f10a502da",
            "borrowDate": "1565539200",
            "borrowUser": "张三",
            "borrowOperator": "张三",
            "comment": "",
            "isBorrow": true,
            "assetId": 3060948,
            "createDate": "1565591787",
            "signatureStatus": 1,
            "signaturePicPath": "//UploadImage/5128b0cd-dcc8-48c4-8614-c12095bb7f8a.jpg",
            "createUserId": 46967,
            "userEmployeeId": "ea6acdeb-d0ed-4de5-b4b8-070395ef2f3f",
            "appliedBySelfService": true,
            "revertedBySelfService": false,
            "signatureDate": "1565592391",
            "needEmployeeSign": true
        }
    ],
    "meta": {}
}
参数说明
offset当前结果对于首条结果的偏移量，指定分页查询时不为0
total所有符合查询条件的查询结果数量，指定需要结果记录数量时不为0
results符合查询条件的资产借用单详情集合
meta其他信息

5. 资产借用发放单签字 ​

请求地址 ​

text
POST /SelfService/EmployeeSign

请求示例 ​

json
{
    "billType": 2,
    "picPath": "img/aaa.jpg",
    "billNo": "JY201908120001"
}

参数说明 ​

参数是否必须说明
billType是单据类型，1：资产申领单、2：资产借用单、3：资产退库单、4：耗材申领单
picPath是签字图片路径
billNo是发放单号

返回结果 ​

json
{}

对于成功更新的请求，该接口仅返回HTTP 200 OK

附录 ​

1. 支持的查询参数 ​

如无特别说明，下列操作对于查询实体对象中的任意属性均适用。使用时只需将其追加至请求的querystring中即可。对实体对象中不存在的属性进行操作将会得到不可预期的结果。

分页

skip={数字} 跳过指定条数的记录数

take={数字} 取出指定条数的记录数（注：最大值为1500，即单页最多返回1500条数据）

include=total 需要返回记录总数

排序

orderBy=[-]{属性名称},[-]{属性名称} 返回结果按指定属性排序，在名称前加”-“表示按倒序排序。多个属性的排序可使用逗号分隔。如：orderBy=-Id,Name,-Age

条件过滤

不等于

{属性名称}!={值} 如：Id!=1

大于等于

>{属性名称}={值} 如：>Id=1

大于

{属性名称}>={值} 如：Id>=1

小于

<{属性名称}={值} 如：<Id=1

小于等于

{属性名称}<={值} 如：Id<=1

In

{属性名称}In={值，值，值} 属性的值需包含在指定的集合中，如：IdIn=1,2,3

Between

{属性名称}Between={值，值} 属性的值需处于指定的区间之间，仅支持数字，如： IdBetween=1,3

字符串包含指定字符

{属性名称}Contains={值} 如：nameContains=abc

字符串以指定字符开头

{属性名称}StartsWith={值} 如：nameStartsWith=abc

字符串以指定字符结尾

{属性名称}EndsWith={值} 如：nameEndsWith=abc

2. 数据实体格式 ​

1. 资产借用申请单数据对象格式 ​

属性名称说明
companyCode申请公司编码
companyName申请公司名称
departmentCode申请部门编码
departmentName申请部门名称
applyEmployeeNo申请人编码
applyEmployeeName申请人名称
receiveEmployeeNo接收人编码
receiveEmployeeName接收人名称
approveTime审批时间
approveRemark审批备注
approveBy审批人
applyCount申请数量
receiptCount发放数量
pendingReceiptCount待签字的发放数量
needApprove是否审批，true：是、false：否
approveId审批单Id
id申请单Id
serialNo申请单号
receiveEmployeeId接收人Id
receiveTime接收时间（时间戳格式）
companyId申请公司Id
departmentId申请部门Id
applyEmployeeId申请人Id
applyTime申请时间（时间戳格式）
applyRemark申请备注
expectedRevertTime预计归还时间（时间戳格式）
status审批单状态，0：待审批、1：已同意、2：发放中、3：已发放、4：已完成、9：已驳回
assets申请单的资产详情集合
specifications申请单的标准资产型号详情集合

申请单的资产详情 ​

属性名称说明
barcode资产编码
assetName资产名称
specs规格型号
measureUnit计量单位
ownCompanyName所属公司名称
useCompanyName使用公司名称
assetTypeName资产分类名称
address存放地点
picturePath资产图片路径
thumbnailPath资产图片的缩略图路径
id申请单的子表Id
applicationId申请单Id
applyTime申请时间（时间戳格式）
assetId资产Id
status资产发放状态，0：未发放、1：已发放、2：已签收

申请单的标准资产型号详情 ​

属性名称说明
picturePath资产图片路径
thumbnailPath资产图片的缩略图路径
id申请单的子表Id
assetSpecsId标准资产型号Id
quantity申请数量
issueQuantity发放数量
applicationId申请单Id
applyTime申请时间（时间戳格式）
assetTypeName资产分类名称
assetName资产名称
specs规格型号
measureUnit计量单位

2. 资产详情 ​

属性名称说明
id资产Id
address存放地点
addressTypeCode区域编码
addressTypeId区域Id
addressTypeName区域名称
amount金额
assetTypeCode资产分类编码
assetTypeId资产分类Id
assetTypeName资产分类名称
assetSpecsId标准资产型号Id
barcode资产编码
createdBy创建人
createdDate创建日期（时间戳格式）
comment备注
deleted是否已报废，1：是、0：否
enterpriseId所属企业Id
includedInBill是否被其他单据占用，空值表示没被占用
measureUnit计量单位
name资产名称
ownCompanyCode所属公司编码
ownCompanyId所属公司名称
ownCompanyName所属公司名称
purchasedDate购入时间
picturePath图片路径
rfidRfid
serviceLife使用期限
signaturePicturePath签字图片路径
signatureStatus签字状态，0：待签字、1：已签字、2：已打回、"":空状态
source来源
specs规格型号
snSN号
state资产状态，1＆6：在用、2：闲置、3：借用、4：报废、5：调拨中、7：维修中
supervisor管理员
supervisorId管理员Id
user使用人
useCompanyCode使用公司编码
useCompanyId使用公司Id
useCompanyName使用公司名称
useDepartmentCode使用部门编码
useDepartmentId使用部门Id
useDepartmentName使用部门名称
userEmployeeNo使用人编号
userEmployeeName使用人姓名
userEmployeeId使用人Id
thumbnailPath资产图片的缩略图路径
vendor供应商
vendorName供应商联系人
vendorContact供应商联系方式
maintainer负责人Id
maintainerName负责人名称
maintenanceExpiredDate维保到期日期（时间戳格式）
maintenanceMemo维保说明
lastModifyDate最后一次修改时间（时间戳格式）
lastModifyUserId最后一次修改人
extensionFields自定义字段详情集合

自定义字段详情 ​

属性名称说明
fieldAreaType自定义字段类型，1：公有属性、2：分类属性、3：私有属性
name自定义字段名称
value自定义字段值

3. 资产借用单数据对象格式 ​

属性名称说明
userEmployeeNo借用人编码
serialNo单据号
applicationId申请单Id
borrowDate借用日期（时间戳格式）
borrowUser借用人名称
borrowOperator借用处理人
comment备注
isBorrow是否借用状态，true：借用、false：归还
appliedBySelfService是否员工端申请，true：是、false：否
revertedBySelfService是否员工端退库，true：是、false：否
signatureStatus签字状态，0：待签字、1：已签字、2：已打回、"":空状态
userEmployeeId借用人Id
createUserId单据创建人Id
assetId资产Id
createDate创建时间（时间戳格式）
signaturePicPath签字图片路径
signatureDate签字时间
needEmployeeSign是否需要员工端签字，true：是、false：否
assets借用单包含的资产详情集合

借用单包含的资产详情 ​

属性名称说明
barcode资产编码
picturePath资产图片路径
thumbnailPath资产图片的缩略图路径
name资产名称
specs规格型号
ownCompanyName所属公司名称
useCompanyName使用公司名称
address存放地点
applyBarcode申请的资产编号
measureUnit计量单位
assetType资产分类名称
applicationSpecsId申请的标准资产型号Id
sNSN号