ICS35.240

L79

DB4403

深圳市地方標準

DB4403/T31—2019

數(shù)字城管數(shù)據(jù)交換規(guī)范

2019-11-15發(fā)布2019-12-01實施

深圳市市場監(jiān)督管理局發(fā)布

DB4403/T31—2019

數(shù)字城管數(shù)據(jù)交換規(guī)范

1范圍

本標準規(guī)范了數(shù)字化城市管理數(shù)據(jù)交換的術語與定義、基本規(guī)定、數(shù)據(jù)交換接口約定、數(shù)據(jù)交換規(guī)

范的內(nèi)容。

本標準適用于深圳市市、區(qū)兩級數(shù)字化城市管理信息系統(tǒng)之間的數(shù)據(jù)交換。

2規(guī)范性引用文件

下列文件對于本文件的應用是必不可少的。凡是注日期的引用文件，僅所注日期的版本適用于本文

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

GB/T2260中華人民共和國行政區(qū)劃代碼

GB/T30428.1-2013數(shù)字化城市管理信息系統(tǒng)第1部分：單元網(wǎng)格

GB/T30428.2-2013數(shù)字化城市管理信息系統(tǒng)第2部分：管理部件和事件

GB/T30428.3-2016數(shù)字化城市管理信息系統(tǒng)第3部分：地理編碼

GB/T30428.4-2016數(shù)字化城市管理信息系統(tǒng)第4部分：績效評價

GB/T30428.5-2017數(shù)字化城市管理信息系統(tǒng)第5部分：監(jiān)管信息采集設備

GB/T30428.6-2017數(shù)字化城市管理信息系統(tǒng)第6部分：驗收

GB/T30428.7-2017數(shù)字化城市管理信息系統(tǒng)第7部分：監(jiān)管信息采集

SZDB/Z300.1-2018數(shù)字化城市管理第1部分：總則

SZDB/Z300.2-2018數(shù)字化城市管理第2部分：信息采集規(guī)范

SZDB/Z300.3-2018數(shù)字化城市管理第3部分：案件立案規(guī)范

SZDB/Z300.4-2018數(shù)字化城市管理第4部分：處置和結案規(guī)范

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

數(shù)據(jù)交換對象DataExchangeObject

參與數(shù)據(jù)交換過程的數(shù)字化城市管理信息系統(tǒng)。

3.2

數(shù)據(jù)上行DataUpload

區(qū)級數(shù)字化城市管理信息系統(tǒng)向市級數(shù)字化城市管理信息系統(tǒng)進行數(shù)據(jù)上報或傳輸。

3.3

數(shù)據(jù)下行DataDownload

市級數(shù)字化城市管理信息系統(tǒng)向區(qū)級數(shù)字化城市管理信息系統(tǒng)進行數(shù)據(jù)下派或傳輸。

1

DB4403/T31—2019

4基本規(guī)定

4.1數(shù)據(jù)交換規(guī)則

4.1.1各區(qū)的信息采集員班次數(shù)據(jù)（見附錄B表B.3）應提前一天報送到市級系統(tǒng)；

4.1.2各區(qū)的信息采集員在崗狀態(tài)數(shù)據(jù)（附錄B表B.5）發(fā)生變化時需在1分鐘內(nèi)傳送到市級系統(tǒng)；

4.1.3其他各動態(tài)數(shù)據(jù)須在5分鐘內(nèi)報送到市級系統(tǒng)；

4.1.4區(qū)級系統(tǒng)的基礎數(shù)據(jù)類數(shù)據(jù)要根據(jù)雙方約定時間進行上報市級系統(tǒng)；

4.1.5市級系統(tǒng)的案件數(shù)據(jù)類、信息采集員數(shù)據(jù)類數(shù)據(jù)實時下派區(qū)級系統(tǒng)。

4.2數(shù)據(jù)傳輸方式

4.2.1結構化數(shù)據(jù)采取文本形式傳輸。

4.2.2非結構化數(shù)據(jù)（如影像類、聲音類等）采用url下載方式進行數(shù)據(jù)傳輸，采取二進制形式存儲。

4.3時間格式定義

系統(tǒng)定義的時間格式為yyyy-MM-ddHH:mm:ss（年-月-日時：分：秒）。

5數(shù)據(jù)交換接口約定

5.1數(shù)據(jù)交換接口基于國內(nèi)外主流的J2EE或.NET技術架構設計。

