首页仪表盘接口 ​

1. 获取首页头部数据 ​

请求地址 ​

text
GET /Dashboard/Header

参数说明 ​

参数是否必须参数类型说明
AssetTotal否bool是否需要资产总量
PendingSignCount否bool是否需要待签字数量
ExpiredAssetCount否bool是否需要当月到期资产数量
MaintenanceExpiredCount否bool是否需要维保到期资产数量
ReportRepairCount否bool是否需要报修资产数量
PendingTransferCount否bool是否需要待确认调拨单数量
SafeAlertCount否bool是否需要安全库存报警数量
PendingApproveCount否bool是否需要待审批任务数量
PendingCheckCount否bool是否需要待盘点任务数量
ConsumablesTotalCount否bool是否需要耗材总量
AssetInCount否bool是否需要资产总数
AssetInSumAmount否bool是否需要资产总金额
AssetUnderMaintenanceCount否bool是否需要维修中资产数
ConsumableStockMoneyCount否bool是否需要库存耗材总金额
EmployeeTurnoverAssetCount否bool是否需要离职员工名下资产

返回结果 ​

json
{
    "assetTotal": 29,
    "pendingSignCount": 1,
    "pendingSignCountCurrent": 0,
    "pendingSignCountOld": 1,
    "pendingSignArrow": 2,
    "expiredAssetCount": 0,
    "expiredAssetCountCurrent": 0,
    "expiredAssetCountOld": 5,
    "expiredAssetArrow": 2,
    "expiredAssetPercent": 0,
    "maintenanceExpiredCount": 0,
    "maintenanceExpiredCountCurrent": 0,
    "maintenanceExpiredCountOld": 0,
    "maintenanceExpiredArrow": 0,
    "maintenanceExpiredPercent": 0,
    "reportRepairCount": 1,
    "reportRepairCountCurrent": 0,
    "reportRepairCountOld": 1,
    "reportRepairArrow": 2,
    "pendingTransferCount": 1,
    "pendingTransferCurrent": 0,
    "pendingTransferOld": 1,
    "pendingTransferArrow": 2,
    "safeAlertCount": 0,
    "pendingApproveCount": 3,
    "pendingCheckCount": 2,
    "consumablesTotalCount": 8,
    "assetInCount": 0,
    "assetInSumAmount": 0,
    "assetUnderMaintenanceCount": 0,
    "consumablesStockAmountCount": 0,
    "employeeTurnoverAssetCount": 0
}

2. 获取资产状态占比 ​

请求地址 ​

text
GET /Dashboard/AssetStatPercent

参数说明 ​

参数是否必须参数类型说明
CompanyCodes否String公司编码
DepartmentCodes否String部门编码

返回结果 ​

json
{
    "freeCount": 17,
    "useCount": 10,
    "borrowCount": 1,
    "repairCount": 0,
    "transferCount": 1,
    "clearCount": 0,
    "freeAmount": 1112.00,
    "useAmount": 575.00,
    "borrowAmount": 100.00,
    "repairAmount": 0,
    "transferAmount": 0.00,
    "clearAmount": 0
}
属性名称说明
freeCount闲置资产数量
useCount在用资产数量
borrowCount借用资产数量
repairCount维修中资产数量
transferCount调拨中资产数量
clearCount报废资产数量
freeAmount闲置资产金额
useAmount在用资产金额
borrowAmount借用资产金额
repairAmount维修中资产金额
transferAmount调拨中资产金额
clearAmount报废资产金额

3. 获取公司使用情况、公司占比 ​

请求地址 ​

text
GET /Dashboard/CompanyPercent

参数说明 ​

参数是否必须参数类型说明
CompanyCodes否String公司编码
ContainsDeleted否bool是否包含已报废的
MaxCount否int图表最大显示多少项
IsAmount否bool是否显示金额，否的话显示数量

返回结果 ​

