ICS 35.080 CCS L 77 山 14 西 省 地 方 标 准 DB 14/T 2542—2022 预算管理一体化系统会计核算软件 接口规范 2022 - 09 - 02 发布 山西省市场监督管理局  发 布 2022 - 12 - 01 实施 DB14/T 2542—2022 目 次 前言 .................................................................................. II 1 范围 ................................................................................ 1 2 规范性引用文件 ...................................................................... 1 3 术语和定义 .......................................................................... 1 4 缩略语 .............................................................................. 2 5 基本要求 ............................................................................ 2 6 接口组成 ............................................................................ 3 7 接口要求 ........................................................................... 46 8 接口安全 ........................................................................... 47 I DB14/T 2542—2022 前 言 本文件按照 GB/T 1.1—2020《标准化工作导则 第 1 部分：标准化文件的结构和起草规则》的规 定起草。 本文件由山西省财政厅提出、组织实施和监督检查。 本文件由山西省市场监督管理局对标准的组织实施情况进行监督检查。 本文件由山西省财政标准化技术委员会（SXS/TC48）归口。 本文件起草单位：山西省财政科学研究院、山西省大众科技评估中心。 本文件主要起草人：薛兆军、韩慧彦、李林骏、张维华、司文。 II DB14/T 2542—2022 预算管理一体化系统会计核算软件接口规范 1 范围 本文件规定了预算管理一体化系统会计核算软件标准的基本要求、接口组成、接口要求、接口安全 等。 本文件适用于全省预算管理一体化系统开发和建设。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 《国库集中支付电子化管理接口报文规范（2017）》财政部，2017。 《财政业务基础数据规范（3.0 版）》财政部，2019 年 1 月。 《财政信息化三年重点工作规划》财政部，2019 年 7 月。 《财政核心业务一体化系统实施方案》财政部，2019 年 7 月。 《财政核心业务一体化管理规范》财政部，2019 年 10 月。 《财政核心业务管理要素目录》财政部，2019 年 10 月。 3 术语和定义 下列术语和定义适用于本文件。 3.1 服务 对外提供能被服务请求者系统访问到的接口称为“服务”。 3.2 业务活动 财政核心业务一体化系统中支撑业务管理活动的基本用户操作和系统功能。 3.3 业务实体 财政核心业务一体化系统中业务活动产生或处理的数据对象。 3.4 业务要素 财政核心业务一体化系统中构成业务实体的基本数据单元。 3.5 逻辑库表 对业务规范进行分析，设计财政核心业务一体化系统数据库的逻辑结构，形成含字段、类型、长度 等属性的库表，反映财政核心业务内在逻辑。 1 DB14/T 2542—2022 3.6 逻辑库表要素 逻辑库表的基本单元，规定了逻辑库表字段的类型、长度、值域、字段说明、参考来源等信息。 3.7 代码集 能够完整表达逻辑库表要素全部值的集合。 3.8 报文 数据交互传输中记录的日志文件。 3.9 类型说明 符号 说明 String 表示包含 x-字符集组成的字符串，如：PbcGkjCfcc NString 表示由数字[0-9]组成的字符串，如：000045 GBString 表示包含中文字符集组成的字符串，报文规范中的长度定义以字节为单位，如：人民银行 Currency 4 表示金额，符号位可选，单位为元，整数部分最长 18 位，小数部分固定两位，不能包含逗号等分隔符， 如：8979.05 Integer 表示整数，符号位可选，数值部分最长 8 位，如：88888 Date 表示日期，格式为 yyyymmdd（年月日）。如：20050611 DateTime 表示日期时间，格式为 yyyymmddhhmmss（年月日时分秒）。如：20050611112739 Decimal 表示金额以外的浮点型数字，如面积、分成比例等。不能包含逗号等分隔符，如：12.053 Binary 二进制数据类型 缩略语 下列缩略语适用于本文件。 FTP：文件传输协议（File Transfer Protocol）。 XML：可扩展的标记语言，广泛应用于系统间的信息交互（Extensible Markup Language）。 SSL：带安全的套接层（Secure Sockets Layer）。 HTTP：超文本传输协议。HTTP 底层是基于 TCP/IP 协议（Hypertext Transfer Protocol）。 HTTPS：基于 SSL 的 HTTP 协议。 5 基本要求 5.1 应用接入方 应满足以下要求： a) 在财政内网统一布署集中版的财务核算软件； 2 DB14/T 2542—2022 b) c) d) 按需申请接入； 按照本文件要求使用接口服务； 协调所选取的业务应用系统及服务提供方与预算管理一体化会计核算平台运营方的对接工作。 5.2 接口提供方 应满足以下要求： a) 确保开放的接口不影响平台的正常运行； b) 对业务应用系统及服务的接入制定相应的安全策略，并确保正常执行； c) 对业务应用系统及服务的接入进行审批和管理； d) 协助预算管理一体化会计核算平台运营方安排专人负责接入应用的日常管理。 5.3 平台运营方 应满足以下要求： a) 按照规范性文件等的要求定义及开发接口； b) 负责应用接口的维护更新与缺陷修正，并为系统接入方提供技术支持。 6 接口组成 6.1 账套信息提取 6.1.1 接口描述 预算单位财务核算软件通过单位账套代码从财政核心业务一体化系统提取已经设置的账套信息。业 务场景描述：初始建立账套时，预算单位将账套信息从数据中心读取到预算单位会计核算系统中。 6.1.2 请求 URL GET /gla/v2/cloud/{MOFDIVS}/{FISYEAR}/{APPID}/account/read?TOKEN= 6.1.3 请求参数 表1 请求参数表 序号 字段名称 中文名称 类型 长度 强制/可选 1 AGENCY_CODE 单位代码 NString 21 M 2 ACCT_SET_CODE 账套编号 String 38 M 3 CHECK_CODE 验证码 GBString 10 M 备注 输入的是显示编号 从财政核心业务一体化 系统提取验证码 6.1.4 响应参数 对象名称:GLA_ACCT_SET 3 DB14/T 2542—2022 表2 响应参数表 序号 字段名称 中文名称 类型 长度 强制/可选 备注 1 ACCT_SET_ID 账套唯一标识 String 38 M 主键 2 ACCT_SET_CODE 账套编码 String 38 M 存储账套编码 3 ACCT_SET_NAME 账套名称 GBString 100 M 存储账套名称 4 ACCT_SET_TYPE 账套类型 String 38 M 存储账套类型 5 MOF_DIV_CODE 财政区划代码 NString 9 M 存储财政区划代码 6 AGENCY_CODE 单位代码 NString 21 M 存储单位代码 7 SET_YEAR 会计年度 NString 4 M 存储会计年度 8 START_DATE 启用日期 Date 19 M 账套启用日期 yyyymmdd 9 CREATE_USER 创建人 GBString 60 M 账套创建人 10 IS_ENABLED 账套状态 Integer 1 M 11 FI_LEADER 财务负责人 GBString 60 M 12 UPDATE_TIME 更新时间 DateTime 13 IS_DELETED 是否删除 Integer 1 M 14 ACCT_VIEW_CODE 账套显示代码 String 38 M 15 IS_STANDARD 是否标准账套 Integer 1 M 是否标准账套 16 ACCT_SET_PIN 验证码 NString 10 O 验证码 0 停用 1 启用 单位财务负责人 M 1 删除 2 正常 显示给用户的编码，层级 流水号 6.2 标准科目信息提取 6.2.1 接口描述 6.2.1.1 预算单位财务核算软件通过单位账套属性从财政核心业务一体化系统提取已经设置的标准科 目信息。 业务场景描述：根据预算单位在数据中心注册的账套属性，将科目信息从数据中心读取到会 计核算系统中且预算单位会计核算系统中不可以变更账套属性，如需变更需在数据中心变更后再同步到 单位会计核算系统。 6.2.1.2 预算单位财务核算软件通过单位代码和账套代码等