资产列表接口 ​

1. 获取资产列表 ​

请求地址 ​

text
GET /asset

参数说明 ​

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

返回结果 ​

json
{
    "offset": 0,
    "total": 0,
    "results": [
        {
            "assetTypeCode": "10",
            "assetTypeName": "家具用具及其他类",
            "useCompanyCode": "01",
            "useCompanyName": "测试企业",
            "ownCompanyCode": "01",
            "ownCompanyName": "测试企业",
            "maintainerName": "张三",
            "extensionFields": [
                {
                    "model": "input_1",
                    "name": "品牌",
                    "value": "苹果",
                    "fieldAreaType": 1,
                },
                {
                    "model": "input_2",
                    "name": "显示器",
                    "value": "15.6",
                    "fieldAreaType": 2
                }
            ],
            "tags": [
                {
                    "name": "已标记",
                    "foreColor": "#ffffff",
                    "backgroundColor": "#dba549",
                    "createTime": "1630048517",
                }
            ],
            "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": ""
            "dataJson": "{\"input_1627651550100\":\"\",\"textarea_1627651551520\":\"\",\"number_1627651554928\":0,\"checkbox_1627651560891\":[],\"time_1627651562839\":null,\"date_1627651564093\":null,\"select_1627651565724\":{\"value\":\"3562d6fa-a73f-4f81-a011-09b91fa88fbd\",\"label\":\"三个一级\"},\"imgUpload_1627651574113\":null,\"query_1627651577323\":null,\"version\":\"b92e1c11-7d8a-4dcf-8124-26296e544922\"}"
        ]
        }
    ],
    "meta": {}
}
参数说明
offset当前结果对于首条结果的偏移量，指定分页查询时不为0
total所有符合查询条件的查询结果数量，指定需要结果记录数量时不为0
results符合查询条件的资产详情集合
meta其他信息

2. 获取资产财务详情 ​

请求地址 ​

text
GET /Asset/Financial

参数说明 ​

参数是否必须参数类型说明
barcode是String资产编码

返回结果 ​

json
{
    "financialInformation": {
        "apportionDepartment": "测试啊",
        "apportionDepartmentCode": "64672",
        "companyName": "测试",
        "companyCode": "01",
        "id": 36130,
        "barcode": "01010001",
        "financialType": 1,
        "afterTaxAmount": 700.00,
        "tax": 32.00,
        "enterPeriod": "",
        "serviceLife": 240,
        "accumulatedDepreciation": 5.0000,
        "netValue": 663.0000,
        "apportionDepartmentId": 13758,
        "residualsRate": 12,
        "enteredTime": "1566144000",
        "usedMonth": 1,
        "financialStatus": 3,
        "periodDepreciation": 0.0000,
        "lastDepreciationPeriod": "",
        "isInitData": true,
        "createdTime": "1600222832"
    }
}
属性名称说明
financialInformation资产财务详情
apportionDepartment分摊部门
apportionDepartmentCode分摊部门编码
companyName所属公司名称
companyCode所属公司编码
id财务id
barcode资产编码
financialType财务类型（1:固定资产、2:低值易耗品）
afterTaxAmount含税金额
tax税额
enterPeriod入账期间
serviceLife使用期限
accumulatedDepreciation累计折旧
netValue净值
apportionDepartmentId分摊部门id
residualsRate残值率
enteredTime入账时间
usedMonth已使用月数
financialStatus财务信息状态（0:未入账、1:在账、2:已处置、3:初始化、4:结束初始化）
periodDepreciation本期折旧字段
lastDepreciationPeriod未用
isInitData未用
createdTime创建时间

3. 获取资产处理记录 ​

请求地址 ​

text
GET /Asset/HandleLog

参数说明 ​

参数是否必须参数类型说明
barcode是String资产编码

返回结果 ​

json
{
    "offset": 0,
    "total": 0,
    "results": [
        {
            "handler": "尚德",
            "handledDate": "1599966022",
            "handleType": 1,
            "handleContent": "【使用人】字段由 \"<空>\" 变更为 \"尚德\";【使用公司】字段由 \"测试\" 变更为 \"恶魔\";【使用部门】字段由 \"<空>\" 变更为 \"测试吧\";"
        }
    ],
    "meta": {}
}
参数说明
offset当前结果对于首条结果的偏移量，指定分页查询时不为0
total所有符合查询条件的查询结果数量，指定需要结果记录数量时不为0
results符合查询条件的资产处理记录详情集合
meta其他信息

4. 复制资产 ​

请求地址 ​

