维修信息登记接口
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 |