# 费用预算

# 预算基数记录新增接口

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/budgetRadix/v1/addRecords/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "radix_code": "JS202201271856",
    "radix_name": "预算基数",
    "rows": [
        {
            "dims": {
                "维度名": "维度值"
            },
            "record_period": "2022-01",
            "num": "1000"
        }
    ]
}
说明: 本示例仅供参考,具体以参数说明为准。

请求说明

参数 类型 必填 说明
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": "2022年预算",
	"year": "2022",
    "service_type": "1",
	"account": "dm",
    "remarks": "备注",
	"rows": [
        {
            "subject_code": "KM202201271940",
            "subject_name": "科目",
            "period": "2022-01",
            "dims": {
                "维度名": "纬度值"
            },
            "amount": "100000.00"
        }
    ]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
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": "2022年预算",
  "year": "2022",
  "service_type": "1",// * 1:期初预算,2:预算调整,3:预算追加,4:冻结,5:扣减
  "account": "dm",
  "remarks": "备注",
  "rows": [
    {
      "subject_code": "KM202201271940",
      "subject_name": "科目",
      "period": "2022-01",
      "dims": {
        "维度名": "纬度值"
      },
      "amount": "100000.00"
    }
  ]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
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": "2022年预算表",
	"subject_code": "KM202201271951",
	"subject_name": "科目二",
	"period": "2022-01",
    "dims": {
        "维度名": "纬度值"
    },
    "page": "1",
    "rows": "100"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
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": "2022年预算表",
	"subject_code": "KM202201271951",
	"subject_name": "科目二",
	"period": "2022-01",
    "dims": {
        "维度名": "纬度值"
    },
    "bills_code": "SQ202211150001",
    "page": "1",
    "rows": "100"
}
说明: 本示例仅供参考,具体以参数说明为准。

请求说明

参数 类型 必填 说明
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": "2022年预算表",
	"subject_code": "KM202201271951",
	"subject_name": "科目二",
	"period": "2022-01",
    "dims": {
        "维度名": "纬度值"
    },
    "bills_code": "SQ202211150001",
    "page": "1",
    "rows": "100"
}
说明: 本示例仅供参考,具体以参数说明为准。

请求说明

参数 类型 必填 说明
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": "2022-04-07 00:00:00",
    "create_to": "2022-04-08 00:00:00",
    "modify_from": "2022-04-07 00:00:00",
    "modify_to": "2022-04-08 00:00:00",
    "bills_code": "BGT202204070001-CX",
    "bills_type": "1",
    "setting_name": "维值权限",
    "approval_status": "1",
    "audit_from": "2022-04-07 00:00:00",
    "audit_to": "2022-04-08 00:00:00",
    "page": "1",
    "rows": "100"
}
说明: 本示例仅供参考,具体以参数说明为准。

请求说明

参数 类型 必填 说明
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": "BGT202204010002",
  "auditor":"zhanghao",
  "audit_time": "2022-04-11 12:59:59",
  "approval_status": "2"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
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