text
POST /Asset/Copy

请求示例 ​

json
{
    "barcode":"0201003",
    "quantity":1
}

参数说明 ​

参数是否必须参数类型说明
barcode是String资产编码
quantity是Int数量（最大99个）

返回结果 ​

json
{
    "assets": [
        {
            "id": 5065599,
            "barcode": "023725581001"
        }
    ]
}

结果说明 ​

属性名称说明
assets复制后的资产合集
id资产id
barcode资产编码

5. 新建资产 ​

请求地址 ​

text
POST /Asset?_clienttype=1

请求示例 ​

json
{
    "vendorPhoneNumber":"83263996",
    "maintenanceExpiredDate":"2020-11-16",
    "amount":"80",
    "userEmployeeId":"d93ac28f-0198-4c65-8056-f03c67e7e1dd",
    "barcode":"",
    "sn":"36666",
    "specs":"新型号",
    "assetTypeCode":"1002",
    "vendorName":"供应",
    "source":"1",
    "maintainerId":"6261",
    "serviceLife":"12",
    "useCompanyCode":"01",
    "address":"本地仓库",
    "ownCompanyCode":"01",
    "name":"新电脑",
    "purchasedDate":"2020-09-16",
    "comment":"资产",
    "measureUnit":"新单位",
    "supervisorId":"6261",
    "maintenanceMemo":"维保",
    "useDepartmentCode":"64672",
    "districtCode":"01",
    "specificationId":"13557",
    "vendorContacts":"联系"
    "extensionFields": [
        {
            "name": "CP",
            "value": "i7"
        }, 
        {
            "name": "内存大小",
            "value": "16GB"
        },
        {
            "name": "用户选择",
            "value": "12345"
        },
        {
            "name": "公司选择",
            "value": "000079"
        },
        {
            "name": "资产分类",
            "value": "6000000"
        }, 
        {
            "name": "单选框组",
            "value": "Option a"
        }, 
        {
            "name": "下拉选择框",
            "value": "Option a"
        }, 
        {
            "name": "多选框组", 
            "value": "aaa,bbb,Option 2,Option 3"
        }
    ]
}

参数说明 ​

参数是否必须参数类型说明
vendorPhoneNumber否String联系方式
maintenanceExpiredDate否String维保到期日期
amount否String金额
userEmployeeId否String使用人id
barcode否String资产编码
sn否Stringsn编码
specs否String规格型号
assetTypeCode是String资产分类编码
vendorName否String供应商
source否String来源方式（1:购入、2:自建、3:租赁、4:捐赠、5:其他、6:内部购入、7:盘盈）
maintainerId否String维保负责人id
serviceLife否String使用期限
useCompanyCode是String使用公司编码
address否String存放地点
ownCompanyCode是String所属公司编码
name是String资产名称
purchasedDate否String购入日期
comment否String资产备注
measureUnit否String计量单位
supervisorId是String管理员id
maintenanceMemo否String维保备注
useDepartmentCode否String使用部门编码
districtCode是String区域编码
specificationId否String标准型号id
vendorContacts否String联系人
thumbnailMediaResourceNo否String资产缩略图编号
pictureMediaResourceNo否String资产图片编号
extensionFields否json对象集合自定义属性

注意：自定义属性参数仅支持在表单设计器中标识为基础字段和数据字段的自定义属性。 提交时参数值会根据您的定义进行验证。（有默认值设置的属性会使用默认值替换空值，请确保默认值与您设置的验证规则没有冲突） 对于可能包含多值的自定义属性如复选框，请将value属性赋值为使用逗号分隔的字符串。 ​

返回结果 ​

json
{
    "assetId": 5068329,
    "barcode": "100201001",
    "pendingSignatureId": "2372"
}

结果说明 ​

属性名称说明
assetId资产id
pendingSignatureId签字id（未开启签字时不返回）
barcode资产编码

6. 修改资产 ​

请求地址 ​

text
POST /Asset/put?_clienttype=1

请求示例 ​

