资产退库接口 ​

1. 获取资产退还申请单列表 ​

请求地址 ​

text
GET /application/revert

参数说明 ​

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

返回结果 ​

json
{
    "offset": 0,
    "total": 0,
    "results": [
        {
            "assets": [
                {
                    "barcode": "10010001",
                    "assetName": "椅子",
                    "specs": "欧尼",
                    "measureUnit": "个",
                    "ownCompanyName": "测试企业",
                    "useCompanyName": "测试企业",
                    "address": "111",
                    "picturePath": "/UploadImage/6b736518-9325-43bc-a6b2-4d3d4704375a.jpg",
                    "thumbnailPath": "/UploadImage/c7da9110-081e-497d-89b2-ae774c950f38.jpg",
                    "id": "3a34d20c-219f-4f4c-b7b8-a3b5cfefbbd0",
                    "applicationId": "7e5eab7c-960e-4a9b-b675-7e15e340a048",
                    "applyTime": "1564207413",
                    "assetId": 3060852,
                    "status": 1
                }
            ],
            "companyName": "测试企业",
            "companyCode": "01",
            "departmentCode": "1001",
            "departmentName": "测试部门",
            "applyEmployeeName": "张三",
            "applyEmployeeNo": "100001",
            "receiveEmployeeNo": "100001",
            "approveRemark": "",
            "approveTime": "1564207425",
            "applyCount": 1,
            "approveBy": "张三",
            "needApprove": true,
            "approveId": "2e89a60b-5c86-452e-b758-d4f34255b358",
            "receiptCount": 1,
            "pendingReceiptCount": 0,
            "id": "7e5eab7c-960e-4a9b-b675-7e15e340a048",
            "serialNo": "RVT201907270002",
            "revertEmployeeId": "ea6acdeb-d0ed-4de5-b4b8-070395ef2f3f",
            "revertTime": "1564207413",
            "companyId": 45448,
            "departmentId": 243533,
            "applyEmployeeId": "ea6acdeb-d0ed-4de5-b4b8-070395ef2f3f",
            "applyTime": "1564207413",
            "applyRemark": "",
            "status": 4
        }
    ],
    "meta": {}
}
参数说明
offset当前结果对于首条结果的偏移量，指定分页查询时不为0
total所有符合查询条件的查询结果数量，指定需要结果记录数量时不为0
results符合查询条件的资产退库申请单详情集合
meta其他信息

2. 获取资产退库单列表 ​

请求地址 ​

text
GET /receipt/revert

参数说明 ​

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

返回结果 ​

json
{
    "offset": 0,
    "total": 0,
    "results": [
        {
            "userEmployeeNo": "100001",
            "companyCode": "01",
            "companyName": "测试企业",
            "districtCode": "01",
            "districtName": "本地",
            "assets": [
                {
                    "barcode": "10010005",
                    "picturePath": "/UploadImage/bf04b855-0fba-4a95-bfe7-c80b373ba7cb.jpg",
                    "thumbnailPath": "/UploadImage/2f863a93-5145-425f-aab8-118b03017b31.jpg",
                    "name": "MacBook",
                    "specs": "苹果",
                    "ownCompanyName": "测试企业",
                    "useCompanyName": "测试企业",
                    "address": "本地仓",
                    "measureUnit": "台",
                    "assetType": "电子产品及通信设备"
                }
            ],
            "operatedDate": "1565590586",
            "operatedBy": "张三",
            "actualRevertDate": "1565539200",
            "revertedBy": "张三",
            "districtId": 47502,
            "serialNo": "TK201908120001",
            "applicationId": "f49fd768-173d-463f-b348-34316b0966c8",
            "appliedBySelfService": false,
            "revertedBySelfService": true,
            "signatureStatus": 1,
            "userEmployeeId": "ea6acdeb-d0ed-4de5-b4b8-070395ef2f3f",
            "address": "本地仓",
            "createUserId": 46967,
            "assetId": 3060943,
            "createDate": "1565590586",
            "revertComment": "",
            "signaturePicPath": "/SignatureImage/c2b50d43-d43f-406f-88a2-88fb46b65323.jpg",
            "needEmployeeSign": false
        }
    ],
    "meta": {}
}
参数说明
offset当前结果对于首条结果的偏移量，指定分页查询时不为0
total所有符合查询条件的查询结果数量，指定需要结果记录数量时不为0
results符合查询条件的资产退库单详情集合
meta其他信息

