DB14-T2542-2022預算管理一體化系統(tǒng)會計核算軟件接口規(guī)范

DB14/T2542—2022

預算管理一體化系統(tǒng)會計核算軟件接口規(guī)范

1范圍

本文件規(guī)定了預算管理一體化系統(tǒng)會計核算軟件標準的基本要求、接口組成、接口要求、接口安全

等。

本文件適用于全省預算管理一體化系統(tǒng)開發(fā)和建設。

2規(guī)范性引用文件

下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，

僅該日期對應的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本

文件。

《國庫集中支付電子化管理接口報文規(guī)范（2017）》財政部，2017。

《財政業(yè)務基礎數(shù)據(jù)規(guī)范（3.0版）》財政部，2019年1月。

《財政信息化三年重點工作規(guī)劃》財政部，2019年7月。

《財政核心業(yè)務一體化系統(tǒng)實施方案》財政部，2019年7月。

《財政核心業(yè)務一體化管理規(guī)范》財政部，2019年10月。

《財政核心業(yè)務管理要素目錄》財政部，2019年10月。

3術語和定義

下列術語和定義適用于本文件。

3.1

服務

對外提供能被服務請求者系統(tǒng)訪問到的接口稱為“服務”。

3.2

業(yè)務活動

財政核心業(yè)務一體化系統(tǒng)中支撐業(yè)務管理活動的基本用戶操作和系統(tǒng)功能。

3.3

業(yè)務實體

財政核心業(yè)務一體化系統(tǒng)中業(yè)務活動產(chǎn)生或處理的數(shù)據(jù)對象。

3.4

業(yè)務要素

財政核心業(yè)務一體化系統(tǒng)中構(gòu)成業(yè)務實體的基本數(shù)據(jù)單元。

3.5

邏輯庫表

對業(yè)務規(guī)范進行分析，設計財政核心業(yè)務一體化系統(tǒng)數(shù)據(jù)庫的邏輯結(jié)構(gòu)，形成含字段、類型、長度

等屬性的庫表，反映財政核心業(yè)務內(nèi)在邏輯。

1

DB14/T2542—2022

3.6

邏輯庫表要素

邏輯庫表的基本單元，規(guī)定了邏輯庫表字段的類型、長度、值域、字段說明、參考來源等信息。

3.7

代碼集

能夠完整表達邏輯庫表要素全部值的集合。

3.8

報文

數(shù)據(jù)交互傳輸中記錄的日志文件。

3.9

類型說明

符號說明

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

NString表示由數(shù)字[0-9]組成的字符串，如：000045

GBString表示包含中文字符集組成的字符串，報文規(guī)范中的長度定義以字節(jié)為單位，如：人民銀行

表示金額，符號位可選，單位為元，整數(shù)部分最長18位，小數(shù)部分固定兩位，不能包含逗號等分隔符，

Currency

如：8979.05

Integer表示整數(shù)，符號位可選，數(shù)值部分最長8位，如：88888

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

DateTime表示日期時間，格式為yyyymmddhhmmss（年月日時分秒）。如：20050611112739

Decimal表示金額以外的浮點型數(shù)字，如面積、分成比例等。不能包含逗號等分隔符，如：12.053

Binary二進制數(shù)據(jù)類型

4縮略語

下列縮略語適用于本文件。

FTP：文件傳輸協(xié)議（FileTransferProtocol）。

XML：可擴展的標記語言，廣泛應用于系統(tǒng)間的信息交互（ExtensibleMarkupLanguage）。

SSL：帶安全的套接層（SecureSocketsLayer）。

HTTP：超文本傳輸協(xié)議。HTTP底層是基于TCP/IP協(xié)議（HypertextTransferProtocol）。

HTTPS：基于SSL的HTTP協(xié)議。

5基本要求

5.1應用接入方

應滿足以下要求：

a)在財政內(nèi)網(wǎng)統(tǒng)一布署集中版的財務核算軟件；

2

DB14/T2542—2022

b)按需申請接入；

c)按照本文件要求使用接口服務；

d)協(xié)調(diào)所選取的業(yè)務應用系統(tǒng)及服務提供方與預算管理一體化會計核算平臺運營方的對接工作。

5.2接口提供方

應滿足以下要求：

a)確保開放的接口不影響平臺的正常運行；