json
[
    {
        "id": 0,
        "code": "1",
        "name": "1",
        "hasChildren": false,
        "doubleValue": 0,
        "doubleValue1": 0,
        "decimalValue": 0.00,
        "decimalValue1": 0,
        "intValue": 3,
        "intValue1": 0
    },
    {
        "id": 0,
        "code": "5",
        "name": "5",
        "hasChildren": false,
        "doubleValue": 0,
        "doubleValue1": 0,
        "decimalValue": 0.00,
        "decimalValue1": 0,
        "intValue": 1,
        "intValue1": 0
    }
]
属性名称说明
id未用
code公司编码
name公司名称
hasChildren是否包含子公司
doubleValue未用
doubleValue1未用
decimalValue金额
decimalValue1未用
intValue数量
intValue1未用

4. 获取部门使用情况、部门占比 ​

请求地址 ​

text
GET /Dashboard/DepartmentPercent

参数说明 ​

参数是否必须参数类型说明
CompanyCode否String公司编码
ContainsDeleted否bool是否包含已报废的
MaxCount否int图表最大显示多少项
IsAmount否bool是否显示金额，否的话显示数量

返回结果 ​

json
[
    {
        "id": 0,
        "code": "1",
        "name": "1",
        "hasChildren": false,
        "doubleValue": 0,
        "doubleValue1": 0,
        "decimalValue": 0.00,
        "decimalValue1": 0,
        "intValue": 3,
        "intValue1": 0
    },
    {
        "id": 0,
        "code": "5",
        "name": "5",
        "hasChildren": false,
        "doubleValue": 0,
        "doubleValue1": 0,
        "decimalValue": 0.00,
        "decimalValue1": 0,
        "intValue": 1,
        "intValue1": 0
    }
]
属性名称说明
id未用
code部门编码
name部门名称
hasChildren是否包含子部门
doubleValue未用
doubleValue1未用
decimalValue金额
decimalValue1未用
intValue数量
intValue1未用

5. 获取资产分类统计 ​

请求地址 ​

text
GET /Dashboard/AssetTypeSum

参数说明 ​

参数是否必须参数类型说明
CompanyCodes否String公司编码
TypeCode否String资产分类编码

返回结果 ​

json
{
    "xAxis": [
        "土地、房屋及构筑物",
        "图书文物及陈列品",
        "家具用具及其他类"
    ],
    "yAxis": [],
    "series": [
        23,
        5,
        1
    ],
    "series1": [
        412.00,
        1375.00,
        0.00
    ],
    "seriesList": [],
    "seriesList1": [],
    "idList": [
        428446,
        428454,
        428455
    ],
    "codeList": [
        "01",
        "09",
        "010"
    ],
    "hasChildrenList": [
        false,
        false,
        true
    ]
}
属性名称说明
xAxis显示的分类项
yAxis未用
series数量
series1金额
idList分类id
codeList分类编码
hasChildrenList分类是否拥有子分类
seriesList未用
seriesList1未用

6. 获取资产使用情况（统计累积量） ​

请求地址 ​

text
GET /Dashboard/AssetUseStatus

参数说明 ​

参数是否必须参数类型说明
CompanyCode否String公司编码
Month否int以多少个月为一周期进行查询

返回结果 ​

json
{
    "xAxis": [
        "2020-07",
        "2020-08",
        "2020-09"
    ],
    "yAxis": [],
    "series": [
        21628,
        21642,
        21647
    ],
    "series1": [
        46579511.21,
        46579511.21,
        46579910.21
    ],
    "seriesList": [],
    "seriesList1": [],
    "idList": [],
    "codeList": [],
    "hasChildrenList": []
}
属性名称说明
xAxis显示的月份周期
yAxis未用
series数量
series1金额
idList未用
codeList未用
hasChildrenList未用
seriesList未用
seriesList1未用

7. 获取耗材领用情况 ​

请求地址 ​

text
GET /Dashboard/HcUseStatus

参数说明 ​