3. 新增资产退库单 ​

请求地址 ​

text
PUT /issue/asset/revert?_clienttype=1
POST /issue/asset/revert/put?_clienttype=1

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

请求示例 ​

json
{   
    "OwnerCompanyCode":"3725581",
    "applicationNo":"RVT201909250001",
    "actualRevertDate":"23542434",
    "companyCode":"10101",
    "districtCode":"01",
    "address":"石家庄仓库",
    "revertComment":"退库",
    "assets":
        [
            "10010005"
        ]
}

参数说明 ​

参数是否必须说明
OwnerCompanyCode是业务所属公司
applicationNo否申请单号
actualRevertDate是实际退库时间（时间戳格式）
companyCode是使用公司编码
districtCode否区域编码
address否存放地点
revertComment否退库备注
assets是退库的资产条码集合

附加信息 ​

1、applicationNo：通过申请单创建的发放单必须填写申请单号；

2、assets：数组中不需要参数名，只添加要退库的资产的条码即可。

返回结果 ​

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

结果说明 ​

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

4. 修改资产退库单 ​

请求地址 ​

text
PUT /issue/asset/revert?_clienttype=1
POST /issue/asset/revert/put?_clienttype=1

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

请求示例 ​

json
{   
    "OwnerCompanyCode":"3725581",
    "applicationNo":"RVT201909250001",
    "serialNo":"TK201909250001"，
    "actualRevertDate":"654534544",
    "companyCode":"10101",
    "districtCode":"01",
    "address":"石家庄仓库",
    "revertComment":"退库",
    "assets":
        [
            "10010005"
        ]
}

参数说明 ​

参数是否必须说明
OwnerCompanyCode是业务所属公司
applicationNo否申请单号
serialNo是单据号
actualRevertDate是实际退库时间（时间戳格式）
companyCode是使用公司编码
districtCode否区域编码
address否存放地点
revertComment否退库备注
assets是退库的资产条码集合

附加信息 ​

1、applicationNo：通过申请单创建的发放单必须填写申请单号；

2、assets：数组中不需要参数名，只添加要退库的资产的条码即可。

返回结果 ​

json
{
    "serialNo": "TK201908120001",
    "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接收人编码
approveTime审批时间（时间戳格式）
approveRemark审批备注
approveBy审批人
applyCount申请数量
receiptCount发放数量
pendingReceiptCount待签字的发放数量
needApprove是否审批，true：是、false：否
approveId审批单Id
id申请单Id
serialNo申请单号
revertEmployeeId退库人Id
revertTime退库时间（时间戳格式）
companyId申请公司Id
departmentId申请部门Id
applyEmployeeId申请人Id
applyTime申请时间（时间戳格式）
applyRemark申请备注
status审批单状态，0：待审批、1：已同意、2：发放中、3：已发放、4：已完成、9：已驳回
assets申请单的资产详情集合

申请单的资产详情 ​

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

2. 资产退库单数据对象格式 ​

属性名称说明
companyCode使用公司编码
companyName使用公司名称
districtCode区域编码
districtName区域名称
userEmployeeNo申请人编码
operatedDate处理日期（时间戳格式）
operatedBy处理人
revertedBy退库操作人
districtId区域Id
applicationId申请单Id
serialNo单据号
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创建时间（时间戳格式）
revertComment退库备注
signaturePicPath签字图片路径
needEmployeeSign是否需要员工端签字，true：是、false：否
dataJson单据扩展字段字符串合集
assets退库单包含的资产详情集合

退库单包含的资产详情 ​

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