5.2數(shù)據(jù)交換對象是深圳市、區(qū)兩級數(shù)字化城市管理信息系統(tǒng)。

5.3數(shù)據(jù)交換方式采用WebAPI。

5.4數(shù)據(jù)交換周期包括實時交換、定期交換。

5.5數(shù)據(jù)交換類別包括結構化數(shù)據(jù)、非結構化數(shù)據(jù)，圖片類、圖像視頻類、文檔類等附件數(shù)據(jù)是非結

構化數(shù)據(jù)，文本信息類、數(shù)據(jù)庫表數(shù)據(jù)是結構化數(shù)據(jù)。

5.6接口協(xié)議采用Http或Https。

5.7接口編碼采用UTF-8。

5.8數(shù)據(jù)格式：接口數(shù)據(jù)的返回格式為JSON格式字符串，接口返回值詳見表1數(shù)據(jù)格式表。

表1數(shù)據(jù)格式表

JSON變量說明

success調(diào)用接口操作成功標志，boolean值true、false

code返回結果狀態(tài)標識，0代表成功，1代表失敗，-1代表其它

message返回結果的文字說明

data返回的結果數(shù)據(jù)

5.9安全驗證：根據(jù)授權用戶和密碼產(chǎn)生的隨機Token來訪問各API。

2

DB4403/T31—2019

6數(shù)據(jù)交換規(guī)范

6.1區(qū)級系統(tǒng)數(shù)據(jù)上行接口規(guī)范

6.1.1區(qū)級系統(tǒng)進行數(shù)據(jù)上報的接口由市級系統(tǒng)提供，按照市級系統(tǒng)提供的接口規(guī)范進行設計，區(qū)級

系統(tǒng)進行上報的數(shù)據(jù)包括：

a)案件基本信息；

b)案件辦理過程信息；

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

6.1.2案件上報數(shù)據(jù)信息接口規(guī)范

接口由市級系統(tǒng)提供，接口約定規(guī)范請詳細見附錄F中F.1上報案件預受理信息接口規(guī)范示例。

6.1.3案件辦理流程信息接口規(guī)范

案件的辦理流程需要同步辦理過程信息,接口由市級系統(tǒng)提供，接口約定規(guī)范請詳細見附錄F中F.2

同步案件的辦理流程信息接口規(guī)范示例。

6.1.4案件申請延期（改期）信息接口規(guī)范

區(qū)級系統(tǒng)辦理的案件，當申請延時（改期）被批準后需同步案件改期信息，接口由市級系統(tǒng)提供，

接口約定規(guī)范請詳細見附錄F中F.3同步案件的延期（改期）申請信息接口規(guī)范示例。

6.2區(qū)級系統(tǒng)上行數(shù)據(jù)規(guī)范

6.2.1區(qū)級系統(tǒng)向市級系統(tǒng)上報的數(shù)據(jù)信息類型包括：基礎數(shù)據(jù)類、案件數(shù)據(jù)類、信息采集員數(shù)據(jù)類。

6.2.2基礎數(shù)據(jù)類信息包括問題來源、問題類型、問題大類、問題小類、行政區(qū)信息、街道信息、社

區(qū)信息、工作網(wǎng)格信息、工作網(wǎng)格卡點信息和案件辦理環(huán)節(jié)信息。

6.2.3案件數(shù)據(jù)類信息包括案件基本信息、案件受理信息、案件受理附件、案件辦理經(jīng)過信息、案件

改期申請信息、案件附件信息、案件辦理用時信息、案件督辦催辦信息和案件滿意度信息。

6.2.4信息采集員數(shù)據(jù)類信息包括信息采集員基礎信息、班次信息、排班信息、軌跡信息、在崗情況

信息、抽查任務信息、抽查任務回復信息。

區(qū)級系統(tǒng)向市級系統(tǒng)上報數(shù)據(jù)標準規(guī)范，接口約定的信息請參考表2數(shù)據(jù)上報索引表。

表2數(shù)據(jù)上報索引表

序號數(shù)據(jù)類別數(shù)據(jù)信息對應附錄表

1問題來源字典參考附錄C表C.2問題來源示例

2問題類型字典參考附錄C表C.3問題類型信息示例

3問題大類字典參考附錄C表C.7問題大類信息示例

4問題小類字典參考附錄C表C.8問題小類信息示例

基礎數(shù)據(jù)類信息

5行政區(qū)信息字典參考附錄C表C.4行政區(qū)信息示例

