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

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

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

1删除

18IS_DELETED是否删除Integer1M

2正常

19IS_STANDARD是否标准台账Integer1M是否标准台账

6.4凭证分录辅助核算要素数据值集提取

6.4.1接口描述

预算单位财务核算软件通过辅助核算代码从财政核心业务一体化系统提取会计凭证分录辅助

核算要素。

业务场景描述：预算单位从数据中心读取凭证分录的各项辅助核算对应要素表信息。即预算

单位财务核算软件从数据中心获取每一本辅助核算台账包括的要素值集。

6.4.2请求URL

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

6.4.3请求参数

表8请求参数表

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

1AGENCY_CODE单位代码NString21M

2ACCT_SET_CODE账套编号String38M

从财政核心业务一体化

3CHECK_CODE验证码GBString10M

系统提取验证码

4VOU_AUX_ID辅助核算设置信息IDString38M主键

5VOU_AUX_CODE辅助核算设置信息代码String30M

6.4.4响应参数

对象名称:GLA_VOU_AUX_ELEMENT

表9响应参数表

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

1ELE_ID辅助核算要素值IDString38M主键

2ELE_CODE辅助核算要素代码NString9M

9

DB14/T2542—2022

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

3ELE_NAME辅助核算要素代码GBString360M

地方财政扩展时有值，财

4MOF_DIV_CODE财政区划代码NString9O

政厅下发时为空

存储账套编号，账套编号

5ACCT_SET_CODE账套编号String38O

空表示所有账套通用

存储会计年度.会计年度

6SET_YEAR会计年度NString4O

空表示所有年度通用

7START_DATE启用日期DateM启用日期yyyymmdd

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

9PARENT_ID父级节点IDString38M父级信息项ID

10PARENT_CODE父级节点CODENString38M父级信息项CODE

11LEVEL_NO级次Integer2M当前信息项级次

当前信息项是否为末级

12IS_LEAF是否末级Integer1M

节点

13IS_ENABLED是否启用Integer1M是否启用

14VOU_AUX_CODE辅助核算代码String1M

维护本条信息项的更新

15UPDATE_TIME更新时间DateTimeM

时间

1删除

16IS_DELETED是否删除Integer1M

2正常

17IS_STANDARD是否标准台账Integer1M

IS_CAPTIAL_CONS_

18是否基建Integer1M1是，2否

PRO

19PRO_KIND_CODE项目类别NString2M有值下发，无值时为空

FUND_TRAOBJ_TYPE

20资金往来对象类别NString2M有值下发，无值时为空

_CODE

6.5科目辅助信息提取

6.5.1接口描述

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

10

DB14/T2542—2022

业务场景描述：预算单位从数据中心读取科目辅助核算参数总表。

科目辅助信息目前主要适用于银行存款类科目，用于标注银行存款类科目的辅助信息，如开

户银行、账户类别等。

6.5.2请求URL

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

6.5.3请求参数

表10请求参数表

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

1AGENCY_CODE单位代码NString21M

ACCT_SET_COD

2账套编号String38M

E

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

3CHECK_CODE验证码GBString10M

提取验证码

6.5.4响应参数

对象名称:GLA_CLS_AUX_CONTROL

表11响应参数表

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

1CLS_AUX_ID辅助核算IDString38M主键

2CLS_AUX_CODE辅助核算代码String30M

3CLS_AUX_NAME辅助核算名称GBString360M

辅助核算信息在凭证分

4CLS_FIELD_NAME凭证字段名称GBString30M录及余额汇总表中的字

段名称

V参数表选择

D日期选择

5CLS_FIELD_TYPE辅助核算字段类型String1M

S输入字符

N输入数字

6AUX_ELE_SOURCE辅助核算值集表名GBString30M

台账类型

7AUX_ELE_TYPE辅助核算值集类型NString10M0.所有账套统一使用、

1.各账套分别设置、

11

DB14/T2542—2022

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