办公用品申领接口 ​

1. 获取耗材出库申请单列表 ​

请求地址 ​

text
GET /application/consumable

参数说明 ​

参数是否必须说明
taskStatus是审批状态；0：审批中、1，2，3：已批准、9：已驳回、4：已签收

耗材出库申请单查询接口支持丰富的条件过滤参数，请参见支持的查询参数附录 ​

返回结果 ​

json
{
    "offset": 0,
    "total": 0,
    "results": [
        {
            "receiveEmployeeName": "张三",
            "companyName": "测试企业",
            "companyCode": "01",
            "departmentCode": "1001",
            "departmentName": "测试部门",
            "applyEmployeeName": "张三",
            "products": [
                {
                    "categoryID": 36361,
                    "code": "10010101",
                    "name": "铅笔",
                    "commodityCode": "10010101",
                    "specs": "",
                    "measureUnit": "",
                    "remark": "",
                    "picPath": "/UploadImage/c5509207-eeae-4002-8d7e-d8c565a644a4.jpg",
                    "smallPicPath": "/UploadImage/a3f8c0db-d2bf-4677-8b0e-1b362caf19ba.jpg",
                    "batchID": 2,
                    "categoryName": "物品分类",
                    "categoryCode": "sys001",
                    "id": "7f978bae-bd13-4b99-844c-970cf1c5e4a3",
                    "applicationId": "40f0de1c-40a9-4d78-bfbe-01d4ad86b684",
                    "applyTime": "1565166826",
                    "productId": 63831,
                    "applyQuantity": 2,
                    "approveQuantity": 2,
                    "unitPrice": 1.5,
                    "amount": 3,
                    "status": 0,
                    "issueQuantity": 0
                }
            ],
            "applyEmployeeNo": "100001",
            "receiveEmployeeNo": "100001",
            "receiptCount": 0,
            "pendingReceiptCount": 0,
            "needApprove": true,
            "approveId": "ba76b773-5e7b-41bf-b457-1b9c80fd9cdb",
            "applyCount": 1,
            "id": "40f0de1c-40a9-4d78-bfbe-01d4ad86b684",
            "serialNo": "CONS201908070001",
            "receiveEmployeeId": "ea6acdeb-d0ed-4de5-b4b8-070395ef2f3f",
            "companyId": 45448,
            "departmentId": 243533,
            "applyEmployeeId": "ea6acdeb-d0ed-4de5-b4b8-070395ef2f3f",
            "applyTime": "1565166826",
            "applyRemark": "",
            "status": 9
        }
    ],
    "meta": {}
}
参数说明
offset当前结果对于首条结果的偏移量，指定分页查询时不为0
total所有符合查询条件的查询结果数量，指定需要结果记录数量时不为0
results符合查询条件的耗材出库申请单详情集合
meta其他信息

2. 获取可以被出库的物品 ​

请求地址 ​

text
GET /consumable

参数说明 ​

参数是否必须说明
categorycode是耗材分类编码
disabled是是否已禁用，1：是、0：否

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

返回结果 ​

json
{
    "offset": 0,
    "total": 0,
    "results": [
        {
            "stockQty": 6,
            "code": "346676688",
            "name": "测试分类",
            "barcode": "346676688",
            "logo": "",
            "specification": "",
            "measureUnit": "",
            "disabled": true,
            "remark": "",
            "createTime": "1571041062",
            "batchDate": "1571041062",
            "batchId": 2,
            "category": {
                "code": "5001",
                "name": "新的分类",
                "remark": "",
                "createdTime": "1568873128"
            },
            "createdUser": {
                "userName": "zhangsan@123456.com",
                "name": "张三",
                "isAdministrator": true,
                "deleted": false,
                "pushClientId": "6240843f1f0d451f78ef0201e4e45593"
            }
        }
    ],
    "meta": {}
}
参数说明
offset当前结果对于首条结果的偏移量，指定分页查询时不为0
total所有符合查询条件的查询结果数量，指定需要结果记录数量时不为0
results符合查询条件的物品详情集合
meta其他信息

3. 新增耗材领用申请单 ​

请求地址 ​

text
POST /application/consumable

请求示例 ​

json
{
    "applyRemark":"备注",
    "products": 
    [
        {
            "productCode":"2197",
            "applyQuantity":"2"
        }
    ]
}

参数说明 ​

参数是否必须说明
applyRemark否申请备注
products是要领用的物品详情集合

要领用的物品详情 ​

参数是否必须说明
productCode是物品编码
applyQuantity是申请数量

返回结果 ​

json
{
    "serialNo": "CONS201910100001",
}

结果说明 ​

属性名称说明
serialNo申请单号

3. 获取耗材出库单签字列表 ​

请求地址 ​

text
GET /receipt/consumable

参数说明 ​

参数是否必须说明
signatureStatus是签字状态，0：待签字、1：已签字

资耗材出库申请单查询接口支持丰富的条件过滤参数，请参见支持的查询参数附录 ​

返回结果 ​

