财务域开放(376 个接口)
财务能力接入开放平台,新增 376 个接口:finance 域 365 个,另有 11 个财务业务设置
归入 config.finance.*。覆盖应收应付、收付款、发票、费用借款、资金银行、成本与收入确认、
期初与报表七大类共 38 个实体。
接口分布
| 类别 | 主要实体 | 接口数 |
|---|---|---|
| 应收与收款 | 应收账款、收款单、预收款、退款单、对账单、核销 | 74 |
| 应付与付款 | 应付账款、付款单、付款申请、预付款、应收应付对冲 | 75 |
| 发票 | 发票、开票申请、发票邮箱、税额调整、未开票查询 | 40 |
| 费用与借款 | 费用单、费用类别、借款单、银行借款、财务分类 | 60 |
| 资金与银行 | 资金流水、银行账户、银行流水、收款账户、币种、汇率 | 48 |
| 成本与收入 | 成本单、成本池、成本结转、收入确认 | 39 |
| 期初、报表与其他 | 期初数据、财务报表、报表订阅、审批表单 schema | 29 |
授权
finance 与 config 都是既有的范围词汇,本次没有新增范围。但在此之前完成授权的
凭证若没勾选 finance:read / finance:write,仍访问不到财务接口——先前无接口可用时
多数集成没有勾它。
- OAuth 凭证:重新走一次授权流程,勾选所需的
finance范围 - AppKey:授权范围创建时固定,需新建后切换、再吊销旧的
财务业务设置(付款方式、发票邮箱)归 config 域,需 config:read / config:write,
与 finance 范围相互独立。
高危操作
183 个写接口标记为高危,占财务写接口的绝大多数——财务写操作普遍涉及资金、审批状态 或账务数据,包括收付款确认、核销、开票、成本结转、收入确认、期初数据设置与各类审批 动作(提交、审核、驳回、撤回、反审核)。
经 MCP 调用这些接口须先向用户复述操作内容并获得明确同意,再携 confirm: true
重新调用。直连 POST /v1/api/invoke 的集成方不受此门限制,请自行确保调用前已获授权。
未纳入本批
- 一次性内部数据回填(
/v1/internal/*):运维用途,后端默认以配置开关禁用,不对外开放。 - 附件绑定、导入导出任务、打印模板等辅助接口,与其他域的处理一致。
- 路径中带
{id}占位符的 11 个接口:统一 invoke 入口目前只传query/body, 不做路径参数替换,登记了也调用不通。这批接口待入口支持路径参数后再开放。