资产申领接口 ​

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

请求地址 ​

text
GET /application/requisition

参数说明 ​

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

返回结果 ​

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": "c24eaaa7-b6dc-4898-b883-3de26cdcaca8",
                    "applicationId": "dbb4a963-6046-4781-b03a-ff445f706c58",
                    "applyTime": "1564199430",
                    "assetId": 3060939,
                    "status": 1
                }
            ],
            "specifications": [
                {
                    "picturePath": "/UploadImage/dff386ab-8762-458f-8158-0ff8fdf7f1a6.jpg",
                    "thumbnailPath": "/UploadImage/2f2e3623-fc09-4a5e-aa75-70ede15306d5.jpg",
                    "id": "eb998b3c-ee37-446e-a74f-be32b81c2bf4",
                    "assetSpecsId": 2197,
                    "quantity": 3,
                    "issueQuantity": 3,
                    "applicationId": "dbb4a963-6046-4781-b03a-ff445f706c58",
                    "applyTime": "1564199430",
                    "assetTypeName": "测试分类",
                    "assetName": "测试资产",
                    "specs": "测试型号",
                    "measureUnit": ""
                }
            ],
            "companyCode": "01",
            "companyName": "测试企业",
            "departmentCode": "1001",
            "departmentName": "测试部门",
            "applyEmployeeNo": "100001",
            "applyEmployeeName": "张三",
            "receiveEmployeeNo": "100001",
            "receiveEmployeeName": "张三",
            "approveTime": "1564199437",
            "approveRemark": "",
            "approveBy": "张三",
            "applyCount": 4,
            "receiptCount": 3,
            "pendingReceiptCount": 0,
            "needApprove": true,
            "approveId": "feb3c1aa-850c-4641-89c8-4ee49e64583a",
            "id": "dbb4a963-6046-4781-b03a-ff445f706c58",
            "serialNo": "REQ201907270002",
            "receiveEmployeeId": "ea6acdeb-d0ed-4de5-b4b8-070395ef2f3f",
            "receiveTime": "1564199531",
            "companyId": 45448,
            "departmentId": 243533,
            "applyEmployeeId": "ea6acdeb-d0ed-4de5-b4b8-070395ef2f3f",
            "applyTime": "1564199430",
            "applyRemark": "",
            "status": 4
        }
    ],
    "meta": {}
}
参数说明
offset当前结果对于首条结果的偏移量，指定分页查询时不为0
total所有符合查询条件的查询结果数量，指定需要结果记录数量时不为0
results符合查询条件的资产领用申请单详情集合
meta其他信息

2. 获取资产领用单列表 ​

请求地址 ​

text
GET /receipt/requisition

参数说明 ​

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

返回结果 ​

json
{
    "offset": 0,
    "total": 0,
    "results": [
        {
            "userEmployeeNo": "100001",
            "companyCode": "01",
            "companyName": "测试企业",
            "departmentCode": "1001",
            "departmentName": "测试部门",
            "assets": [
                {
                    "barcode": "10010001",
                    "picturePath": "/UploadImage/6b736518-9325-43bc-a6b2-4d3d4704375a.jpg",
                    "thumbnailPath": "/UploadImage/c7da9110-081e-497d-89b2-ae774c950f38.jpg",
                    "name": "椅子",
                    "specs": "欧尼",
                    "ownCompanyName": "测试企业",
                    "useCompanyName": "测试企业",
                    "address": "111",
                    "applyBarcode": "10010001",
                    "measureUnit": "个",
                    "assetType": "家具用具及其他类"
                }
            ],
            "applicationSerialNo": "REQ201907270003",
            "operatedDate": "1564156800",
            "operatedBy": "张三",
            "receiver": "张三",
            "comment": "",
            "serialNo": "LY201907270005",
            "applicationId": "8315fa54-d452-480c-aee0-a0352e77fbf1",
            "appliedBySelfService": true,
            "revertedBySelfService": false,
            "signatureStatus": 1,
            "userEmployeeId": "ea6acdeb-d0ed-4de5-b4b8-070395ef2f3f",
            "address": "仓库01",
            "createUserId": 46967,
            "assetId": 3060852,
            "createDate": "1564206779",
            "signaturePicPath": "/SignatureImage/50f5ab83-f75b-4936-9535-7f15a26aabf0.jpg",
            "needEmployeeSign": false
        }
    ],
    "meta": {}
}
参数说明
offset当前结果对于首条结果的偏移量，指定分页查询时不为0
total所有符合查询条件的查询结果数量，指定需要结果记录数量时不为0
results符合查询条件的资产领用单详情集合
meta其他信息

3. 新增资产领用单 ​

请求地址 ​

text
PUT /issue/requisition?_clienttype=1
POST /issue/requisition/put?_clienttype=1

对于不支持PUT请求的网络环境，请尝试使用备份的POST请求地址

请求示例 ​

