资产交接

更新时间：2019-9-27

1. 获取可以被交接的资产

【注意】一次最多可交接10个资产

请求地址

GET /asset

参数说明

参数	是否必须	说明
UserEmployeeId	是	当前登录员工Id
billType	是	单据类型，默认值：13
assettypecode	是	资产类型编码，可以被交接的资产类型的编码

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

返回结果

{
    "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	其他信息

2. 资产交接确认

请求地址

PUT /selfService/handover
POST /selfService/handover/put

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

请求示例

{
    "originalOwnEmployeeNo":"A10001",
    "barcodes":
    [
        "2358492121","297162616"
    ]
}

参数说明

参数	是否必须	说明
originalOwnEmployeeNo	是	发起交接的员工的编码
barcodes	是	要交接的资产的条码集合

返回结果

{}

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

附录

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. 资产详情

属性名称	说明
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	图片路径
rfid	Rfid
serviceLife	使用期限
signaturePicturePath	签字图片路径
signatureStatus	签字状态，0：待签字、1：已签字、2：已打回、"":空状态
source	来源
specs	规格型号
sn	SN号
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	自定义字段值