匹配可用的预算科目
- 接口:/budget/account/match
- Method:POST
- 数据格式:JSON
- 描述,本接口为根据业务参数,匹配业务可用的预算科目集合的接口,匹配的逻辑根据费用类型和适用范围两个维度取 "与"关系,既既满足费用类型,又满足适用范围的的科目会返回,各个维度的适用范围取"或"关系,科目只要满足其中一个维度,就会返回。单次接口最多可以请求50组业务;
- 请求参数:
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
List | List | Y | 可用预算科目查询参数集合 |
└budgetAccountMatchParam | Object | Y | |
└└bizCode | String | Y | 客户自定义的业务编码,用于匹配返回结果 |
└└feeTypeBizCode | String | Y | 费用类型业务编码 |
└└departmentBizCodes | List |
N | 匹配适用部门的科目,不填写,仅匹配适用全部部门的预算科目 |
└└costTrackingItemBizCodes | List |
N | 匹配适用项目的科目,不填写,仅匹配适用全部项目的预算科目 |
└└subsidiaryBizCodes | List |
N | 匹配适用业务实体的科目,不填写,仅匹配适用全部业务实体的预算科目 |
└└employeeId | String | N | 匹配适用个人的科目,不填写,仅匹配适用全部人员的预算科目 |
请求示例:
{ "timestamp":"1545902846044", "data":[ { "bizCode":"testCode1", "feeTypeBizCode":"JY_1", "departmentBizCodes":["DI2002241IMABO1T"], "costTrackingItemBizCodes":["test_01"], "subsidiaryBizCodes":["SUB1"], "employeeId":"1001" }, { "bizCode":"testCode1", "feeTypeBizCode":"JY_2", "departmentBizCodes":["DI2002241IMABO1T"] } ] }
返回数据:
字段 | 类型 | 描述 |
---|---|---|
List | List | 匹配到的可用预算科目集合 |
└bizCode | String | 业务唯一编码(由请求方定义) |
└budgetaryAccountList | List | 匹配到的可用预算科目 |
└└code | String | 预算科目唯一编码 |
└└businessCode | String | 预算科目业务编码 |
└└name | String | 预算科目名称 |
└└status | String | 预算科目状态 ENABLE(启用)、 DISABLE(禁用) |
└└mask | Int | 匹配适用范围的匹配度,与对应的适用范围维度的值按位“与“,大于0代表适用该范围,业务实体(0),部门(1), 项目(2), 个人(3) |
- 返回示例:
{ "code": "ACK", "message": "", "data": [ { "bizCode": "test1", "budgetaryAccountList": [ { "code": "code1", "businessCode": "biz1", "status": "ENABLE", "name": "yuowh", "mask":"6" } ] }, { "bizCode": "test2", "budgetaryAccountList": [ { "code": "code2", "businessCode": "biz2", "status": "ENABLE", "name": "yuowh2", "mask":"2" } ] } ], "args": null, "linkDetail": false, "nonBizError": false }
- 失败示例:
{ "code": "NACK", "message": "4业务编码错误, 费用类型不存在", "data": null, "args": null, "linkDetail": false, "nonBizError": false }