json
{
    "applicationNo":"REQ201908120001",
    "applyEmployeeNo":"100001",
    "companyCode":"01",
    "departmentCode":"1001",
    "borrowDate":"34242332",
    "districtCode":"01"
    "address":"仓库01",
    "comment":"领用",
    "receiver":"张三",
    "assets": 
    [
        {
            "applicationSpecsId":"dec7b63f-82f8-48c1-8b2e-ce5bfba8f8f1",
            "barcode":"1001010001"
        },
        {
            "applyBarcode":"1001101010001",
            "barcode":"1001101010001"
        }
    ]
}

参数说明 ​

参数是否必须说明
applicationNo否申请单号
applyEmployeeNo是领用人编码
companyCode是使用公司编码
departmentCode否使用部门编码
borrowDate是领用时间（时间戳格式）
districtCode否区域编码
address否存放地点
comment否领用备注
receiver是领用人名称
assets是新增领用单的资产详情集合

新增领用单的资产详情 ​

参数是否必须说明
barcode是资产编码
applicationSpecsId否申请的标准资产型号Id
applyBarcode否申请的资产编码

附加信息 ​

1、applicationNo：通过申请单创建的发放单必须填写申请单号；
2、ApplicationSpecsId：如果是通过申请单创建领用单需要根据申请单的内容填写标准资产型号Id；手动创建领用单不需要填写该参数；
3、ApplyBarcode：如果是通过申请单创建领用单需要根据申请单的内容填写资产编码；手动创建领用单不需要填写该参数。

返回结果 ​

json
{
    "serialNo": "LY201908120001",
    "signatureId": 0
}

结果说明 ​

属性名称说明
serialNo单据号
signatureId签字Id

4. 修改资产领用单 ​

请求地址 ​

text
PUT /issue/requisition?_clienttype=1
POST /issue/requisition/put?_clienttype=1

对于不支持PUT请求的网络环境，请尝试使用备份的POST请求地址

请求示例 ​

json
{
    "applicationNo":"REQ201908120001",
    "applyEmployeeNo":"100001",
    "companyCode":"01",
    "departmentCode":"1001",
    "borrowDate":"4534544",
    "districtCode":"01"
    "address":"仓库01",
    "comment":"领用",
    "receiver":"张三",
    "SerialNo":"LY201908190001".
    "assets": 
    [
        {
            "applicationSpecsId":"dec7b63f-82f8-48c1-8b2e-ce5bfba8f8f1",
            "barcode":"1001010001"
        },
        {
            "applyBarcode":"1001101010001",
            "barcode":"1001101010001"
        }
    ]
}

参数说明 ​

参数是否必须说明
SerialNo是单据号
applicationNo否申请单号
applyEmployeeNo是领用人编码
companyCode是使用公司编码
departmentCode否使用部门编码
borrowDate是领用时间（时间戳格式）
districtCode否区域编码
address否存放地点
comment否领用备注
receiver是领用人名称
assets是修改领用单的资产详情集合

修改领用单的资产详情 ​

参数是否必须说明
barcode是资产编码
applicationSpecsId否申请的标准资产型号Id
applyBarcode否申请的资产编码

附加信息 ​

1、applicationNo：通过申请单创建的发放单必须填写申请单号；
2、ApplicationSpecsId：如果是通过申请单创建领用单需要根据申请单的内容填写标准资产型号Id；手动创建领用单不需要填写该参数；
3、ApplyBarcode：如果是通过申请单创建领用单需要根据申请单的内容填写资产编码；手动创建领用单不需要填写该参数。

返回结果 ​

json
{
    "serialNo": "LY201908120001",
    "signatureId": 0
}

结果说明 ​

属性名称说明
serialNo单据号
signatureId签字Id

附录 ​

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申请备注
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. 资产领用单数据对象格式 ​

属性名称说明
companyCode使用公司编码
companyName使用公司名称
departmentCode使用部门编码
departmentName使用部门名称
districtCode区域编码
districtName区域名称
userEmployeeNo领用人编码
applicationSerialNo申请单编号
operatedDate处理日期（时间戳格式）
operatedBy处理人
receiver领用人名称
comment备注
serialNo单据号
applicationId申请单Id
appliedBySelfService是否员工端申请，true：是、false：否
revertedBySelfService是否员工端退库，true：是、false：否
signatureStatus签字状态，0：待签字、1：已签字、2：已打回、4：待审批、5:已审批、6:审批驳回、10:已审批待签字、11:已审批已签字、21:已审批签字驳回、3:空状态
userEmployeeId领用人Id
address存放地点
createUserId单据创建人Id
assetId资产Id
createDate创建时间（时间戳格式）
signaturePicPath签字图片路径
needEmployeeSign是否需要员工端签字，true：是、false：否
dataJson单据扩展字段字符串合集
assets领用单包含的资产详情集合

领用单包含的资产详情 ​

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