Skip to content

维修信息登记接口 ​

1. 获取资产维修单列表 ​

请求地址 ​

text
GET /receipt/repair

参数说明 ​

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

返回结果 ​

json
{
    "offset": 0,
    "total": 13,
    "results": [
        {
            "userEmployeeNo": "000001",
            "mediaResources": [
                {
                    "serialNo": "MR202004180054",
                    "enterpriseId": 4506,
                    "displayName": "/MediaResources/4506/AssetStockIn/20200418/cfc0c619e9ea406c93c33752b0373d41.jpg",
                    "savePath": "/MediaResources/4506/AssetStockIn/20200418/cfc0c619e9ea406c93c33752b0373d41.jpg",
                    "thumbPath": "/MediaResources/4506/AssetStockIn/20200418/cfc0c619e9ea406c93c33752b0373d41.jpg",
                    "fileExt": ".jpg",
                    "billNo": "ARP202004180002",
                    "billType": 1,
                    "billId": 21497,
                    "createById": 6261,
                    "createDate": "1587194203",
                    "isCompleted": true
                },
                {
                    "serialNo": "MR202004180055",
                    "enterpriseId": 4506,
                    "displayName": "/MediaResources/4506/AssetStockIn/20200418/662279a14b23485e8cde7ed90266bd8c.jpg",
                    "savePath": "/MediaResources/4506/AssetStockIn/20200418/662279a14b23485e8cde7ed90266bd8c.jpg",
                    "thumbPath": "/MediaResources/4506/AssetStockIn/20200418/662279a14b23485e8cde7ed90266bd8c.jpg",
                    "fileExt": ".jpg",
                    "billNo": "ARP202004180002",
                    "billType": 1,
                    "billId": 21497,
                    "createById": 6261,
                    "createDate": "1587194223",
                    "isCompleted": true
                }
            ],
            "assets": [
                {
                    "barcode": "369258",
                    "picturePath": "/MediaResources/4506/AssetCheck/20200418/8abc4cf91f9d455bac0b164e96944cf6.jpg",
                    "thumbnailPath": "/MediaResources/4506/AssetCheck/20200418/d4c4a6cf56284124a221b0c47e832153.jpg",
                    "name": "手机",
                    "specs": "联想",
                    "specsId": 0,
                    "ownCompanyCode": "01",
                    "ownCompanyName": "测试",
                    "useCompanyCode": "01",
                    "useCompanyName": "测试",
                    "address": "嗯呢",
                    "measureUnit": "个",
                    "assetTypeCode": "01",
                    "assetTypeName": "土地、房屋及构筑物",
                    "amount": 0,
                    "user": "新员工",
                    "useDepartmentCode": "64672",
                    "useDepartmentName": "测试啊",
                    "userEmployeeNo": "563333",
                    "userEmployeeName": "新员工",
                    "supervisor": "尚德",
                    "district": "石家庄",
                    "assetId": 4359542
                }
            ],
            "repairStatus": "已完成",
            "id": 21497,
            "serialNo": "ARP202004180002",
            "useDate": "1587168000",
            "amount": 66,
            "user": "尚德",
            "content": "内容",
            "comment": "",
            "isDelete": false,
            "status": 2,
            "signatureStatus": 1,
            "signaturePicPath": "/MediaResources/4506/Signature/20200418/d2cdcc4098ec41d59938a4280cbe2d3a.jpg",
            "userEmployeeId": "dbb5aa65-8f1c-4d69-8366-49823fe978a3",
            "userEmployeeName": "阿敏",
            "completeDate": "1587194223",
            "isByWeiXin": false
        }
    ],
    "meta": {}
}
参数说明
offset当前结果对于首条结果的偏移量,指定分页查询时不为0
total所有符合查询条件的查询结果数量,指定需要结果记录数量时不为0
results符合查询条件的资产维修单详情集合
meta其他信息

2. 新增资产维修单 ​

请求地址 ​

text
PUT /Issue/Asset/Repair
POST /Issue/Asset/Repair/put

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

请求示例 ​