6街道信息字典參考附錄C表C.5街道信息示例

7社區(qū)信息字典參考附錄C表C.6社區(qū)信息示例

8工作網(wǎng)格信息字典參考附錄C表C.9工作網(wǎng)格信息示例

3

DB4403/T31—2019

表2數(shù)據(jù)上報索引表(續(xù))

序號數(shù)據(jù)類別數(shù)據(jù)信息對應附錄表

9工作網(wǎng)格卡點信息參考附錄C表C.1工作網(wǎng)格卡點信息示例

基礎數(shù)據(jù)類信息

10案件辦理環(huán)節(jié)信息參考附錄C表C.10案件辦理環(huán)節(jié)信息示例

11案件基本信息參考附錄A表A.1案件基本信息示例

12案件受理附件參考附錄A表A.6案件受理附件示例

13案件受理信息參考附錄A表A.5案件受理信息示例

14案件辦理經(jīng)過信息參考附錄A表A.2案件辦理過程信息示例

15案件數(shù)據(jù)類信息案件改期申請信息參考附錄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信息采集員工作班次信息示例

信息采集員數(shù)據(jù)

22信息采集員排班信息參考附錄B表B.3信息采集員排班信息示例

類信息

23信息采集員軌跡信息參考附錄B表B.4信息采集員軌跡信息示例

24信息采集員在崗情況信息參考附錄B表B.5信息采集員在崗情況信息示例

6.3市級系統(tǒng)數(shù)據(jù)下行標準規(guī)范

6.3.1市級系統(tǒng)向區(qū)級系統(tǒng)下派的數(shù)據(jù)信息類型包括：案件數(shù)據(jù)類、信息采集員數(shù)據(jù)類。

6.3.2案件數(shù)據(jù)類信息包括案件下派信息、案件下派接收反饋信息。

6.3.3信息采集員數(shù)據(jù)類信息包括信息采集員抽查任務信息、信息采集員抽查任務回復信息。

市級系統(tǒng)向區(qū)級系統(tǒng)下派數(shù)據(jù)的標準規(guī)范，接口約定信息請參考表3數(shù)據(jù)下派索引表。

表3數(shù)據(jù)下派索引表

序號數(shù)據(jù)類別數(shù)據(jù)信息對應附錄表

1案件數(shù)據(jù)類信案件下派信息表參考附錄D表D.1案件下派信息示例

2息案件下派接收反饋信息參考附錄D表D.2案件下派接收反饋信息示例

3信息采集員數(shù)信息采集員抽查任務信息參考附錄E表E.1信息采集員抽查任務信息示例

4據(jù)類信息信息采集員抽查任務回復信息參考附錄E表E.2信息采集員抽查任務回復信息示例

6.4市級系統(tǒng)數(shù)據(jù)下行接口規(guī)范

6.4.1市級系統(tǒng)進行數(shù)據(jù)下派的接口由市級系統(tǒng)提供，區(qū)級系統(tǒng)調(diào)用，按照市級系統(tǒng)提供的接口規(guī)范

進行設計。市級系統(tǒng)向區(qū)級系統(tǒng)下派的數(shù)據(jù)包括：

a)案件下派信息；

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

c)信息采集員抽查任務信息；

d)信息采集員抽查任務回復信息。

4

DB4403/T31—2019

6.4.2案件下派數(shù)據(jù)信息接口規(guī)范

接口由市級系統(tǒng)提供，接口約定規(guī)范請詳細見附錄F中F.4市級系統(tǒng)案件下派接口規(guī)范示例。

6.4.3案件下派接收反饋信息接口規(guī)范

接口由市級系統(tǒng)提供，接口約定規(guī)范請詳細見附錄F中F.5區(qū)級案件處置反饋案件狀態(tài)到市級系統(tǒng)接

口規(guī)范示例。

6.4.4信息采集員抽查任務信息接口規(guī)范

接口由市級系統(tǒng)提供，接口約定規(guī)范請詳細見附錄F中F.6從市級系統(tǒng)獲取信息采集員抽查任務信息

接口規(guī)范示例。

6.4.5信息采集員抽查任務回復信息接口規(guī)范

接口由市級系統(tǒng)提供，接口約定規(guī)范請詳細見附錄F中F.7各區(qū)級系統(tǒng)調(diào)用市級系統(tǒng)接口反饋采集

員抽查任務反饋結果接口規(guī)范示例。

