资产盘点单接口 ​

1. 获取资产盘点单列表 ​

请求地址 ​

text
GET /Asset/Inventory?requireInventoryAudit=1&isCompleted=0

参数说明 ​

参数是否必须类型说明
requireInventoryAudit否Bool是否返回盘点单内的资产总个数和各个盘点状态（如：未盘点、盘点、盘盈、盘亏）下的资产个数
isCompleted否Bool要返回哪种状态的盘点单（0:未完成状态、1：已完成状态、不写该参数则两种状态的盘点单都返回）
stateIn否String状态（0:未完成，1,4:已完成，2:审批中，3:已驳回）
name否String盘点单号
createdByName否String创建人
supportManualInventory否String管理员盘点方式：选择，示例：1
supportAdminScanCheck否String管理员盘点方式：扫码，示例：1
supportAdminRFIDCheck否String管理员盘点方式：RFID，示例：1
supportAdminRFIDCheck否String成员盘点方式：选择，示例：1
supportEmployeeScanCheck否String成员盘点方式：扫码，示例：1

资产盘点单列表查询接口支持丰富的条件过滤参数，请参见支持的查询参数附录 ​

返回结果 ​

json
{
    "offset": 0,
    "total": 13,
    "results": [
        {
            "assignees": [
                "尚德"
            ],
            "createdByName": "尚德",
            "itemTotal": 30,
            "itemChecked": 2,
            "itemUnchecked": 28,
            "itemLoss": 0,
            "itemProfit": 0,
            "itemMarked": 0,
            "itemTagged": 0,
            "id": 32280,
            "serialNo": "PD202005260001",
            "name": "年终盘点",
            "year": 2020,
            "createdBy": 6261,
            "createdTime": "1590461907",
            "isCompleted": false,
            "comment": "",
            "forAllPersonnel": true,
            "supportManualInventory": true,
            "purchasedDateRange": "",
            "useCompanyRange": "",
            "useDepartRange": "",
            "ownCompanyRange": "",
            "assetTypeRange": "专用设备,分类二",
            "districtRange": "",
            "supervisorRange": "",
            "includeSubsidiary": false,
            "needPhotograph": false,
            "photoFromCameraOnly": false,
            "supportAdminCheck": true,
            "supportEmployeeScanCheck": true,
            "supportAdminScanCheck": true,
            "supportAdminRFIDCheck": true
        }
    ],
    "meta": {}
}
参数说明
offset当前结果对于首条结果的偏移量，指定分页查询时不为0
total所有符合查询条件的查询结果数量，指定需要结果记录数量时不为0
results符合查询条件的资产盘点单集合
meta其他信息

2. 新建盘点单 ​

请求地址 ​

text
POST /Asset/Inventory
x-www-form-urlencoded

请求示例 ​

text
auditName: test
assignees: 管理员
auditComment: comment
includeTransferAssets: false
forAllPersonnel: true
supportAdminCheck: true
supportManualInventory: true
supportEmployeeScanCheck: true
supportAdminScanCheck: true
supportAdminRFIDCheck: true
supportEmployeeManualCheck: true
assetTypeCodeIn: 002
photoFromCameraOnly: true
needPhotograph: true

参数说明 ​

参数是否必须参数类型说明
auditName是String盘点单名称
auditComment否String备注
assignees是String[]盘点管理员
forAllPersonnel否Bool全员盘点(员工盘点)
supportManualInventory否Bool是否支持手动盘点（false 只能扫码）
needPhotograph否Bool盘点资产时必须拍照
photoFromCameraOnly否Bool盘点图片仅允许拍照上传
includeTransferAssets否Bool是否包括调拨资产
includeSubsidiary否Bool是否包括附属资产
previewSeed否Int是否是预览
purchasedFrom否DateTime购入日期 开始日期
purchasedTo否DateTime购入日期 结束日期
useCompanyCodeIn否String[]使用公司编码
ownCompanyCodeIn否String[]所属公司编码
useDepartmentCodeIn否String[]使用部门编码
districtCodeIn否String[]区域编码
assetTypeCodeIn否String[]资产分类编码
employeeSupervisorIn否String[]管理人
stateIn否String资产状态

返回结果 ​

json
{"id":1,"serialNo":"AIN202405010001"}

结果说明 ​

属性名称说明
id资产id
serialNo盘点单号

3. 删除盘点单 ​

请求地址 ​

text
POST /Asset/Inventory/delete
x-www-form-urlencoded

请求示例 ​

text
serialNo: AIN202406090001

参数说明 ​

参数是否必须参数类型说明
serialNo是String盘点单单据号

返回结果 ​

json
{}

4. 获取资产盘点单详情 ​

请求地址 ​

text
GET /Asset/Inventory/{serialNo}/items
{serialNo}盘点单单据号

参数说明 ​

参数是否必须类型说明
serialNo是String盘点单号

资产盘点单详情接口支持丰富的条件过滤参数，请参见支持的查询参数附录 ​

返回结果 ​

