DB14_T 2542-2022 预算管理一体化系统会计核算软件接口规范.docx

《DB14_T 2542-2022 预算管理一体化系统会计核算软件接口规范.docx》由会员分享，可在线阅读，更多相关《DB14_T 2542-2022 预算管理一体化系统会计核算软件接口规范.docx（54页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、ICS35.080CCSL7714山西省地方标准DB14/T25422022预算管理一体化系统会计核算软件接口规范2022-09-02发布2022-12-01实施山西省市场监督管理局发布DB14/T25422022目次前言.II1范围.12规范性引用文件.13术语和定义.14缩略语.25基本要求.26接口组成.37接口要求.468接口安全.47IDB14/T25422022预算管理一体化系统会计核算软件接口规范1范围本文件规定了预算管理一体化系统会计核算软件标准的基本要求、接口组成、接口要求、接口安全等。本文件适用于全省预算管理一体化系统开发和建设。2规范性引用文件下列文件中的内容通过文中的规

2、范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。国库集中支付电子化管理接口报文规范（2017）财政部，2017。财政业务基础数据规范（3.0版）财政部，2019年1月。财政信息化三年重点工作规划财政部，2019年7月。财政核心业务一体化系统实施方案财政部，2019年7月。财政核心业务一体化管理规范财政部，2019年10月。财政核心业务管理要素目录财政部，2019年10月。3术语和定义下列术语和定义适用于本文件。3.1服务对外提供能被服务请求者系统访问到的接口称为“服务”。3.2业务活动财

3、政核心业务一体化系统中支撑业务管理活动的基本用户操作和系统功能。3.3业务实体财政核心业务一体化系统中业务活动产生或处理的数据对象。3.4业务要素财政核心业务一体化系统中构成业务实体的基本数据单元。3.5逻辑库表对业务规范进行分析，设计财政核心业务一体化系统数据库的逻辑结构，形成含字段、类型、长度等属性的库表，反映财政核心业务内在逻辑。1符号说明String表示包含x-字符集组成的字符串，如：PbcGkjCfccNString表示由数字0-9组成的字符串，如：000045GBString表示包含中文字符集组成的字符串，报文规范中的长度定义以字节为单位，如：人民银行Currency表示金额，符号

4、位可选，单位为元，整数部分最长18位，小数部分固定两位，不能包含逗号等分隔符，如：8979.05Integer表示整数，符号位可选，数值部分最长8位，如：88888Date表示日期，格式为yyyymmdd（年月日）。如：20050611DateTime表示日期时间，格式为yyyymmddhhmmss（年月日时分秒）。如：20050611112739Decimal表示金额以外的浮点型数字，如面积、分成比例等。不能包含逗号等分隔符，如：12.053Binary二进制数据类型DB14/T254220223.6逻辑库表要素逻辑库表的基本单元，规定了逻辑库表字段的类型、长度、值域、字段说明、参考来源等信

5、息。3.7代码集能够完整表达逻辑库表要素全部值的集合。3.8报文数据交互传输中记录的日志文件。3.9类型说明4缩略语下列缩略语适用于本文件。FTP：文件传输协议（FileTransferProtocol）。XML：可扩展的标记语言，广泛应用于系统间的信息交互（ExtensibleMarkupLanguage）。SSL：带安全的套接层（SecureSocketsLayer）。HTTP：超文本传输协议。HTTP底层是基于TCP/IP协议（HypertextTransferProtocol）。HTTPS：基于SSL的HTTP协议。5基本要求5.1应用接入方应满足以下要求：a)在财政内网统一布署集中版

6、的财务核算软件；2序号字段名称中文名称类型长度强制/可选备注1AGENCY_CODE单位代码NString21M2ACCT_SET_CODE账套编号String38M输入的是显示编号3CHECK_CODE验证码GBString10M从财政核心业务一体化系统提取验证码DB14/T25422022b)按需申请接入；c)按照本文件要求使用接口服务；d)协调所选取的业务应用系统及服务提供方与预算管理一体化会计核算平台运营方的对接工作。5.2接口提供方应满足以下要求：a)确保开放的接口不影响平台的正常运行；b)对业务应用系统及服务的接入制定相应的安全策略，并确保正常执行；c)对业务应用系统及服务的接入进

