跳到主要内容

财务域开放(376 个接口)

Avery
Risemap 开放平台

财务能力接入开放平台,新增 376 个接口:finance 域 365 个,另有 11 个财务业务设置 归入 config.finance.*。覆盖应收应付、收付款、发票、费用借款、资金银行、成本与收入确认、 期初与报表七大类共 38 个实体。

接口分布​

类别主要实体接口数
应收与收款应收账款、收款单、预收款、退款单、对账单、核销74
应付与付款应付账款、付款单、付款申请、预付款、应收应付对冲75
发票发票、开票申请、发票邮箱、税额调整、未开票查询40
费用与借款费用单、费用类别、借款单、银行借款、财务分类60
资金与银行资金流水、银行账户、银行流水、收款账户、币种、汇率48
成本与收入成本单、成本池、成本结转、收入确认39
期初、报表与其他期初数据、财务报表、报表订阅、审批表单 schema29

完整清单与字段级说明见财务域与 接口参考。

授权​

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, 不做路径参数替换,登记了也调用不通。这批接口待入口支持路径参数后再开放。