单据注册管理

源系统定义

（以下为示例，具体配置需明确项目需求场景后确定）

单据类型定义

（以下为示例，具体配置需明确项目需求场景后确定）

适用角色

实施人员或系统管理员负责根据业务需求完成配置。上游业务系统需要确认传入的源系统编码、单据类型编码与注册信息一致。

配置前需要明确的内容

在新增注册信息前，应先从业务方取得以下信息：

• 源系统：产生预算单据并调用预算控制接口的业务系统，例如采购系统、费用系统或项目系统。

• 单据类型：源系统内需要进行预算控制的业务单据类型，例如采购申请单、费用申请单。单据类型应能区分不同的业务含义和预算控制口径。

• 控制策略绑定关系：确认该单据类型默认命中哪些控制策略、使用哪些预算版本和控制维度，并由预算管理员复核。

编码和变更约束

源系统编码和单据类型编码会参与接口调用及控制策略匹配，配置完成后应视为接口契约的一部分：

• 编码应保持稳定、唯一、可读，并与上游系统实际传值完全一致；名称可以优化，但不能用名称替代编码联调。

• 停用前应确认上游系统不会继续发送该编码，并检查是否存在待处理单据。

• 修改编码相当于变更接口契约。应优先新增新编码、完成联调和切换，再按项目流程停用旧编码；不要直接覆盖仍在使用的编码。

• 修改名称通常不改变接口匹配，但可能影响管理人员识别，应同步更新配置说明和交接文档。

配置完成后的校验

配置保存后，不能只以页面保存成功作为完成标志，应至少完成以下检查：

1. 确认源系统和单据类型编码与上游接口文档、实际请求值一致。

2. 确认单据类型已经绑定正确的控制策略。

3. 用一笔测试单据调用预算发生接口，分别验证命中策略、预算余额、超预算时的处理结果和返回信息。

4. 在“预算发生日志”中按单据 ID 找到该请求，核对请求参数、返回结果和单据明细；异常时按预算发生记录查询的排查路径处理。

完整示例：采购申请和费用申请

以下编码仅用于说明配置关系，实际项目应替换为项目确认的编码。

示例配置流程如下：

1. 注册源系统“采购系统”和“费用系统”，分别确认源系统编码。

2. 注册“采购申请单”和“费用申请单”，分别分配单据类型编码，并关联对应的源系统。

3. 由预算控制管理员为两种单据类型绑定控制策略。

4. 由集成测试人员使用两种单据各发起一笔正常额度和一笔超预算测试，保存请求、返回和日志编号，作为上线验收记录。