参数是否必须参数类型说明
CompanyCode否String公司编码
DepartmentCode否String部门编码
CategoryCode否String耗材分类编码
Month否int以多少个月为一周期进行查询

返回结果 ​

json
{
    "xAxis": [],
    "yAxis": [
        "卡卷类",
        "礼品类",
        "纸",
    ],
    "series": [],
    "series1": [],
    "seriesList": [
        {
            "name": "卡卷类",
            "type": "line",
            "stack": "数量",
            "color": "#4489FE",
            "data": []
        },
        {
            "name": "礼品类",
            "type": "line",
            "stack": "数量",
            "color": "#FFCC33",
            "data": []
        },
        {
            "name": "纸",
            "type": "line",
            "stack": "数量",
            "color": "#54da93",
            "data": []
        }
    ],
    "seriesList1": [
        {
            "name": "卡卷类",
            "type": "line",
            "stack": "金额",
            "color": "#4489FE",
            "data": []
        },
        {
            "name": "礼品类",
            "type": "line",
            "stack": "金额",
            "color": "#FFCC33",
            "data": []
        },
        {
            "name": "纸",
            "type": "line",
            "stack": "金额",
            "color": "#54da93",
            "data": []
        }
    ],
    "idList": [
        7131,
        11169,
        23561
    ],
    "codeList": [
        "01",
        "1",
        "001000"
    ],
    "hasChildrenList": [
        false,
        false,
        false
    ],
    "pId": 0
}
属性名称说明
xAxis未用
yAxis耗材分类合集
series未用
series1未用
idList耗材分类id
codeList耗材分类编码
hasChildrenList是否拥有子类
seriesList数量和相关显示信息
seriesList1金额和相关显示信息
pId父类id

8. 获取安全库存报警列表 ​

请求地址 ​

text
GET /Dashboard/HcSafeAlertList

返回结果 ​

json
{
    "offset": 0,
    "total": 1,
    "results": [
        {
            "id": "47623",
            "code": "000001",
            "name": "测试打印纸",
            "picturePath": "/UploadImage/a7f56ada-018e-4613-b520-323c252e5a25.jpg",
            "thumbnailPath": "/UploadImage/3da16c87-445c-415b-b4b0-3cc723bdd308.jpg",
            "measureUnit": "袋",
            "stockQuantity": 262.00,
            "stockPrice": 8.5500000000000000000,
            "stockAmount": 2239.0000,
            "warehouseName": ",,,,",
            "barcode": "6921319110263",
            "safeStockUpperLimit": 50,
            "safeStockLowerLimit": 10,
            "categoryCode": "12345",
            "categoryName": "分类"
        }
    ]
}
属性名称说明
id物品id
code物品编码
name物品名称
picturePath物品图片地址
thumbnailPath物品图片缩略图地址
measureUnit计量单位
stockQuantity数量
stockPrice单价
stockAmount金额
warehouseName仓库名称
barcode商品码
safeStockUpperLimit安全库存上限
safeStockLowerLimit安全库存下限
categoryCode耗材分类编码
categoryName耗材分类名称

9. 获取待签字列表 ​

请求地址 ​

text
GET /Dashboard/PendingSignature

返回结果 ​

json
{
    "offset": 0,
    "total": 0,
    "results": [
        {
            "operatorName": "XGY",
            "id": 79346,
            "serialNo": "PY20181031001",
            "billType": 9,
            "operator": 1941,
            "createdTime": "1540968450",
            "enterpriseId": 1469
        }
    ]
}
参数说明
offset当前结果对于首条结果的偏移量，指定分页查询时不为0
total所有符合查询条件的查询结果数量，指定需要结果记录数量时不为0
results符合查询条件的待签字单据集合

10. 获取呆滞资产清单 ​

请求地址 ​

text
GET /asset/report/assetofstagnant

参数说明 ​

参数是否必须参数类型说明
CompanyCode否String公司编码
DullPeriod否int呆滞天数