json
{
    "offset": 0,
    "total": 13,
    "results": [
        {
            "revisedDistrictCode": "A01",
            "revisedUseCompanyCode": "232",
            "revisedUseDepartmentCode": "23211",
            "revisedUserEmployeeNo": "0001",
            "tags": [
                {
                    "name": "已标记",
                    "foreColor": "#ffffff",
                    "backgroundColor": "#dba549",
                    "createTime": "1636786620"
                },
                {
                    "name": "重点资产",
                    "foreColor": "#ffffff",
                    "backgroundColor": "#4fbbe0",
                    "createTime": "1636786620"
                }
            ],
            "id": 17191022,
            "assetTypeName": "土地、房屋及构筑物",
            "barcode": "011020000001",
            "name": "好的",
            "specification": "型号的",
            "measureUnit": "台",
            "district": "石家庄长安区建设大街富邦大厦11楼1102室",
            "address": "地点在",
            "useCompanyName": "测试",
            "ownCompanyName": "测试",
            "supervisor": "尚德",
            "comment": "盘盈",
            "inventoryState": 1,
            "inventoryDate": "1636786368",
            "inventoryId": 47708,
            "assetPicturePath": "/MediaResources/4506/AssetCheck/20211113/7fece310708c4302b72d996ff458eb25.jpg",
            "assetThumbnailPath": "/MediaResources/4506/AssetCheck/20211113/65d55b59ca8b457eb1ef859a705ca391.jpg",
            "sn": "76272772",
            "updatedTime": "1636786620",
            "isMarked": false,
            "purchasedDate": "1632931200",
            "changeState": "2",
            "submittedSupervisor": "尚德",
            "revisedDistrictId": 9723,
            "revisedDistrictName": "石家庄",
            "revisedAddress": "第二仓库",
            "revisedUseCompanyId": 90378,
            "revisedUseCompanyName": "易点易动北京公司",
            "revisedUseDepartmentId": 478779,
            "revisedUseDepartmentName": "市场部",
            "revisedUserEmployeeId": "6a9bd6d3-ecd3-44ee-a566-3aae6b977a68",
            "revisedUserEmployeeName": "王艳"
        }
    ],
    "meta": {}
}
参数说明
offset当前结果对于首条结果的偏移量，指定分页查询时不为0
total所有符合查询条件的查询结果数量，指定需要结果记录数量时不为0
results符合查询条件的资产盘点单详情
meta其他信息

5. 修改盘点单中的资产 ​

请求地址 ​

text
POST /Asset/Inventory/{serialNo}/Items/put
x-www-form-urlencoded
{serialNo}盘点单单据号

请求示例 ​

json
{
    "barcodes": "01608104",
    "inventoryMethod": 1,
    "status": 1
}

参数说明 ​

参数是否必须参数类型说明
barcodes是String资产编码（英文逗号隔开）
districtCode否String修改后区域
address是String修改后存放地址
useCompanyCode否String修改后使用公司
useDepartmentCode否String修改后使用部门
userEmployeeNo否String修改后使用人
inventoryMethod否Int盘点结果

返回结果 ​

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. 资产盘点单数据对象格式 ​

属性名称属性类型说明
assigneesArray分配用户
createdByNameString盘点单创建人名称
itemTotalInt盘点单资产总数
itemCheckedInt已盘点资产个数
itemUncheckedInt未盘点资产个数
itemLossInt盘亏资产个数
itemProfitInt盘盈资产个数
itemMarkedInt已标记资产个数
itemTaggedInt有标签的资产个数
idInt盘点单id
serialNoString盘点单号
nameString盘点单名称
yearInt盘点单创建年份
createdByInt创建人id
createdTimeString创建时间（时间戳格式）
isCompletedBool盘点单是否已完成
commentString备注
forAllPersonnelBool是否全员盘点单
supportManualInventoryBool是否允许手动选择资产盘点
purchasedDateRangeString购入日期范围
useCompanyRangeString使用公司范围
useDepartRangeString使用部门范围
ownCompanyRangeString所属公司范围
assetTypeRangeString资产分类范围
districtRangeString区域范围
supervisorRangeString管理员范围
includeSubsidiaryBool是否包含附属资产
needPhotographBool盘点资产时是否必须要拍照
photoFromCameraOnlyBool盘点图片是否仅允许拍照上传
supportEmployeeScanCheckBool成员盘点方式：扫码
supportAdminScanCheckBool管理员盘点方式：扫码
supportAdminRFIDCheckBool管理员盘点方式：RFID

2. 资产盘点单详情数据对象格式 ​

属性名称属性类型说明
revisedDistrictCodeString盘点后区域编码
revisedUseCompanyCodeString盘点后使用公司编码
revisedUseDepartmentCodeString盘点后使用部门编码
revisedUserEmployeeNoString盘点后使用人工号
tagsInt资产标签集合
idInt资产id
assetTypeNameString资产分类名称
barcodeString资产编码
nameString资产名称
specificationString规格型号
measureUnitString计量单位
districtString盘点前区域
addressString盘点前存放地点
useCompanyNameString盘点前使用公司
ownCompanyNameString所属公司
supervisorString资产管理员名称
commentString盘点备注
inventoryStateInt盘点状态（0:未盘点、1:已盘点、2:盘亏、3和4都是盘盈）
inventoryDateString盘点时间（时间戳格式）
inventoryIdInt盘点单id
assetPicturePathString资产图片路径
assetThumbnailPathString资产图片的缩略图路径
snStringsn号
updatedTimeString更新时间（时间戳格式）
isMarkedBool是否被标记
purchasedDateString购入日期（时间戳格式）
changeStateInt资产状态（1＆6：在用、2：闲置、3：借用、4：报废、5：调拨中、7：维修中）
submittedSupervisorString盘点人名称
revisedDistrictIdString盘点后区域id
revisedDistrictNameString盘点后区域名称
revisedAddressString盘点后存放地点
revisedUseCompanyIdString盘点后使用公司id
revisedUseCompanyNameString盘点后使用公司名称
revisedUseDepartmentIdString盘点后使用部门id
revisedUseDepartmentNameString盘点后使用部门名称
revisedUserEmployeeIdString盘点后使用人id
revisedUserEmployeeNameString盘点后使用人名称

资产标签详情 ​

属性名称属性类型说明
nameString标签名称
foreColorString标签文字颜色
backgroundColorString标签背景颜色
createTimeString创建时间（时间戳格式）