DB3308/T 048-2018 “一窗受理”平台接入技术规范

ICS01.040.03

A12

DB3308

浙江省衢州市地方标准

DB3308/T048—2018

“一窗受理”平台接入技术规范

2018-09-11发布2018-10-11实施

衢州市质量技术监督局发布

DB3308/T048—2018

目  次

前言.....................................................................................................................................................................II

1范围.................................................................................................................................................................1

2规范性引用文件.............................................................................................................................................1

3术语和定义.....................................................................................................................................................1

4数据接入流程.................................................................................................................................................2

5接口规范.........................................................................................................................................................5

6数据对接.........................................................................................................................................................8

7数据安全.........................................................................................................................................................8

附录A（资料性附录）字段参数和XML样例.............................................................................................10

附录B（资料性附录）申报号编码规则......................................................................................................26

I

DB3308/T048—2018

前  言

本标准根据GB/T1.1-2009给出的规则起草。

本标准由衢州市行政服务中心管理办公室提出并归口。

本标准主要起草单位：衢州市行政服务中心管理办公室、南威软件股份有限公司、浙报浙数文化集

团股份有限公司、浙江省方大标准信息有限公司、衢州市质量技术监督检测中心（衢州市标准化研究院）。

本标准主要起草人：洪寒月、李文阳、袁琼、程飞、罗妍、叶华飞、徐亦萍、王燕、陈旭文、王丽

英。

II

DB3308/T048—2018

“一窗受理”平台接入技术规范

1范围

本标准规定了衢州市域内政府部门“一窗受理”平台的数据接入流程、接口规范、数据对接、数据

安全等内容。

本标准适用于衢州市域内政府部门“一窗受理”平台数据对接与共享工作。

2规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文

件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。

GB/T20270信息安全技术网络基础安全技术要求

GB/T20271信息安全技术信息系统通用安全技术要求

GB/T28452信息安全技术应用软件系统通用安全技术要求

3术语和定义

下列术语和定义适用于本标准文件。

3.1

“一窗受理”平台

政务服务事项（包括公共事项和权力事项）收件受理的统一入口，窗口工作人员登录“一窗受理”

平台进行收件登记、办事材料收取，一窗平台收件数据通过公共数据共享平台流转至部门业务办理系统。

3.2

RESTful

REST即表述性状态传递（英文：RepresentationalStateTransfer，简称REST），一种软件架构

风格、设计风格，提供了一组设计原则和约束条件。它主要用于客户端和服务器交互类的软件。基于这

个风格设计的软件可以更简洁，更有层次，更易于实现缓存等机制。

3.3

API

API（ApplicationProgrammingInterface,应用程序编程接口）是一些预先定义的函数，目的是

提供应用程序与开发人员基于某软件或硬件得以访问一组例程的能力，而又无需访问源码，或理解内部

工作机制的细节。

3.4

申报号

1

DB3308/T048—2018

全省统一，作为办件的唯一标识，由业务系统按规则自动生成。

4数据接入流程

4.1数据接入要求

4.1.1应按照接口定义的要求，创建一窗受理平台收件分发和补齐补正的数据推送接口，并将接口服

务发布到公共数据共享平台中，供业务办理系统调用。

4.1.2应按照接口定义的要求，创建业务办理系统受理、补交告知、办结的数据推送接口，并将接口

服务发布到公共数据共享平台中，供一窗受理平台调用。

4.1.3宜采用RESTful的方式调用接口。

4.1.4应依托浙江政务服务网，推进国家省市县四级部门自建业务系统与浙江政务服务网“一窗受理”

平台对接，窗口工作人员登录“一窗受理”平台进行收件登记、办事材料收取，“一窗受理”平台收件

数据通过公共数据共享平台流转至部门业务办理系统。

4.1.5应通过“一窗受理”平台整合各部门业务系统，共享业务数据从而实现“就近能办、同城通办、

市域可办”。

4.2平台注册

4.2.1公共数据共享平台服务注册流程

公共数据共享平台服务注册，包括但不限于以下几个步骤：

a)使用具有发布权限的账号登录公共数据共享平台；

b)在API发布页面中注册API信息并选择网关；

c)提交发布API，由审核员进行审核（可选）；

d)API发布成功后生成API目录。

公共数据共享平台服务注册流程图见下图1所示。

图1公共数据共享平台服务注册流程图

4.2.2公共数据共享平台服务申请授权流程

2

DB3308/T048—2018

公共数据共享平台服务申请授权，包括但不限于以下几个步骤：

a)使用具有开发者权限的账号登录公共数据共享平台；

b)登记应用相关信息并选择网关；

c)生成应用主键（ID）和秘钥（Secret）；

d)搜索需要的API；

