API开放平台

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

参数说明：

参数 类型 必填 说明
table_name VARCHAR 是 预算表名称
code VARCHAR 否 编码
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) 是 编制金额
rows.remarks VARCHAR 否 备注

响应示例：

{
    "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年预算",
  "code": "BGT202304050001",
  "name": "测试预算",
  "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",
      "remarks": "备注"
    }
  ]
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
table_name VARCHAR 是 预算表名称
code VARCHAR 否 编码
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) 是 编制金额(正数增加，负数减少)
rows.remarks VARCHAR 否 备注

响应示例：

{
    "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": "子科目一",
                "remarks": "备注信息"
            },
            {
                "subject_code": "KM2022011202",
                "period": "2020-01",
                "amount": "1000.00",
                "dims": {
                    "商品": "无尽之刃",
                    "岗位": "测试"
                },
                "subject_name": "子科目二",
                "remarks": "备注信息"
            }
        ],
        "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": "子科目一",
                "remarks": "备注信息"
            },
            {
                "subject_code": "KM2022011202",
                "period": "2020-01",
                "amount": "-1000.00",
                "dims": {
                    "商品": "无尽之刃",
                    "岗位": "测试"
                },
                "subject_name": "子科目二",
                "remarks": "备注信息"
            }
        ],
        "audit_time": null,
        "setting_name": "维值权限",
        "reverse_status": "1",
        "creator_id": 4883362607570892159,
        "auditor_id": null
    }
]

参数说明：

参数 类型 必填 说明
id string Y 预算编制单id
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 经办人的id
operator_code string Y 经办人的账号
operator_name string Y 经办人的姓名
operator_source_code string Y 经办人的外部id
operator_dept_name string Y 经办人部门名称
creator_id Long Y 提交人的id
creator_code Long Y 提交人的账号
creator_name Long Y 提交人的姓名
creator_source_code Long Y 提交人的外部id
creator_dept_name string Y 提交人的部门名称
create_time string Y 提交时间。格式：yyyy-MM-dd HH:mm:ss
approval_status string Y 审批状态；0：处理中；1：已批准；2：被打回；3：审批中；9：待提交
auditor_source_code String - 最近审批人的外部id
auditor_id string - 最近审批人的id
auditor_code 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
next_auditor_id string - 当前审批人的id
next_auditor_code string - 当前审批人的账号
next_auditor_name string - 当前审批人的姓名
next_auditor_source_code string - 当前审批人的外部id
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或者正数
rows.remarks string Y 行备注

# 预算编制单审批状态回写接口