json
{
    "Status":"1",
    "Comment":"维修单",
    "UserEmployeeNo":"563333",
    "Money":"66",
    "UseDate":"1600790400",
    "Content":"椅子坏了",
    "AssetBarcodes": 
    [
        "1001010001"
    ],
    "MediaResourceNoList": 
    [
        "MR202009230001"
    ]
}

参数说明 ​

参数是否必须说明
Status是维修状态(0:报修中,1:维修中,2:已完成)
Comment否维修备注
UserEmployeeNo否报修人编码
Money是调入使用公司编码
UseDate是业务日期(时间戳格式)
Content是维修内容
AssetBarcodes是新增维修单的资产编码集合
MediaResourceNoList否新增维修单的图片资源集合

返回结果 ​

json
{
    "serialNo": "ARP202009230001",
    "signatureId": 0
}

结果说明 ​

属性名称说明
serialNo单据号
signatureId签字id

3. 修改资产维修单 ​

请求地址 ​

text
PUT /Issue/Asset/Repair
POST /Issue/Asset/Repair/put

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

请求示例 ​

json
{
    "SerialNo":"ARP202009230001",
    "Status":"2",
    "Comment":"维修单",
    "UserEmployeeNo":"563333",
    "UserEmployeeName":"张三",
    "Money":"66",
    "UseDate":"1600790400",
    "Content":"椅子坏了",
    "AssetBarcodes": 
    [
        "1001010001"
    ],
    "MediaResourceNoList": 
    [
        "MR202009230001"
    ]
}

参数说明 ​

参数是否必须说明
SerialNo是维修单号
Status是维修状态(0:报修中,1:维修中,2:已完成)
Comment否维修备注
UserEmployeeNo否报修人编码
UserEmployeeNo否报修人名称
Money是调入使用公司编码
UseDate是业务日期(时间戳格式)
Content是维修内容
AssetBarcodes是修改维修单的资产编码集合
MediaResourceNoList否修改维修单的图片资源集合

返回结果 ​

json
{
    "serialNo": "ARP202009230001",
    "signatureId": 0
}

结果说明 ​

属性名称说明
serialNo单据号
signatureId签字id

附录 ​

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

属性名称说明
userEmployeeNo报修人编码
repairStatus维修单状态(报修中、维修中、已完成)
id维修单id
serialNo维修单编码
useDate单据操作日期(时间戳格式)
amount维修金额
user报修人名称
content维修说明
comment备注
isDelete是否被删除
status维修单状态(0:报修中、1:维修中、2:已完成)
signatureStatus签字状态(0:待签字、1:已签字、2:已驳回)
signaturePicPath签字图片路径
userEmployeeId报修人id
userEmployeeName报修人名称
completeDate单据完成时间(时间戳格式)
isByWeiXin是否员工端创建
dataJson单据扩展字段字符串合集
mediaResources维修单包含的图片资源详情集合
assets维修单包含的资产详情集合

维修单包含的图片资源详情 ​

属性名称说明
serialNo资源编码
enterpriseId企业id
displayName资源名称
savePath资源图片路径
thumbPath资源图片的缩略图路径
fileExt资源类型
billNo资源所属单据号
billType资源所属类型(1:资产维修单、2:资产盘点单、3:资产图片、4:标准资产型号、5、资产变更单、6:签字图片、7:资产附件、8:耗材物品图片、9:耗材盘点单)
billId资源所属单据id
createById创建人id
createDate创建日期(时间戳格式)
isCompleted是否保存成功

维修单包含的资产详情 ​

属性名称说明
barcode资产编码
picturePath资产图片路径
thumbnailPath资产图片的缩略图路径
name资产名称
specs规格型号
specsId标准型号id
ownCompanyCode所属公司编码
ownCompanyName所属公司名称
useCompanyCode使用公司编码
useCompanyName使用公司名称
address存放地点
measureUnit计量单位
assetTypeCode资产分类编码
assetTypeName资产分类名称
amount金额
user使用人
useDepartmentCode使用部门编号
useDepartmentName使用部门名称
userEmployeeNo使用人编号
userEmployeeName使用人名称
supervisor管理员
district区域名称
assetId资产id