DB4403/T 31-2019 数字城管数据交换规范

ICS35.240

L79

DB4403

深圳市地方标准

DB4403/T31—2019

数字城管数据交换规范

2019-11-15发布2019-12-01实施

深圳市市场监督管理局发布

DB4403/T31—2019

目次

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

引言.............................................................................III

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

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

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

4基本规定...........................................................................2

5数据交换接口约定...................................................................2

6数据交换规范.......................................................................3

附录A（资料性附录）数据上行案件数据类信息数据交换信息表示例.......................6

附录B（资料性附录）数据上行信息采集员数据类信息上报数据交换信息示例..............13

附录C（资料性附录）数据上行基础数据类信息数据交换信息表示例.....................15

附录D（资料性附录）数据下行案件数据类信息下派数据交换信息示例...................34

附录E（资料性附录）数据下行信息采集员数据类信息下派数据交换信息示例.............35

附录F（资料性附录）数据交换标准规范示例...........................................36

I

DB4403/T31—2019

前言

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

本标准由深圳市城市管理和综合执法局提出并归口。

本标准主要起草单位：深圳市城市管理监督指挥中心、深圳市图元科技有限公司。

本标准主要起草人：刘海军、陈毓贞、林隆健、旷涛、童林、余良、黄晓伟、钟苑、郑驰、曾飞鹏、

周曙光。

II

DB4403/T31—2019

引言

随着数字化城市管理信息系统由行业标准升级为国家标准，以及《深圳市新型智慧城市建设总体方

案》（深府〔2018〕47号）、《深圳市智慧城管建设十三五规划纲要》（深城管函〔2016〕660号）等

文件的出台，为解决深圳市数字化城市管理运行十多年来存在的问题，并立足长远、面向未来，规范深

圳市数字化城市管理的建设和运行，实现信息资源整合和共享，推广应用数字化城市管理模式，全面提

升深圳市城市管理和公共服务的水平，特制定本文件。

制定《数字城管数据交换规范》，明确深圳市数字化城市管理信息系统的数据交换范围、规范性引

用文件、术语和定义、基本规定、接口约定、标准规范要求，有利于深圳市数字化城市管理数据交换、

信息资源共享，进一步提升深圳城市管理服务水平和效率。

III

DB4403/T31—2019

数字城管数据交换规范

1范围

本标准规范了数字化城市管理数据交换的术语与定义、基本规定、数据交换接口约定、数据交换规

范的内容。

本标准适用于深圳市市、区两级数字化城市管理信息系统之间的数据交换。

2规范性引用文件

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

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

GB/T2260中华人民共和国行政区划代码

GB/T30428.1-2013数字化城市管理信息系统第1部分：单元网格

GB/T30428.2-2013数字化城市管理信息系统第2部分：管理部件和事件

GB/T30428.3-2016数字化城市管理信息系统第3部分：地理编码

GB/T30428.4-2016数字化城市管理信息系统第4部分：绩效评价

GB/T30428.5-2017数字化城市管理信息系统第5部分：监管信息采集设备

GB/T30428.6-2017数字化城市管理信息系统第6部分：验收

GB/T30428.7-2017数字化城市管理信息系统第7部分：监管信息采集

SZDB/Z300.1-2018数字化城市管理第1部分：总则

SZDB/Z300.2-2018数字化城市管理第2部分：信息采集规范

SZDB/Z300.3-2018数字化城市管理第3部分：案件立案规范

SZDB/Z300.4-2018数字化城市管理第4部分：处置和结案规范

3术语和定义

GB/T2260、GB/T30428.1-2013、GB/T30428.2—2013、GB/T30428.3-2016、GB/T30428.4-2016、

GB/T30428.5-2017、GB/T30428.6-2017、GB/T30428.7-2017和SZDB/Z300.1-2018、SZDB/Z300.2

—2018、SZDB/Z300.3—2018、SZDB/Z300.4—2018中确定的及下列术语和定义适用于本标准。

3.1

数据交换对象DataExchangeObject

参与数据交换过程的数字化城市管理信息系统。