b)對業(yè)務應用系統(tǒng)及服務的接入制定相應的安全策略，并確保正常執(zhí)行；

c)對業(yè)務應用系統(tǒng)及服務的接入進行審批和管理；

d)協(xié)助預算管理一體化會計核算平臺運營方安排專人負責接入應用的日常管理。

5.3平臺運營方

應滿足以下要求：

a)按照規(guī)范性文件等的要求定義及開發(fā)接口；

b)負責應用接口的維護更新與缺陷修正，并為系統(tǒng)接入方提供技術支持。

6接口組成

6.1賬套信息提取

6.1.1接口描述

預算單位財務核算軟件通過單位賬套代碼從財政核心業(yè)務一體化系統(tǒng)提取已經(jīng)設置的賬套信息。業(yè)

務場景描述：初始建立賬套時，預算單位將賬套信息從數(shù)據(jù)中心讀取到預算單位會計核算系統(tǒng)中。

6.1.2請求URL

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

6.1.3請求參數(shù)

表1請求參數(shù)表

序號字段名稱中文名稱類型長度強制/可選備注

1AGENCY_CODE單位代碼NString21M

2ACCT_SET_CODE賬套編號String38M輸入的是顯示編號

從財政核心業(yè)務一體化

3CHECK_CODE驗證碼GBString10M

系統(tǒng)提取驗證碼

6.1.4響應參數(shù)

對象名稱:GLA_ACCT_SET

3

DB14/T2542—2022

表2響應參數(shù)表

序號字段名稱中文名稱類型長度強制/可選備注

1ACCT_SET_ID賬套唯一標識String38M主鍵

2ACCT_SET_CODE賬套編碼String38M存儲賬套編碼

3ACCT_SET_NAME賬套名稱GBString100M存儲賬套名稱

4ACCT_SET_TYPE賬套類型String38M存儲賬套類型

5MOF_DIV_CODE財政區(qū)劃代碼NString9M存儲財政區(qū)劃代碼

6AGENCY_CODE單位代碼NString21M存儲單位代碼

7SET_YEAR會計年度NString4M存儲會計年度

8START_DATE啟用日期Date19M賬套啟用日期yyyymmdd

9CREATE_USER創(chuàng)建人GBString60M賬套創(chuàng)建人

0停用

10IS_ENABLED賬套狀態(tài)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接口描述

預算單位財務核算軟件通過單位賬套屬性從財政核心業(yè)務一體化系統(tǒng)提取已經(jīng)設置的標準科

目信息。

業(yè)務場景描述：根據(jù)預算單位在數(shù)據(jù)中心注冊的賬套屬性，將科目信息從數(shù)據(jù)中心讀取到會

計核算系統(tǒng)中且預算單位會計核算系統(tǒng)中不可以變更賬套屬性，如需變更需在數(shù)據(jù)中心變更后再同步到

單位會計核算系統(tǒng)。

預算單位財務核算軟件通過單位代碼和賬套代碼等信息從財政預算管理一體化系統(tǒng)提取已經(jīng)

設置的標準科目信息。每個賬套及單位都需要單獨提取一次，且需要把提取下來的科目信息ID保存，

并作為以后操作該條科目信息的唯一ID。

4

DB14/T2542—2022

業(yè)務場景描述：根據(jù)預算單位在數(shù)據(jù)中心注冊的賬套屬性，數(shù)據(jù)中心自動把標準科目引入到

該賬套中，然后通過數(shù)據(jù)接口把該賬套的標準科目返回到單位核算系統(tǒng)中。

6.2.2請求URL

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

6.2.3請求參數(shù)

表3請求參數(shù)表

強制/可

序號字段名稱中文名稱類型長度備注

選

1AGENCY_CODE單位代碼NString21M

2ACCT_SET_CODE賬套編號String38M

從財政核心業(yè)務一體化系

3CHECK_CODE驗證碼GBString10M

統(tǒng)提取驗證碼

6.2.4響應參數(shù)

對象名稱:GLA_ACCOUNT_CLS

表4響應參數(shù)表

序號字段名稱中文名稱類型長度強制/可選備注

科目唯一標

1ACCOUNT_CLS_IDString38M主鍵

識

財政區(qū)劃代

2MOF_DIV_CODENString9M存儲財政區(qū)劃代碼

碼

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目類型代碼

執(zhí)行會計制

14EXECUTIVE_ACCNString10M執(zhí)行的會計制度類型