返回结果 ​

json
{
    "data": [
        {
            "companyName": "1",
            "quantity": 1,
            "amount": 0.00
        }
    ],
    "amount": 19888590.08
}
参数说明
data呆滞资产详情合集
amount呆滞资产总金额

11. 获取年度部门耗材成本占比 ​

请求地址 ​

text
GET /Consumable/Report/ConsumablesDepartmentCostOf

参数说明 ​

参数是否必须参数类型说明
CompanyCode是String公司编码
Year是int年份

返回结果 ​

json
{
    "data": [
        {
            "departmentId": 0,
            "code": "64672",
            "name": "测试啊",
            "companyId": 0,
            "amount": 50.0000,
            "month": 0
        }
    ],
    "totalAmount": 50.0000
}
参数说明
data查询到的耗材物品详情合集
totalAmount查询到的公司耗材总金额

12. 获取公司、部门耗材使用成本对比 ​

请求地址 ​

text
GET /Consumable/Report/ConsumablesCostComparison

参数说明 ​

参数是否必须参数类型说明
CompanyCode否String公司编码
Year是int年份

返回结果 ​

json
[
    {
        "code": "3725581",
        "name": "测试",
        "months": [
            {
                "consumableId": 0,
                "businessMonth": 1,
                "quantity": 0,
                "amount": 0
            },
            {
                "consumableId": 0,
                "businessMonth": 2,
                "quantity": 0,
                "amount": 0
            },
            {
                "consumableId": 0,
                "businessMonth": 3,
                "quantity": 0,
                "amount": 2.0000
            },
            {
                "consumableId": 0,
                "businessMonth": 4,
                "quantity": 0,
                "amount": 0
            },
            {
                "consumableId": 0,
                "businessMonth": 5,
                "quantity": 0,
                "amount": 10.0000
            },
            {
                "consumableId": 0,
                "businessMonth": 6,
                "quantity": 0,
                "amount": 4.0000
            },
            {
                "consumableId": 0,
                "businessMonth": 7,
                "quantity": 0,
                "amount": 0
            },
            {
                "consumableId": 0,
                "businessMonth": 8,
                "quantity": 0,
                "amount": 29.0000
            },
            {
                "consumableId": 0,
                "businessMonth": 9,
                "quantity": 0,
                "amount": 0
            },
            {
                "consumableId": 0,
                "businessMonth": 10,
                "quantity": 0,
                "amount": 0
            },
            {
                "consumableId": 0,
                "businessMonth": 11,
                "quantity": 0,
                "amount": 0
            },
            {
                "consumableId": 0,
                "businessMonth": 12,
                "quantity": 0,
                "amount": 0
            }
        ],
        "hasChildren": true
    }
]
参数说明
months每月耗材使用情况详情合集
code公司、部门编码
name公司、部门名称
hasChildren是否有子集

附录 ​

1. 数据实体格式 ​

1. 待签字单据数据对象格式 ​

属性名称说明
operatorName处理人名称
id单据id
serialNo单据号
billType单据类型（1:资产入库、2:领用单、3:借用归还单、4:实物信息变更单、5:财务信息变更单、6:维修信息变更单、7:清理报废单、8:耗材入库单、9:耗材盘盈入库单、10:耗材出库单、11:耗材盘亏出库单、12:耗材冲销单、13:耗材腿裤单、14:资产退库单、15:员工领用申请、16:员工借用申请、17:员工退还申请、18:维保信息变更单）
operator处理人id
createdTime创建时间（时间戳格式）
enterpriseId公司id

呆滞资产详情 ​

属性名称说明
companyName公司名称
quantity数量
amount金额

耗材物品详情 ​

属性名称说明
departmentId部门id
code部门编码
name部门名称
companyId公司id
amount部门耗材金额
month月份

每月耗材使用情况详情 ​

属性名称说明
consumableId物品id
businessMonth月份
quantity数量
amount金额