json
{
    "vendorPhoneNumber":"83263996",
    "maintenanceExpiredDate":"2020-11-16",
    "amount":"80",
    "userEmployeeId":"d93ac28f-0198-4c65-8056-f03c67e7e1dd",
    "barcode":"100201001",
    "sn":"36666",
    "specs":"新型号",
    "assetTypeCode":"1002",
    "vendorName":"供应",
    "source":"1",
    "maintainerId":"6261",
    "serviceLife":"12",
    "useCompanyCode":"01",
    "address":"本地仓库",
    "ownCompanyCode":"01",
    "name":"新资产",
    "purchasedDate":"2020-09-16",
    "comment":"资产",
    "measureUnit":"新单位",
    "supervisorId":"6261",
    "maintenanceMemo":"维保",
    "useDepartmentCode":"64672",
    "districtCode":"01",
    "specificationId":"13557",
    "vendorContacts":"联系"
    "extensionFields": [
        {
            "name": "CP",
            "value": "i7"
        }, 
        {
            "name": "内存大小",
            "value": "16GB"
        },
        {
            "name": "用户选择",
            "value": "12345"
        },
        {
            "name": "公司选择",
            "value": "000079"
        },
        {
            "name": "资产分类",
            "value": "6000000"
        }, 
        {
            "name": "单选框组",
            "value": "Option a"
        }, 
        {
            "name": "下拉选择框",
            "value": "Option a"
        }, 
        {
            "name": "多选框组", 
            "value": "aaa,bbb,Option 2,Option 3"
        }
    ]
}

参数说明 ​

参数是否必须参数类型说明
vendorPhoneNumber否String联系方式
maintenanceExpiredDate否String维保到期日期
amount否String金额
userEmployeeId否String使用人id
barcode是String资产编码
sn否Stringsn编码
specs否String规格型号
assetTypeCode是String资产分类编码
vendorName否String供应商
source否String来源方式（1:购入、2:自建、3:租赁、4:捐赠、5:其他、6:内部购入、7:盘盈）
maintainerId否String维保负责人id
serviceLife否String使用期限
useCompanyCode是String使用公司编码
address否String存放地点
ownCompanyCode是String所属公司编码
name是String资产名称
purchasedDate否String购入日期
comment否String资产备注
measureUnit否String计量单位
supervisorId是String管理员id
maintenanceMemo否String维保备注
useDepartmentCode否String使用部门编码
districtCode是String区域编码
specificationId否String标准型号id
vendorContacts否String联系人
thumbnailMediaResourceNo否String资产缩略图编号
pictureMediaResourceNo否String资产图片编号
extensionFields否json对象集合自定义属性

注意：自定义属性参数仅支持在表单设计器中标识为基础字段和数据字段的自定义属性。 提交时参数值会根据您的定义进行验证。（有默认值设置的属性会使用默认值替换空值，请确保默认值与您设置的验证规则没有冲突） 对于可能包含多值的自定义属性如复选框，请将value属性赋值为使用逗号分隔的字符串。 ​

返回结果 ​

json
{
    "assetId": 5068329,
    "barcode": "100201001",
    "pendingSignatureId": "2372"
}

结果说明 ​

属性名称说明
assetId资产id
pendingSignatureId签字id（未开启签字时不返回）
barcode资产编码

附录 ​

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

2. 数据实体格式 ​

1. 资产数据对象格式 ​

属性名称说明
address存放地点
addressTypeCode区域编码
addressTypeId区域Id
addressTypeName区域名称
amount金额
assetTypeCode资产分类编码
assetTypeId资产分类Id
assetTypeName资产分类名称
assetSpecsId标准资产型号Id
barcode资产编码
createdBy创建人
createdDate创建日期
comment备注
deleted是否已报废，1：是、0：否
enterpriseId所属企业Id
id资产Id
includedInBill是否被其他单据占用，空值表示没被占用
measureUnit计量单位
name资产名称
ownCompanyCode所属公司编码
ownCompanyId所属公司名称
ownCompanyName所属公司名称
purchasedDate购入时间
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最后一次修改人
dataJson自定义属性字符串合集
extensionFields自定义属性详情集合
tags标签详情集合

自定义属性详情 ​

属性名称说明
fieldAreaType自定义属性类型，1：公有属性、2：分类属性、3：私有属性
name自定义属性名称
value自定义属性值
model自定义属性标识

标签详情 ​

属性名称说明
name标签名称
foreColor文字颜色
backgroundColor背景颜色
createTime创建时间（时间戳格式）

2. 资产处理记录数据对象格式 ​

属性名称说明
handler处理人
handledDate处理时间
handleType处理类型（1:领用、2:退库、3:借用归还、4:资产调拨、5:实物信息变更、6:财务变更、7:维修记录、8:清理、9:盘点处理、10:签字、11:维保信息变更、12:维保批量变更、13:自助交接、14:资产入账、15:财务信息变更、16:财务处置、17：标准资产型号变更、30:申请单审核、40:创建盘点单不包含调拨资产、50:删除附件）
handleContent处理内容