资产调拨接口
1. 获取资产调拨单列表
请求地址
text
GET /receipt/transfer参数说明
资产调拨单查询接口支持丰富的条件过滤参数，请参见支持的查询参数附录
返回结果
json
{
"offset": 0,
"total": 13,
"results": [
{
"outUseCompanyCode": "01",
"outUseCompanyName": "测试",
"outHandleUserName": "尚德",
"outDistrictCode": "01",
"outDistrict": "本地",
"inSupervisor": "尚德",
"inHandleUserName": "尚德",
"assets": [
{
"id": 6133,
"assetTransferId": 2053,
"barcode": "02010001",
"picturePath": "/UploadImage/fbbe0307-2102-4054-9802-3c5a3ded9a82.jpg",
"thumbnailPath": "/UploadImage/12be1f2b-a8b2-47c9-a9b2-d6ef6c8529c1.jpg",
"name": "测试",
"sn": "",
"specs": "",
"address": "1102",
"measureUnit": "",
"assetType": "专用设备",
"amount": 666.00,
"useCompanyId": 7024,
"useCompanyCode": "3725581",
"useCompanyName": "恶魔",
"ownCompanyId": 7023,
"ownCompanyCode": "01",
"ownCompanyName": "测试",
"assetTypeId": 57412,
"assetTypeCode": "03",
"districtId": 9723,
"district": "石家庄",
"districtCode": "27594",
"supervisorId": 6261,
"supervisor": "尚德",
"vendor": "",
"comment": "",
"serviceLife": "60",
"tranStatus": 2
}
],
"id": 2053,
"serialNo": "DB201701052053",
"outDate": "1483545600",
"outUseCompanyId": 7023,
"outDistrictId": 9722,
"outAddress": "11把",
"outComment": "",
"outHandleUserId": 6261,
"outHandleDate": "1483545600",
"inSupervisorId": 6261,
"inHandleUserId": 6261,
"inHandleDate": "1483611020",
"transferStatus": 2,
"assetId": 278059
}
],
"meta": {}
}| 参数 | 说明 |
|---|---|
| offset | 当前结果对于首条结果的偏移量，指定分页查询时不为0 |
| total | 所有符合查询条件的查询结果数量，指定需要结果记录数量时不为0 |
| results | 符合查询条件的资产调拨单详情集合 |
| meta | 其他信息 |
2. 新增资产调拨单
请求地址
text
PUT /Asset/Transfer
POST /Asset/Transfer/put对于不支持PUT请求的网络环境，请尝试使用备份的POST请求地址
请求示例
json
{
"OutCompanyCode":"01",
"OutComment":"调拨",
"InSupervisorUserName":"test@123.com",
"InUseCompanyCode":"112233",
"assets":
[
{
"barcode":"1001010001"
}
]
}参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| OutCompanyCode | String | 是 | 调出公司编码 |
| OutComment | String | 否 | 调出备注 |
| InSupervisorUserName | String | 是 | 调入管理员 |
| InUseCompanyCode | String | 是 | 调入使用公司编码 |
| assets | Array | 是 | 新增调拨单的资产详情集合 |
新增调拨单的资产详情
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| barcode | String | 是 | 资产编码 |
返回结果
json
{
"serialNos": [
"ATR202009230001"
]
}结果说明
| 属性名称 | 类型 | 说明 |
|---|---|---|
| serialNos | Array | 单据号 |
3. 确认调拨中资产
请求地址
text
PUT /Asset/ConfirmTransfer
POST /Asset/ConfirmTransfer/put对于不支持PUT请求的网络环境，请尝试使用备份的POST请求地址
请求示例
json
{
"InAddress":"仓库",
"InUseCompanyCode":"112233",
"InUseDepartmentCode":"2312213",
"InDistrictCode":"01",
"InComment":"",
"SerialNos":[
"ATR202009230001"
],
"assets"[
{
"inDistrictCode":"01",
"InUseCompanyCode":"112233",
"barcode":"100201002",
"InUseDepartmentCode":"2312213",
"inUserEmployeeNo":"12312312",
"InAddress":"仓库",
"inUserEmployeeName":"张三",
"InDate":"1600790400"
}
]
}参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| SerialNos | Array | 是 | 单据号 |
| InUseCompanyCode | String | 是 | 调入后使用公司编码 |
| InUseDepartmentCode | String | 否 | 调入后使用部门编码 |
| InDistrictCode | String | 否 | 调入后区域编码 |
| InAddress | String | 否 | 调入后存放地点 |
| InComment | String | 否 | 调入备注 |
| assets | Array | 是 | 确认调拨单的资产详情集合 |
确认调拨单的资产详情
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| barcode | String | 是 | 资产编码 |
| InUseCompanyCode | String | 是 | 调入后使用公司编码 |
| InUseDepartmentCode | String | 否 | 调入后使用部门编码 |
| inUserEmployeeNo | String | 否 | 调入后使用人编码 |
| inDistrictCode | String | 否 | 调入后区域编码 |
| InAddress | String | 否 | 调入后存放地点 |
| inUserEmployeeName | String | 否 | 调入后使用人名称 |
| InDate | String | 否 | 调入日期（时间戳格式） |
返回结果
json
{
"serialNos": [
"ATR202009230001"
]
}结果说明
| 属性名称 | 参数 | 说明 |
|---|---|---|
| serialNos | Array | 单据号 |
4. 取消调拨单
请求地址
text
PUT /Asset/CancelTransfer
POST /Asset/CancelTransfer/put对于不支持PUT请求的网络环境，请尝试使用备份的POST请求地址
请求示例
json
{
"fromDetails":true,
"SerialNos":[
"ATR202009230001"
],
"assets"[
{
"barcode":"100201002"
}
]
}参数说明
| 参数 | 是否必须 | 说明 |
|---|---|---|
| SerialNos | 是 | 单据号 |
| fromDetails | 否 | 是否单个取消资产（如果为false是取消整个调拨单，不用填写assets参数；如果为true是可以单个打回某个资产，需要填写assets参数） |
| assets | 否 | 取消调拨单的资产详情集合（内容为要打回的资产，不需要打回的资产不要填写） |
取消调拨单的资产详情
| 参数 | 是否必须 | 说明 |
|---|---|---|
| barcode | 是 | 资产编码 |
返回结果
json
{
"serialNos": [
"ATR202009230001"
]
}结果说明
| 属性名称 | 说明 |
|---|---|
| serialNos | 单据号 |
附录
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. 资产调拨单数据对象格式
| 属性名称 | 类型 | 说明 |
|---|---|---|
| outUseCompanyCode | String | 调出使用公司编码 |
| outUseCompanyName | String | 调出使用公司名称 |
| outHandleUserName | String | 调出单据处理人名称 |
| outDistrictCode | String | 调出区域编码 |
| outDistrict | String | 调出区域名称 |
| inSupervisor | String | 调入管理员 |
| inUseCompanyCode | String | 调入使用公司编码 |
| inUseCompanyName | String | 调入使用公司名称 |
| inHandleUserName | String | 调入管理员 |
| id | Long | 调拨单id |
| serialNo | String | 调拨单号 |
| outDate | String | 调出日期（时间戳格式） |
| outUseCompanyId | Long | 调出使用公司id |
| outSupervisorId | Long | 调出管理员id |
| outDistrictId | Long | 调出区域id |
| outAddress | String | 调出存放地址 |
| outComment | String | 调出备注 |
| outHandleUserId | Long | 调出单据处理人id |
| outHandleDate | String | 调出处理日期（时间戳格式） |
| inSupervisorId | Long | 调入管理员id |
| inUseCompanyId | Long | 调入使用公司id |
| inDistrictId | Long | 调入区域id |
| inAddress | String | 调入存放地址 |
| inComment | String | 调入备注 |
| inHandleUserId | Long | 调入处理人id |
| inHandleDate | String | 调入处理日期（时间戳格式） |
| transferStatus | Int | 调拨单状态（0:已完成、1:已调出、2:已取消、3:已调出待审批、4:已调出审批通过、5:已调出审批驳回） |
| assetId | Long | 资产Id |
| dataJson | String | 单据扩展字段字符串合集 |
| assets | Array | 调拨单包含的资产详情集合 |
调拨单包含的资产详情
| 属性名称 | 类型 | 说明 |
|---|---|---|
| id | Long | 资产编id |
| assetTransferId | Long | 资产所属调拨单id |
| barcode | String | 资产编码 |
| picturePath | String | 资产图片路径 |
| thumbnailPath | String | 资产图片的缩略图路径 |
| name | String | 资产名称 |
| sn | String | SN号 |
| specs | String | 规格型号 |
| address | String | 存放地点 |
| measureUnit | String | 计量单位 |
| assetType | String | 资产分类名称 |
| amount | Float | 金额 |
| useCompanyId | Long | 使用公司id |
| useCompanyCode | String | 使用公司编码 |
| useCompanyName | String | 使用公司名称 |
| ownCompanyId | Long | 所属公司id |
| ownCompanyCode | String | 所属公司编码 |
| ownCompanyName | String | 所属公司名称 |
| assetTypeId | Long | 资产分类id |
| assetTypeCode | String | 资产分类编码 |
| useDepartmentId | Long | 使用部门id |
| useDepartmentCode | String | 使用部门编号 |
| useDepartmentName | String | 使用部门名称 |
| districtId | Long | 区域id |
| district | String | 区域名称 |
| districtCode | String | 区域编号 |
| supervisorId | Long | 管理员id |
| supervisor | String | 管理员 |
| userEmployeeId | String | 使用人id |
| userEmployeeNo | String | 使用人编号 |
| userEmployeeName | String | 使用人名称 |
| inUseDepartmentCode | String | 调入使用部门编码 |
| inUseDepartmentName | String | 调入使用部门名称 |
| inUserEmployeeNo | String | 调入使用人编码 |
| vendor | String | 供应商 |
| comment | String | 备注 |
| serviceLife | String | 使用期限 |
| user | String | 使用人 |
| inUserEmployeeId | String | 调入使用人id |
| inUserEmployeeName | String | 调入使用人名称 |
| tranStatus | Int | 资产的调拨状态（0:未确认、1:已确认、2:已打回） |
| inDistrictId | Long | 调入区域id |
| inDistrictCode | String | 调入区域编码 |
| inDistrict | String | 调入区域 |
| inAddress | String | 调入存放地点 |
| inDate | String | 调入日期（时间戳格式） |