5

DB4403/T31—2019

附錄A

（資料性附錄）

數(shù)據(jù)上行案件數(shù)據(jù)類信息數(shù)據(jù)交換信息表示例

A.1案件類基本信息

示例見表A.1—A.9

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

案件基本信息

字段描述字段名數(shù)據(jù)類型字段長度是否可空備注

案件標識evtIdString36否

立案時間regTimeDatetime20否

案件結束時間endTimeDatetime20否

受理號acceptIdString36否

案件號codeString32否

案件來源evtSrcIdString36否

案件類型typeIdString36否

問題大類bigClassIdString36否

問題小類smallClassIdString36否

部件CODEpartCodeString64否

案件標題titleString200否

事發(fā)位置positionString1024否

問題描述eventDescString2048否

所在區(qū)districtIdString36否

所在街道streetIdString36否

所在社區(qū)communityIdString36否

所在工作網(wǎng)格workGridIdString36否

所在單元網(wǎng)格gridIdString36否

絕對坐標XabsXNumber36否

絕對坐標YabsYNumber36否

舉報人reporterString32否

回復號碼或者郵件等replyWayString32否

來電號碼telNumString36否

0未辦結；

案件狀態(tài)statusNumber4否

1已結案。

0.一般性案件;

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

2.特大案件。

案件登記時間dbCreateDateDatetime20否

最后更新時間dbLastUpdateDateDatetime20否

最后更新人dbLastUpdateIdString36否

6

DB4403/T31—2019

表A.1案件基本信息示例（續(xù)）

案件基本信息

字段描述字段名數(shù)據(jù)類型字段長度是否可空備注

由市級系統(tǒng)提

供，根據(jù)案件標

案件全市唯一標識evtUniqueIdString50否

識及案件標題

產(chǎn)生。

表A.2案件辦理過程信息示例

案件辦理過程信息

字段描述字段名數(shù)據(jù)類型字段長度是否可空備注

辦理步驟標識activityInstIdString36否

案件idevtIdString36否

上一步驟標識prevActivityInstIdString36否

環(huán)節(jié)名稱activityNameString50否

上一環(huán)節(jié)辦理人姓名inUserNameString50否

接收對象名稱receiveObjectNameString50否

接收對象所在部門名稱receiveObjDeptNameString50否

來件時間inDateDatetime20否

辦理時限limitNumber20否單位秒

辦理時限文字描述limitStrString50否*天*小時*分

應完成時間shouldFinishedDateDatetime20否

實際完成時間finishedDateDatetime20否

簽收人姓名signedUserNameString50否

簽收時間signedTimeDatetime20否

操作人姓名operatorNameString50否

辦理意見contentString128否

7

DB4403/T31—2019

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

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

字段描述字段名數(shù)據(jù)類型字段長度是否可空備注

案件idevtIdString36否

案件環(huán)節(jié)實例IDactInstIdString36否

發(fā)出申請日期reqDateDatetime20否

申請人姓名reqUserNameString50否

申請責任單位名稱reqUserDeptNameString50否

申請理由reqReasonString512否

審核時間auditDateDatetime20否

審核人姓名auditUserNameString50否

對于部件案件:

0一般性處理；

1特殊性處理；,

2工程性處理。

審核后的處理類型auditTypeNumber12否對于事件案件：

11一般性處理；

12綜合性處理；

20自行估算時限；

30無時限。

審核意見auditOpinionString512否

是否通過審核isPassBoolean12否

申請前的時限oldLimitNumber12否

審批后的時限newLimitNumber20否

8

DB4403/T31—2019

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

案件附件信息

字段描述字段名數(shù)據(jù)類型字段長度是否可空備注

附件標識attachIdString36否

案件標識evtIdString36否

0：照片

附件類型typeNumber12否1：聲音

2：視頻

0：問題原始照片

1：核實照片

2：問題核查照片

附件用途usageNumber12否

3：專業(yè)部門上傳的

附件

4：其他附件

文件名稱fileNameString128否

絕對坐標XabsXNumber36否

絕對坐標YabsYNumber36否

創(chuàng)建時間dbCreateDateDatetime20否

附件下載地址downUrlString500否

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

案件受理信息

字段描述字段名數(shù)據(jù)類型字段長度是否可空備注

受理標識acceptIdString36否

受理號acceptCodeString128否

受理角色IDacceptRoleIdString36否

案件來源evtSrcIdString36否