e)申请API，并由审核员进行审核（可选）；

f)API提供者对应用授权。

公共数据共享平台服务申请授权流程图如下图2所示。

图2公共数据共享平台服务申请授权流程图

4.2.3系统附件的命名和传递

业务信息中包含的附件，应采用“21位申报号（见附录B）”+“_”+“11位（数字+大小写字母）

随机码”的规则命名，使用公共数据共享平台文件存储中心传递。

4.3数据接入方式

4.3.1公共数据共享平台

“一窗受理”平台与业务办理系统须依托公共数据共享平台实现对接，由“一窗受理”平台、

省垂直业务办理系统、权力运行系统、自建业务办理系统开发信息接收API，并注册发布到公共数据共

享平台，涉及对接的系统按需在公共数据共享平台申请授权相应的API服务。

公共数据共享平台提供接口访问权限控制、调用监控和性能分析。

4.3.2“一窗受理”平台收件登记、补齐补正

“一窗受理”平台收件登记、补齐补正结束将涉及推送给业务办理系统的附件存入公共数据共享平

台统一文件存储中心，并推送收件登记、补齐补正结束信息到公共数据共享平台，由公共数据共享平台

转发到业务办理系统，业务办理系统根据接收到的信息到统一文件存储中心下载材料附件。“一窗受理”

平台收件登记、补齐补正结束信息推送业务流程图如下图3所示。

3

DB3308/T048—2018

图3“一窗受理”平台收件登记、补齐补正结束信息推送业务流程图

4.3.3业务办理系统补齐补正、受理、办结

业务办理系统补齐补正、受理、办结时，将涉及推送至“一窗受理”平台的办理结果附件写入公共

数据共享平台统一文件存储中心，并推送补齐补正、受理、办结信息到公共数据共享平台，由公共数据

共享平台转发到“一窗受理”平台，“一窗受理”平台根据接收到的信息到统一文件存储中心下载办理

结果附件。业务办理系统补齐补正、受理、办结信息推送业务流程图如下图4所示。

4

DB3308/T048—2018

图4业务办理系统补齐补正、受理、办结信息推送业务流程图

5接口规范

5.1收件分发接口

5.1.1接口说明

用于“一窗受理”平台在完成收件登记后，向各个需要对接的业务系统分发企业或公众申请的相关

信息，包括办件信息、表单、材料信息。

5.1.2接口地址

http://《系统地址》/api/register，接口调用请求说明：采用http的POST请求方式。

5.1.3接口参数

收件分发接口参数见表1。

表1收件分发接口参数表

参数名参数说明是否必须

申报基本信息，内容要求具体参

baseInfoXml是

考《申报基本信息定义》

申报材料信息，内容具体要求参

attrXml是

考《申报材料信息定义》

业务表单信息（可选），内容要求

formXml否

具体参考《业务表单信息定义》

5

DB3308/T048—2018

5.1.4返回结果

以JSON格式返回结果数据，格式定义如下：

{

"result":"01",

"resultmsg":"调用结果描述"

}

5.2受理接口

5.2.1接口说明

用于部门在自建的业务系统上完成办件的受理之后，将受理数据推送给“一窗受理”平台。

5.2.2接口地址

http://《系统地址》/api/accept，接口调用请求说明：采用http的POST请求方式。

5.2.3接口参数

受理接口参数见表2。

表2受理接口参数表

参数名参数说明是否必须

受理信息，内容具体参考《受理

acceptInfoXml是

信息定义》

受理附件材料（可选），内容具体

attrXml否

参考《附件信息定义》

5.2.4返回结果

以JSON格式返回结果数据，格式定义如下：

{

"result":"01",

"resultmsg":"调用结果描述"

}

5.3补齐补正告知接口

5.3.1接口说明

用于部门在接收“一窗受理”平台的申请数据后，对申请的材料不符合要求作出补齐补正决定后，

将需要补齐补正的相关信息反馈给“一窗受理”平台。

5.3.2接口地址

http://《系统地址》/api/patchApply，接口调用请求说明:：采用http的POST请求方式。

6

DB3308/T048—2018

5.3.3接口参数

补齐补正告知接口参数见表3。

表3补齐补正告知接口参数表

参数名参数说明是否必须

补齐补正申请信息，内容具体参

patchXml是

考《补齐补正告知信息定义》

补齐补正材料信息，内容具体参

patchAttrXml是

考《补齐补正告知材料信息定义》

5.3.4返回结果

以JSON格式返回结果数据，格式定义如下：

{

"result":"01",

"resultmsg":"调用结果描述"

}

5.4补齐补正结束接口

5.4.1接口说明

用于在部门作出补交告知后，申请人在“一窗受理”平台补交完所需材料的后，将补交的相关信息

