（正式版）DB36∕T 982-2017 《网上审批系统数据接口规范》

ICS35.200DB36/T982—2017网上审批系统数据接口规范2018-03-01实施2018-03-01实施I前言 引言 I1范围 12术语和定义 13接口主要功能 24数据查询 25数据交互 36接口调用要求 4附录A(规范性附录)查询类接口示例及说明 5附录B(规范性附录)交互类接口示例及说明 7附录C(规范性附录)政府部门业务专网系统前置数据库数据结构及说明 DB36/T982—2017本标准按照GB/T1.1-2009《标准化工作导则第1部分：标准的结构和编写》的规定编写。本标准由江西省发展和改革委员会提出并归口。本标准主要起草单位：江西省信息中心、软件股份有限公司。本标准主要起草人：金俊平、吴俐、孙杨、袁振武、陈兆亮、蔡亮、郑剑波、胡坚勇、郑自。IDB36/T982—2017为进一步加强全省网上审批系统的规划、建设、运行、管理和服务，建立健全全省网上审批系统的管理机制，推动网上审批系统建设规范有序发展，提升各级政府及其部门的社会管理和公共服务水平，现根据国家、地方的相关文件要求和标准规范，结合我省网上审批业务现状和发展要求，制定本规范。1网上审批系统数据接口规范本标准规定了网上审批系统的数据接口规范，包括数据查询类和数据交互类两类接口标准规范。本标准适用于省、市、县三级政务服务网及部门自建业务系统等第三方系统相关方开发、使用江西省网上审批系统数据接口，以及相关政府部门自有系统对江西省网上审批系统及相关接口的管理。下列术语和定义适用于本文件。一种轻量级的数据交换格式。基于ECMAScript(w3c制定的js规范)的一个子集，采用完全独立于编程语言的文本格式来存储和表示数据。标准超文本传输协议。使用对参数进行编码并将参数作为键值对传递，还使用关联的请求语义。每式传递其参数。URL编码是一种字符编码形式，可确保传递的参数中包含一致性文本，例如将空格编码为%20,其它符号转换为%XX,其中XX为该符号以16进制表示的ASCII(或ISOLatin-1)值。追加的参数也的，而不是作为URL的一部分进行传递。一个函数，可将字符串以URL编码，用于编码处理。URL编码((Percent-encoding),是特定上下文的统一资源定位符(URL)的编码机制。适用于统一资源标识符(URI)电子政务外网2政府的业务专网，主要运行政务部门面向社会的专业性业务和不需要在内网上运行的业务，与互联网之间逻辑隔离。江西省网上审批系统全省统一的集信息公开、网上办理、便民服务、电子监察于一体的网上审批系统，实现行政审批事项统一网上受理、统一网上反馈、统一效能监察。实现非涉密行政审批事项全流程网上办理、并联审批、信息共享、业务协同和即时电子监察，推进政务公开、规范权力运行、提升行政效能。3接口主要功能江西省网上审批系统数据接口应包括但不限于以下功能：a)数据查询；b)数据交互；4数据查询4.1总则系统提供完善的数据查询接口，满足不同应用场景的数据查询要求，为增加调用接口返回数据的易读性，统一格式为标准JSON格式，以保障系统间正常数据抓取。4.2接口名称1、获取系统办件公示；2、获取办件统计数据；3、根据申办编号，获取办理信息；4、获取表单信息。4.3调用流程数据查询应能实现对外的数据共享。接口接入方按照不同查询场景传入格式参数获取指定信息。如图1所示1、应用接入方按照业务查询场景组装查询参数并发送查询请求；2、系统接受查询请求后解析相关参数，按查询场景返回相关数据；3、将返回信息组装编码后返回。3DB36/T982—2017①调用接口①调用接口应用接入方B查询类接口1、获取系统办件公示；2、获取办件统计数据；3、依申办编号，获取办理信息；4、获取表单信息。发布接口江西省网上审批系统②返回结果②返回结果应用接入方A5.1接口名称1、保存表单项；2、外部(政务服务网)业务申报；3、外部业务(第三方业务系统所涉及的业务)转存政府部门业务专网系统前置数据库。5.2调用流程数据交互实现外部接入方和系统的数据交互，实现完整的网上审批业务申报逻辑。如图2所示。1、外部应用接入方按照事项唯一标识组装查询参数获取申请表单(见下图2①);2、表单填入后组装表单保存的报文，调用表单保存接口(见下图2②);3、系统接受程序解析表单保存报文，返回保存结果：申办编号；4、调用网盘上传逻辑(见下图2③);5、组装业务申请报文调用申报接口(见下图2④);6、系统接受程序解析申请报文，界定事项办理地址，是否需要进行业务转发(见下图2⑤),外部业务转存政府部门业务专网系统前置数据库(见下图2⑥);7、组装业务的基础信息、表单信息、材料信息，返回保存结果(见下图2⑦)。4DB36/T982—2017政务服务网政务服务网④-②获取表单信息查询类接口⑤-内部业务判定内外部傲据江西省网上审批系统江西省电子政务按归口分发一按归口分发A部门专网系统政府部门业务专网系统前置数据库调用网盘上传逻辑交互类接口外部业务申报交互类接口共享数据统一交换平台C部门专网系统B部门专网系统一按归口分发外部业务图2交互类接口调用流程6接口调用要求6.1接口类型、传输协议系统接口部署于江西省电子政务外网，应确保外部调用方与江西省网上审批系统应用服务器之间能6.3返回数据编码返回信息使用UrlEncode编码，接收后需解码。DB36/T982—20175(规范性附录)查询类接口示例及说明表1获取办件公示接口表服务名称95:8091/web/jxapproval/getBusinessListInfo服务说明获取网上审批系统最新的50条业务请求方式GET参数列表参数参数说明可不传固定传入360521000000返回值{"info":[{"RECEIVE_NUMBER":受理编号"FINISH_TIME":办结时间有值代表已办结，"ACCEPT_USER_NAME":"受理用户名称","APPLICANT":"申报单位名称","APPLY_SUBJECT":"业务主题","CURRENT_NODE_NAME”:"当前环节名称","ITEM_NAME":"是想名称","ORG_NAME":"单位名称","RECEIVE_NUMBER":"收件编号-对应的业务查询","SUBMIT_TIME":提交时间，"TIME_LIMIT":承诺期限}],"state":"200"}备注返回信息使用了urlencode加密(uft-8)A.2获取办件统计数据接口表2获取办件统计数据接口表服务名称web/jxapproval/getStatistics服务说明获取网上审批系统获取统计数据请求方式GET参数列表参数名称参数说明部门编码返回值{"info":[{"ALLACCEPT":受理总数，"ALLFINISH":办结总数，"MONTHACCEPT":月受理数，"MONTHFINISH":月办结数}],"state":"200"}6备注返回信息使用了urlencode加密(uft-8)服务名称web/jxapproval/getBusinessInfo服务说明根据申办编号，获取办理信息请求方式参数列表参数名称参数说明receiveNumber申办编号返回值{"state":"200","error":"错误信息","info":[{"RECEIVE_NUMBER":"10134110201411280117",//受理编号"BSNUM":370100000000-351100-XK-1417158418717-1862",//业务实例号"CURRENT_NODE_ID":"sid-7AEF96EA-7ACC-4EF2-8A3B-6686850018DB",//业务当前环节编号"CURRENT_NODE_NAME":"KL3-2",/业务当前环节名称"LIMIT_TIME":1417536000000,/1步骤承诺时间"RECEIVE_TIME":1417158605000,//接收时间"SEND_TIME":1417158605000,//提交时间"STATUS":"01",//运转状态取值业务实例状态目录"USER_CODE":"41D2DB1E914C4D38911AFF5D1865F2BC",//审批人工号"USER_NAME”:”通用审批管理员",//审批人姓名"WARNING_TIME":1417449600000//步骤预警时间“OPINION”:办理}]}7DB36/T982—2017表4获取表单信息接口表接口访问地址：web/jxapproval/getFormlnfo参数名类型说明备注事项id事项id返回结果：{"info":{"formld":表单id,"formName":表单名称，"objectType":"1,2,3""state":"200"}DB36/T982—20171(规范性附录)交互类接口示例及说明B.1保存表单项接口表5保存表单项接口表接口访问地址：审批系统访问地址/web/jxapproval/saveFormData参数名类型说明备注orgCodestring单位编码单位编码formldstring表单id表单idformDatastring{"BeiZhu":"555","DanWeiMingChen":"11","GongGaoKanDengQingKuang":"4444","ZhengZhangShouJiaoQingKuang":"33","ZhuXiaoLiYou":"122"}返回结果：成功：{"datald":"20150414080743181200","state":"200"}示例：获取表单申报信息/***获得指定表单数据**@paramform*表单*@returnsobject,key为fieldld,value为fieldValue*若表单中含有动态行，则key为动态行定义ID,value为CForm.ListCForm.getFormData=function(form){var$form=form?$(form):$("[cf_elementType=form]").eq(O);if($form.length<=0){alert("请指定要要获得数据的表单!");return{};}varmap={};//动态行var$dynRows=$form.find(".cfDynRow[cf_modelld][cf_elementType=zone]");//动态表格var$dynTables=$form.find(.cfDynTable[cf_modelld][cf_elementType=zone]');2DB36/T982—2017//具有modelItemId的所有域varfields=$form.find("[cf_modelltemld][cf_elementType=field]");varcheckBoxMap={};//组装主表单数据$.each(fields,function(i,field){if($dynRows.find(field).length>0|I$dynTables.find(field).length>0){return;}varfieldId=field.id;varfieldValue=CForm.getFieldValue(field);if(field.type=="checkbox"||field.type=="radio"){if(checkBoxMap[fieldId]){if(field.getAttribute("name")!=checkBoxMap[fieldId]){//多余的镜像域checkbox,不用处理return;}checkBoxMap[fieldld]=field.getAttribute("name");}varpreFieldValue=map[fieldId];if(preFieldValue){//如果是复选框，则连接值if(field.type=="checkbox"&&fieldValue){fieldValue=preFieldValue+","+fieldValue;}fieldValue=preFieldValue;Lif(fieldValue==null){fieldValue="";}map[fieldId]=fieldValue;//组装动态行数据$.each($dynRows,function(i,dynRow){var$trs=$(dynRow).find("tbodytr");DB36/T982—20173//存放动态行的各行数据vardynRowRows=[];$.each($trs,function(j,tr){varrowData={};var$fields=$(tr).find([cf_modelltemld][cf_elementType=field]);$.each($fields,function(k,field){varfieldId=$(field).attr("id");varfieldValue=CForm.getFieldValue(field);//若已有数据，则用","间隔各个数据varpreFieldValue=rowData[fieldId];if(preFieldValue){if($.trim(fieldValue)){fieldValue=preFieldValue+","+fieldValue;fieldValue=preFieldValue;}fieldValue="";}rowData[fieldld]=fieldValue;dynRowRows.push(rowData);map[$(dynRow).attr("id")]=dynRowRows;/1组装动态表格数据$.each($dynTables,function(i,dynTable){varStable=$('table',dynTable);//存放动态表格的各表格数据vardynTableRows=[];vardata=map[$(dynTable).attr("id")];if(data){dynTableRows=data;{$.each($table,function(j,table){varrowData={};var$fields=$(table).find([cf_modelltemld][cf_elementType=field]);$.each($fields,function(k,field){DB36/T982—20174varfieldId=$(field).attr("id");varfieldValue=CForm.getFieldValue(field);/1若已有数据，则用”,"间隔各个数据varpreFieldValue=rowData[fieldld];if(preFieldValue){if($.trim(fieldValue)){fieldValue=preFieldValue+","+fieldValue;fieldValue=preFieldValue;{}if(fieldValue==null){fieldValue="";{rowData[fieldId]=fieldValue;dynTableRows.push(rowData);map[$(dynTable).attr("id")]=dynTableRows;returnmap;B.2外部(政务服务网)业务申报接口审批系统访问地址/web/jxapproval/accpet参数名类型说明备注申报参数{“receiveNum”:外网二次提交必填，“state”:"sp:外网首次提交bqbz:外网二次提交”,"itemld":“事项ID”,“itemCode”:“事项CODE”,“itemName”:“事项名称”,“orgCode”:“事项所属单位”,“orgName”:“事项所属单位名称”,“objectType”:“服务对象类型”,(1:人员；2:项目3:企“datald”:“表单数据ID”,“formld”:“表单ID”,DB36/T982—20175“metail”:[{“OPERATOR_ID”:"操作人ID”,“OPERATOR_NAME”:”操作人”,“DOCUMENT_ID”:“材料ID”,"DOCUMENT_NAME":“材料名称”,“TYPE”:“文件类型(纸质：0;电子：1)”,“FILE_NAME”:“上传文件”,“FILE_PATH”:“文件路径”“info”:{企业格式：orgName;//组织机构名称(必填)varchar(100)不能为空orgCode;//组织机构代码(必填)varchar(20)不能为空orgCodeAwardDate;//组织机构代码证发证日期datetimeorgCodeAwardOrg;//组织机构代码发证机构varchar(50)orgCodeValidPeriodStart;//组织机构代码证有效期起datetimeorgCodeValidPeriodEnd_str;//组织机构代码证有效期止datetimeorgCodeValidPeriodEnd;orgEnglishName;//机构英文名称varchar(100)orgType;//组织机构类型varchar(50)不能为空enterpriseSortCode;//企业类别代码varchar(5)根据国家工商总局2007年9月30日发布的《gs1-2007企业信用分类监管数据规范》中“b.10ca16企业(机构)类型代码”:1000enterpriseSortName;//企业类别名称varchar(30)根据国家工商总局2007年9月30日发布的《gs1-2007企业信用分类监管数据规范》中“b.10ca16企业(机构)类型代码”enterpriseTypeCode;//企业类型代码varchar(5)根据国家工商总局2007年9月30日发布的《gs1-2007企业信用分类监管数据规范》中“b.10ca16企业(机构)类型代码”enterpriseTypeName;//企业类型名称varchar(50)根据国家工商总局2007年9月30日发布的《gs1-2007企业信用分类监管数据规范》中“b.10ca16企业(机构)类型代码”legalPerson;//法定代表人varchar(50)不能为空legalPersonType;//法定代表人类型varchar(50)DB36/T982—20176legal_person法人certificateName;//法人证件名称varchar(20)不能为空certificateNo;//法人证件号码varchar(20)不能为空responsiblePerson;//单位负责人varchar(50)inAreaCode;//所属行政区划代码varchar(30)inArea;//所属行政区划名称varchar(100)chargeDepartment;//上级主管单位varchar(100)registerAddress;//单位注册地址varchar(200)不能为空produceAddress;//单位生产地址varchar(200)mailingAddress;//单位通讯地址varchar(200)postalCode;//邮政编码varchar(6)linkMan;//联系人varchar(50)contactPhone;//联系电话varchar(20)fax;//传真varchar(20)linkManEmail;//联系人邮箱varchar(50)bank;//单位开户银行varchar(20)必须写入全称1、中国工商银行；2、中国农业银行；3、中国银行；4、中国建设银行；5、中国民生银行；6、华夏银行；7、中国光大银行；8、中信实业银行；9、恒丰银行；10、上海浦东发展银行；11、交通银行；12、兴业银行；13、深圳发展银行；14、招商银行；15、广东发展银行；16、中国邮政储蓄bankAccount;//银行账号varchar(20)organizationKind;//经济性质varchar(20)employeeNum;//单位人数varchar(6)registerCapital;//注册资本(金)float单位：万元currencyKind;//货币种类varchar(10)groundArea;//占地面积varchar(20)varchar(1500)不能为空businessScopePart;//经营范围(兼营)mainProduct;//主要产品varchar(1000)operatingMode;//经营方式varchar(20)自产自销；代购代销；加工；批发(法人);批发(非法人);零售连锁；零售单DB36/T982—20177体；运输；咨询registerDate;/1登记注册日期date不能为空orgFoundDate;//单位成立日期datebusinessLicense;//工商注册号varchar(20)aicAwardDate;//工商营业执照发证日期datetimeaicValidPeriodStart;//工商营业执照有效期起aicValidPeriodEnd;//工商营业执照有效期止datetimeaicCertAwardOrg;//工商营业执照发证机构varchar(50)taxManager;//主管税务机关varchar(100)nationTaxRegisterNo;//国税纳税人识别号varchar(20)税务登记证号locationTaxRegisterNo;//地税纳税人识别号varchar(20)税务登记证号nationInvestRate;//国家投资额比例varchar(5)百分比corporationInvestRate;//企业投资额比例varchar(5)百分比foreignInvestRate;//外资投资额比例varchar(5)百分比varchar(5)百分比bankLoanRate;//银行贷款额比例varchar(5)百分比orgActuality;//组织机构现状varchar(10)不能为空个人格式：identityType;//证件类型不能为空idcardNo;//证件号不能为空name;//姓名不能为空sex;//性别nation;//民族politicalStatus;//政治面貌education;//学历nativePlace;//籍贯birthday;//出生日期country;//国籍homeAddress;//居住地址DB36/T982—20178linkPhone;//联系电话不能为空linkAddress;//联系地址不能为空postCode;//邮政编码province;//省city;//市county;//县email;//邮箱项目格式：projectName;/项目名称(必填)projectCode;/项目编码(必填)location;/项目地址linkMan;//联系人linkPhone;//联系人电话projectContent;//建设内容areaAll;//1总用地面积areaBuild;//建筑面积investment;//总投资projectAllowedNo;//项目审批核准备案文号}}成功：{"receiverNumber":"20150414080743181200","state":"200"}B.3网盘保存附件接口类表7网盘保存附件接口类表接口访问地址：上传递至参数名类型说明备注Map<String,String>Mapuid:用户id;type:doc;folder_name:文件夹名字(系统会根据该文件夹名字在个人网盘下创建文件夹，用来存放应用中的资源)注意：该文件夹创建之后，不能删除file_ur表单id要上传的文件的存放路径server_url网盘上传地址返回结果：code:0000msgok:成功消息docid:文件存储iduuid:文件的uuidDB36/T982—20179示例：StringNetworklocationaddress=//10:8136/WeMap<String,String>params=newHashMap<String,String>();备注我方提供相关的网盘保存类DB36/T982—2017(规