我的资产接口 ​

1. 获取资产列表 ​

请求地址 ​

text
GET /asset

参数说明 ​

参数是否必须说明
userEmployeeId是员工Id
deleted是是否返回已报废资产，1：是、0：否

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

返回结果 ​

json
{
    "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. 资产报修 ​

请求地址 ​

text
POST /selfService/repair

请求示例 ​

json
{
    "barcode":"293229991",
    "comment":"备注",
    "mediaResources":
    [
        "/Image/2f2e3623-fc09-4a5e-aa75-70ede15306d5.jpg", "/Image/45j2i298-fc09-4a5e-aa75-70ede19928325.jpg"
    ]
}

参数说明 ​

参数是否必须说明
barcode是要报修的资产的条码
comment否备注
mediaResources否要报修的资产的图片路径，最多可传入三张图片

返回结果 ​

json
{
    "serialNo": "ARP201910100002",
}

结果说明 ​

属性名称说明
serialNo报修单号

附录 ​

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. 资产数据对象格式 ​

属性名称说明
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购入时间（时间戳格式）/td>
picturePath图片路径
rfidRfid
serviceLife使用期限
signaturePicturePath签字图片路径
signatureStatus签字状态，0：待签字、1：已签字、2：已打回、"":空状态
source来源
specs规格型号
snSN号
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自定义字段值