DB37T3448.7“爱山东”政务服务平台 第7部分：业务中台对接规范

Q/LB.□XXXXX-XXXXDB37/T3448.7—2024目次TOC\o"1-1"\h前言 II引言 III1范围 12规范性引用文件 13术语和定义 14对接范围 15事项申报对接 26事项审批对接 27验证方法 10附录A（资料性）签名生成算法示例 12附录B（资料性）接口公共请求头参数 13附录C（规范性）代码集 14前言本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。本文件是DB37/T3448《“爱山东”政务服务平台》的第7部分。DB37/T3448已经发布了以下部分：第1部分：基本功能要求；第2部分：基础数据元目录；第3部分：基础代码集；第4部分：基础数据规范；第5部分：业务办件号编码规则；第6部分：事项分类；第7部分：业务中台对接规范；第8部分：统一身份认证系统接入规范。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由山东省大数据局提出、归口并组织实施。引言为响应国家一体化政务服务平台建立政务服务效能提升常态化工作机制要求，山东省建设“爱山东”政务服务平台，提供了面向企业、群众提供政务服务和公共服务，解决业务办理不够便捷、平台支撑能力不足等问题。DB37/T3448旨在确立“爱山东”政务服务平台建设和管理要求，拟由8个部分组成。第1部分：基本功能要求。目的在于规范“爱山东”政务服务平台基本功能框架，以及各层级的基本功能要求。第2部分：基础数据元目录。目的在于规范“爱山东”政务服务平台相关的基础数据元。第3部分：基础代码集。目的在于规范“爱山东”政务服务平台相关的基础代码集。第4部分：基础数据规范。目的在于规范“爱山东”政务服务平台基础数据结构，以及数据项的名称、数据类型及格式、非空说明、数据元标识符、代码标识符及备注等。第5部分：业务办件号编码规则。目的在于规范“爱山东”政务服务平台业务办件号的编码规则。第6部分：事项分类。目的在于规范“爱山东”政务服务平台事项性质、服务对象、实施主体、服务主题、服务层级、服务形式、行政管辖、维护管理。第7部分：业务中台对接规范。目的在于规范“爱山东”政务服务业务中台的对接范围、事项申报对接、事项审批对接要求，并描述了对应的验证方法要求，并描述对应的验证方法。第8部分：统一身份认证系统接入规范。目的在于规范“爱山东”政务服务平台中全省统一身份认证系统接入流程、接入接口、接入管理要求，并描述对应的验证方法。"爱山东"政务服务平台第7部分：业务中台对接规范范围本文件规定了“爱山东”政务服务业务中台的对接范围、事项申报对接、事项审批对接要求，并描述了对应的验证方法。本文件适用于“爱山东”政务服务平台业务中台的建设、应用和管理。规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T19488.2—2008电子政务数据元第2部分：公共数据元目录术语和定义下列术语和定义适用于本文件。

“爱山东”政务服务平台“Aishandong”governmentserviceplatform面向企业、群众提供政务服务和公共服务的一体化服务平台，由“爱山东”政务服务网、移动客户端及各类小程序平台组成，简称“爱山东”。