7、行审批和管理；d)协助预算管理一体化会计核算平台运营方安排专人负责接入应用的日常管理。5.3平台运营方应满足以下要求：a)按照规范性文件等的要求定义及开发接口；b)负责应用接口的维护更新与缺陷修正，并为系统接入方提供技术支持。6接口组成6.1账套信息提取6.1.1接口描述预算单位财务核算软件通过单位账套代码从财政核心业务一体化系统提取已经设置的账套信息。业务场景描述：初始建立账套时，预算单位将账套信息从数据中心读取到预算单位会计核算系统中。6.1.2请求URLGET/gla/v2/cloud/MOFDIVS/FISYEAR/APPID/account/read?TOKEN=6.1.3请求参数表

8、1请求参数表6.1.4响应参数对象名称:GLA_ACCT_SET3序号字段名称中文名称类型长度强制/可选备注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启用日期Date

9、19M账套启用日期yyyymmdd9CREATE_USER创建人GBString60M账套创建人10IS_ENABLED账套状态Integer1M0停用1启用11FI_LEADER财务负责人GBString60M单位财务负责人12UPDATE_TIME更新时间DateTimeM13IS_DELETED是否删除Integer1M1删除2正常14ACCT_VIEW_CODE账套显示代码String38M显示给用户的编码，层级流水号15IS_STANDARD是否标准账套Integer1M是否标准账套16ACCT_SET_PIN验证码NString10O验证码DB14/T25422022表2响应参数表

10、6.2标准科目信息提取6.2.1接口描述6.2.1.1预算单位财务核算软件通过单位账套属性从财政核心业务一体化系统提取已经设置的标准科目信息。6.2.1.2业务场景描述：根据预算单位在数据中心注册的账套属性，将科目信息从数据中心读取到会计核算系统中且预算单位会计核算系统中不可以变更账套属性，如需变更需在数据中心变更后再同步到单位会计核算系统。6.2.1.3预算单位财务核算软件通过单位代码和账套代码等信息从财政预算管理一体化系统提取已经设置的标准科目信息。每个账套及单位都需要单独提取一次，且需要把提取下来的科目信息ID保存，并作为以后操作该条科目信息的唯一ID。4序号字段名称中文名称类型长度强制

11、/可选备注1ACCOUNT_CLS_ID科目唯一标识String38M主键2MOF_DIV_CODE财政区划代码NString9M存储财政区划代码3ACCT_SET_CODE账套编号String38M存储账套编号4SET_YEAR会计年度NString4M存储会计年度5AGENCY_CODE单位代码NString21M存储单位代码6GOV_ACCT_CLS_CODE单位会计科目代码NString30M存储单位会计科目代码7GOV_ACCT_CLS_NAME单位会计科目名称GBString90M存储单位会计科目名称8PARENT_ID父级唯一标识String38M存储该科目父级唯一标识9LEVE

12、L_NO级次Integer2M该科目的级次10IS_LEAF是否末级Integer1M0非末级1末级11IS_ENABLED是否启用Integer1M0停用序号字段名称中文名称类型长度强制/可选备注1AGENCY_CODE单位代码NString21M2ACCT_SET_CODE账套编号String38M3CHECK_CODE验证码GBString10M从财政核心业务一体化系统提取验证码表4响应参数表5DB14/T254220226.2.1.4业务场景描述：根据预算单位在数据中心注册的账套属性，数据中心自动把标准科目引入到该账套中，然后通过数据接口把该账套的标准科目返回到单位核算系统中。6.2.