3.2

数据上行DataUpload

区级数字化城市管理信息系统向市级数字化城市管理信息系统进行数据上报或传输。

3.3

数据下行DataDownload

市级数字化城市管理信息系统向区级数字化城市管理信息系统进行数据下派或传输。

1

DB4403/T31—2019

4基本规定

4.1数据交换规则

4.1.1各区的信息采集员班次数据（见附录B表B.3）应提前一天报送到市级系统；

4.1.2各区的信息采集员在岗状态数据（附录B表B.5）发生变化时需在1分钟内传送到市级系统；

4.1.3其他各动态数据须在5分钟内报送到市级系统；

4.1.4区级系统的基础数据类数据要根据双方约定时间进行上报市级系统；

4.1.5市级系统的案件数据类、信息采集员数据类数据实时下派区级系统。

4.2数据传输方式

4.2.1结构化数据采取文本形式传输。

4.2.2非结构化数据（如影像类、声音类等）采用url下载方式进行数据传输，采取二进制形式存储。

4.3时间格式定义

系统定义的时间格式为yyyy-MM-ddHH:mm:ss（年-月-日时：分：秒）。

5数据交换接口约定

5.1数据交换接口基于国内外主流的J2EE或.NET技术架构设计。

5.2数据交换对象是深圳市、区两级数字化城市管理信息系统。

5.3数据交换方式采用WebAPI。

5.4数据交换周期包括实时交换、定期交换。

5.5数据交换类别包括结构化数据、非结构化数据，图片类、图像视频类、文档类等附件数据是非结

构化数据，文本信息类、数据库表数据是结构化数据。

5.6接口协议采用Http或Https。

5.7接口编码采用UTF-8。

5.8数据格式：接口数据的返回格式为JSON格式字符串，接口返回值详见表1数据格式表。

表1数据格式表

JSON变量说明

success调用接口操作成功标志，boolean值true、false

code返回结果状态标识，0代表成功，1代表失败，-1代表其它

message返回结果的文字说明

data返回的结果数据

5.9安全验证：根据授权用户和密码产生的随机Token来访问各API。

2

DB4403/T31—2019

6数据交换规范

6.1区级系统数据上行接口规范

6.1.1区级系统进行数据上报的接口由市级系统提供，按照市级系统提供的接口规范进行设计，区级

系统进行上报的数据包括：

a)案件基本信息；

b)案件办理过程信息；

c)案件申请延期（改期）信息。

6.1.2案件上报数据信息接口规范

接口由市级系统提供，接口约定规范请详细见附录F中F.1上报案件预受理信息接口规范示例。

6.1.3案件办理流程信息接口规范

案件的办理流程需要同步办理过程信息,接口由市级系统提供，接口约定规范请详细见附录F中F.2

同步案件的办理流程信息接口规范示例。

6.1.4案件申请延期（改期）信息接口规范

区级系统办理的案件，当申请延时（改期）被批准后需同步案件改期信息，接口由市级系统提供，

接口约定规范请详细见附录F中F.3同步案件的延期（改期）申请信息接口规范示例。

6.2区级系统上行数据规范

6.2.1区级系统向市级系统上报的数据信息类型包括：基础数据类、案件数据类、信息采集员数据类。

6.2.2基础数据类信息包括问题来源、问题类型、问题大类、问题小类、行政区信息、街道信息、社

区信息、工作网格信息、工作网格卡点信息和案件办理环节信息。

6.2.3案件数据类信息包括案件基本信息、案件受理信息、案件受理附件、案件办理经过信息、案件

改期申请信息、案件附件信息、案件办理用时信息、案件督办催办信息和案件满意度信息。

6.2.4信息采集员数据类信息包括信息采集员基础信息、班次信息、排班信息、轨迹信息、在岗情况

信息、抽查任务信息、抽查任务回复信息。

区级系统向市级系统上报数据标准规范，接口约定的信息请参考表2数据上报索引表。

表2数据上报索引表

序号数据类别数据信息对应附录表

