我的审批

更新时间:2019-9-27

1. 获取审批列表

请求地址
GET /ApproveTask
参数说明
审批查询接口支持丰富的条件过滤参数,请参见支持的查询参数附录
返回结果
{
    "offset": 0,
    "total": 0,
    "results": [
        {
            "id": "83e19288-2fc6-4021-96ed-03f01a18747e",
            "applicationType": 2,
            "description": "543",
            "applicationId": "33b725cb-d5fa-436b-b754-63783e33ae60",
            "companyCode": "01",
            "departmentCode": "1001",
            "createdTime": "1564201007",
            "updatedTime": "1564201060",
            "status": 1,
            "employeeName": "张三",
            "applyRemark": "",
            "serialNo": "BRW201907270001",
            "updatedUser": {
                "userName": "test@123456.com",
                "name": "张三",
                "isAdministrator": true,
                "deleted": false,
                "pushClientId": "6240843f1f0d451f78ef0201e4e45593"
            }
        }
    ],
    "meta": {}
}
参数 说明
offset 当前结果对于首条结果的偏移量,指定分页查询时不为0
total 所有符合查询条件的查询结果数量,指定需要结果记录数量时不为0
results 符合查询条件的审批单详情集合
meta 其他信息

2. 驳回审批单

请求地址
PUT /approveTask
POST /approveTask/put

对于不支持PUT请求的网络环境,请尝试使用备份的POST请求地址

请求示例
{
    "taskIds": "83e19288-2fc6-4021-96ed-03f01a18747e",
    "status": 9,
    "comment": "驳回"
}
参数说明
参数 是否必须 说明
taskIds 审批单Id
status 审批单状态,驳回值为9
comment 驳回备注
返回结果
{}

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

3. 同意审批单

请求地址
PUT /approveTask
POST /approveTask/put

对于不支持PUT请求的网络环境,请尝试使用备份的POST请求地址

请求示例
{
    "taskIds": "83e19288-2fc6-4021-96ed-03f01a18747e",
    "status": 9,
    "comment": "驳回",
    "consumables":   
    [
        {
            "approveQuantity":"2",
            "approveAmount":"3.0",
            "productCode":"10010101",
            "applyQuantity":"2",
            "productId":"63831"
        }
    ]
}
参数说明
参数 是否必须 说明
taskIds 审批单Id
status 审批单状态,驳回值为9
comment 驳回备注
consumables 耗材物品信息详情集合
耗材物品信息详情
参数 是否必须 说明
productId 物品Id
productCode 物品编码
applyQuantity 申请数量
approveAmount 金额
approveQuantity 审批数量
附加信息

要审批的申请单类型为耗材出库申请时,耗材物品信息的相关信息为必填,否则可以不填写。

返回结果
{}

对于成功更新的请求,该接口仅返回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. 审批单数据对象格式
属性名称 说明
id 审批单Id
applicationType 申请单类型,1:资产领用申请、2:资产借用申请、3:资产退库申请、4:耗材领用申请
description 审批说明
applicationId 申请单Id
companyCode 申请公司编码
departmentCode 申请部门编码
createdTime 单据创建时间
updatedTime 单据更新时间
status 审批单状态,0:待审批、1:已同意、2:发放中、3:已发放、4:已完成、9:已驳回
employeeName 申请人
applyRemark 申请备注
serialNo 申请单号
updatedUser 单据更新人详情
单据更新人详情
属性名称 说明
userName 用户账号
name 用户名
isAdministrator 是否管理员,true:是、false:否
deleted 用户是否被删除,true:被删除、false:未删除
pushClientId 推送消息Id