DB14/T 2542-2022 预算管理一体化系统会计核算软件接口规范

ICS35.080

CCSL77

14

山西省地方标准

DB14/T2542—2022

预算管理一体化系统会计核算软件

接口规范

2022-09-02发布2022-12-01实施

山西省市场监督管理局  发布

DB14/T2542—2022

目次

前言II

1范围1

2规范性引用文件1

3术语和定义1

4缩略语2

5基本要求2

6接口组成3

7接口要求46

8接口安全47

I

DB14/T2542—2022

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规

定起草。

本文件由山西省财政厅提出、组织实施和监督检查。

本文件由山西省市场监督管理局对标准的组织实施情况进行监督检查。

本文件由山西省财政标准化技术委员会（SXS/TC48）归口。

本文件起草单位：山西省财政科学研究院、山西省大众科技评估中心。

本文件主要起草人：薛兆军、韩慧彦、李林骏、张维华、司文。

II

DB14/T2542—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/T2542—2022

3.6

逻辑库表要素

逻辑库表的基本单元，规定了逻辑库表字段的类型、长度、值域、字段说明、参考来源等信息。

3.7

代码集

能够完整表达逻辑库表要素全部值的集合。

3.8

报文

数据交互传输中记录的日志文件。

3.9

类型说明

符号说明

String表示包含x-字符集组成的字符串，如：PbcGkjCfcc

NString表示由数字[0-9]组成的字符串，如：000045

GBString表示包含中文字符集组成的字符串，报文规范中的长度定义以字节为单位，如：人民银行

表示金额，符号位可选，单位为元，整数部分最长18位，小数部分固定两位，不能包含逗号等分隔符，

Currency

如：8979.05

Integer表示整数，符号位可选，数值部分最长8位，如：88888

Date表示日期，格式为yyyymmdd（年月日）。如：20050611

DateTime表示日期时间，格式为yyyymmddhhmmss（年月日时分秒）。如：20050611112739

Decimal表示金额以外的浮点型数字，如面积、分成比例等。不能包含逗号等分隔符，如：12.053

Binary二进制数据类型

4缩略语

下列缩略语适用于本文件。

FTP：文件传输协议（FileTransferProtocol）。

XML：可扩展的标记语言，广泛应用于系统间的信息交互（ExtensibleMarkupLanguage）。

SSL：带安全的套接层（SecureSocketsLayer）。

HTTP：超文本传输协议。HTTP底层是基于TCP/IP协议（HypertextTransferProtocol）。

HTTPS：基于SSL的HTTP协议。

5基本要求

5.1应用接入方

应满足以下要求：

a)在财政内网统一布署集中版的财务核算软件；

2

DB14/T2542—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请求参数表

序号字段名称中文名称类型长度强制/可选备注

1AGENCY_CODE单位代码NString21M

2ACCT_SET_CODE账套编号String38M输入的是显示编号

从财政核心业务一体化

3CHECK_CODE验证码GBString10M

系统提取验证码

6.1.4响应参数

对象名称:GLA_ACCT_SET

3

DB14/T2542—2022

表2响应参数表

序号字段名称中文名称类型长度强制/可选备注

1ACCT_SET_ID账套唯一标识String38M主键

2ACCT_SET_CODE账套编码String38M存储账套编码

3ACCT_SET_NAME账套名称GBString100M存储账套名称

4ACCT_SET_TYPE账套类型String38M存储账套类型

5MOF_DIV_CODE财政区划代码NString9M存储财政区划代码

6AGENCY_CODE单位代码NString21M存储单位代码

7SET_YEAR会计年度NString4M存储会计年度

8START_DATE启用日期Date19M账套启用日期yyyymmdd

9CREATE_USER创建人GBString60M账套创建人

0停用

10IS_ENABLED账套状态Integer1M

1启用

11FI_LEADER财务负责人GBString60M单位财务负责人

12UPDATE_TIME更新时间DateTimeM

1删除

13IS_DELETED是否删除Integer1M

2正常

显示给用户的编码，层级

14ACCT_VIEW_CODE账套显示代码String38M

流水号

15IS_STANDARD是否标准账套Integer1M是否标准账套

16ACCT_SET_PIN验证码NString10O验证码

6.2标准科目信息提取

6.2.1接口描述

预算单位财务核算软件通过单位账套属性从财政核心业务一体化系统提取已经设置的标准科

目信息。

业务场景描述：根据预算单位在数据中心注册的账套属性，将科目信息从数据中心读取到会

计核算系统中且预算单位会计核算系统中不可以变更账套属性，如需变更需在数据中心变更后再同步到

单位会计核算系统。

预算单位财务核算软件通过单位代码和账套代码等信息从财政预算管理一体化系统提取已经

设置的标准科目信息。每个账套及单位都需要单独提取一次，且需要把提取下来的科目信息ID保存，

并作为以后操作该条科目信息的唯一ID。

4

DB14/T2542—2022

业务场景描述：根据预算单位在数据中心注册的账套属性，数据中心自动把标准科目引入到

该账套中，然后通过数据接口把该账套的标准科目返回到单位核算系统中。

6.2.2请求URL

GET/gla/v2/cloud/{MOFDIVS}/{FISYEAR}/{APPID}/subject/read?TOKEN=

6.2.3请求参数

表3请求参数表

强制/可

序号字段名称中文名称类型长度备注

选

1AGENCY_CODE单位代码NString21M

2ACCT_SET_CODE账套编号String38M

从财政核心业务一体化系

3CHECK_CODE验证码GBString10M

统提取验证码

6.2.4响应参数

对象名称:GLA_ACCOUNT_CLS

表4响应参数表

序号字段名称中文名称类型长度强制/可选备注