接口说明：根据预算编制单号进行审批，审批时调用平台的审批流，如果传的审批人和当前这张单子的审批人不一致，审批失败。当前节点手工指定下一审批人时，不支持外部审批。

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/budgetBills/v1/auditBills/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{ 
  "id": "5945873929671013359",
  "bills_code": "BGT202204010002",
  "auditor_id":"8011199459513275384",
  "auditor_code": "varchar类型",
  "approval_status": "2",
  "audit_time": "2022-04-11 12:59:59",
  "opinion": "varchar类型"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
id VARCHAR 是 预算编制单id
bills_code VARCHAR 是 预算编制单号
auditor_id VARCHAR 否 最后审批人账号id
auditor_code VARCHAR 否 最后审批人账号编码
approval_status VARCHAR 是 1:已通过或者2:已打回
audit_time VARCHAR 否 审批状态。如果不传，则为接口传输日期
opinion VARCHAR 否 审批意见

响应示例：

{
    "return_code": 0,
    "return_msg": "预算编制审批成功",
    "msg_id": "{ msg_id }"
}
参数 说明
return_code 响应编码
return_msg 响应信息编码说明
msg_id 请求消息ID

# 预算科目新增

接口说明：新增预算科目基础数据，新增后预算编制权限、预算查看权限默认为“全公司”，状态为“启用”。

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/budget/v1/addSubject/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "code":"20230619003",
  "name":"openapi方式",
  "source_code":"20230619003",
  "parent_name":"父科目",
  "type":"2",
  "subject_type_name": "科目类型1",
  "is_share": "0"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
code VARCHAR(100) 是 预算科目编码，不能重复
name VARCHAR(100) 是 预算科目名称，不能重复
source_code VARCHAR(100) 否 预算科目外部id
parent_name VARCHAR(100) 是 上级科目
type VARCHAR(100) 否 关联订单促销，不传默认为否（1：是； 2：否；）
subject_type_name VARCHAR(100) 否 科目类型，系统中存在且启用的科目类型
is_share VARCHAR(100) 是 共用父级科目预算（1：是；0：否）

参数说明：

{
  "return_code": "0",
  "return_msg": "会计科目新增成功。",
  "msg_id": "{ msg_id }",
  "response_data": null
}
参数 说明
return_code 响应编码
return_msg 响应信息
msg_id 消息ID
response_data 响应返回值

# 预算科目查询

接口说明：查询会计科目基础数据，状态为“启用”。 请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/budget/v1/querySubject/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "id":"8448092065936246439",
  "code":"",
  "name":"",
  "source_code":"",
  "page_number":"1",
  "page_size":"1"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
id VARCHAR(100) 否 预算科目id
code VARCHAR(100) 否 预算科目编码
name VARCHAR(100) 否 预算科目名称
source_code VARCHAR(100) 否 预算科目外部id
page_number VARCHAR(100) 否 页码 不填默认第一页
page_size VARCHAR(100) 否 页长 不填默认1000

响应示例：

{
  "return_code": "0",
  "return_msg": "响应信息",
  "msg_id": "{ msg_id }",
  "response_data": "<<DATA>>"
}

数据DATA示例:

[
  {
    "parent_name": "父科目",
    "code": "KM20230619004",
    "is_share": "0",
    "subject_type": "",
    "name": "openapi方式新增科目",
    "subject_type_name": "",
    "id": "9181053931316471349",
    "type": "2",
    "source_code": "20230619004"
  }
]

参数说明：

参数 类型 说明
id VARCHAR 会计科目id
code VARCHAR 会计科目编码
name VARCHAR 会计科目名称
source_code VARCHAR 会计科目外部id
parent_name VARCHAR 上级科目名称
type VARCHAR 关联订单促销（1：是； 2：否；）
subject_type VARCHAR 科目类型
is_share VARCHAR 共用父级科目预算（1：是；0：否）

# 预算编制单红冲

接口说明：预算编制单红冲，红冲的逻辑和页面逻辑一致，生成一条负数金额的红冲单，红冲状态为冲销，提交人、经办人为红冲人。原单红冲状态为被冲销。

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/budgetBills/v1/writeBackBills/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "bills_id":"5291697875326861642",
  "bills_code":"",
  "write_back_user":"yz",
  "write_back_time":"2023-09-20"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
bills_id VARCHAR(100) 否 预算编制单id
bills_code VARCHAR(100) 否 预算编制单号
write_back_user VARCHAR(100) 是 红冲人账号
write_back_time VARCHAR(100) 否 单据红冲日期。样式yyyy-MM-dd（如果不传，则为接口传输日期）

响应示例：

{
  "return_code": "0",
  "return_msg": "响应信息",
  "msg_id": "{ msg_id }",
  "response_data": null
}
参数 说明
return_code 响应编码
return_msg 响应信息
msg_id 消息ID
response_data 响应返回值

# 预算组织新增

接口说明：新增预算组织基础数据，新增后预算组织权限默认为“全公司”，状态为“启用”。

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/budget/v1/addOrg/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "code":"ORG0919008",
  "name":"0919预算组织008",
  "sourceCode":"12345678",
  "parentCode":"ORG0919005",
  "deptCode":"BM21111601",
  "cusTypeCode":"CT00098",
  "ownerCode":"yz",
  "ownerName":"",
  "account":"yz"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
code VARCHAR(100) 是 预算组织编码，不能重复
name VARCHAR(100) 是 预算组织名称，不能重复
sourceCode VARCHAR(100) 否 预算组织外部id
parentCode VARCHAR(100) 否 上级预算组织编码，为空时默认为全部组织，传值时必须时系统中存在的。
deptCode VARCHAR(100) 否 关联部门编码
cusTypeCode VARCHAR(100) 否 关联客户类型编码
ownerCode VARCHAR(100) 否 预算组织负责人编码（预算组织负责人编码，在系统中存在且为启用状态，编码和名称都有值时，必须为同一个）
ownerName VARCHAR(100) 否 预算组织负责人名称（预算组织负责人编码，在系统中存在且为启用状态，编码和名称都有值时，必须为同一个）
account VARCHAR(100) 是 操作人账号

参数说明：

{
  "return_code": "0",
  "return_msg": "预算组织新增成功！",
  "msg_id": "{ msg_id }",
  "response_data": null
}
参数 说明
return_code 响应编码
return_msg 响应信息
msg_id 消息ID
response_data 响应返回值

# 预算组织查询

接口说明：查询预算组织基础数据。 请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/budget/v1/queryOrgList/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "id":"7010549600665784637",
  "code":"ORG0919008",
  "name":"0919预算组织008",
  "sourceCode":"12345678",
  "rows":"1000",
  "page":"1"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
id VARCHAR(100) 否 预算组织id
code VARCHAR(100) 否 预算组织编码
name VARCHAR(100) 否 预算组织名称
source_code VARCHAR(100) 否 预算组织外部id
rows VARCHAR(100) 否 页长 不填默认1000
page VARCHAR(100) 否 页码 不填默认第一页

响应示例：

{
  "return_code": "0",
  "return_msg": "响应信息",
  "msg_id": "{ msg_id }",
  "response_data": "<<DATA>>"
}

数据DATA示例:

[
  {
    "parent_org_code": "ORG0919005",
    "parent_org_source_code": "12345",
    "code": "ORG0919008",
    "dept_list": [
      {
        "dept_code": "BM21111601",
        "dept_name": "诺克萨斯",
        "dept_id": "4732833996161900894",
        "source_code": ""
      }
    ],
    "name": "0919预算组织008",
    "use_status": "1",
    "parent_org_name": "0919预算组织005",
    "id": "7010549600665784637",
    "manager_list": [
      {
        "manager_name": "yangzhi",
        "manager_id": "7806203820472342773",
        "manager_code": "yz",
        "source_code": ""
      }
    ],
    "source_code": "12345678",
    "cus_type_list": [
      {
        "cus_type_code": "CT00098",
        "type_id": "7529059882058389092",
        "cus_type_name": "第三级类型",
        "source_code": ""
      }
    ]
  }
]

参数说明：

参数 类型 说明
id VARCHAR(100) 预算组织id
code VARCHAR(100) 预算组织编码
name VARCHAR(100) 预算组织名称
source_code VARCHAR(100) 预算组织外部id
parent_org_code VARCHAR(100) 上级预算组织编码
parent_org_name VARCHAR(100) 上级预算组织名称
parent_org_source_code VARCHAR(100) 上级预算组织外部id
dept_list List 关联部门
dept_list.dept_id VARCHAR(100) 关联部门id
dept_list.dept_code VARCHAR(100) 关联部门编码
dept_list.dept_name VARCHAR(100) 关联部门名称
dept_list.source_code VARCHAR(100) 关联部门外部id
cus_type_list List 关联客户类型
cus_type_list.type_id VARCHAR(100) 关联客户类型id
cus_type_list.cus_type_code VARCHAR(100) 关联客户类型编码
cus_type_list.cus_type_name VARCHAR(100) 关联客户类型名称
cus_type_list.source_code VARCHAR(100) 关联客户类型外部id
manager_list List 预算组织负责人
manager_list.manager_id VARCHAR(100) 预算组织负责人id
manager_list.manager_code VARCHAR(100) 预算组织负责人编码
manager_list.manager_name VARCHAR(100) 预算组织负责人名称
manager_list.source_code VARCHAR(100) 预算组织负责人外部id
use_status VARCHAR(1) 状态（1：启用；0：停用）

← 费用核销新增/修改接口 →