办公用品申领

更新时间：2019-9-27

1. 获取耗材领用申请单列表

请求地址

GET /application/consumable

参数说明

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

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

返回结果

{
    "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. 获取可以被领用的物品

请求地址

GET /consumable

参数说明

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

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

返回结果

{
    "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. 新增耗材领用申请单

请求地址

POST /application/consumable

请求示例

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

参数说明

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

要领用的物品详情

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

返回结果

{
    "serialNo": "CONS201910100001",
}

结果说明

属性名称	说明
serialNo	申请单号

3. 获取耗材领用单签字列表

请求地址

GET /receipt/consumable

参数说明

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

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

返回结果

{
    "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. 耗材领用发放单签字

请求地址

POST /SelfService/EmployeeSign

请求示例

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

参数说明

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

返回结果

{}

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

附录

1. 支持的查询参数

如无特别说明，下列操作对于查询实体对象中的任意属性均适用。使用时只需将其追加至请求的querystring中即可。对实体对象中不存在的属性进行操作将会得到不可预期的结果。

分页
- skip={数字} 跳过指定条数的记录数
- take={数字} 取出指定条数的记录数
- 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
自定义返回结果
- 使用Fields参数来指定返回结果中需要的属性或字段名称 如：对于员工查询接口使用Fields=Id,employeeName，返回的员工集合结果中将仅包含此2个属性。

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	备注