维保信息变更接口
1. 获取资产维保信息变更单列表
请求地址
text
GET /receipt/maintenance参数说明
资产维保信息变更单查询接口支持丰富的条件过滤参数，请参见支持的查询参数附录
返回结果
json
{
"offset": 0,
"total": 13,
"results": [
{
"createUserName": "尚德",
"ownerCompanyCode": "112233",
"ownerCompanyName": "新公司啊",
"maintenancePersonUserName": "shangde@112.com",
"assets": [
{
"barcode": "2312432122",
"picturePath": "/MediaResources/4506/AssetSpecs/20200418/d6498fd7ea0d455783cc3177467176ce.jpg",
"thumbnailPath": "/MediaResources/4506/AssetSpecs/20200418/d6498fd7ea0d455783cc3177467176ce.jpg",
"name": "新资产",
"sn": "2344234",
"specs": "新型号",
"specsId": 0,
"ownCompanyName": "测试",
"useCompanyName": "新公司啊",
"address": "仓库",
"applyBarcode": "2312432122",
"measureUnit": "新单位",
"assetType": "分类二",
"amount": 0,
"useDepartmentName": "新部门啊",
"userEmployeeName": "爱死才啊",
"supervisor": "管理二",
"districtName": "石家庄",
"oldMaintenancPersonUserName": "shangde@123.com",
"assetId": 5093370,
"assetMaintenanceChangeId": 2022,
"oldProvider": "供应商",
"oldMaintenancePersonId": 6261,
"oldMaintenancePerson": "尚德",
"oldProviderLinker": "联系人",
"oldMaintenanceExpiredDate": "1601447640",
"oldContactWay": "83263998",
"oldMaintenanceMemo": "维保"
}
],
"id": 2022,
"serialNo": "AMC202009240002",
"changeDate": "1600929387",
"provider": "供应商2",
"maintenancePersonId": 55048,
"maintenancePerson": "管理二",
"providerLinker": "联系人2",
"maintenanceExpiredDate": "1602633600",
"contactWay": "83263997",
"maintenanceMemo": "维保啊",
"signatureStatus": 0
}
],
"meta": {}
}| 参数 | 说明 |
|---|---|
| offset | 当前结果对于首条结果的偏移量，指定分页查询时不为0 |
| total | 所有符合查询条件的查询结果数量，指定需要结果记录数量时不为0 |
| results | 符合查询条件的资产维保信息变更单详情集合 |
| meta | 其他信息 |
2. 新增资产维保信息变更单
请求地址
text
PUT /Issue/Asset/MaintenanceChange
POST /Issue/Asset/MaintenanceChange/put对于不支持PUT请求的网络环境，请尝试使用备份的POST请求地址
请求示例
json
{
"OwnerCompanyCode":"112233",
"AssetBarcodes":
[
"2312432122"
],
"Provider":"供应啦",
"MaintenanceMemo":"维保啊",
"ChangeDate":"1600876800",
"MaintenanceExpiredDate":"1603728000",
"MaintenancePerson":"管理二",
"ContactWay":"83263996",
"MaintenanceUserName":"shangde@112.com",
"ProviderLinker":"联系吧"
}参数说明
| 参数 | 是否必须 | 说明 |
|---|---|---|
| OwnerCompanyCode | 是 | 业务所属公司编码 |
| Provider | 否 | 供应商 |
| MaintenanceMemo | 否 | 维保备注 |
| ChangeDate | 否 | 变更日期（时间戳格式） |
| MaintenanceExpiredDate | 否 | 维保到期日期（时间戳格式）（维保到期日期和维保管理员要么都不填写，要么都填写，不能只填写一项） |
| MaintenancePerson | 否 | 维保管理员 |
| ContactWay | 否 | 联系方式 |
| MaintenanceUserName | 否 | 维保管理员账号 |
| ProviderLinker | 否 | 联系人 |
| AssetBarcodes | 是 | 新增维保信息变更单的资产编码集合 |
返回结果
json
{
"serialNo": "AMC202009240003",
"signatureId": 337927
}结果说明
| 属性名称 | 说明 |
|---|---|
| serialNo | 单据号 |
| signatureId | 签字id |
3. 修改资产维保信息变更单
请求地址
text
PUT /Issue/Asset/MaintenanceChange
POST /Issue/Asset/MaintenanceChange/put对于不支持PUT请求的网络环境，请尝试使用备份的POST请求地址
请求示例
json
{
"SerialNo":"AMC202009240003",
"OwnerCompanyCode":"112233",
"AssetBarcodes":
[
"2312432122"
],
"Provider":"供应啦",
"MaintenanceMemo":"维保啊",
"ChangeDate":"1600876800",
"MaintenanceExpiredDate":"1603728000",
"MaintenancePerson":"管理二",
"ContactWay":"83263996",
"MaintenanceUserName":"shangde@112.com",
"ProviderLinker":"联系吧"
}参数说明
| 参数 | 是否必须 | 说明 |
|---|---|---|
| SerialNo | 是 | 单据号 |
| OwnerCompanyCode | 是 | 业务所属公司编码 |
| Provider | 否 | 供应商 |
| MaintenanceMemo | 否 | 维保备注 |
| ChangeDate | 否 | 变更日期（时间戳格式） |
| MaintenanceExpiredDate | 否 | 维保到期日期（时间戳格式）（维保到期日期和维保管理员要么都不填写，要么都填写，不能只填写一项） |
| MaintenancePerson | 否 | 维保管理员 |
| ContactWay | 否 | 联系方式 |
| MaintenanceUserName | 否 | 维保管理员账号 |
| ProviderLinker | 否 | 联系人 |
| AssetBarcodes | 是 | 新增维保信息变更单的资产编码集合 |
返回结果
json
{
"serialNo": "AMC202009240003",
"signatureId": 337927
}结果说明
| 属性名称 | 说明 |
|---|---|
| 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. 资产维保信息变更单数据对象格式
| 属性名称 | 说明 |
|---|---|
| createUserName | 创建人 |
| ownerCompanyCode | 业务所属公司编码 |
| ownerCompanyName | 业务所属公司名称 |
| maintenancePersonUserName | 维保管理员账号 |
| id | 单据id |
| serialNo | 单据号 |
| changeDate | 变更日期（时间戳格式） |
| provider | 供应商 |
| maintenancePersonId | 维保管理员id |
| maintenancePerson | 维保管理员 |
| providerLinker | 联系人 |
| maintenanceExpiredDate | 维保到期日期（时间戳格式） |
| contactWay | 联系方式 |
| maintenanceMemo | 维保备注 |
| signatureStatus | 办理状态（0:待签字、1:已签字、2:已驳回、4:审批中、5:已审批、6:已驳回、10:已审批待签字、11:已审批已签字、12:已审批已驳回、3:空状态） |
| signaturePicPath | 签字图片 |
| dataJson | 单据扩展字段字符串合集 |
| assets | 维保信息变更单包含的资产详情集合 |
维保信息变更单包含的资产详情
| 属性名称 | 说明 |
|---|---|
| barcode | 资产编码 |
| picturePath | 资产图片路径 |
| thumbnailPath | 资产图片的缩略图路径 |
| name | 资产名称 |
| sn | sn号 |
| specs | 规格型号 |
| specsId | 标准型号id |
| ownCompanyName | 所属公司名称 |
| useCompanyName | 使用公司名称 |
| address | 存放地点 |
| measureUnit | 计量单位 |
| assetType | 资产分类名称 |
| amount | 金额 |
| useDepartmentName | 使用部门名称 |
| userEmployeeName | 使用人 |
| supervisor | 管理员 |
| districtName | 区域名称 |
| oldMaintenancPersonUserName | 旧的维保管理员账号 |
| assetId | 资产id |
| assetMaintenanceChangeId | 资产所属的单据id |
| oldProvider | 旧的供应商 |
| oldMaintenancePersonId | 旧的维保管理员id |
| oldMaintenancePerson | 旧的维保管理员 |
| oldProviderLinker | 旧的联系人 |
| oldMaintenanceExpiredDate | 旧的维保到期日期（时间戳格式） |
| oldContactWay | 旧的联系方式 |
| oldMaintenanceMemo | 旧的维保备注 |