13、2请求URLGET/gla/v2/cloud/MOFDIVS/FISYEAR/APPID/subject/read?TOKEN=6.2.3请求参数表3请求参数表6.2.4响应参数对象名称:GLA_ACCOUNT_CLS序号字段名称中文名称类型长度强制/可选备注1启用12BALANCE_DIR余额方向Integer1M科目余额方向序号字段名称中文名称类型长度强制/可选备注13GOV_ACCT_CLS_ENUM_CODE单位会计科目类型代码NString1M存储单位会计科目类型代码14EXECUTIVE_ACC执行会计制度类型NString10M执行的会计制度类型15AGENCY_TYPE_COD

14、E单位类型NString3M单位类型16CURRENCY_CODE币种代码String3O币种代码（RMB、USD等）17IS_CUR是否外币核算Integer1M0否1是18IS_QTY是否数量核算Integer1M0否1是19UPDATE_TIME更新时间DateTimeM20IS_DELETED是否删除Integer1M1删除2正常序号字段名称中文名称类型长度强制/可选备注1REL_ID关联表唯一标识String38M主键2MOF_DIV_CODE财政区划代码NString9M3SET_YEAR会计年度NString4M4ACCT_SET_CODE账套编号String38M存储账套编号5

15、AGENCY_CODE单位代码NString21M存储单位代码6GOV_ACCT_CLS_COD单位会计科目代码NString30M存储单位会计科目代码7AUX_TYPE辅助类型NString1M会计科目辅助核算凭证分录辅助核算8AUX_ID辅助核算IDString38M9AUX_CODE辅助核算代码String10M表5响应参数表6DB14/T25422022对象名称:GLA_CLS_AUX_RELATION序号字段名称中文名称类型长度强制/可选备注10IS_MUST是否必输Integer1M1是0否11DEFAULT_CODE默认值String30O12CREATE_TIME创建时间Dat

16、eTimeM13UPDATE_TIME更新时间DateTimeM14IS_DELETED是否删除Integer1M1删除2正常序号字段名称中文名称类型长度强制/可选备注1AGENCY_CODE单位代码NString21M2ACCT_SET_CODE账套编号String38M3CHECK_CODE验证码GBString10M从财政核心业务一体化系统提取验证码序号字段名称中文名称类型长度强制/可选备注1VOU_AUX_ID辅助核算IDString38M主键DB14/T254220226.3凭证分录辅助核算控制要素提取6.3.1接口描述6.3.1.1预算单位财务核算软件从财政核心业务一体化系统提取会

17、计凭证分录辅助核算控制信息。6.3.1.2业务场景描述：单位核算系统从数据中心获取所有的辅助核算控制要素，辅助核算控制信息分三类，一类是公用辅助核算（不允许对数据值进行扩展），一类是专用台账，一类是公用+扩展，即系统中一共设置了多少本辅助核算台账。6.3.2请求URLGET/gla/v2/cloud/MOFDIVS/FISYEAR/APPID/auxiliary/control?TOKEN=6.3.3请求参数表6请求参数表6.3.4响应参数对象名称:GLA_VOU_AUX_CONTROL表7响应参数表7序号字段名称中文名称类型长度强制/可选备注2VOU_AUX_CODE辅助核算代码String

18、30M辅助核算代码.3VOU_AUX_NAME辅助核算名称GBString360M4VOU_FIELD_NAME凭证字段名称GBString30M辅助核算信息在凭证分录及余额汇总表中的字段名称5VOU_FIELD_TYPE凭证字段类型String1MV参数表选择D日期选择S输入字符N输入数字6AUX_ELE_SOURCE辅助核算值集表名GBString30M7AUX_ELE_TYPE辅助核算值集类型NString10M辅助核算类型0.所有账套统一使用、1.各账套分别设置、2.财政统一设置，允许各账套在指定级次扩展8AUX_EXT_CODE允许扩展的要素代码String300O多个逗号（,）分隔

19、。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存储会计