推送给业务办理系统的过程。

5.4.2接口地址

http://《系统地址》/api/patchAccept，接口调用请求说明：采用http的POST请求方式。

5.4.3接口参数

补齐补正结束接口参数见表4。

表4补齐补正结束接口参数表

参数名参数说明是否必须

patchEndXml补齐补正结束信息是

补齐补正的材料信息,内容具体

attrXml是

参考《申报材料信息定义》

5.4.4返回结果

以JSON格式返回结果数据，格式定义如下：

{

"result":"01",

"resultmsg":"调用结果描述"

}

7

DB3308/T048—2018

5.5办结接口

5.5.1接口说明

用于各个业务系统在完成业务办结后，将办理结果信息和结果文件反馈给“一窗受理”平台包括办

结信息、附件信息。

5.5.2接口地址

http://《系统地址》/api/transact，接口调用请求说明：采用http的POST请求方式。

5.5.3接口参数

办结接口参数见表5。

表5办结接口参数表

参数名参数说明是否必须

办结信息，内容具体参考《办结

transactXml是

信息定义》

办结附件信息，内容具体参考《附

attrXml否

件信息定义》

5.5.4返回结果

以JSON格式返回结果数据，格式定义如下：

{

"result":"01",

"resultmsg":"调用结果描述"

}

6数据对接

应按《浙江政务服务网技术规范第三部分数据交换信息规范》、《浙江省公共数据共享平台数据

共享标准规范》等规定执行。

7数据安全

应按GB/T20270、GB/T20271、GB/T28452的规定执行。

8

DB3308/T048—2018

附录A

（资料性附录）

字段参数和XML样例

A.1申报基本信息定义

申报基本信息定义的字段参数见表A.1。

表A.1申报基本信息定义的字段参数

序号字段名标签名数据格式必填说明

全省统一，作为办件的唯一标识，

1.申报号PROJIDVARCHAR(21)是由业务系统按规则自动生成，详情

见附录B

由业务系统随机自动生成的数字，

2.查询密码PROJPWDVARCHAR(6)是

如：234765

权力事项的唯一标识,从权力事项

权力事项

3.SERVICECODEVARCHAR(50)是库中获取，如果是垂管事项，请填

编码

写权力基本码

权力事项

4.SERVICEVERSIONINT是权力事项的版本号

版本号

权力事项申报的事项名称，如：交通建设工

5.SERVICENAMEVARCHAR(200)是

名称程施工许可

申请项目的具体名称。如：关于XXX

6.申报名称PROJECTNAMEVARCHAR(200)是

的交通建设工程施工许可

7.办件类型INFOTYPEVARCHAR(20)是值为：即办件、承诺件、其他

是否并联IS_MULTI业务类型

业务0-普通办件

8.VARCHAR(1)是1-业务协同（并联）

2-多级联动

3-窗口延伸类

9

DB3308/T048—2018

表A.1申报基本信息定义的字段参数（续）

序号字段名标签名数据格式必填说明

并联业务MULTI_ID当业务为并联业务时候，该项必填，

9.标识VARCHAR(50)否值为牵头事项办件的ID；当业务为多

级联动是，值为下级办件唯一标识

申报者名填写申报者的名称，如为个人，则填

10.APPLYNAMEVARCHAR(100)是

称写姓名；如为法人，则填写单位名称

申报者提供的有效证件名称，包括身

申报者证

11.APPLY_CARDTYPEVARCHAR(30)否份证、组织机构代码证等，详见9.3

件类型

证件类型

申报者提供的有效证件的识别号。如

申报者证APPLY_CARDNUMBE

12.VARCHAR(100)否身份证号码：

件号码R

330102198805059786

联系人/

13.代理人姓CONTACTMANVARCHAR(100)是如果无代理人，联系人就是申报者

名

联系人/

CONTACTMAN_CARD提供的有效证件名称，包括身份证、

14.代理人证VARCHAR(100)否

TYPE组织机构代码证等详见9.3证件类型

件类型

联系人/提供的有效证件的识别号。如身份证

CONTACTMAN_CARD

15.代理人证VARCHAR(100)否号码：

NUMBER

件号码330102198805059786

联系人手

16.TELPHONEVARCHAR(13)是申报者的联系号码

机号码

17.邮编POSTCODEVARCHAR(6)否申报者联系地址对应的邮政编码

18.通讯地址ADDRESSVARCHAR(100)否申报者的联系地址

对于企事业单位，填写对应的法人代

19.法人代表LEGALMANVARCHAR(50)否

表

10

DB3308/T048—2018

表A.1申报基本信息定义的字段参数（续）

序号字段名标签名数据格式必填说明

参与该业务办理第一环节的