科目唯一标

1ACCOUNT_CLS_IDString38M主键

识

财政区划代

2MOF_DIV_CODENString9M存储财政区划代码

码

3ACCT_SET_CODE账套编号String38M存储账套编号

4SET_YEAR会计年度NString4M存储会计年度

5AGENCY_CODE单位代码NString21M存储单位代码

单位会计科

6GOV_ACCT_CLS_CODENString30M存储单位会计科目代码

目代码

单位会计科

7GOV_ACCT_CLS_NAMEGBString90M存储单位会计科目名称

目名称

父级唯一标

8PARENT_IDString38M存储该科目父级唯一标识

识

9LEVEL_NO级次Integer2M该科目的级次

0非末级

10IS_LEAF是否末级Integer1M

1末级

11IS_ENABLED是否启用Integer1M0停用

5

DB14/T2542—2022

序号字段名称中文名称类型长度强制/可选备注

1启用

12BALANCE_DIR余额方向Integer1M科目余额方向

序号字段名称中文名称类型长度强制/可选备注

GOV_ACCT_CLS_ENUM_单位会计科

13NString1M存储单位会计科目类型代码

CODE目类型代码

执行会计制

14EXECUTIVE_ACCNString10M执行的会计制度类型

度类型

15AGENCY_TYPE_CODE单位类型NString3M单位类型

16CURRENCY_CODE币种代码String3O币种代码（RMB、USD等）

是否外币核

17IS_CURInteger1M0否1是

算

是否数量核

18IS_QTYInteger1M0否1是

算

19UPDATE_TIME更新时间DateTimeM

1删除

20IS_DELETED是否删除Integer1M

2正常

对象名称:GLA_CLS_AUX_RELATION

表5响应参数表

序号字段名称中文名称类型长度强制/可选备注

关联表唯一

1REL_IDString38M主键

标识

财政区划代

2MOF_DIV_CODENString9M

码

3SET_YEAR会计年度NString4M

4ACCT_SET_CODE账套编号String38M存储账套编号

5AGENCY_CODE单位代码NString21M存储单位代码

单位会计科

6GOV_ACCT_CLS_CODNString30M存储单位会计科目代码

目代码

会计科目辅助核算凭证分录辅

7AUX_TYPE辅助类型NString1M

助核算

8AUX_ID辅助核算IDString38M

辅助核算代

9AUX_CODEString10M

码

6

DB14/T2542—2022

序号字段名称中文名称类型长度强制/可选备注

1是

10IS_MUST是否必输Integer1M

0否

11DEFAULT_CODE默认值String30O

12CREATE_TIME创建时间DateTimeM

13UPDATE_TIME更新时间DateTimeM

1删除

14IS_DELETED是否删除Integer1M

2正常

6.3凭证分录辅助核算控制要素提取

6.3.1接口描述

预算单位财务核算软件从财政核心业务一体化系统提取会计凭证分录辅助核算控制信息。

业务场景描述：单位核算系统从数据中心获取所有的辅助核算控制要素，辅助核算控制信息

分三类，一类是公用辅助核算（不允许对数据值进行扩展），一类是专用台账，一类是公用+扩展，即

系统中一共设置了多少本辅助核算台账。

6.3.2请求URL

GET/gla/v2/cloud/{MOFDIVS}/{FISYEAR}/{APPID}/auxiliary/control?TOKEN=

6.3.3请求参数

表6请求参数表

序号字段名称中文名称类型长度强制/可选备注

1AGENCY_CODE单位代码NString21M

ACCT_SET

2账套编号String38M

_CODE

从财政核心业务一体化系统

3CHECK_CODE验证码GBString10M

提取验证码

6.3.4响应参数

对象名称:GLA_VOU_AUX_CONTROL

表7响应参数表

序号字段名称中文名称类型长度强制/可选备注

1VOU_AUX_ID辅助核算IDString38M主键

7

DB14/T2542—2022

序号字段名称中文名称类型长度强制/可选备注

2VOU_AUX_CODE辅助核算代码String30M辅助核算代码.

3VOU_AUX_NAME辅助核算名称GBString360M

辅助核算信息在凭证分录及

4VOU_FIELD_NAME凭证字段名称GBString30M

余额汇总表中的字段名称

V参数表选择

D日期选择

5VOU_FIELD_TYPE凭证字段类型String1M

S输入字符

N输入数字

6AUX_ELE_SOURCE辅助核算值集表名GBString30M

辅助核算类型

0.所有账套统一使用、

7AUX_ELE_TYPE辅助核算值集类型NString10M1.各账套分别设置、

2.财政统一设置，允许各账套

在指定级次扩展

允许扩展的要素代

8AUX_EXT_CODEString300O多个逗号（,）分隔。

码

级次设置格式

9AUX_CODE_LEVEL辅助核算代码级次NString10M例：322。表示一级3位，二

级2位，3级2位。

对应核算核算值集表中的代

10ELE_CODE_FIELD值集代码字段GBString30M

码字段

对应核算核算值集表中的名

11ELE_NAME_FIELD值集名称字段GBString30M

称字段

对应核算核算值集表中的关

12ELE_KEY_FIELD值集关键值字段GBString30M键字段，存放与凭证分录及余

额中。

财政厅设置下发时为空，可以

13MOF_DIV_CODE财政区划代码NString9O

按级次增加，下级使用。

存储会计年度.会计年度空表

14SET_YEAR会计年度NString4O

示所有年度通用

15START_DATE启用日期DateM启用日期yyyymmdd

16END_DATE停用日期DateM结束日期yyyymmdd

17UPDATE_TIME更新时间DateTimeM维护本条信息项的更新时间

8

DB14/T2542—2022

序号字段名称中文名称类型