资产退库

更新时间：2019-9-27

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

请求地址
GET /application/revert
参数说明

|参数|是否必须|说明|

资产退库申请单查询接口支持丰富的条件过滤参数，请参见支持的查询参数附录
返回结果
{
    "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. 获取资产退库单列表

请求地址
GET /receipt/revert
参数说明
资产退库申请单查询接口支持丰富的条件过滤参数，请参见支持的查询参数附录
返回结果
{
    "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. 新增资产退库单

请求地址
PUT /issue/asset/revert
POST /issue/asset/revert/put

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

请求示例
{   
    "applicationNo":"RVT201909250001",
    "actualRevertDate":"2019-09-25",
    "companyCode":"10101",
    "districtCode":"01",
    "address":"石家庄仓库",
    "revertComment":"退库",
    "assets":
        [
            "10010005"
        ]
}
参数说明
参数 是否必须 说明
applicationNo 否 申请单号
actualRevertDate 是 实际退库时间
companyCode 是 使用公司编码
districtCode 否 区域编码
address 否 存放地点
revertComment 否 退库备注
assets 是 退库的资产条码集合
附加信息

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

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

返回结果
{
    "serialNo": "TK201908120001",
    "signatureId": 0
}
结果说明
属性名称 说明
serialNo 单据号
signatureId 签字Id

4. 修改资产退库单

请求地址
PUT /issue/asset/revert
POST /issue/asset/revert/put

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

请求示例
{   
    "applicationNo":"RVT201909250001",
    "serialNo":"TK201909250001"，
    "actualRevertDate":"2019-09-25",
    "companyCode":"10101",
    "districtCode":"01",
    "address":"石家庄仓库",
    "revertComment":"退库",
    "assets":
        [
            "10010005"
        ]
}
参数说明
参数 是否必须 说明
applicationNo 否 申请单号
serialNo 是 单据号
actualRevertDate 是 实际退库时间
companyCode 是 使用公司编码
districtCode 否 区域编码
address 否 存放地点
revertComment 否 退库备注
assets 是 退库的资产条码集合
附加信息

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

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

返回结果
{
    "serialNo": "TK201908120001",
    "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 接收人编码
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：已打回、"":空状态
userEmployeeId 申请人Id
address 存放地点
createUserId 单据创建人Id
assetId 资产Id
createDate 创建时间
revertComment 退库备注
signaturePicPath 签字图片路径
needEmployeeSign 是否需要员工端签字，true：是、false：否
assets 退库单包含的资产详情集合
退库单包含的资产详情
属性名称 说明
barcode 资产编码
picturePath 资产图片路径
thumbnailPath 资产图片的缩略图路径
name 资产名称
specs 规格型号
ownCompanyName 所属公司名称
useCompanyName 使用公司名称
address 存放地点
applyBarcode 申请的资产编号
measureUnit 计量单位
assetType 资产分类名称
applicationSpecsId 申请的标准资产型号Id
sN SN号