# 费用预算
# 预算基数记录新增接口
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/budgetRadix/v1/addRecords/{ openid }/{ timestamp }/{ digest }/{ msg_id }
在线调试
请求示例:
请求说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
radix_code | VARCHAR | 是 | 预算基数编码 |
radix_name | varchar(100) | 否 | 预算基数名称 |
rows | List | 列表 | |
rows.dims | VARCHAR | 是 | 记录行维度信息,格式为:{“记录行维度名称":维值名称} |
rows.record_period | varchar(32) | 是 | 业务日期, 按日(格式:yyyy-MM-dd)、按月(yyyy-MM)、按季(yyyy-QQ) |
rows.num | varchar(20) | 是 | 数值 |
响应示例:
{
"return_code": "0",
"return_msg": "响应信息",
"msg_id": "{ msg_id }"
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
msg_id | string | 请求消息ID |
return_code | int | 响应编码。0:成功,1:失败 |
return_msg | string | 响应说明 |
# 预算新增接口
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/budget/v1/addBudget/{ openid }/{ timestamp }/{ digest }/{ msg_id }
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
table_name | VARCHAR | 是 | 预算表名称 |
year | NUMERIC | 是 | 预算年度 |
account | VARCHAR | 是 | 员工登陆账号 |
service_type | VARCHAR | 否 | 预算业务类型 |
remarks | VARCHAR | 否 | 备注 |
rows | List | 列表 | |
rows.subject_code | VARCHAR | 是 | 预算科目编码 |
rows.subject_name | VARCHAR | 是 | 预算科目名称 |
rows.period | VARCHAR | 是 | 预算期间 |
rows.dims | VARCHAR | 是 | 预算维度jason |
rows.amount | NUMERIC(20, 2) | 是 | 编制金额 |
响应示例:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
参数 | 说明 |
---|---|
return_code | 响应编码 |
return_msg | 响应信息 |
msg_id | 消息ID |
# 预算调整接口
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/budget/v1/adjustBudget/{ openid }/{ timestamp }/{ digest }/{ msg_id }
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
table_name | VARCHAR | 是 | 预算表名称 |
year | NUMERIC | 是 | 预算年度 |
account | VARCHAR | 是 | 员工登陆账号 |
service_type | VARCHAR | 否 | 预算业务类型 |
remarks | VARCHAR | 否 | 备注 |
rows | List | 列表 | |
rows.subject_code | VARCHAR | 是 | 预算科目编码 |
rows.subject_name | VARCHAR | 是 | 预算科目名称 |
rows.period | VARCHAR | 是 | 预算期间 |
rows.dims | VARCHAR | 是 | 预算维度jason |
rows.amount | NUMERIC(20, 2) | 是 | 编制金额 |
参数 | 类型 | 必填 | 说明 |
:--- | :--- | :--- | :--------------------------------------------------------------- |
table_name | VARCHAR | 是 | 预算表名称 |
year | NUMERIC | 是 | 预算年度 |
account | VARCHAR | 是 | 员工登陆账号 |
rows | List | 列表 | |
rows.subject_code | VARCHAR | 是 | 预算科目编码 |
rows.subject_name | VARCHAR | 是 | 预算科目名称 |
rows.period | VARCHAR | 是 | 预算期间 |
rows.dims | VARCHAR | 是 | 预算维度jason |
rows.amount | NUMERIC(20, 2) | 是 | 编制金额(正数增加,负数减少) |
响应示例:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
参数 | 说明 |
---|---|
return_code | 响应编码 |
return_msg | 响应信息 |
msg_id | 消息ID |
# 可用预算查询接口
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/budget/v1/queryBudgets/{ openid }/{ timestamp }/{ digest }/{ msg_id }
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
table_name | VARCHAR(100) | 是 | 系统中存在的预算表 |
subject_code | VARCHAR(100) | 否 | 预算科目编码 |
subject_name | VARCHAR(100) | 否 | 预算科目名称 |
period | VARCHAR(100) | 否 | 预算期间, 按月(yyyy-MM)、按季(yyyy-QQ)、按年(yyyy) |
dims | JSON | 否 | 预算维度信息,格式为:{"预算维度名称":维值名称} |
page | INT | 否 | 页码,默认为 1 |
rows | INT | 否 | 单页最大数据数,默认 100 |
响应示例:
{
"return_code": "0",
"return_msg": "响应信息",
"msg_id": "{ msg_id }",
"response_data": "<<DATA>>"
}
数据DATA示例:
[{
"use_parent_amount": "0.00",
"subject_code": "KM20220112",
"period": "2021-10",
"changed_amount": "0.00",
"dims": {
"商品": "蓝药水",
"岗位": "开发"
},
"child_use_amount": "-4.40",
"subject_name": "父科目",
"deducted_amount": "0.00",
"add_amount": "0.00",
"start_amount": "0.00",
"freezing_amount": "0.00",
"budget_amount": "4.40"
}]
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
subject_code | VARCHAR | 是 | 预算科目编码 |
subject_name | VARCHAR | 是 | 预算科目名称 |
period | VARCHAR | 是 | 预算期间, 按月(yyyy-MM)、按季(yyyy-QQ)、按年(yyyy) |
dims | VARCHAR | 是 | 预算维度信息,格式为:{"预算维度名称":维值名称} |
start_amount | NUMERIC(20, 2) | 是 | 期初预算,预实分析表中对应预算行的期初预算 |
changed_amount | NUMERIC(20, 2) | 是 | 预算调整,预实分析表中对应预算行的预算调整 |
add_amount | NUMERIC(20, 2) | 是 | 预算调拨,预实分析表中对应预算行的预算调拨 |
freezing_amount | NUMERIC(20, 2) | 是 | 冻结额,预实分析表中对应预算行的冻结额 |
deducted_amount | NUMERIC(20, 2) | 是 | 扣减额,预实分析表中对应预算行的扣减额 |
child_use_amount | NUMERIC(20, 2) | 是 | 子科目使用预算,预实分析表中对应预算行的子科目使用预算 |
use_parent_amount | NUMERIC(20, 2) | 是 | 使用父科目预算,预实分析表中对应预算行的使用父科目预算 |
budget_amount | NUMERIC(20, 2) | 是 | 可用预算,预实分析表中对应预算行的可用预算额度 |
# 预算占用查询接口
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/budgetQuery/v1/freezingRecords/{ openid }/{ timestamp }/{ digest }/{ msg_id }
在线调试
请求示例:
请求说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
table_name | VARCHAR(100) | 是 | 系统中存在的预算表 |
subject_code | VARCHAR(100) | 否 | 预算科目编码 |
subject_name | VARCHAR(100) | 否 | 预算科目名称 |
period | VARCHAR(100) | 否 | 预算期间, 按月(yyyy-MM)、按季(yyyy-QQ)、按年(yyyy) |
dims | JSON | 否 | 预算维度信息,格式为:{"预算维度名称":维值名称} |
bills_code | VARCHAR(100) | 否 | 方案、申请、核销单据编号 |
page | INT | 否 | 页码,默认为 1 |
rows | INT | 否 | 单页最大数据数,默认 1000 |
响应示例:
注: return_code 为 2 时表示不存在预算占用数据
{
"return_code": "0",
"return_msg": "响应信息",
"msg_id": "{ msg_id }",
"response_data": "<<DATA>>"
}
数据DATA示例:
[{
"table_name": "2022年预算表",
"subject_code": "KM202201271951",
"subject_name": "科目二",
"period": "2022-01",
"dims": {
"维度名": "纬度值"
},
"bills_code": "SQ202211150001",
"type_name": "万能活动申请",
"amount": "5.00"
}]
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
table_name | VARCHAR(32) | 是 | 预算表名称 |
subject_code | VARCHAR(100) | 是 | 预算科目编码 |
subject_name | VARCHAR(100) | 是 | 预算科目名称 |
period | VARCHAR(32) | 是 | 预算期间, 按月(yyyy-MM)、按季(yyyy-QQ)、按年(yyyy) |
dims | VARCHAR | 是 | 预算维度信息,格式为:{"预算维度名称":维值名称} |
bills_code | VARCHAR | 是 | 方案、申请、核销单据编号 |
type_name | VARCHAR | 是 | 方案、申请、核销单据类型 |
amount | NUMERIC(20, 2) | 是 | 预实分析表中,对应预算行冻结额明细中,对应的冻结金额 |
# 预算扣减查询接口
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/budgetQuery/v1/deductedRecords/{ openid }/{ timestamp }/{ digest }/{ msg_id }
在线调试
请求示例:
请求说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
table_name | VARCHAR(100) | 是 | 系统中存在的预算表 |
subject_code | VARCHAR(100) | 否 | 预算科目编码 |
subject_name | VARCHAR(100) | 否 | 预算科目名称 |
period | VARCHAR(100) | 否 | 预算期间, 按月(yyyy-MM)、按季(yyyy-QQ)、按年(yyyy) |
dims | JSON | 否 | 预算维度信息,格式为:{"预算维度名称":维值名称} |
bills_code | VARCHAR(100) | 否 | 方案、申请、核销单据编号 |
page | INT | 否 | 页码,默认为 1 |
rows | INT | 否 | 单页最大数据数,默认 1000 |
响应示例:
注: return_code 为 2 时表示不存在预算扣减数据
{
"return_code": "0",
"return_msg": "响应信息",
"msg_id": "{ msg_id }",
"response_data": "<<DATA>>"
}
数据DATA示例:
[{
"table_name": "2022年预算表",
"subject_code": "KM202201271951",
"subject_name": "科目二",
"period": "2022-01",
"dims": {
"维度名": "纬度值"
},
"bills_code": "SQ202211150001",
"type_name": "万能活动申请",
"amount": "5.00"
}]
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
table_name | VARCHAR(32) | 是 | 预算表名称 |
subject_code | VARCHAR(100) | 是 | 预算科目编码 |
subject_name | VARCHAR(100) | 是 | 预算科目名称 |
period | VARCHAR(32) | 是 | 预算期间, 按月(yyyy-MM)、按季(yyyy-QQ)、按年(yyyy) |
dims | VARCHAR | 是 | 预算维度信息,格式为:{"预算维度名称":维值名称} |
bills_code | VARCHAR | 是 | 方案、申请、核销单据编号 |
type_name | VARCHAR | 是 | 方案、申请、核销单据类型 |
amount | NUMERIC(20, 2) | 是 | 预实分析表中,对应预算行扣减额明细中,对应的扣减金额 |
# 预算编制单查询接口
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/budgetBills/v1/queryRecords/{ openid }/{ timestamp }/{ digest }/{ msg_id }
在线调试
请求示例:
请求说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
create_from | VARCHAR | 否 | 创建开始时间。格式:yyyy-MM-dd HH:mm:ss |
create_to | VARCHAR | 否 | 创建结束时间。格式:yyyy-MM-dd HH:mm:ss |
modify_from | VARCHAR | 否 | 修改开始时间。格式:yyyy-MM-dd HH:mm:ss |
modify_to | VARCHAR | 否 | 修改结束时间。格式:yyyy-MM-dd HH:mm:ss |
bills_code | VARCHAR | 否 | 预算编制单号 |
bills_type | VARCHAR | 否 | 预算编制类型; 1:期初预算;2:预算调拨;3:预算调整 |
setting_name | VARCHAR | 否 | 预算表名称 |
approval_status | VARCHAR | 否 | 审批状态; 0:处理中;1:已批准;2:被打回;3:审批中;9:待提交; |
audit_from | VARCHAR | 否 | 最近审批开始时间。格式:yyyy-MM-dd HH:mm:ss |
audit_to | VARCHAR | 否 | 最近审批结束时间。格式:yyyy-MM-dd HH:mm:ss |
page | VARCHAR | 否 | 页码,不填默认第一页 |
rows | VARCHAR | 否 | 页长,不填默认1000 |
响应示例:
{
"return_code": "0",
"return_msg": "响应信息",
"msg_id": "{ msg_id }",
"response_data": "<<DATA>>"
}
数据DATA示例:
[
{
"bills_code": "BGT202204070001",
"create_time": "2022-04-07 11:22:22",
"year": 2020,
"remarks": "aaa",
"attachment_url": "5578927823916678536/budget/202206/b7f9247428ab4abb954c5c760591a2c1.sql",
"auditor_name": "刀妹",
"approval_status": "1",
"reverse_time": "2022-04-07 11:22:46",
"dept_name": "艾欧尼亚",
"bills_type": "1",
"service_type":"普通期初预算",
"operator_id": 2131231,
"operator_name": "啊伟大",
"rows": [
{
"subject_code": "KM2022011201",
"period": "2020-01",
"amount": "1000.00",
"dims": {
"商品": "无尽之刃",
"岗位": "开发"
},
"subject_name": "子科目一"
},
{
"subject_code": "KM2022011202",
"period": "2020-01",
"amount": "1000.00",
"dims": {
"商品": "无尽之刃",
"岗位": "测试"
},
"subject_name": "子科目二"
}
],
"audit_time": "2022-04-07 11:22:33",
"setting_name": "维值权限",
"reverse_status": "2",
"creator_id": 4883362607570892159,
"auditor_id": 4883362607570892159
},
{
"bills_code": "BGT202204070001-CX",
"create_time": "2022-04-07 11:22:46",
"year": 2020,
"auditor_name": null,
"approval_status": "1",
"reverse_time": null,
"dept_name": "艾欧尼亚",
"bills_type": "1",
"rows": [
{
"subject_code": "KM2022011201",
"period": "2020-01",
"amount": "-1000.00",
"dims": {
"商品": "无尽之刃",
"岗位": "开发"
},
"subject_name": "子科目一"
},
{
"subject_code": "KM2022011202",
"period": "2020-01",
"amount": "-1000.00",
"dims": {
"商品": "无尽之刃",
"岗位": "测试"
},
"subject_name": "子科目二"
}
],
"audit_time": null,
"setting_name": "维值权限",
"reverse_status": "1",
"creator_id": 4883362607570892159,
"auditor_id": null
}
]
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
bills_code | string | Y | 预算编制单号 |
bills_type | string | Y | 预算编制类型; 1:期初预算; 2:预算调拨; 3:预算调整 |
service_type | string | Y | 预算业务类型 |
setting_name | string | Y | 预算表名称 |
year | string | Y | 预算年度:如2018 |
remarks | string | Y | 备注 |
attachment_url | string | Y | 附件 |
operator_id | string | Y | 经办人的员工账号 |
operator_name | string | Y | 经办人部门名称 |
creator_id | Long | Y | 提交人的员工账号 |
dept_name | string | Y | 提交人部门名称 |
create_time | string | Y | 提交时间。格式:yyyy-MM-dd HH:mm:ss |
approval_status | string | Y | 审批状态;0:处理中;1:已批准;2:被打回;3:审批中;9:待提交 |
auditor_id | Long | - | 最近审批人的员工账号 |
auditor_name | string | - | 最近审批人员工姓名 |
audit_time | string | - | 最近审批时间。格式:yyyy-MM-dd HH:mm:ss |
reverse_status | string | - | 红冲状态; 0:正常; 1:冲销; 2:被冲销 |
reverse_time | string | - | 红冲时间,只有状态为“被冲销”的,才有值。格式:yyyy-MM-dd HH:mm:ss |
rows | List | 列表 | |
rows.subject_code | string | Y | 预算科目编码 |
rows.subject_name | string | Y | 预算科目名称 |
rows.period | string | Y | 期间 |
rows.dims | string | Y | 预算维度信息,格式为:{"预算维度名称":维值名称},多个维度用逗号隔开 |
rows.amount | string | Y | 预算编制金额,可能为负数或者0或者正数 |
# 预算编制单审批状态回写接口
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/budgetBills/v1/auditBills/{ openid }/{ timestamp }/{ digest }/{ msg_id }
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
bills_code | VARCHAR | 是 | 预算编制单号 |
auditor | VARCHAR | 否 | 最后审批人的名称 |
audit_time | VARCHAR | 否 | 如果不传,则为接口传输日期 |
approval_status | VARCHAR | 是 | 1:已通过或者2:已打回 |
响应示例:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
参数 | 说明 |
---|---|
return_code | 响应编码 |
return_msg | 响应信息 |
msg_id | 消息ID |
← 费用核算接口 费用核销新增/修改接口 →