清理报废接口
1. 获取资产报废单列表
请求地址
text
GET /receipt/clear参数说明
资产报废单查询接口支持丰富的条件过滤参数,请参见支持的查询参数附录
返回结果
json
{
"offset": 0,
"total": 13,
"results": [
{
"assets": [
{
"barcode": "100237255811",
"picturePath": "/MediaResources/4506/AssetCheck/20200418/1cb3ecf0feaa4eee8c46eb57601e6ae2.jpg",
"thumbnailPath": "/MediaResources/4506/AssetCheck/20200418/d190f9df5b8847ffa24f71a40c190277.jpg",
"name": "新资产",
"sn": "366669",
"specs": "新型号",
"specsId": 13557,
"ownCompanyName": "恶魔",
"useCompanyName": "恶魔",
"address": "三星的",
"applyBarcode": "100237255811",
"measureUnit": "新单位",
"assetType": "分类二",
"user": "尚德",
"amount": 122.00,
"useDepartmentName": "测试吧",
"userEmployeeName": "尚德",
"supervisor": "尚德",
"district": "本地",
"purchasedDate": "1587139200",
"assetId": 4359048,
"assetOldComment": "资产变更"
}
],
"id": 39254,
"serialNo": "ACR202004180002",
"clearDate": "1587139200",
"clearUser": "尚德",
"comment": "",
"createUserId": 6261,
"enterpriseId": 4506,
"createDate": "1587188284",
"isDelete": false,
"signatureStatus": 6,
"updateUser": 0
}
],
"meta": {}
}| 参数 | 说明 |
|---|---|
| offset | 当前结果对于首条结果的偏移量,指定分页查询时不为0 |
| total | 所有符合查询条件的查询结果数量,指定需要结果记录数量时不为0 |
| results | 符合查询条件的资产报废单详情集合 |
| meta | 其他信息 |
2. 新增资产报废单
请求地址
text
PUT /Issue/Asset/Clear
POST /Issue/Asset/Clear/put对于不支持PUT请求的网络环境,请尝试使用备份的POST请求地址
请求示例
json
{
"Comment":"报废",
"AssetBarcodes":
[
"100201002"
],
"ClearDate":"1600790400",
"OwnerCompanyCode":"01"
}参数说明
| 参数 | 是否必须 | 说明 |
|---|---|---|
| ClearDate | 是 | 报废日期(时间戳格式) |
| Comment | 否 | 报废备注 |
| OwnerCompanyCode | 是 | 业务所属公司编码 |
| AssetBarcodes | 是 | 新增报废单的资产编码集合 |
返回结果
json
{
"serialNo": "ACR202009230001",
"signatureId": 0
}结果说明
| 属性名称 | 说明 |
|---|---|
| serialNo | 单据号 |
| signatureId | 签字id |
3. 修改资产报废单
请求地址
text
PUT /Issue/Asset/Clear
POST /Issue/Asset/Clear/put对于不支持PUT请求的网络环境,请尝试使用备份的POST请求地址
请求示例
json
{
"SerialNo":"ACR202009230001",
"Comment":"报废",
"AssetBarcodes":
[
"100201002"
],
"ClearDate":"1600790400",
"OwnerCompanyCode":"01"
}参数说明
| 参数 | 是否必须 | 说明 |
|---|---|---|
| SerialNo | 是 | 报废单号 |
| ClearDate | 是 | 报废日期(时间戳格式) |
| Comment | 否 | 报废备注 |
| OwnerCompanyCode | 是 | 业务所属公司编码 |
| AssetBarcodes | 是 | 新增报废单的资产编码集合 |
返回结果
json
{
"serialNo": "ACR202009230001",
"signatureId": 0
}结果说明
| 属性名称 | 说明 |
|---|---|
| serialNo | 单据号 |
| signatureId | 签字id |
4. 还原资产报废单
请求地址
text
POST /Asset/Clear/Restore请求示例
json
{
"SerialNos":
[
"ACR202009230001"
]
}参数说明
| 参数 | 是否必须 | 说明 |
|---|---|---|
| SerialNos | 是 | 报废单号集合 |
返回结果
json
{
}附录
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. 资产报废单数据对象格式
| 属性名称 | 说明 |
|---|---|
| ownerCompanyCode | 业务所属公司编码 |
| ownerCompanyName | 业务所属公司名称 |
| id | 报废单id |
| serialNo | 报废单编码 |
| clearDate | 报废日期(时间戳格式) |
| clearUser | 报废处理人 |
| comment | 备注 |
| createUserId | 报废处理人id |
| enterpriseId | 企业id |
| signatureStatus | 办理状态(0:待签字、1:已签字、2:已驳回、4:审批中、5:已审批、6:已驳回、10:已审批待签字、11:已审批已签字、12:已审批已驳回、3:空状态) |
| createDate | 创建日期(时间戳格式) |
| isDelete | 是否被删除 |
| updateUser | 单据更新人 |
| dataJson | 单据扩展字段字符串合集 |
| assets | 报废单包含的资产详情集合 |
报废单包含的资产详情
| 属性名称 | 说明 |
|---|---|
| barcode | 资产编码 |
| picturePath | 资产图片路径 |
| thumbnailPath | 资产图片的缩略图路径 |
| name | 资产名称 |
| sn | sn号 |
| specs | 规格型号 |
| specsId | 标准型号id |
| ownCompanyName | 所属公司名称 |
| useCompanyName | 使用公司名称 |
| address | 存放地点 |
| applyBarcode | 申请单资产编码 |
| measureUnit | 计量单位 |
| assetType | 资产分类名称 |
| amount | 金额 |
| user | 使用人 |
| useDepartmentName | 使用部门名称 |
| userEmployeeName | 使用人名称 |
| supervisor | 管理员 |
| district | 区域名称 |
| purchasedDate | 购入日期(时间戳格式) |
| assetId | 资产id |
| assetOldComment | 资产备注 |