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

CCSL7714IDB14/T2542—2022前言 2规范性引用文件 3术语和定义 4缩略语 5基本要求 6接口组成 7接口要求 468接口安全 47DB14/T2542—2022本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。本文件由山西省财政厅提出、组织实施和监督检查。本文件由山西省市场监督管理局对标准的组织实施情况进行监督检查。本文件由山西省财政标准化技术委员会（SXS/TC48）归口。本文件起草单位：山西省财政科学研究院、山西省大众科技评估中心。本文件主要起草人：薛兆军、韩慧彦、李林骏、张维华、司文。DB14/T2542—20221预算管理一体化系统会计核算软件接口规范本文件规定了预算管理一体化系统会计核算软件标准的基本要求、接口组成、接口要求、接口安全本文件适用于全省预算管理一体化系统开发和建设。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逻辑库表对业务规范进行分析，设计财政核心业务一体化系统数据库的逻辑结构，形成含字段、类型、长度等属性的库表，反映财政核心业务内在逻辑。DB14/T2542—202223.6逻辑库表要素逻辑库表的基本单元，规定了逻辑库表字段的类型、长度、值域、字段说明、参考来源等信息。3.7代码集能够完整表达逻辑库表要素全部值的集合。3.8报文数据交互传输中记录的日志文件。3.9类型说明表示由数字[0-9]组成的字符串，如：0表示包含中文字符集组成的字符串，报文规范中的长度定义以字节为单表示整数，符号位可选，数值部分最长8位，如：表示日期，格式为yyyymmdd（年月日）。如：表示日期时间，格式为yyyymmddhhmmss（年月日时分秒）。如：20050611表示金额以外的浮点型数字，如面积、分成比例等。不能包含逗号等分隔符，如4缩略语下列缩略语适用于本文件。FTP：文件传输协议（FileTransferProtocol）。XML：可扩展的标记语言，广泛应用于系统间的信息交互（ExtensibleMarkupLanguage）。SSL：带安全的套接层（SecureSocketsLayer）。HTTP：超文本传输协议。HTTP底层是基于TCP/IP协议（HypertextTransferProtocol）。HTTPS：基于SSL的HTTP协议。5基本要求5.1应用接入方应满足以下要求：a)在财政内网统一布署集中版的财务核算软件；DB14/T2542—20223b)按需申请接入；c)按照本文件要求使用接口服务；d)协调所选取的业务应用系统及服务提供方与预算管理一体化会计核算平台运营方的对接工作。5.2接口提供方应满足以下要求：a)确保开放的接口不影响平台的正常运行；b)对业务应用系统及服务的接入制定相应的安全策略，并确保正常执行；c)对业务应用系统及服务的接入进行审批和管理；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请求参数表1请求参数表1M2M3M6.1.4响应参数对象名称:GLA_ACCT_SETDB14/T2542—20224表2响应参数表1M2M3M4M59M6M74M8M9M1MMM1MM1MO6.2标准科目信息提取6.2.1接口描述预算单位财务核算软件通过单位账套属性从财政核心业务一体化系统提取已经设置的标准科业务场景描述：根据预算单位在数据中心注册的账套属性，将科目信息从数据中心读取到会计核算系统中且预算单位会计核算系统中不可以变更账套属性，如需变更需在数据中心变更后再同步到单位会计核算系统。预算单位财务核算软件通过单位代码和账套代码等信息从财政预算管理一体化系统提取已经设置的标准科目信息。每个账套及单位都需要单独提取一次，且需要把提取下来的科目信息ID保存，并作为以后操作该条科目信息的唯一ID。业务场景描述：根据预算单位在数据中心注册的账套属性，数据中心自动把标准科目引入到该账套中，然后通过数据接口把该账套的标准科目返回到单位核算系统中。6.2.2请求URLGET/gla/v2/cloud/{MOFDIVS}/{FISYEAR}/{APPID}/subject/read?TOKEN=6.2.3请求参数表3请求参数表选1M2M3M6.2.4响应参数对象名称:GLA_ACCOUNT_CLS表4响应参数表1识M2码9M3M44M5M6M7M8识M92M1M1MDB14/T2542—202261M1MM3M3O算1M算1MM1M对象名称:GLA_CLS_AUX_RELATION表5响应参数表1关联表唯一M2码9M34M4M5M6M71M8M9码MDB14/T2542—202271MOMM1M6.3凭证分录辅助核算控制要素提取6.3.1接口描述预算单位财务核算软件从财政核心业务一体化系统提取会计凭证分录辅助核算控制信息。业务场景描述：单位核算系统从数据中心获取所有的辅助核算控制要素，辅助核算控制信息分三类，一类是公用辅助核算（不允许对数据值进行扩展），一类是专用台账，一类是公用+扩展，即系统中一共设置了多少本辅助核算台账。6.3.2请求URLGET/gla/v2/cloud/{MOFDIVS}/{FISYEAR}/{APPID}/auxiliary/control?TOKEN=6.3.3请求参数表6请求参数表1M2_CODEM3M6.3.4响应参数对象名称:GLA_VOU_AUX_CONTROL表7响应参数表1MDB14/T2542—202282M辅助核算代码.3M4M51M6M7M8码O9MMMM9O4OMMMDB14/T2542—202291M1M6.4凭证分录辅助核算要素数据值集提取6.4.1接口描述预算单位财务核算软件通过辅助核算代码从财政核心业务一体化系统提取会计凭证分录辅助核算要素。业务场景描述：预算单位从数据中心读取凭证分录的各项辅助核算对应要素表信息。即预算单位财务核算软件从数据中心获取每一本辅助核算台账包括的要素值集。6.4.2请求URLGET/gla/v2/cloud/{MOFDIVS}/{FISYEAR}/{APPID}/auxiliary/element?TOKEN=6.4.3请求参数表8请求参数表1M2M3M4M5M6.4.4响应参数对象名称:GLA_VOU_AUX_ELEMENT表9响应参数表1M29M3M49O5O64O7M8M9MM2M1M1M1MM1M1M1M2M_CODE2M6.5科目辅助信息提取6.5.1接口描述预算单位财务核算软件从财政核心业务一体化系统提取会计科目辅助核算控制信息。业务场景描述：预算单位从数据中心读取科目辅助核算参数总表。科目辅助信息目前主要适用于银行存款类科目，用于标注银行存款类科目的辅助信息，如开户银行、账户类别等。6.5.2请求URLGET/gla/v2/cloud/{MOFDIVS}/{FISYEAR}/{APPID}/subject/auxiliary/control?TOKEN=6.5.3请求参数表10请求参数表1M2EM3M6.5.4响应参数对象名称:GLA_CLS_AUX_CONTROL表11响应参数表1M2M3M4M51M6M7M2.财政统一设置，允许8码O9MMMM9O4OMMM1M6.6科目辅助要素提取6.6.1接口描述预算单位财务核算软件通过辅助核算代码从财政核心业务一体化系统提取会计科目辅助核算要素。业务场景描述：预算单位财务核算软从数据中心读取科目辅助要素的具体要素时，对应科目辅助信息的各类要素值，如开户银行对应的具体银行列表等。6.6.2请求URLGET/gla/v2/cloud/{MOFDIVS}/{FISYEAR}/{APPID}/subject/auxiliary/element?TOKEN=6.6.3请求参数表12请求参数表1M2M3M4M51M6.6.4响应参数对象名称:GLA_CLS_AUX_ELEMENT表13响应参数表1M2M3M49O5O64O7M8M9M2M1M1MMM1M6.7支付数据提取6.7.1接口描述预算单位财务核算软件从财政核心业务一体化系统提取已经生成的支付数据信息，包括正常支付凭证、支付更正凭证、支付退回凭证。支付退回凭证金额为负数，表示退款金额，收付款人分别为原凭证的收付款人。支付更正凭证为一负一正对应凭证。业务场景描述：预算单位从数据中心读取银行回单后支付明细数据，根据业务场景结转对应凭证。6.7.2请求URLGET/gla/v2/cloud/{MOFDIVS}/{FISYEAR}/{APPID}/pay/voucher?TOKEN=6.7.3请求参数表14请求参数表1M2M3M4M5M6.7.4响应参数对象名称:PAY_VOUCHER_BILL表15响应参数表DB14/T2542—20221PAY_CERT_ID识M24M34M4M5PAY_CERT_NOM6M7M8M9OO_NAMEO额M号OOLQD_CERT_NOO7M7ME7MMMMMM2MM9MO3MOOOEOOOMUPDATE_TIMEM1MM2MMDB14/T2542—20226.8资产数据提取6.8.1接口描述预算单位财务核算软件从财政核心业务一体化系统提取已经生成的资产信息。6.8.2请求URLGET/gla/v2/cloud/{MOFDIVS}/{FISYEAR}/{APPID}/asset/change?TOKEN=6.8.3请求参数表16请求参数表1M2EM3M4M5M6O6.8.4响应参数对象名称:BAS_ASSET_CHANGE表17响应参数表1DM2M34M43M5M67M72M8M9M1M6.9引入标准科目6.9.1接口描述预算单位财务核算软件将标准的会计科目信息引入各账套使用。业务场景描述：预算单位将会计科目读取且写入成功后，再读取此接口，数据中心根据账套信息也写入标准科目。数据中心和单位核算分别引入标准科目的话，无法保证科目的ID一致。故此接口与“标准科目信息提取”合并。在读取标准科目时系统自动引入数据中心并返回单位核算。6.9.2请求URLPOST/gla/v2/cloud/{MOFDIVS}/{FISYEAR}/{APPID}/subject/import?TOKEN=6.9.3请求参数表18请求参数表1M2M3M6.9.4响应参数表19响应参数表1Y2Y6.10会计科目信息6.10.1接口描述预算单位财务核算软件将新增的会计科目信息写入财政核心业务一体化系统。业务场景描述：预算单位将会计科目新增、修改、删除实时写入数据中心成功后，单位核算系统才能确认成功。写入时，不允许增加标准科目的同级科目，仅允许增加标准科目的下级科目。会计分录中使用的辅助核算代码和会计科目中使用的辅助核算代码不得少于标准科目设置的辅助核算。6.10.2请求URLPOST/gla/v2/cloud/{MOFDIVS}/{FISYEAR}/{APPID}/subject/save?TOKEN=6.10.3发送参数对象名称:GLA_ACCOUNT_CLS表20发送参数表1M29M3M44MDB14/T2542—20225M6M7M8M92M1M1M1M1MEXECUTIVE_ACC2MAGENCY_TYPE_CODE2M3O1M1MM1MOOODB14/T2542—20221M财务收入5财务费用6预算余对象名称:GLA_CLS_AUX_RELATION表21发送参数表1M29M34M4ACCT_SET_CODEM5M6E码M71M8M9M1MOMM1M6.10.4响应参数表22响应参数表1Y2YDB14/T2542—20226.11会计账套建立6.11.1接口描述建立预算单位会计账套。会计账套建立后不允许修改年初余额，且建立会计账套后才可以编制会计凭证。业务场景描述：建立预算单位会计账套后将启用日期等信息实时写入数据中心成功后，单位核算系统才能确认成功。6.11.2请求URLPOST/gla/v2/cloud/{MOFDIVS}/{FISYEAR}/{APPID}/account/create?TOKEN=6.11.3请求参数表23请求参数表1M2EM3M4M6.11.4响应参数表24响应参数表1Y2Y6.12辅助核算要素6.12.1接口描述预算单位财务核算软件将生成的辅助核算信息写入财政核心业务一体化系统。业务场景描述：将新增辅助核算信息实时写入数据中心成功后，单位核算系统才能确认成功。6.12.2请求URLPOST/gla/v2/cloud/{MOFDIVS}/{FISYEAR}/{APPID}/auxiliary/element?TOKEN=DB14/T2542—20226.12.3发送参数对象名称:GLA_ACCOUNT_AUX_ELEMENT表25发送参数表1M2M3M49O54M6O7O8M9MMM2M1M1M1MM1MM1M6.12.4响应参数表26响应参数表1Y2Y6.13会计凭证保存6.13.1接口描述预算单位财务核算软件将生成的会计凭证信息数据写入财政核心业务一体化系统。业务场景描述：凭证新增、修改、删除实时写入数据中心成功后，单位核算系统才能确认成6.13.2请求URLPOST/gla/v2/cloud/{MOFDIVS}/{FISYEAR}/{APPID}/voucher/save?TOKEN=6.13.3发送参数会计凭证主表：GLA_VOU_HEAD表27会计凭证主表选1识M29M34M4M53M6M7M8M9MDB14/T2542—2022选MMMMO息O息MMVOUCHER_DATEMMMMM4M1OOM证MM1M1MDB14/T2542—2022选1M会计凭证分录表：GLA_VOU_DETAIL表28会计凭证分录表1VOU_DET_IDM2M39M44M5M63M7M8M9VOUCHER_NOM5MM_CODEM单位会计科目代码NStri1M2MMO3OOO4O码OOOOO_NO2OOOEO2O码O码1O1O码E1O码1O7O码OOOOOOOOM1MOOO1OOEOM现金流量表：GLA_VOU_CASHFLOWDB14/T2542—2022表29现金流量表选号1识M2识M3M49M5M64M7ACCT_SET_CODEM83M9M3MMMM1MM盈余与结余差异表：GLA_VOU_DIFF表30盈余与结余差异表选号1M选号2识M39M4M54M6ACCT_SET_CODEM73M8M95M码MM1MM单位会计原始单据关联表：GLA_VOU_BILL_RELATION表31单位会计原始单据关联表1M29M3ACCT_SET_CODEM4ACCT_SET_NAMEM54MDB14/T2542—202263M7M85M9MOMO识M识OMM1MM6.14会计凭证审核6.14.1接口描述预算单位财务核算软件将写入财政核心业务一体化系统的凭证进行审核。业务场景描述：凭证审核将凭证变动内容实时写入数据中心成功后，单位核算系统才能确认成功。6.14.2请求URLPOST/gla/v2/cloud/{MOFDIVS}/{FISYEAR}/{APPID}/voucher/audit?TOKEN=6.14.3请求参数表32请求参数表DB14/T2542—2022选1识M29M34M4M53M6M7M8M9MMMMMO息O息MMMMMMDB14/T2542—2022选M4M1OOM证MM1M6.14.4响应参数表33响应参数表1Y2Y6.15会计凭证记账6.15.1接口描述预算单位财务核算软件将写入财政核心业务一体化系统的凭证进行记账。不允许跨月进行记业务场景描述：凭证记账将凭证变动内容实时写入数据中心成功，单位核算系统才能确认成6.15.2请求URLPOST/gla/v2/cloud/{MOFDIVS}/{FISYEAR}/{APPID}/voucher/register?TOKEN=6.15.3请求参数DB14/T2542—2022表34请求参数表选1识M29M34M4M53M6M7M8M9MMMMMO息O息MMMMMDB14/T2542—2022选MM4M1OOM证MM1M6.15.4响应参数表35响应参数表1Y2Y6.16会计科目及辅助台账余额汇总表6.16.1接口描述预算单位财务核算软件将生成的会计科目及辅助台账余额信息数据写入财政核心业务一体化系统。必须先发起会计凭证记账才可以上传余额，系统会自动校验已记账的凭证信息是否与余额信息一致。业务场景描述：年初余额在会计账套建立账前写入数据中心，会计账套建立成功后，不允许修改年初余额；分月余额信息在本月会计凭证全部记账完毕后将本月会计期间余额写入数据中心。6.16.2请求URLPOST/gla/v2/cloud/{MOFDIVS}/{FISYEAR}/{APPID}/subject/balance?TOKEN=6.16.3发送参数DB14/T2542—2022对象名称:GLA_BAL表36发送参数表1M29M34M4M5M63M7EM81M9MMOOMMO4OO码O码_CODE2O码FUND_TRA_OBJ_NOOEOOO码4OOE2O2O2O2OOOOOODB14/T2542—2022M1MOOO1OEOOM6.16.4响应参数表37响应参数表1Y2Y6.17会计账套月结6.17.1接口描述对预算单位会计账套进行月结或者年结,不允许跨月结账，空凭证无数据也需要进行结账操作。本月不月结，不允许下个月凭证进行记账。业务场景描述：本月结账信息实时写入数据中心成功后，单位核算系统才能确认成功，结账后不允许操作上月凭证。6.17.2请求URLPOST/gla/v2/cloud/{MOFDIVS}/{FISYEAR}/{APPID}/account/check?TOKEN=6.17.3请求参数表38请求参数表1AGENCY_CODEM2M3M43M6.17.4响应参数表39响应参数表1Y2Y6.18会计账套撤销建立6.18.1接口描述撤销预算单位会计账套。有已编制的会计凭证不允许撤销建账，必须删除后才可以进行此操作。业务场景描述：已经发生凭证业务的账套撤销需要先将凭证删除写入数据中心，再将账套撤消写入数据中心成功后，单位核算系统才能确认成功。6.18.2请求URLPOST/gla/v2/cloud/{MOFDIVS}/{FISYEAR}/{APPID}/account/uncreate?TOKEN=6.18.3请求参数表40请求参数表1M2ME3M4M6.18.4响应参数表41响应参数表1Y2Y6.19会计凭证撤销审核6.19.1接口描述预算单位财务核算软件将写入财政核心业务一体化系统的凭证撤销审核。业务场景描述：撤销审核凭证后，将凭证变动内容实时写入数据中心成功后，单位核算系统才能确认成功。6.19.2请求URLPOST/gla/v2/cloud/{MOFDIVS}/{FISYEAR}/{APPID}/voucher/unaudit?TOKEN=6.19.3请求参数表42请求参数表选1识M29M34M4M53MDB14/T2542—2022选6M7M8M9MMMMMO息O息MMMMMMM4O1OOMDB14/T2542—2022选证MM1M6.19.4响应参数表43响应参数表1Y2Y6.20会计凭证撤销记账6.20.1接口描述预算单位财务核算软件将写入财政核心业务一体化系统的凭证进行撤销记账，不允许跨月进行撤销记账。撤销记账时系统会判断是否结账，且撤销记账后删除该月上传的会计科目及辅助台账余额表信息。业务场景描述：撤销审核记账后，将凭证变动内容实时写入数据中心成功后，单位核算系统才能确认成功。6.20.2请求URLPOST/gla/v2/cloud/{MOFDIVS}/{FISYEAR}/{APPID}/voucher/unregister?TOKEN=6.20.3请求参数表44请求参数表选1识M2MOF_DIV_CODE9M34MDB14/T2542—2022选4M53M6M7M8M9MMMMMO息O息MMMMMMM4M1ODB14/T2542—2022选OM证MM1M6.20.4响应参数表45响应参数表1Y2Y6.21会计账套月结撤销6.21.1接口描述对预算单位会计账套进行撤销月结，不允许跨月撤销结账。业务场景描述：撤销会计账套月结，将会计账套变动内容实时写入数据中心成功后，单位核算系统才能确认成功。6.21.2请求URLPOST/gla/v2/cloud/{MOFDIVS}/{FISYEAR}/{APPID}/account/uncheck?TOKEN=6.21.3请求参数表46请求参数表1AGENCY_CODEM2M3M43M6.21.4响应参数表47响应参数表1Y2Y6.22凭证号批量调整6.22.1接口描述预算单位财务核算软件批量调整写入财政核心业务一体化系统的会计凭证号信息。6.22.2请求U