1问题来源字典参考附录C表C.2问题来源示例

2问题类型字典参考附录C表C.3问题类型信息示例

3问题大类字典参考附录C表C.7问题大类信息示例

4问题小类字典参考附录C表C.8问题小类信息示例

基础数据类信息

5行政区信息字典参考附录C表C.4行政区信息示例

6街道信息字典参考附录C表C.5街道信息示例

7社区信息字典参考附录C表C.6社区信息示例

8工作网格信息字典参考附录C表C.9工作网格信息示例

3

DB4403/T31—2019

表2数据上报索引表(续)

序号数据类别数据信息对应附录表

9工作网格卡点信息参考附录C表C.1工作网格卡点信息示例

基础数据类信息

10案件办理环节信息参考附录C表C.10案件办理环节信息示例

11案件基本信息参考附录A表A.1案件基本信息示例

12案件受理附件参考附录A表A.6案件受理附件示例

13案件受理信息参考附录A表A.5案件受理信息示例

14案件办理经过信息参考附录A表A.2案件办理过程信息示例

15案件数据类信息案件改期申请信息参考附录A表A.3案件申请延期（改期）信息示例

16案件附件信息参考附录A表A.4案件附件信息示例

17案件办理用时信息参考附录A表A.7案件办理用时信息示例

18案件督办催办信息参考附录A表A.8案件督办催办信息示例

19案件满意度信息参考附录A表A.9案件满意度信息

20信息采集员基础信息参考附录B表B.1信息采集员基础信息示例

21信息采集员班次信息参考附录B表B.2信息采集员工作班次信息示例

信息采集员数据

22信息采集员排班信息参考附录B表B.3信息采集员排班信息示例

类信息

23信息采集员轨迹信息参考附录B表B.4信息采集员轨迹信息示例

24信息采集员在岗情况信息参考附录B表B.5信息采集员在岗情况信息示例

6.3市级系统数据下行标准规范

6.3.1市级系统向区级系统下派的数据信息类型包括：案件数据类、信息采集员数据类。

6.3.2案件数据类信息包括案件下派信息、案件下派接收反馈信息。

6.3.3信息采集员数据类信息包括信息采集员抽查任务信息、信息采集员抽查任务回复信息。

市级系统向区级系统下派数据的标准规范，接口约定信息请参考表3数据下派索引表。

表3数据下派索引表

序号数据类别数据信息对应附录表

1案件数据类信案件下派信息表参考附录D表D.1案件下派信息示例

2息案件下派接收反馈信息参考附录D表D.2案件下派接收反馈信息示例

3信息采集员数信息采集员抽查任务信息参考附录E表E.1信息采集员抽查任务信息示例

4据类信息信息采集员抽查任务回复信息参考附录E表E.2信息采集员抽查任务回复信息示例

6.4市级系统数据下行接口规范

6.4.1市级系统进行数据下派的接口由市级系统提供，区级系统调用，按照市级系统提供的接口规范

进行设计。市级系统向区级系统下派的数据包括：

a)案件下派信息；

b)案件下派接收反馈信息；

c)信息采集员抽查任务信息；

d)信息采集员抽查任务回复信息。

4

DB4403/T31—2019

6.4.2案件下派数据信息接口规范

接口由市级系统提供，接口约定规范请详细见附录F中F.4市级系统案件下派接口规范示例。

6.4.3案件下派接收反馈信息接口规范

接口由市级系统提供，接口约定规范请详细见附录F中F.5区级案件处置反馈案件状态到市级系统接

口规范示例。

6.4.4信息采集员抽查任务信息接口规范

接口由市级系统提供，接口约定规范请详细见附录F中F.6从市级系统获取信息采集员抽查任务信息

接口规范示例。

6.4.5信息采集员抽查任务回复信息接口规范

接口由市级系统提供，接口约定规范请详细见附录F中F.7各区级系统调用市级系统接口反馈采集

员抽查任务反馈结果接口规范示例。

5

DB4403/T31—2019

附录A

（资料性附录）

数据上行案件数据类信息数据交换信息表示例

