DB34T 4141-2022 电梯应急救援平台数据接口规范

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否油压泵流量（m³/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电梯应急救援记录接口输入参数及说明参数名类型非空参数