20、年度.会计年度空表示所有年度通用15START_DATE启用日期DateM启用日期yyyymmdd16END_DATE停用日期DateM结束日期yyyymmdd17UPDATE_TIME更新时间DateTimeM维护本条信息项的更新时间DB14/T254220228序号字段名称中文名称类型长度强制/可选备注1AGENCY_CODE单位代码NString21M2ACCT_SET_CODE账套编号String38M3CHECK_CODE验证码GBString10M从财政核心业务一体化系统提取验证码4VOU_AUX_ID辅助核算设置信息IDString38M主键5VOU_AUX_CODE辅助核算设置

21、信息代码String30M序号字段名称中文名称类型长度强制/可选备注18IS_DELETED是否删除Integer1M1删除2正常19IS_STANDARD是否标准台账Integer1M是否标准台账序号字段名称中文名称类型长度强制/可选备注1ELE_ID辅助核算要素值IDString38M主键2ELE_CODE辅助核算要素代码NString9MDB14/T254220226.4凭证分录辅助核算要素数据值集提取6.4.1接口描述6.4.1.1预算单位财务核算软件通过辅助核算代码从财政核心业务一体化系统提取会计凭证分录辅助核算要素。6.4.1.2业务场景描述：预算单位从数据中心读取凭证分录的各项辅

22、助核算对应要素表信息。即预算单位财务核算软件从数据中心获取每一本辅助核算台账包括的要素值集。6.4.2请求URLGET/gla/v2/cloud/MOFDIVS/FISYEAR/APPID/auxiliary/element?TOKEN=6.4.3请求参数表8请求参数表6.4.4响应参数对象名称:GLA_VOU_AUX_ELEMENT表9响应参数表9序号字段名称中文名称类型长度强制/可选备注3ELE_NAME辅助核算要素代码GBString360M4MOF_DIV_CODE财政区划代码NString9O地方财政扩展时有值，财政厅下发时为空5ACCT_SET_CODE账套编号String38O存

23、储账套编号，账套编号空表示所有账套通用6SET_YEAR会计年度NString4O存储会计年度.会计年度空表示所有年度通用7START_DATE启用日期DateM启用日期yyyymmdd8END_DATE停用日期DateM结束日期yyyymmdd9PARENT_ID父级节点IDString38M父级信息项ID10PARENT_CODE父级节点CODENString38M父级信息项CODE11LEVEL_NO级次Integer2M当前信息项级次12IS_LEAF是否末级Integer1M当前信息项是否为末级节点13IS_ENABLED是否启用Integer1M是否启用14VOU_AUX_CODE

24、辅助核算代码String1M15UPDATE_TIME更新时间DateTimeM维护本条信息项的更新时间16IS_DELETED是否删除Integer1M1删除2正常17IS_STANDARD是否标准台账Integer1M18IS_CAPTIAL_CONS_PRO是否基建Integer1M1是，2否19PRO_KIND_CODE项目类别NString2M有值下发，无值时为空20FUND_TRAOBJ_TYPE_CODE资金往来对象类别NString2M有值下发，无值时为空DB14/T254220226.5科目辅助信息提取6.5.1接口描述6.5.1.1预算单位财务核算软件从财政核心业务一体化系

25、统提取会计科目辅助核算控制信息。10序号字段名称中文名称类型长度强制/可选备注1CLS_AUX_ID辅助核算IDString38M主键2CLS_AUX_CODE辅助核算代码String30M3CLS_AUX_NAME辅助核算名称GBString360M4CLS_FIELD_NAME凭证字段名称GBString30M辅助核算信息在凭证分录及余额汇总表中的字段名称5CLS_FIELD_TYPE辅助核算字段类型String1MV参数表选择D日期选择S输入字符N输入数字6AUX_ELE_SOURCE辅助核算值集表名GBString30M7AUX_ELE_TYPE辅助核算值集类型NString10M台账

