ICS35.100CCSL79ICS35.100CCSL79安 徽 省 地 方 標 準DB34/T4141—2022電梯應急救援平臺數據接口規范發布安徽省市場監督管理局發布安徽省市場監督管理局2022042920220329DB34/T4141DB34/T4141—2022前 言本文件按照GB/T1.1—2020《標準化工作導則第1部分：標準化文件的結構和起草規則》的規定起草。本文件起草單位：安徽省特種設備檢測院、科大國創云網科技有限公司。本文件主要起草人：莫誠生、趙龍、許迪、許佳偉、嚴偉、姚剛、王啟龍、熊鈺才、汪源、許路夷。IIDB34/T4141DB34/T4141—2022DB34/T4141—DB34/T4141—2022據下載和上傳，以完成平臺間數據的互聯互通。數據交換架構如圖1所示：電梯應急救援平臺數據接口規范范圍本文件規定了電梯應急救援平臺的數據交換架構、接口基本規定、接口協議清單及內容。）本文件沒有規范性引用文件。下列術語和定義適用于本文件。3.1使用單位elevatoruser1使用單位；產權單位自行管理的電梯，產權單位是使用單位。1使用單位；產權單位自行管理的電梯，產權單位是使用單位。[來源：TSG08-2017，2.1.2]3.2網格grid119、1103.3電梯一識 theuniqueidentificationofelevator用于電梯應急救援定位的唯一編碼。3.4JSONJavaScript對象簡譜（(JavaScriptObjectNotation），是一種輕量級的數據交換格式。3.5JavaScript一種具有函數優先的輕量級、解釋型或即時編譯型的網頁編程語言。3.6HTTP超文本傳輸協議（HyperTextTransferProtocol），是一種請求-響應協議。4 圖1 數據換構圖2數據接口協議統一采用HTTP協議,接口請求方式為POST請求，采用同步方式進行。接口交換格式采用JSON傳輸數據，具備通用性和可擴展性。2數據接口協議統一采用HTTP協議,接口請求方式為POST請求，采用同步方式進行。接口交換格式采用JSON傳輸數據，具備通用性和可擴展性。關于接口規范的數據清單應符合附錄A的規定。附錄A（規范性）電梯應急救援平臺數據接口規范接口標識符：Dict。接口說明：用于獲取省電梯平臺內的數據字典信息。省電梯平臺提供的數據字典接口的輸入參數及說明見表A.1。33接口標識符：DtList。接口說明：本接口用于獲取電梯基礎信息數據。電梯基礎信息接口的輸入參數及說明見表A.3。A.1.1.3 省電梯平臺提供的數據字典接口的返回參數及說明見表A.2。表A.2省電梯平臺數據字典接口返回參數及說明輸入參數名類型非空參數描述typeString是type故障類型：FALT_TYPE；AREA_CODE：區域字典。PageInt否頁數（默認為1）RowsInt否每頁顯示數（默認為10）返回參數類型非空字段描述DataLabelString是數據字段編碼ValueString是數據值TypeString是字段類型DescriptionString是數據字段描述ParentValueString否父級字段數據值DB34/T4141DB34/T4141—2022DB34/T4141—DB34/T4141—2022A.4（）表A.3電梯基礎信息接口輸入參數及說明參數名類型非空參數描述EquDataSysIDString否設備系統內IDEquCardNoString否電梯唯一標識EquCodeString否設備代碼equregcodeString否設備注冊代碼ProNoString否產品編號(出廠編號)UseCarNoString否使用證編號equlocarecodeString否設備所在地區(縣)字段編碼MtorgNameString否維保單位名稱UseOrgNameString否使用單位名稱porgaonameString否制造單位名稱buiorgnameString否安裝單位名稱PageInt否頁數（默認為1）RowsInt否每頁顯示數（默認為10）A.1.2.3 電梯基礎信息返回參數及說明見表A.4。44返回參數字段類型非空字段描述DataEquDataSysIDString是設備系統內IDEquCardNoString否電梯唯一標識編號EquCodeString是設備代碼EquRegCodeString是設備注冊代碼EquClaCodeString是設備種類編碼EquKindCodeString是設備類別編碼EquVartString是設備品種編碼EquipNameString是設備名稱EquipModelString是設備型號ProNoString是產品編號(出廠編號)UseCarNoString是使用證編號IssuecerDateString是最新發證日期（yyyy-MM-dd）RegOrgCodeString是注冊登記機構名稱55返回參數字段類型非空字段描述DataRegNoString是登記表編號EquLogCodeString是設備注冊字段編碼LoginStateString是注冊狀態UseStatusString是使用狀態IsInsuranceString否是否購置保險EquLocareCodeString是設備所在地區(縣)字段編碼EquLocareNameString是設備所在地區(縣)名稱EquLocareInfoString是設備詳細地址EquOrgNoString是設備單位內部編號MtorgNameString是維保單位名稱MtOrgLinmanString是維保單位聯系人MtOrgLintelString是維保單位聯系電話MtPrgAddString是維保單位地址MtDeadLineString是維保合同截止時間（yyyy-MM-dd）UseOrgNameString是使用單位名稱UseOrgAddString是使用單位地址EconoTypeCodeString是單位經濟類型UseOrgLinmanString是使用單位聯系人UseOrgLintelString是使用單位聯系電話EquUseDateString是設備投用日期（yyyy-MM-dd）porgaonameString是制造單位名稱BuiOrgNameString是安裝單位名稱EqubuiapDateString是設備安裝日期（yyyy-MM-dd）lastInspectorgnameString是最新檢驗機構名稱lastInspecttypeString是最近檢驗類型LastInspecttimeString是最近檢驗日期（yyyy-MM-dd）LastInspectresultString是最近檢驗結論LocationInfoString是作為分隔符，如“坐標系有：WGS84、CGCS2000、西安80、北京54、其他LongitudeString是所在經度LatitudeString是所在維度MainStrFormString否主體結構形式ManageModeString否管理方式EleMoveSpeedFloat否電梯運行速度EleratingloadFloat否電梯額定載荷66表A.4 電梯礎息口回數及明續）返回參數字段類型非空字段描述DataElefloorString否電梯層站EleheightFloat否電梯提升高度（m）TracangtypeString否曳引機型號TracangleafacnumberString否曳引機出廠編號ElectTypeString否電動機型號ElectLeafacNumberString否電動機出廠編號ElectRoPowerFloat否電動機功率（MW）ConscrTypeString否控制屏型號ContscrCodeString否控制屏出廠編號RestSpeedTypeString否限速器型號RestSpleafacNumberString否限速器出廠編號LadincangleFloat否扶梯傾斜角（°）RundlebreadthFloat否梯級寬度（m）ElewalkDistanceFloat否電梯走行距離（m）EleStadeNumberInt否電梯站數EleFloorNumberInt否電梯層數EleDoorNumberInt否電梯門數RatedSpeedFloat否額定速度BlastProofFormLevelString否防爆等級BlastProofFormString否防爆形式SeneRunModeString否節能運行方式ContrModeString否控制方式StartModeString否啟動方式PassennumbInt否乘客人數RoomLengthFloat否機房長（m）RoomHeightFloat否機房高（m）RoomWidthFloat否機房寬（m）roomformString否機房形式BinLengthFloat否轎箱長（m）BinHeightFloat否轎箱高（m）BinWidthFloat否轎箱寬（m）DoorPatternString否門型式BalaquotString否平衡系數DragModeString否拖動方式PullPowerFloat否拖動功率（MW）FireControlFormString否消防形式RopewrapmodeString否曳引繩繞繩方式接口標識符：OrgInfo。（7返回參數字段類型非空字段描述DataPullquotString否曳引系數AdspeedmodeString否調速方式RisemodeString否頂升方式RatedvelocityupFloat否額定速度（上行）RatedvelocitydownFloat否額定速度（下行）SwingratioString否懸掛比SwingropestrString否懸掛繩結構HydprecoolmodeString否液壓泵冷卻方式HydpretmarkString否液壓油液牌號OiljartypeString否油缸類型OilBoxContFloat否油箱容量（L）OilJarpressFloat否油缸壓力（MPA）OilhydrpumpoutputFloat否油壓泵流量（m3/s）LiquhydrpumpoutputFloat否液壓泵功率（MW）OilcrockamountInt否油缸數量BerthnumInt否泊位數量SafeclamnumString否安全鉗編號SafeclamtypeString否安全鉗編號CompentypeString否補償方式BottomdepthFloat否底坑深度RatingcurrentFloat否額定電流RatingvoltageFloat否額定電壓TopheightFloat否頂層高度(m)CounorbtypeString否對重導軌型式CounteramountString否對重塊數量RunmethodString否運行方法BuffernumberString否緩沖器數量BuffertypeString否緩沖器型號ExttechparamString否擴展技術屬性DesigncriterionString否設計規范ManufacturecriterionString否制造規范單位主體信息接口的輸入參數及說明見表A.5。表A.5單位主體接口輸入參數及說明參數名類型非空參數描述UnitNatureString是單位性質unitNature傳入不同值獲取不同的單位應急救援支援單位信息UnitNameString是單位名稱UnitCodeString否單位統一社會信用代碼PageInt否頁數（默認為1）RowsInt否每頁顯示數（默認為10）A.1.3.3 單位主體信息返回參數及說明見表A.6。接口標識符：DtReport。接口說明：本接口用于獲取電梯安裝改造維修告知業務的數據。電梯安裝改造維修告知信息接口的輸入參數及說明見表A.7。8返回參數類型非空字段描述DataUnitNameString是單位名稱UnitSimpleNameString否單位簡稱PropertyUnitSocialCodeString是統一社會信用代碼UnitPhoneString是單位聯系電話UnitLegalStaffString是法定代表人UnitLegalPhoneString是聯系人聯系電話UnitContactStaffString是單位聯系人UnitLocationString是單位地址LocationInfoString否分隔符，如“坐標系有：WGS84、CGCS2000、西安80、北京54、其他LongitudeString否經度LatitudeString否緯度UnitStatusString是單位狀態UnitNatureString是單位類型DB34/T4141DB34/T4141—2022DB34/T4141DB34/T4141—2022表A.7電梯安裝改造維修告知信息接口輸入參數及說明參數名類型非空參數描述EquDataSysIDString否設備系統內IDEquCardNoString否電梯唯一標識編號ProNoString是產品編號(出廠編號)NoticeCodeString否告知單號ConstructUnitNameString否施工單位名稱PageInt否頁數（默認為1）RowsInt否每頁顯示數（默認為10）A.1.4.3 電梯安裝改造維修告知信息接口返回參數及說明見表A.8。99）接口標識符：DtRegister。接口說明：接口用于獲取電梯使用登記和變更的業務記錄。使用登記（變更）接口的輸入參數及說明見表A.9。返回參數字段類型非空字段描述DataEquCardNoString否電梯唯一標識編號EquDataSysIDString是設備系統內IDNoticeCodeString是告知單號StatusInt是告知單狀態：0-申請中，1-已受理 5-填寫中ConstructUnitNameString是施工單位名稱ConstructUnitCodeString是施工單位統一社會信用代碼ConstructCertString是施工許可證編號ConstructCertDateString是許可證有效期（yyyy-MM-dd）ConstructUnitLinkmanString是施工單位聯系人ConstructUnitTelString是施工單位電話ConstructUnitAddressString是施工單位地址ConstrSortString是施工類別。1：新裝；2：改造；3：重大維修Construct日期型String是施工日期（yyyy-MM-dd）useUnitNameString是使用單位名稱installStartDateString否安裝開工日期（yyyy-MM-dd）installEndDateString否安裝竣工日期（yyyy-MM-dd）CreateDateString是告知時間表A.9使用登記（變更）信息接口輸入參數及說明參數名類型非空參數描述EquCardNoString否電梯唯一標識編號EquDataSysIDString否設備系統內IDSerialNumberString否業務流水號certificateNoString否使用登記證編號useUnitNameString否使用單位名稱propUnitNameString否產權單位名稱PageInt否頁數（默認為1）RowsInt否每頁顯示數（默認為10）A.1.5.3 使用登記（變更）接口返回參數及說明見表A.10。接口標識符：DtCheckInfo。接口說明：接口用于獲取電梯檢驗記錄信息數據。10返回參數字段類型非空字段描述DataEquCardNoString否電梯唯一標識編號EquDataSysIDString是設備系統內IDSerialNumberString是業務流水號CertificateNoString是使用登記證編號RegisTypeInt是登記類型。1：首次登記；2：設備過戶；3：單位名稱變更；4：設備移裝；5：地址信息變更；6：其他CreateDateString是創建日期（yyyy-MM-dd）UseUnitNameString是使用單位名稱UseUnitAddressString是使用單位詳細地址UseUnitCreditCodeString是使用單位統一社會信用代碼UseUnitNoString是單位內編號UseAddressString是設備使用地點UseDateString是投入使用日期（yyyy-MM-dd）UseUnitTelString是單位固定電話SafetyAdminString是安全管理員SafetyAdminMobileString是安全管理員電話PropUnitNameString是產權單位名稱PropUnitCreditCodeString是產權單位統一社會信用代碼PropUnitPhoneString是產權單位聯系電話電梯檢驗檢測記錄接口的輸入參數及說明見表A.11。表A.11電梯檢驗檢測記錄接口輸入參數及說明參數名類型非空參數描述EquCardNoString否電梯唯一標識編號EquDataSysIDString否設備系統內IDSerialNumberString是業務流水號InspectorgNameString否檢驗機構名稱InspectorTypeInt否檢驗檢測類型。1：安裝改造維修監督檢驗；2：定期檢驗；3：定期檢測InspectrepnoString否檢驗檢測報告編號PageInt否頁數（默認為1）RowsInt否每頁顯示數（默認為10）電梯檢驗檢測記錄接口返回參數及說明見表A.12。1111接口說明：接口用于查詢電梯停用報廢注銷信息。電梯停用報廢注銷信息接口的輸入參數及說明見表A.13。返回參數類型非空參數描述DataSerialNumberString是業務流水號EquCardNoString否電梯唯一標識編號EquDataSysIDString是設備系統內IDInspectOrgNameString是檢驗/檢測機構名稱InspectStaffString是檢驗員姓名InspectorTypeInt否檢驗檢測類型。1：安裝改造維修監督檢驗；2：定期檢驗；3：定期檢測InspectRepNoString是檢驗/檢測報告編號InspectStaDateString是檢驗/檢測受理日期（yyyy-MM-dd）InspectEndDateString是檢驗/檢測完成日期（yyyy-MM-dd）InspectResultString是檢驗/檢測結論NextInspectDateString是計劃下次檢驗/檢測時間（yyyy-MM-dd）表A.13電梯停用報廢注銷信息接口輸入參數及說明參數名類型非空參數描述EquCardNoString否電梯唯一標識編號EquDataSysIDString否設備系統內IDProNoString否產品編號（出廠編號）SerialNumberString是業務流水號BeginTimeString否登記時間查詢區間-開始時間（yyyy-MM-dd）EndTimeString否登記時間查詢區間-結束時間（yyyy-MM-dd）registerTypeInt否登記類型。1：停用；2：報廢；3：注銷PageInt否頁數（默認為1）RowsInt否每頁顯示數（默認為10）A.1.7.3 電梯停用報廢注銷記錄接口返回參數及說明見表A.14。接口標識符：DtReboot。接口說明：該接口用于查詢獲取電梯停用后重新恢復的信息。電梯停用后啟用信息接口的輸入參數及說明見表A.15。12返回參數類型非空字段描述DataSerialNumberString是業務流水號EquDataSysIDString是設備系統內IDEquCardNoString否電梯唯一標識編號ProNoString是產品編號（出廠編號）registerypeInt是登記類型。1：停用；2：報廢；3：注銷registertimeString是登記時間（yyyy-MM-dd）RealTimeString是實際停用/報廢/注銷時間（yyyy-MM-dd）UseUnitCodeString是使用單位統一社會信用代碼UseUnitnameString是使用單位名稱StaffNameString是申請人姓名StaffNoString是申請人聯系電話表A.15電梯停用后啟用信息接口輸入參數及說明參數名類型非空參數描述EquCardNoString否電梯唯一標識編號EquDataSysIDString否設備系統內IDProNoString否產品編號（出廠編號）SerialNumberString是業務流水號BeginTimeString否登記時間查詢區間-開始時間（yyyy-MM-dd）EndTimeString否登記時間查詢區間-結束時間（yyyy-MM-dd）PageInt否頁數（默認為1）RowsInt否每頁顯示數（默認為10）A.1.8.3 電梯停用后啟用記錄接口返回參數及說明見表A.16。1313接口標識符：DtExpandInfo。接口說明：該接口用于上傳地方電梯平臺針對電梯救援管理所拓展的數據信息。電梯拓展信息接口的輸入參數及說明見表A.17。返回參數類型非空字段描述DataSerialNumberString是業務流水號EquDataSysIDString是設備系統內IDEquCardNoString否電梯唯一標識編號ProNoString是產品編號（出廠編號）RegisterTypeInt是登記類型。1：停用；2：報廢；3：注銷RegisterTimeString是登記時間（yyyy-MM-dd）RebootTimeString是（計劃）重新啟用時間（yyyy-MM-dd）UseUnitCodeString是使用單位統一社會信用代碼UseUnitNameString是使用單位名稱StaffNameString是申請人姓名StaffNoString是申請人聯系電話1414接口標識符：DtRescueGrid。A.2.1.3 電梯拓展信息上傳后的返回參數及說明見表A.18。表A.18電梯拓展信息接口返回參數及說明表A.17電梯拓展信息接口接口輸入參數及說明參數名類型非空參數描述EquDataSysIDString是設備系統內IDEquCardNoString是電梯唯一標識編號EquCodeString是設備代碼EquRegCodeString是設備注冊代碼EquClaCodeString是設備種類編碼EquKindCodeString是設備類別編碼EquVartString是設備品種編碼EquipNameString是設備名稱EquipModelString是設備型號EquCardTypeInt是救援標識類型。1：救援標識牌；2：物聯網設備。MaintainOrgNameString是維保單位名稱MaintainOrgCodeString是維保單位統一社會信用代碼MaintainOrgIdString否維保單位IDMaintaiStatusString是電梯維保狀態。0：不在保；1：在保UseOrgNameString否使用單位簡稱或別名EquLocareInfoString是電梯所在地址LocationInfoString否坐標系及地理信息描述等，其形式以逗號作為分隔符，如“WGS84”，坐標系有：WGS84、CGCS2000、西安80、北京54、其他LongitudeString否定位所在經度LatitudeString否定位所在維度參數名類型非空參數描述DataInt是電梯記錄上傳成功記錄數RtStatusString是上傳狀態碼MsgString是上傳狀態描述FromSystemString是來自哪個系統功能1515接口標識符：Operators。接口說明：該接口用于上傳電梯維保人員、檢驗檢測人員、安全管理員、救援人員的信息。人員主體信息接口的輸入參數及說明見表A.21。A.2.2.3 救援單位信息返回參數及說明見表A.20。表A.20救援單位信息接口返回參數及說明救援單位信息接口的輸入參數及說明見表A.19。表A.19救援單位信息接口輸入參數及說明返回參數類型非空字段描述DataIDint是網格IDMtOrgidint是救援單位IDMtorgCodeString是救援單位統一社會信用代碼MtorgNameString是救援單位名稱MtOrgtelString是救援單位電話MtStuffname1String是救援人員姓名1MtStufftel1String是救援人員手機1MtStuffname2String否救援人員姓名2MtStufftel2String否救援人員手機2MtStuffname3String否救援人員姓名3MtStufftel3String否救援人員手機3MtOrgAddString是救援單位地址GridListString否1222大緯度2]…)MtOrgTypeInt是救援單位類型。1：1級救援單位；2：2級救援單位；3：3級救援單位ChargeAreaString是負責救援的區域編碼StatusInt是數據狀態，其中-1：刪除，0：停用，1：在用參數名類型非空參數描述DataInt是救援單位上傳成功記錄數RtStatusString是上傳狀態碼MsgString是上傳狀態描述FromSystemString是來自哪個系統功能接口說明：該接口用于上傳電梯無紙化維保記錄。電梯無紙化維保記錄接口的輸入參數及說明見表A.23。16A.2.3.3 人員主體信息返回參數及說明見表A.22。表A.22人員主體信息接口返回參數及說明表A.21人員主體信息接口輸入參數及說明參數名字段類型非空字段描述DataStaffIdInt是人員IDStaffNameString是人員姓名IdCardNoString是身份證號AgeInt是年齡GenderString是性別PhoneNumberString是手機電話號碼JobNumberString否工號PropertyUnitSocialCodeString是所屬單位統一社會信用代碼StationNameString是崗位名稱OnStationStatusString否在職狀態WorkingYearsInt否行業工作年限JobDescriptionString否崗位說明EducationLevelString否最高學歷GraduateSchoolString否最高學歷畢業院校MajorNameString否專業名稱GraduateDateString否畢業時間（yyyy-MM-dd）IsOperationStaffString否是否為作業人員CertificateClassString否證書種類CertificateTypeString否證書類型CertificateDateString否證書取得時間（yyyy-MM-dd）CertificateEffectiveDateString否證書有效期（yyyy-MM-dd）參數名類型非空參數描述DataInt是人員主體信息上傳成功記錄數RtStatusString是上傳狀態碼MsgString是上傳狀態描述FromSystemString是來自哪個系統功能表A.23電梯無紙化維保記錄接口輸入參數及說明返回參數類型非空字段描述DataIDString是工單IDEquDataSysIDString是設備系統內IDEquCardNoString否電梯唯一標識編號ProNoString是產品編號（出廠編號）MaintainTypeInt是維保工單類型。1：半月保養；2：季度保養；3：半年保養；4：年度保養；5：其他MaintainBeginTimeString是保養開始時間（yyyy-MM-ddHH:mm:ss）MaintainEndTimeString是保養結束時間（yyyy-MM-ddHH:mm:ss）MtorgCodeString是維保單位統一社會信用代碼MtorgNameString是維保單位名稱StaffNameString是維保單位姓名StaffNoString是維保單位聯系電話MaintainItemString是維保項目明細MaintainResultString否維保結論建議A.2.4.3 1717接口標識符：DtFaultInfo。接口說明：該接口用于上傳電梯故障處理記錄。電梯故障處理記錄接口的輸入參數及說明見表A.25。表A.24電梯無紙化維保記錄接口返回參數及說明參數名類型非空參數描述DataInt是電梯維保記錄上傳成功數RtStatusString是上傳狀態碼MsgString是上傳狀態描述FromSystemString是來自哪個系統功能表A.25電梯故障處理記錄接口輸入參數及說明返回參數類型非空字段描述DataIDString是工單IDEquDataSysIDString是設備系統內IDEquCardNoString否電梯唯一標識編號ProNoString是產品編號（出廠編號）FaulTypeInt是故障類型FaultReasonString是故障原因說明FaultBeginTimeString是故障發現時間（yyyy-MM-ddHH:mm:ss）ChargeOrgString是責任單位FaultDealTimeString是故障處置時間（yyyy-MM-ddHH:mm:ss）FaultResultInt是故障處置結果。0：未處置；1：已處置A.2.5.3 電梯故障處理記錄接口返回參數及說明見表A.26。1818接口標識符：DtSaveInfo。接口說明：該接口用于上傳電梯應急救援記錄。電梯應急救援記錄接口的輸入參數及說明見表A.27。表A.27電梯應急救援記錄接口輸入參數及說明參數名類型非空參數