A.1案件类基本信息

示例见表A.1—A.9

表A.1案件基本信息示例

案件基本信息

字段描述字段名数据类型字段长度是否可空备注

案件标识evtIdString36否

立案时间regTimeDatetime20否

案件结束时间endTimeDatetime20否

受理号acceptIdString36否

案件号codeString32否

案件来源evtSrcIdString36否

案件类型typeIdString36否

问题大类bigClassIdString36否

问题小类smallClassIdString36否

部件CODEpartCodeString64否

案件标题titleString200否

事发位置positionString1024否

问题描述eventDescString2048否

所在区districtIdString36否

所在街道streetIdString36否

所在社区communityIdString36否

所在工作网格workGridIdString36否

所在单元网格gridIdString36否

绝对坐标XabsXNumber36否

绝对坐标YabsYNumber36否

举报人reporterString32否

回复号码或者邮件等replyWayString32否

来电号码telNumString36否

0未办结；

案件状态statusNumber4否

1已结案。

0.一般性案件;

案件等级importantLevelNumber4否1.重大案件;

2.特大案件。

案件登记时间dbCreateDateDatetime20否

最后更新时间dbLastUpdateDateDatetime20否

最后更新人dbLastUpdateIdString36否

6

DB4403/T31—2019

表A.1案件基本信息示例（续）

案件基本信息

字段描述字段名数据类型字段长度是否可空备注

由市级系统提

供，根据案件标

案件全市唯一标识evtUniqueIdString50否

识及案件标题

产生。

表A.2案件办理过程信息示例

案件办理过程信息

字段描述字段名数据类型字段长度是否可空备注

办理步骤标识activityInstIdString36否

案件idevtIdString36否

上一步骤标识prevActivityInstIdString36否

环节名称activityNameString50否

上一环节办理人姓名inUserNameString50否

接收对象名称receiveObjectNameString50否

接收对象所在部门名称receiveObjDeptNameString50否

来件时间inDateDatetime20否

办理时限limitNumber20否单位秒

办理时限文字描述limitStrString50否*天*小时*分

应完成时间shouldFinishedDateDatetime20否

实际完成时间finishedDateDatetime20否

签收人姓名signedUserNameString50否

签收时间signedTimeDatetime20否

操作人姓名operatorNameString50否

办理意见contentString128否

7

DB4403/T31—2019

表A.3案件申请延期（改期）信息示例

案件申请延期（改期）信息

字段描述字段名数据类型字段长度是否可空备注

案件idevtIdString36否

案件环节实例IDactInstIdString36否

发出申请日期reqDateDatetime20否

申请人姓名reqUserNameString50否

申请责任单位名称reqUserDeptNameString50否

申请理由reqReasonString512否

审核时间auditDateDatetime20否

审核人姓名auditUserNameString50否

对于部件案件:

0一般性处理；

1特殊性处理；,

2工程性处理。

审核后的处理类型auditTypeNumber12否对于事件案件：

11一般性处理；

12综合性处理；

20自行估算时限；

30无时限。

审核意见auditOpinionString512否

是否通过审核isPassBoolean12否

申请前的时限oldLimitNumber12否

审批后的时限newLimitNumber20否

8

DB4403/T31—2019

表A.4案件附件信息示例

案件附件信息

字段描述字段名数据类型字段长度是否可空备注

附件标识attachIdString36否

案件标识evtIdString36否

0：照片

附件类型typeNumber12否1：声音

2：视频

0：问题原始照片

1：核实照片

2：问题核查照片

附件用途usageNumber12否

3：专业部门上传的

附件

4：其他附件

文件名称fileNameString128否

绝对坐标XabsXNumber36否

绝对坐标YabsYNumber36否

创建时间dbCreateDateDatetime20否

附件下载地址downUrlString500否

表A.5案件受理信息示例

案件受理信息

字段描述字段名数据类型字段长度是否可空备注

受理标识acceptIdString36否

受理号acceptCodeString128否

受理角色IDacceptRoleIdString36否

案件来源evtSrcId