json
{
    "offset": 0,
    "total": 0,
    "results": [
        {
            "companyCode": "01",
            "departmentCode": "1001",
            "userEmployeeNo": "100001",
            "repertoryCode": "1001",
            "consumables": [
                {
                    "productId": 63837,
                    "code": "10010102",
                    "commodityCode": "10010102",
                    "name": "钢笔",
                    "picturePath": "/UploadImage/5ac4caf9-2843-45db-98b3-59bb237a1fde.jpg",
                    "thumbnailPath": "/UploadImage/11606769-1ce6-4ce9-b58a-782a388183d8.jpg",
                    "specs": "",
                    "measureUnit": "",
                    "serialNo": "CK201907270012",
                    "receiveNumber": 1,
                    "price": 2,
                    "amount": 2,
                    "safetyLower": 0,
                    "safetyCap": 0,
                    "batchId": 2,
                    "remark": ""
                }
            ],
            "applicationSerialNo": "CONS201907270004",
            "serialNo": "CK201907270012",
            "companyName": "测试企业",
            "departmentName": "测试部门",
            "repertoryName": "仓库01",
            "businessTime": "1564156800",
            "userEmployeeName": "张三",
            "createdTime": "1564219623",
            "createdUser": "张三",
            "remark": "",
            "signatureStatus": 1,
            "signaturePicturePath": "//UploadImage/840b15e4-51bf-4eb2-ac28-8f56acfe90e8.jpg",
            "operationType": 0,
            "applicationId": "dd8fe926-9548-45e5-8b76-5b7709e5a5d0",
            "signatureDate": "1564219636",
            "needEmployeeSign": false
        }
    ],
    "meta": {}
}
参数说明
offset当前结果对于首条结果的偏移量，指定分页查询时不为0
total所有符合查询条件的查询结果数量，指定需要结果记录数量时不为0
results符合查询条件的耗材出库单详情集合
meta其他信息

5. 耗材申领发放单签字 ​

请求地址 ​

text
POST /SelfService/EmployeeSign

请求示例 ​

json
{
    "billType": 4,
    "picPath": "img/aaa.jpg",
    "billNo": "CK201908120001"
}

参数说明 ​

参数是否必须说明
billType是单据类型，1：资产申领单、2：资产借用单、3：资产退库单、4：耗材申领单
picPath是签字图片路径
billNo是发放单号

返回结果 ​

json
{}

对于成功更新的请求，该接口仅返回HTTP 200 OK

附录 ​

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. 耗材出库申请单数据对象格式 ​

属性名称说明
companyCode申请公司编码
companyName申请公司名称
departmentCode申请部门编码
departmentName申请部门名称
applyEmployeeNo申请人编码
applyEmployeeName申请人名称
receiveEmployeeNo接收人编码
receiveEmployeeName接收人名称
applyCount申请数量
receiptCount发放数量
pendingReceiptCount待签字的发放数量
needApprove是否审批，true：是、false：否
approveId审批单Id
id申请单Id
serialNo申请单号
receiveEmployeeId接收人Id
receiveTime接收时间
companyId申请公司Id
departmentId申请部门Id
applyEmployeeId申请人Id
applyTime申请时间
applyRemark申请备注
status审批单状态，0：待审批、1：已同意、2：发放中、3：已发放、4：已完成、9：已驳回
products申请单的物品详情集合

申请单的物品详情 ​

属性名称说明
categoryID耗材分类Id
code耗材编码
name耗材名称
commodityCode商品码
specs规格型号
measureUnit计量单位
remark备注
picPath耗材图片路径
smallPicPath耗材图片的缩略图路径
batchID批次号
categoryName耗材分类名称
categoryCode耗材分类编码
id申请单的子表Id
applicationId申请单Id
applyTime申请时间
productId物品Id
applyQuantity申请数量
approveQuantity审批数量
unitPrice单价
amount金额
issueQuantity发放数量
status物品发放状态，0：未发放、1：已发放、2：已签收

2. 物品详情 ​

属性名称说明
stockQty剩余数量
code物品编码
name物品名称
barcode商品码
logo品牌
specification规格型号
measureUnit单位
disabled是否被禁用，1：是、0：否
remark备注
createTime创建时间
batchDate批次创建时间
batchId批次
category耗材分类详情
createdUser创建人详情

耗材分类详情 ​

属性名称说明
code耗材分类编码
name耗材分类名称
remark备注
createdTime创建时间

创建人详情 ​

属性名称说明
userName用户名称
name用户姓名
isAdministrator是否管理员，1：是、0：否
deleted是否被禁用，1：是、0：否
pushClientId推送Id

3. 耗材出库单数据对象格式 ​

属性名称说明
companyCode领用公司编码
companyName领用公司名称
departmentCode领用部门编码
departmentName领用部门名称
serialNo单据号
repertoryCode仓库编码
repertoryName仓库名称
userEmployeeNo领用人编码
applicationSerialNo申请单据号
businessTime业务日期
userEmployeeName领用人名称
signatureStatus签字状态，0：待签字、1：已签字、2：已打回、"":空状态
createdTime单据创建时间
createUser单据创建人
remark备注
signaturePicturePath签字图片路径
operationType单据类型，0：出库单、1：退库单
applicationId申请单Id
signatureDate签字日期
needEmployeeSign是否需要员工端签字，true：是、false：否
consumables耗材出库单包含的物品详情集合

耗材出库单包含的物品详情 ​

属性名称说明
productId物品Id
code物品编码
commodityCode商品码
name物品名称
picturePath物品图片路径
thumbnailPath物品图片的缩略图路径
specs规格型号
measureUnit计量单位
serialNo单据号
receiveNumber出库数量
price单价
amount金额
safetyLower安全库存下限
safetyCap安全库存上限
batchId批次号
remark备注