实物信息变更接口
1. 获取资产实物信息变更单列表
请求地址
text
GET /receipt/otherChange参数说明
资产实物信息变更单查询接口支持丰富的条件过滤参数,请参见支持的查询参数附录
返回结果
json
{
"offset": 0,
"total": 13,
"results": [
{
"assetTypeCode": "1002",
"assetTypeName": "分类二",
"useCompanyName": "新公司啊",
"useCompanyCode": "112233",
"ownerCompanyName": "测试",
"ownerCompanyCode": "01",
"useDepartmentName": "新部门啊",
"useDepartmentCode": "2312213",
"district": "石家庄",
"districtCode": "27594",
"useEmployeeName": "爱死才啊",
"useEmployeeNo": "12312312",
"sourceName": "购入",
"supervisor": "管理二",
"supervisorUserName": "shangde@112.com",
"assets": [
{
"id": 1443314,
"assetOtherChangeId": 536773,
"assetId": 5093370,
"barcode": "2312432122",
"picturePath": "/MediaResources/4506/AssetSpecs/20200418/d6498fd7ea0d455783cc3177467176ce.jpg",
"thumbnailPath": "/MediaResources/4506/AssetSpecs/20200418/d6498fd7ea0d455783cc3177467176ce.jpg",
"name": "这个哈",
"specs": "",
"ownCompanyName": "测试",
"ownCompanyCode": "01",
"useCompanyId": 56404,
"useCompanyName": "新公司啊",
"useCompanyCode": "112233",
"address": "",
"measureUnit": "",
"assetTypeId": 418599,
"assetTypeCode": 1002,
"assetType": "分类二",
"amount": 0,
"useDepartmentId": 332970,
"useDepartmentCode": 2312213,
"useDepartmentName": "新部门啊",
"supervisorId": 55048,
"supervisor": "尚德",
"supervisorUserName": "shangde@112.com",
"district": "本地",
"districtCode": "27594",
"purchaseDate": "1600425997",
"source": 7,
"sourceName": "盘盈",
"userEmployeeId": "8ed11ca8-70d5-4ffb-9724-f5cff1a0e3a5",
"userEmployeeNo": "12312312",
"dataJson": "{\"input_1627651550100\":\"\",\"textarea_1627651551520\":\"\",\"number_1627651554928\":0,\"checkbox_1627651560891\":[],\"time_1627651562839\":null,\"date_1627651564093\":null,\"select_1627651565724\":{\"value\":\"3562d6fa-a73f-4f81-a011-09b91fa88fbd\",\"label\":\"三个一级\"},\"imgUpload_1627651574113\":null,\"query_1627651577323\":null,\"version\":\"b92e1c11-7d8a-4dcf-8124-26296e544922\"}",
"extensionFields": [
{
"id": 46027964,
"assetId": 5093370,
"name": "品牌",
"value": "111",
"fieldAreaType": 1,
"required": false,
"extensionFieldId": 40591
}
]
}
],
"extensionFields": [
{
"id": 40591,
"name": "品牌",
"value": "品牌",
"fieldAreaType": 1,
"required": false,
"extensionFieldId": 40591,
"fieldType": "0"
}
],
"id": 536773,
"serialNo": "AOC202009230002",
"useDate": "1600851126",
"assetTypeId": 418599,
"assetName": "新资产",
"specs": "新型号",
"snNo": "2344234",
"measureUnit": "新单位",
"provider": "公允个",
"comment": "资产吧",
"picPath": "/MediaResources/4506/AssetSpecs/20200418/d6498fd7ea0d455783cc3177467176ce.jpg",
"thumbPath": "/MediaResources/4506/AssetSpecs/20200418/d6498fd7ea0d455783cc3177467176ce.jpg",
"operator": "尚德",
"changeDate": "1600790400",
"useCompanyId": 56404,
"useDepartmentId": 332970,
"assetUser": "爱死才啊",
"districtId": 9723,
"address": "仓库",
"useYear": 12,
"source": 1,
"userEmployeeId": "8ed11ca8-70d5-4ffb-9724-f5cff1a0e3a5",
"supervisorId": 55048,
"assetSpecsId": 13557,
"dataJson": "{\"input_1627651550100\":\"\",\"textarea_1627651551520\":\"\",\"number_1627651554928\":0,\"checkbox_1627651560891\":[],\"time_1627651562839\":null,\"date_1627651564093\":null,\"select_1627651565724\":{\"value\":\"3562d6fa-a73f-4f81-a011-09b91fa88fbd\",\"label\":\"三个一级\"},\"imgUpload_1627651574113\":null,\"query_1627651577323\":null,\"version\":\"b92e1c11-7d8a-4dcf-8124-26296e544922\"}",
"assetDataJson": "{\"input_1627651550100\":\"\",\"textarea_1627651551520\":\"\",\"number_1627651554928\":0,\"checkbox_1627651560891\":[],\"time_1627651562839\":null,\"date_1627651564093\":null,\"select_1627651565724\":{\"value\":\"3562d6fa-a73f-4f81-a011-09b91fa88fbd\",\"label\":\"三个一级\"},\"imgUpload_1627651574113\":null,\"query_1627651577323\":null,\"version\":\"b92e1c11-7d8a-4dcf-8124-26296e544922\"}",
}
],
"meta": {}
}| 参数 | 说明 |
|---|---|
| offset | 当前结果对于首条结果的偏移量,指定分页查询时不为0 |
| total | 所有符合查询条件的查询结果数量,指定需要结果记录数量时不为0 |
| results | 符合查询条件的资产实物信息变更单详情集合 |
| meta | 其他信息 |
2. 新增资产实物信息变更单
请求地址
text
PUT /Issue/Asset/OtherChange
POST /Issue/Asset/OtherChange/put对于不支持PUT请求的网络环境,请尝试使用备份的POST请求地址
请求示例
json
{
"UseYear":"60",
"UseDate":"1600790400",
"AssetName":"测试",
"DistrictCode":"01",
"UseCompanyCode":"112233",
"AssetUser":"爱死才啊",
"Comment":"资产备注",
"MeasureUnit":"单位",
"AssetSpecsId":"",
"OwnerCompanyCode":"01",
"UseDepartmentCode":"2312213",
"Address":"仓库",
"BuyDate":"1600185600",
"Specs":"型号",
"SupervisorUserName":"shangde@123.com",
"AssetBarcodes":
[
"100201002"
],
"Operator":"尚德",
"UserEmployeeNo":"12312312",
"SNNo":"36666",
"thumbnailMediaResourceNo":"MR202009230002",
"AssetTypeCode":"02",
"pictureMediaResourceNo":"MR202009230003",
"Source":"1",
"SourceName":"购入"
}参数说明
| 参数 | 是否必须 | 说明 |
|---|---|---|
| UseYear | 否 | 使用期限 |
| UseDate | 否 | 变更日期(时间戳格式) |
| AssetName | 否 | 资产名称 |
| DistrictCode | 否 | 区域编码 |
| UseCompanyCode | 否 | 使用公司编码 |
| AssetUser | 否 | 资产使用人 |
| Comment | 否 | 备注 |
| MeasureUnit | 否 | 计量单位 |
| AssetSpecsId | 否 | 标准资产型号 |
| OwnerCompanyCode | 是 | 业务所属公司编码 |
| UseDepartmentCode | 否 | 使用部门编码 |
| Address | 否 | 存放地址 |
| BuyDate | 否 | 购入时间(时间戳格式) |
| Specs | 否 | 规格型号 |
| SupervisorUserName | 否 | 管理员账号 |
| Operator | 否 | 处理人 |
| UserEmployeeNo | 否 | 员工编号 |
| SNNo | 否 | sn号 |
| thumbnailMediaResourceNo | 否 | 资产缩略图地址 |
| AssetTypeCode | 否 | 资产分类编码 |
| pictureMediaResourceNo | 否 | 资产图片地址 |
| Source | 否 | 来源id |
| SourceName | 否 | 来源 |
| AssetBarcodes | 是 | 新增实物信息变更单的资产编码集合 |
返回结果
json
{
"serialNo": "AOC202009240001",
"signatureId": 0
}结果说明
| 属性名称 | 说明 |
|---|---|
| serialNo | 单据号 |
| signatureId | 签字id |
3.修改资产实物信息变更单
请求地址
text
PUT /Issue/Asset/OtherChange
POST /Issue/Asset/OtherChange/put对于不支持PUT请求的网络环境,请尝试使用备份的POST请求地址
请求示例
json
{
"SerialNo":"AOC202009240001",
"UseYear":"60",
"UseDate":"1600790400",
"AssetName":"测试",
"DistrictCode":"01",
"UseCompanyCode":"112233",
"AssetUser":"爱死才啊",
"Comment":"资产备注",
"MeasureUnit":"单位",
"AssetSpecsId":"",
"OwnerCompanyCode":"01",
"UseDepartmentCode":"2312213",
"Address":"仓库",
"BuyDate":"1600185600",
"Specs":"型号",
"SupervisorUserName":"shangde@123.com",
"AssetBarcodes":
[
"100201002"
],
"Operator":"尚德",
"UserEmployeeNo":"12312312",
"SNNo":"36666",
"thumbnailMediaResourceNo":"MR202009230002",
"AssetTypeCode":"02",
"pictureMediaResourceNo":"MR202009230003",
"Source":"1",
"SourceName":"购入"
}参数说明
| 参数 | 是否必须 | 说明 |
|---|---|---|
| SerialNo | 是 | 单据号 |
| UseYear | 否 | 使用期限 |
| UseDate | 否 | 变更日期(时间戳格式) |
| AssetName | 否 | 资产名称 |
| DistrictCode | 否 | 区域编码 |
| UseCompanyCode | 否 | 使用公司编码 |
| AssetUser | 否 | 资产使用人 |
| Comment | 否 | 备注 |
| MeasureUnit | 否 | 计量单位 |
| AssetSpecsId | 否 | 标准资产型号 |
| OwnerCompanyCode | 是 | 业务所属公司编码 |
| UseDepartmentCode | 否 | 使用部门编码 |
| Address | 否 | 存放地址 |
| BuyDate | 否 | 购入时间(时间戳格式) |
| Specs | 否 | 规格型号 |
| SupervisorUserName | 否 | 管理员账号 |
| Operator | 否 | 处理人 |
| UserEmployeeNo | 否 | 员工编号 |
| SNNo | 否 | sn号 |
| thumbnailMediaResourceNo | 否 | 资产缩略图地址 |
| AssetTypeCode | 否 | 资产分类编码 |
| pictureMediaResourceNo | 否 | 资产图片地址 |
| Source | 否 | 来源id |
| SourceName | 否 | 来源 |
| AssetBarcodes | 是 | 新增实物信息变更单的资产编码集合 |
返回结果
json
{
"serialNo": "AOC202009240001",
"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. 资产实物信息变更单数据对象格式
| 属性名称 | 说明 |
|---|---|
| assetTypeCode | 资产分类编码 |
| assetTypeName | 资产分类名称 |
| useCompanyName | 使用公司名称 |
| useCompanyCode | 使用公司编码 |
| ownerCompanyName | 业务所属公司名称 |
| ownerCompanyCode | 业务所属公司编码 |
| useDepartmentName | 使用部门名称 |
| useDepartmentCode | 使用部门编码 |
| district | 区域 |
| districtCode | 区域编码 |
| useEmployeeName | 使用人 |
| useEmployeeNo | 使用人编号 |
| sourceName | 来源 |
| supervisor | 管理员 |
| supervisorUserName | 管理员账号 |
| id | 单据id |
| serialNo | 单据号 |
| useDate | 操作日期(时间戳格式) |
| assetTypeId | 资产分类id |
| assetName | 资产名称 |
| specs | 规格型号 |
| snNo | sn号 |
| measureUnit | 计量单位 |
| provider | 供应商 |
| comment | 备注 |
| picPath | 资产图片路径 |
| thumbPath | 资产缩略图片路径 |
| operator | 单据处理人 |
| changeDate | 变更日期(时间戳格式) |
| useCompanyId | 使用公司id |
| useDepartmentId | 使用部门id |
| assetUser | 资产使用人 |
| districtId | 区域id |
| address | 存放地点 |
| useYear | 使用期限 |
| source | 来源 |
| userEmployeeId | 使用人id |
| supervisorId | 管理员id |
| assetSpecsId | 标准资产型号 |
| signatureStatus | 办理状态(0:待签字、1:已签字、2:已驳回、4:审批中、5:已审批、6:已驳回、10:已审批待签字、11:已审批已签字、12:已审批已驳回、3:空状态) |
| signaturePicPath | 签字图片 |
| purchaseDate | 购入日期(时间戳格式) |
| dataJson | 单据自定义字段字符串合集 |
| assetDataJson | 单据包含的资产自定义字段字符串合集 |
| extensionFields | 实物信息变更单包含的扩展属性详情集合 |
| assets | 实物信息变更单包含的资产详情集合 |
实物信息变更单包含的扩展属性详情
| 属性名称 | 说明 |
|---|---|
| id | 扩展属性id |
| name | 扩展属性名称 |
| value | 扩展属性值 |
| fieldAreaType | 扩展属性类型(1:全局属性、2:分类属性、3:私有属性) |
| required | 是否必填 |
| extensionFieldId | 扩展属性id |
| fieldType | 扩展属性字段类型(0:普通文本、1:长文本) |
| applyToAssetTypeId | 分类属性下关联的资产分类id |
| applyToAssetId | 私有属性下关联的资产id |
实物信息变更单包含的资产详情
| 属性名称 | 说明 |
|---|---|
| id | 单据中的资产id |
| assetOtherChangeId | 资产所属变更单id |
| assetId | 资产id |
| barcode | 资产编码 |
| picturePath | 资产图片路径 |
| thumbnailPath | 资产图片的缩略图路径 |
| name | 资产名称 |
| sn | sn号 |
| specs | 规格型号 |
| specsId | 标准型号id |
| ownCompanyName | 所属公司名称 |
| ownCompanyCode | 所属公司编码 |
| useCompanyId | 使用公司id |
| useCompanyName | 使用公司名称 |
| useCompanyCode | 使用公司编码 |
| address | 存放地点 |
| measureUnit | 计量单位 |
| assetTypeId | 资产分类id |
| assetTypeCode | 资产分类编码 |
| assetType | 资产分类名称 |
| amount | 金额 |
| useDepartmentId | 使用部门id |
| useDepartmentCode | 使用部门编码 |
| useDepartmentName | 使用部门名称 |
| supervisorId | 管理员id |
| supervisor | 管理员 |
| supervisorUserName | 管理员账号 |
| district | 区域名称 |
| districtCode | 区域编码 |
| purchasedDate | 购入日期(时间戳格式) |
| source | 来源 |
| sourceName | 来源名称 |
| userEmployeeId | 使用人id |
| userEmployeeNo | 使用人编码 |
| dataJson | 资产自定义字段字符串合集 |
| extensionFields | 扩展属性详情集合 |
扩展属性详情
| 属性名称 | 说明 |
|---|---|
| id | 扩展属性id |
| assetId | 所属资产的id |
| name | 扩展属性名称 |
| value | 扩展属性值 |
| fieldAreaType | 扩展属性类型(1:全局属性、2:分类属性、3:私有属性) |
| required | 是否必填 |
| extensionFieldId | 扩展属性id |
| fieldType | 扩展属性字段类型(0:普通文本、1:长文本) |
| applyToAssetTypeId | 分类属性下关联的资产分类id |
| applyToAssetId | 私有属性下关联的资产id |