资产领用

更新时间：2019-9-27

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

请求地址

GET /application/requisition

参数说明

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

返回结果

{
    "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. 获取资产领用单列表

请求地址

GET /receipt/requisition

参数说明

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

返回结果

{
    "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. 新增资产领用单

请求地址

PUT /issue/requisition
POST /issue/requisition/put

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

请求示例

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

参数说明

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

新增领用单的资产详情

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

附加信息

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

返回结果

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

结果说明

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

4. 修改资产领用单

请求地址

PUT /issue/requisition
POST /issue/requisition/put

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

请求示例

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

参数说明

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

修改领用单的资产详情

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

附加信息

返回结果

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

结果说明

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

附录

1. 支持的查询参数

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

分页
- skip={数字} 跳过指定条数的记录数
- take={数字} 取出指定条数的记录数
- 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
自定义返回结果
- 使用Fields参数来指定返回结果中需要的属性或字段名称 如：对于员工查询接口使用Fields=Id,employeeName，返回的员工集合结果中将仅包含此2个属性。

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：已打回、"":空状态
userEmployeeId	领用人Id
address	存放地点
createUserId	单据创建人Id
assetId	资产Id
createDate	创建时间
signaturePicPath	签字图片路径
needEmployeeSign	是否需要员工端签字，true：是、false：否
assets	领用单包含的资产详情集合

领用单包含的资产详情

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