26、类型0.所有账套统一使用、1.各账套分别设置、序号字段名称中文名称类型长度强制/可选备注1AGENCY_CODE单位代码NString21M2ACCT_SET_CODE账套编号String38M3CHECK_CODE验证码GBString10M从财政核心业务一体化系统提取验证码表11响应参数表11DB14/T254220226.5.1.2业务场景描述：预算单位从数据中心读取科目辅助核算参数总表。6.5.1.3科目辅助信息目前主要适用于银行存款类科目，用于标注银行存款类科目的辅助信息，如开户银行、账户类别等。6.5.2请求URLGET/gla/v2/cloud/MOFDIVS/FISYEAR/A

27、PPID/subject/auxiliary/control?TOKEN=6.5.3请求参数表10请求参数表6.5.4响应参数对象名称:GLA_CLS_AUX_CONTROL序号字段名称中文名称类型长度强制/可选备注2.财政统一设置，允许各账套在指定级次扩展8AUX_EXT_CODE允许扩展的要素代码String300O9AUX_CODE_LEVEL辅助核算代码级次NString10M级次设置格式表示一级3位，二级2位，3级2位。10ELE_CODE_FIELD值集代码字段GBString30M对应核算核算值集表中的代码字段11ELE_NAME_FIELD值集名称字段GBString30M对应

28、核算核算值集表中的名称字段12ELE_KEY_FIELD值集关键值字段GBString30M对应核算核算值集表中的关键字段，存放与凭证分录及余额中。13MOF_DIV_CODE财政区划代码NString9O财政厅设置下发时为空，可以按级次增加，下级使用。14SET_YEAR会计年度NString4O存储会计年度.会计年度空表示所有年度通用15START_DATE启用日期DateM启用日期yyyymmdd16END_DATE停用日期DateM结束日期yyyymmdd17UPDATE_TIME更新时间DateTimeM维护本条信息项的更新时间18IS_DELETED是否删除Integer1M1删除

29、2正常DB14/T25422022例：322。6.6科目辅助要素提取6.6.1接口描述6.6.1.1预算单位财务核算软件通过辅助核算代码从财政核心业务一体化系统提取会计科目辅助核算要素。6.6.1.2业务场景描述：预算单位财务核算软从数据中心读取科目辅助要素的具体要素时，对应科目辅助信息的各类要素值，如开户银行对应的具体银行列表等。6.6.2请求URLGET/gla/v2/cloud/MOFDIVS/FISYEAR/APPID/subject/auxiliary/element?TOKEN=6.6.3请求参数12序号字段名称中文名称类型长度强制/可选备注1ELE_ID辅助核算要素值IDStri

30、ng38M主键2ELE_CODE辅助核算要素代码NString50M3ELE_NAME辅助核算要素代码GBString360M4MOF_DIV_CODE财政区划代码NString9O地方财政扩展时有值，财政厅下发时为空5ACCT_SET_CODE账套编号String38O存储账套编号，账套编号空表示所有账套通用6SET_YEAR会计年度NString4O存储会计年度.会计年度空表示所有年度通用7START_DATE启用日期DateM启用日期yyyymmdd8END_DATE停用日期DateM结束日期yyyymmdd9PARENT_ID父级节点IDString38M父级信息项ID10LEVEL_

31、NO级次Integer2M当前信息项级次11IS_LEAF是否末级Integer1M当前信息项是否为末级节点12IS_ENABLED是否启用Integer1M是否启用序号字段名称中文名称类型长度强制/可选备注1AGENCY_CODE单位代码NString21M2ACCT_SET_CODE账套编号String38M3CHECK_CODE验证码GBString10M从财政核心业务一体化系统提取验证码4CLS_AUX_ID辅助核算设置信息IDString38M主键5CLS_AUX_CODE辅助核算设置信息代码String1M表13响应参数表13DB14/T25422022表12请求参数表6.6.4响应参数对象名称:GLA_CLS_AUX_ELEMENT序号字段名称中文名称类型长度强制/可选备注1AGENCY_CODE单位代码NString21M2ACCT_SET_CODE账套编号