案件類型typeIdString36否

問題大類bigClassIdString36否

問題小類smallClassIdString36否

部件IDpartIdString36否

部件CODEpartCodeString64否

事發(fā)位置positionString1024否

問題描述eventDescString2048否

所在區(qū)districtIdString36否

所在街道streetIdString36否

所在社區(qū)communityIdString36否

所在工作網(wǎng)格workGridIdString36否

所在單元網(wǎng)格gridIdString36否

9

DB4403/T31—2019

表A.5案件受理信息示例（續(xù)）

案件受理信息

字段描述字段名數(shù)據(jù)類型字段長度是否可空備注

絕對坐標XabsXNumber36否

絕對坐標YabsYNumber36否

舉報人reporterString32否

0：未受理

受理狀態(tài)statusNumber12否1：已經(jīng)轉(zhuǎn)案件

2：不予受理

受理意見acceptOpinionString256否

簽收時間signDateDatetime20否

簽收人signUserString36否

舉報時間dbCreateDateDatetime20否

舉報人反饋feedbackString500否

處理速度得分processSpeedScoreNumber36否

處理質(zhì)量得分processQualityScoreNumber36否

是否重復投訴isRepeatBoolean36否

注：公眾舉報類的案件,將產(chǎn)生案件預受理記錄；信息采集員上報的案件，不產(chǎn)生受理信息。

表A.6案件受理附件示例

案件受理附件

字段描述字段名數(shù)據(jù)類型字段長度是否可空備注

附件標識attachIdString36否

案件idevtIdString36否

0：照片

1：聲音

附件類型typeNumber12否

2：視頻;

3.其他

附件名稱fileNameString128否

創(chuàng)建時間dbCreateDateDatetime20否

創(chuàng)建人IDdbCreateIdString36否

創(chuàng)建人姓名dbCreateNameString64否

附件下載地址downUrlString500否

注：公眾舉報類案件，如果上傳圖片、聲音、視頻等附件，本表將記錄相關信息。

10

DB4403/T31—2019

表A.7案件辦理用時信息示例

案件辦理用時信息

字段描述字段名數(shù)據(jù)類型字段長度是否可空備注

案件IDevtIdString36否

立案時間reqDateDatetime20否

結案時間endDateDatetime20否

責任單位名稱lastDeptNameString50否

責任單位意見lastDeptContextString1000否

責任單位開始時間lastDeptBeginDateDatetime20否

責任單位結束時間lastDeptEndDateDatetime20否

0屬實，1不屬實

核實結果hcResNumber12否

2已完成，3未完成

0屬實，1不屬實

核查結果hsResNumber12否

2已完成，3未完成

0街道案件

案件屬性evtAttrNumber12否1區(qū)屬案件

2市屬案件

注：案件立案、結案、派遣、處置完成時，將產(chǎn)生案件辦理用時信息。

表A.8案件督辦信息示例

案件督辦催辦信息

字段描述字段名數(shù)據(jù)類型字段長度是否可空備注

督辦標識idString36否

案件IDevtIdString36否

意見descString50否

督辦人IDuserIdString36否

督辦人名稱userNameString50否

督辦時間dateDatetime20否

注：對案件進行督辦時，將產(chǎn)生相關信息。

11

DB4403/T31—2019

表A.9案件滿意度回訪信息示例

案件滿意度信息

字段描述字段名數(shù)據(jù)類型字段長度是否可空備注

回訪標識ididString36否

回訪人sendUserString36否

案件IDevtIdString36否

回訪時間sendDateDatetime20否

回復內(nèi)容sendBodyString2000否

公眾反饋時間feedbackTimeDatetime20否

0.未知；

1.滿意；

公眾反饋滿意狀態(tài)feedbackStatusNumber12否

3.不滿意;

4.無意見

公眾反饋內(nèi)容feedbackContentString2000否

創(chuàng)建時間dbCreateDateDatetime20否

12

DB4403/T31—2019

附錄B

（資料性附錄）

數(shù)據(jù)上行信息采集員數(shù)據(jù)類信息上報數(shù)據(jù)交換信息示例

B.1信息采集員基本信息

示例見表B.1—B.5

表B.1信息采集員基礎信息示例

信息采集員基礎信息

字段描述字段名數(shù)據(jù)類型字段長度是否可空備注

信息采集員標識obIdString36否

街道IDstreetIdString36否

社區(qū)IDcommunityIdString36否

登錄名