度類型

15AGENCY_TYPE_CODE單位類型NString3M單位類型

16CURRENCY_CODE幣種代碼String3O幣種代碼（RMB、USD等）

是否外幣核

17IS_CURInteger1M0否1是

算

是否數(shù)量核

18IS_QTYInteger1M0否1是

算

19UPDATE_TIME更新時間DateTimeM

1刪除

20IS_DELETED是否刪除Integer1M

2正常

對象名稱:GLA_CLS_AUX_RELATION

表5響應參數(shù)表

序號字段名稱中文名稱類型長度強制/可選備注

關聯(lián)表唯一

1REL_IDString38M主鍵

標識

財政區(qū)劃代

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創(chuàng)建時間DateTimeM

13UPDATE_TIME更新時間DateTimeM

1刪除

14IS_DELETED是否刪除Integer1M

2正常

6.3憑證分錄輔助核算控制要素提取

6.3.1接口描述

預算單位財務核算軟件從財政核心業(yè)務一體化系統(tǒng)提取會計憑證分錄輔助核算控制信息。

業(yè)務場景描述：單位核算系統(tǒng)從數(shù)據(jù)中心獲取所有的輔助核算控制要素，輔助核算控制信息

分三類，一類是公用輔助核算（不允許對數(shù)據(jù)值進行擴展），一類是專用臺賬，一類是公用+擴展，即

系統(tǒng)中一共設置了多少本輔助核算臺賬。

6.3.2請求URL

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

6.3.3請求參數(shù)

表6請求參數(shù)表

序號字段名稱中文名稱類型長度強制/可選備注

1AGENCY_CODE單位代碼NString21M

ACCT_SET

2賬套編號String38M

_CODE

從財政核心業(yè)務一體化系統(tǒng)

3CHECK_CODE驗證碼GBString10M

提取驗證碼

6.3.4響應參數(shù)

對象名稱:GLA_VOU_AUX_CONTROL

表7響應參數(shù)表

序號字段名稱中文名稱類型長度強制/可選備注

1VOU_AUX_ID輔助核算IDString38M主鍵

7

DB14/T2542—2022

序號字段名稱中文名稱類型長度強制/可選備注

2VOU_AUX_CODE輔助核算代碼String30M輔助核算代碼.

3VOU_AUX_NAME輔助核算名稱GBString360M

輔助核算信息在憑證分錄及

4VOU_FIELD_NAME憑證字段名稱GBString30M

余額匯總表中的字段名稱

V參數(shù)表選擇

D日期選擇

5VOU_FIELD_TYPE憑證字段類型String1M

S輸入字符

N輸入數(shù)字

6AUX_ELE_SOURCE輔助核算值集表名GBString30M

輔助核算類型

0.所有賬套統(tǒng)一使用、

7AUX_ELE_TYPE輔助核算值集類型NString10M1.各賬套分別設置、

2.財政統(tǒng)一設置，允許各賬套

在指定級次擴展

允許擴展的要素代

8AUX_EXT_CODEString300O多個逗號（,）分隔。

碼

級次設置格式

9AUX_CODE_LEVEL輔助核算代碼級次NString10M例：322。表示一級3位，二

級2位，3級2位。

對應核算核算值集表中的代

10ELE_CODE_FIELD值集代碼字段GBString30M

碼字段

對應核算核算值集表中的名

11ELE_NAME_FIELD值集名稱字段GBString30M

稱字段

對應核算核算值集表中的關

12ELE_KEY_FIELD值集關鍵值字段GBString30M鍵字段，存放與憑證分錄及余

額中。

財政廳設置下發(fā)時為空，可以

13MOF_DIV_CODE財政區(qū)劃代碼NString9O

按級次增加，下級使用。

存儲會計年度.會計年度空表

14SET_YEAR會計年度NString4O

示所有年度通用

15START_DATE啟用日期DateM啟用日期yyyymmdd

16END_DATE停用日期DateM結(jié)束日期yyyymmdd

17UPDATE_TIME更新時間DateTimeM維護本條信息項的更新時間

8

DB14/T2542—2022

序號字段名稱中文名稱類型長度強制/可選備注

1刪除

18IS_DELETED是否刪除Integer1M

2正常

19IS_STANDARD是否標準臺賬Integer1M是否標準臺賬

