TIP

• 预算基数记录新增接口
• 预算新增接口
• 预算调整接口
• 可用预算查询接口
• 预算占用查询接口
• 预算扣减查询接口
• 预算编制单查询接口
• 预算编制单审批状态回写接口

费用预算

预算基数记录新增接口

请求方式： 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