Skip to content

资产交接接口 ​

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

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

请求地址 ​

text
GET /asset

参数说明 ​

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

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

返回结果 ​

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
PUT /selfService/handover
POST /selfService/handover/put

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

请求示例 ​

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

参数说明 ​

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

返回结果 ​

json
{}

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

附录 ​

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购入时间
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自定义字段值