“爱山东”政务服务业务中台“Aishandong”governmentservicebusinessmiddleplatform为“爱山东”政务服务平台的重要组成部分，通过提供事项数字化梳理、业务运行配置、业务系统对接、事项服务发布等支撑能力，是实现“爱山东”不同渠道间同一事项的统一配置接入、统一服务入口、统一运行管控的平台。对接范围业务中台对接包括事项申报渠道接入和业务审批系统接入，对接范围见图1。事项申报渠道主要包括综合受理窗口、“爱山东”政务服务网、“爱山东”政务服务平台移动端、自助服务终端，业务审批系统包括省、市、县（市、区）级各业务审批系统。对接范围事项申报对接综合受理窗口、“爱山东”政务服务网、“爱山东”政务服务平台移动端、自助服务终端等渠道通过生成的相关地址接入业务中台进行事项申报。地址包括申报地址、申报详情查看地址、申报补齐补正地址等，地址参数包括标识、时间戳、签名等，地址参数见表1。地址参数序号参数名称参数标识说明1标识x-h5-key为接入端分配的标识2密钥secret为接入端分配的密钥3时间戳x-h5-time接入端自动生成的13位时间戳4签名x-h5-sign由业务中台分配的标识和密钥通过算法生成，签名生成算法示例见附录A以“爱山东”政务服务网地址（http://ip:port/context）为例，其申报地址、申报详情查看地址、申报补齐补正地址参数示例如下：申报地址：http://ip:port/context?x-h5-key=xxx&x-h5-time=xxx&x-h5-sign=xxx。申报详情查看地址：http://ip:port/context?x-h5-key=xxx&x-h5-time=xxx&x-h5-sign=xxx&receiveNum=xx&mode=detail。申报补齐补正地址：http://ip:port/context?x-h5-key=xxx&x-h5-time=xxx&x-h5-sign=xxx&receiveNum=xx&mode=correct。事项审批对接概述省、市、县（市、区）级各业务审批系统通过审批接口接入业务中台，各接口的公共请求头信息见附录B。接口描述信息要求包括：接口名称：应给出接口的中文名称；接口描述：应描述出接口的概要信息；接入方式：应给出接口的方式；输入参数：应给出参数名称、参数说明、数据类型、约束等输入信息，数据类型应符合表2的要求；输出参数：宜给出参数名称、数据类型、参数说明等输出信息。输入/输出参数的代码集应符合附录C的要求。参数数据类型数据类型说明字符型通过字符形式表达的值的类型数字型通过从“0”到“9”数字形式表达的值的类型日期型通过YYYYMMDD或YYYY—MM—DD的形式表达的值的类型，符合GB/T19488.2—2008日期时间型通过YYYYMMDDhhmmss或YYYY—MM—DDhh:mm:ss的形式表达的值的类型，符合GB/T19488.2—2008申报流水号对接审批系统接收申报流水号接口应符合表3的要求。审批系统接收申报流水号接口接口描述业务审批系统从业务中台获取申报流水号接口方式POST输入参数参数名称数据类型约束说明申办流水号字符型必选由业务中台生成事项编码字符型必选事项办理中产生的唯一编码，由事项服务中心赋码事项所属区划编码字符型必选应符合山东省民政厅最新公布的“山东省行政区划代码公告”给出的区划编码业务受理类型代码数字型必选0—业务受理；1—补齐受理补正受理人姓名字符型可选应符合GB/T19488.2—2008中“姓名”的要求补正受理清单字符型可选补正受理材料名称的清单补正材料时间日期时间型可选应符合GB/T19488.2—2008中“日期时间”的要求输出参数参数名称数据类型说明返回状态代码数字型应符合C.1的要求返回状态说明字符型返回状态文字说明响应时间日期时间型应符合GB/T19488.2—2008中“日期时间”的要求申请信息对接获取申请详细信息接口获取申请详细信息接口应符合表4的要求。获取申请详细信息接口接口描述根据申办流水号业务审批系统获取业务申请的详细信息接口方式POST输入参数参数名称数据类型约束说明申办流水号字符型必选由业务中台生成事项编码字符型必选事项办理中产生的唯一编码，由事项服务中心赋码输出参数参数名称数据类型说明返回状态代码数字型应符合C.1的要求返回状态说明字符型对返回状态代码的详细说明响应时间日期时间型应符合GB/T19488.2—2008中“日期时间”的要求表4获取申请详细信息接口（续）事项版本编码字符型事项某一版本信息的ID事项表单编码字符型当前事项版本对应的表单ID业务来源代码数字型应符合C.2的要求街道通办的办理区划字符型应符合山东省民政厅最新公布的“山东省行政区划代码公告”给出的区划编码人员申报数据字符型申请人基本信息，包含身份证件号码、姓名、手机号码等企业申报数据字符型申请企业基本信息，包含统一社会信用代码、企业名称等项目申报数据字符型申请项目基本信息，包含项目名称，项目编码等申办信息数据字符型申请人填写业务表单信息获取申请材料信息接口获取申请材料信息接口应符合表5的要求。获取申请材料信息接口接口描述业务审批系统从业务中台获取申办材料附件基本信息接口方式POST输入参数参数名称数据类型约束说明申办流水号字符型必选由业务中台生成事项编码字符型必选事项办理中产生的唯一编码，由事项服务中心赋码业务受理类型代码数字型必选0—业务受理；1—补齐受理输出参数参数名称数据类型说明返回状态代码数字型应符合C.1的要求返回状态说明字符型对返回状态代码的详细说明响应时间日期时间型应符合GB/T19488.2—2008中“日期时间”的要求申办流水号字符型由业务中台生成文件类型代码数字型0—纸质文件；1—电子文件材料类型代码数字型应符合C.3的要求材料数量数字型收取材料数量附件名称字符型材料附件全称（含格式类型后缀）附件标识字符型附件材料唯一标识材料备注字符型附件材料备注信息附件类型字符型如：xls、pdf、doc、wps等附件网盘文件ID字符型申请人上传材料网盘存储ID材料编号字符型附件所属事项材料编号材料名称字符型附件所属事项材料名称业务信息对接推送业务受理信息接口推送业务受理信息接口应符合表6的要求。推送业务受理信息接口接口描述事项受理后，向业务中台推送业务的受理信息接口方式POST输入参数参数名称数据类型约束说明申办流水号字符型必选由业务中台生成事项编码字符型必选事项办理中产生的唯一编码，由事项服务中心赋码业务预审信息字符型必选业务预审审核信息业务预审时间日期时间型必选应符合GB/T19488.2—2008中“日期时间”的要求业务预审人名称字符型必选应符合GB/T19488.2—2008中“姓名”的要求业务预审人工号字符型必选业务预审人员工号业务预审状态代码数字型必选1—预审通过；2—预审驳回业务预审意见字符型必选业务预审意见业务预审区划名称字符型必选应符合山东省民政厅最新公布的“山东省行政区划代码公告”给出的区划名称业务预审区划编码数字型必选应符合山东省民政厅最新公布的“山东省行政区划代码公告”给出的区划代码业务预审部门名称字符型必选应符合GB/T19488.2—2008中“单位名称”的要求业务预审部门编码字符型必选应符合GB/T19488.2—2008中“组织机构代码”的要求业务受理信息字符型必选业务受理相关信息业务受理时间日期时间型必选应符合GB/T19488.2—2008中“日期时间”的要求业务受理人名称字符型必选应符合GB/T19488.2—2008中“姓名”的要求业务受理人工号字符型必选业务受理工作人员工号业务受理情况数字型必选0—不予受理；1—受理业务受理意见字符型必选业务受理审核意见业务受理区划名称字符型必选应符合山东省民政厅最新公布的“山东省行政区划代码公告”给出的区划名称业务受理区划编码数字型必选应符合山东省民政厅最新公布的“山东省行政区划代码公告”给出的区划代码业务受理部门名称字符型必选应符合GB/T19488.2—2008中“单位名称”的要求业务受理部门编码字符型必选应符合GB/T19488.2—2008中“组织机构代码”的要求输出参数参数名称数据类型说明返回状态代码数字型应符合C.1的要求返回状态说明字符型对返回状态代码的详细说明响应时间日期时间型应符合GB/T19488.2—2008中“日期时间”的要求推送业务环节信息接口推送业务环节信息接口应符合表7的要求。推送业务环节信息接口接口描述向业务中台推送业务环节信息接口方式POST输入参数参数名称数据类型约束说明申办流水号字符型必选由业务中台生成事项编码字符型必选事项办理中产生的唯一编码，由事项服务中心赋码审批环节代码数字型必选应符合C.4的要求审批环节名称字符型必选审批人员办理环节名称审批部门名称字符型必选应符合GB/T19488.2—2008中“机构名称”的要求审批部门组织机构代码字符型必选应符合GB/T19488.2—2008中“组织机构代码”的要求审批部门所在地行政区域代码数字型必选应符合山东省民政厅最新公布的“山东省行政区划代码公告”中的区划代码要求审批人姓名字符型必选应符合GB/T19488.2—2008中“姓名”的要求审批人职务代码字符型必选应符合GB/T19488.2—2008中“职务代码”的要求审批人职务名称字符型必选应符合GB/T19488.2—2008中“职务”的要求审批意见字符型必选审批人员办理意见环节开始时间日期时间型必选应符合GB/T19488.2—2008中“日期时间”的要求环节结束时间日期时间型必选应符合GB/T19488.2—2008中“日期时间”的要求审批环节状态代码数字型必选应符合C.5的要求输出参数参数名称数据类型说明返回状态数字型应符合C.1的要求返回状态说明字符型对返回状态代码的详细说明响应时间日期时间型应符合GB/T19488.2—2008中“日期时间”的要求推送业务补正告知信息接口推送业务补正告知信息接口应符合表8的要求。推送业务补正告知信息接口接口描述向业务中台推送业务补正告知信息接口方式POST输入参数参数名称数据类型约束说明申办流水号字符型必选由业务中台生成事项编码字符型必选事项办理中产生的唯一编码，由事项服务中心赋码补正告知发出人姓名字符型必选应符合GB/T19488.2—2008中“姓名”的要求补正告知原因字符型必选需补正信息的原因补正材料清单字符型必选补正材料名称的清单补正告知时限数字型可选没有时填写0补正告知时限单位字符型可选G—工作日（不包含法定节假日）；Z—自然日补正告知材料编码字符型必选需补正材料的编码补正告知时间日期时间型必选应符合GB/T19488.2—2008中“日期时间”的要求补正告知部门所在地行政区划代码数字型必选应符合山东省民政厅最新公布的“山东省行政区划代码公告”给出的区划代码输出参数参数名称数据类型说明返回状态数字型应符合C.1的要求返回状态说明字符型对返回状态代码的详细说明响应时间日期时间型应符合GB/T19488.2—2008中“日期时间”的要求推送业务特别程序申请信息接口推送业务特别程序申请信息接口应符合表9的要求。推送业务特别程序申请信息接口接口描述向业务中台推送业务特别程序申请信息接口方式POST输入参数参数名称数据类型约束说明申办流水号字符型必选由业务中台生成事项编码字符型必选事项办理中产生的唯一编码，由事项服务中心赋码特别程序类型代码数字型必选0—特别程序申请；1—特别程序结果表9推送业务特别程序申请信息接口（续）特别程序种类代码字符型可选A—延长审批：需要部门领导批示的，延长不能超过10个工作日；多部门联合统一办理的，需本级政府负责人批准，延长不能超过15个工作日；B—除延长审批之外，听证、招标、拍卖等法律法规规定的情况，延长时间不得超过法定时间特别程序类型代码为0时必选特别程序种类名称字符型可选填写上栏列举延长审批、专家鉴定等，不再上列范围时可自行扩展，自行扩展的都按照B类处理特别程序类型代码为0时必选特别程序开始日期日期型可选特别程序类型代码为0时必选特别程序批准人字符型可选特别程序类型代码为0时必选特别程序启动理由或依据字符型可选特别程序类型代码为0时必选申请内容字符型可选特别程序类型代码为0时必选特别程序时限数字型可选特别程序种类为A时，此值大于0小于等于10；特别程序种类为B时，填写规定的时限，没有规定特别程序时限的，填写0。特别程序类型代码为0时必选特别程序时限单位字符型可选G—工作日（不包含法定节假日）；Z—自然日特别程序类型代码为0时必选特别程序申请部门所在地行政区划代码数字型可选应符合山东省民政厅最新公布的“山东省行政区划代码公告”中的区划代码特别程序类型代码为0时必选特别程序结果字符型可选特别程序类型代码为1时必选结果产生日期日期型可选特别程序是委托第三方机构进行的，此栏填写产生结果的时间特别程序类型代码为1时必选特别程序结束日期日期型可选特别程序类型代码为1时必选特别程序结果部门所在地行政区划代码数字型可选应符合山东省民政厅最新公布的“山东省行政区划代码公告”中的区划代码特别程序类型代码为1时必选输出参数参数名称数据类型说明返回状态数字型应符合C.1的要求返回状态说明字符型对返回状态代码的详细说明响应时间日期时间型应符合GB/T19488.2—2008中“日期时间”的要求推送业务办结信息接口推送业务办结信息接口应符合表10的要求。推送业务办结信息接口接口描述向业务中台推送业务办结信息接口方式POST输入参数参数名称数据类型约束说明申办流水号字符型必选由业务中台生成事项编码字符型必选事项办理中产生的唯一编码，由事项服务中心赋码办结部门名称字符型可选应符合GB/T19488.2—2008中“机构名称”的要求办结部门组织机构代码字符型必选应符合GB/T19488.2—2008中“组织机构代码”的要求办结部门行政区划代码数字型必选应符合山东省民政厅最新公布的“山东省行政区划代码公告”中的区划代码审批人姓名字符型必选应符合GB/T19488.2—2008中“姓名”的要求办结结果代码数字型必选应符合C.6的要求办结结果描述字符型必选对办理结果的详细描述作废或退回原因字符型可选办结结果代码为1、2、3、5时必选证件/盖章名称字符型可选办结结果代码为0时必选证件编号字符型可选办结结果代码为0时必选证件有效期限字符型可选办结结果代码为0时必选发证/盖章单位字符型可选办结结果代码为0时必选办结时间日期时间型必选业务办结时间输出参数参数名称数据类型说明返回状态数字型应符合C.1的要求返回状态说明字符型对返回状态代码的详细说明响应时间日期时间型应符合GB/T19488.2—2008中“日期时间”的要求推送业务审批结果文件接口推送事项业务结果文件接口应符合表11的要求。推送业务审批结果文件接口接口描述向业务中台推送业务审批结果文件接口方式POST输入参数参数名称数据类型约束说明申办流水号字符型必选由业务中台生成事项编码字符型必选事项办理中产生的唯一编码，由事项服务中心赋码附件名称字符型必选审批结果附件全称（含后缀）附件标识字符型必选审批结果附件唯一标识附件类型字符型必选如：pdf、docx、wps等附件来源数字型必选0—网盘；1—文件表11推送业务审批结果文件接口（续）附件路径/网盘ID字符型必选审批结果材料网盘存储ID部门组织机构代码字符型必选应符合GB/T19488.2—2008中“机构名称”的要求部门所在行政区划代码数字型必选应符合山东省民政厅最新公布的“山东省行政区划代码公告”中的区划代码输出参数参数名称数据类型说明返回状态代码数字型应符合C.1的要求返回状态说明字符型对返回状态代码的详细说明响应时间日期时间型应符合GB/T19488.2—2008中“日期时间”的要求审批系统接收网上申报撤销接口审批系统接收网上申报撤销接口应符合表12的要求。审批系统接收网上申报撤销接口接口描述审批系统开发，接收网上申报撤销信息接口方式POST输入参数参数名称数据类型约束说明申办流水号字符型必选由业务中台生成事项编码字符型必选事项办理中产生的唯一编码，由事项服务中心赋码撤销人姓名字符型必选应符合GB/T19488.2—2008中“姓名”的要求撤销时间日期时间型必选应符合GB/T19488.2—2008中“日期时间”的要求撤销原因字符型必选业务申请撤销原因说明输出参数参数名称数据类型说明返回状态代码数字型应符合C.1的要求返回状态说明字符型对返回状态代码的详细说明响应时间日期时间型应符合GB/T19488.2—2008中“日期时间”的要求验证方法对接范围通过综合受理窗口、“爱山东”政务服务网、“爱山东”政务服务平台移动端、自助服务终端等渠道申报事项，以及通过省、市、县（市、区）级各业务审批系统进行事项审批，验证对接逻辑符合第5章要求。事项申报对接通过获取申报地址数据等形式验证对接符合第6章要求。事项审批对接应通过验证程序调用接口，测试接口运行情况。验证程序应按照第6章给出的接口名称和参数输入，调用后的返回码和返回数据结构与第6章要求一致。

（资料性）

签名生成算法示例Java签名生成算法示例Java签名的生成算法示例如下。importcn.hutool.crypto.SmUtil;publicclassH5AppSignCalc{publicstaticvoidmain(String[]args){try{Stringip="http://x.x.x.x:xx";Stringcontext="/applet";Stringkey="1507165070797443072";Stringsecret="52BFA8BE68D1407A86210035512ABACA";Stringtime=String.valueOf(System.currentTimeMillis());Stringdata=key+"&"+time+"&"+secret;Stringsign=sm3Sign(data);Stringformat=ip+context+"?x-h5-key=%s&x-h5-time=%s&x-h5-sign=%s";System.out.println(String.fo