6.4憑證分錄輔助核算要素數(shù)據(jù)值集提取

6.4.1接口描述

預算單位財務核算軟件通過輔助核算代碼從財政核心業(yè)務一體化系統(tǒng)提取會計憑證分錄輔助

核算要素。

業(yè)務場景描述：預算單位從數(shù)據(jù)中心讀取憑證分錄的各項輔助核算對應要素表信息。即預算

單位財務核算軟件從數(shù)據(jù)中心獲取每一本輔助核算臺賬包括的要素值集。

6.4.2請求URL

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

6.4.3請求參數(shù)

表8請求參數(shù)表

序號字段名稱中文名稱類型長度強制/可選備注

1AGENCY_CODE單位代碼NString21M

2ACCT_SET_CODE賬套編號String38M

從財政核心業(yè)務一體化

3CHECK_CODE驗證碼GBString10M

系統(tǒng)提取驗證碼

4VOU_AUX_ID輔助核算設置信息IDString38M主鍵

5VOU_AUX_CODE輔助核算設置信息代碼String30M

6.4.4響應參數(shù)

對象名稱:GLA_VOU_AUX_ELEMENT

表9響應參數(shù)表

序號字段名稱中文名稱類型長度強制/可選備注

1ELE_ID輔助核算要素值IDString38M主鍵

2ELE_CODE輔助核算要素代碼NString9M

9

DB14/T2542—2022

序號字段名稱中文名稱類型長度強制/可選備注

3ELE_NAME輔助核算要素代碼GBString360M

地方財政擴展時有值，財

4MOF_DIV_CODE財政區(qū)劃代碼NString9O

政廳下發(fā)時為空

存儲賬套編號，賬套編號

5ACCT_SET_CODE賬套編號String38O

空表示所有賬套通用

存儲會計年度.會計年度

6SET_YEAR會計年度NString4O

空表示所有年度通用

7START_DATE啟用日期DateM啟用日期yyyymmdd

8END_DATE停用日期DateM結(jié)束日期yyyymmdd

9PARENT_ID父級節(jié)點IDString38M父級信息項ID

10PARENT_CODE父級節(jié)點CODENString38M父級信息項CODE

11LEVEL_NO級次Integer2M當前信息項級次

當前信息項是否為末級

12IS_LEAF是否末級Integer1M

節(jié)點

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有值下發(fā)，無值時為空

FUND_TRAOBJ_TYPE

20資金往來對象類別NString2M有值下發(fā)，無值時為空

_CODE

6.5科目輔助信息提取

6.5.1接口描述

預算單位財務核算軟件從財政核心業(yè)務一體化系統(tǒng)提取會計科目輔助核算控制信息。

10

DB14/T2542—2022

業(yè)務場景描述：預算單位從數(shù)據(jù)中心讀取科目輔助核算參數(shù)總表。

科目輔助信息目前主要適用于銀行存款類科目，用于標注銀行存款類科目的輔助信息，如開

戶銀行、賬戶類別等。

6.5.2請求URL

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

6.5.3請求參數(shù)

表10請求參數(shù)表

序號字段名稱中文名稱類型長度強制/可選備注

1AGENCY_CODE單位代碼NString21M

ACCT_SET_COD

2賬套編號String38M

E

從財政核心業(yè)務一體化系統(tǒng)

3CHECK_CODE驗證碼GBString10M

提取驗證碼

6.5.4響應參數(shù)

對象名稱:GLA_CLS_AUX_CONTROL

表11響應參數(shù)表

序號字段名稱中文名稱類型長度強制/可選備注

1CLS_AUX_ID輔助核算IDString38M主鍵

2CLS_AUX_CODE輔助核算代碼String30M

3CLS_AUX_NAME輔助核算名稱GBString360M

輔助核算信息在憑證分

4CLS_FIELD_NAME憑證字段名稱GBString30M錄及余額匯總表中的字

段名稱

V參數(shù)表選擇

D日期選擇

5CLS_FIELD_TYPE輔助核算字段類型String1M

S輸入字符

N輸入數(shù)字

6AUX_ELE_SOURCE輔助核算值集表名GBString30M

臺賬類型

7AUX_ELE_TYPE輔助核算值集類型NString10M0.所有賬套統(tǒng)一使用、

1.各賬套分別設置、

11

DB14/T2542—2022

序號字段名稱中文名稱類型長度強制/可選備注