特种设备维保接口规范.docx

深圳市电梯维保记录接口规范深圳市市场监督管理局华宇金信（深圳）信息技术2019年8月1useorgeontime * :* 2016-06-10 *, * useorgstaffidf: 14545 1, aintorgcode1:14441z 1useorgmanager1:* 444 *, 1useorgpone:444, 1elevlongit :，444 , elevlatit1:1 444!,halfmonthmaintitem1 :T hml1 : 12 *, hm21:121, hm31 : * 21,1hm41 : 121,1 hm5 f 1 2 1 , hm6:2l 1 hm7 1 : 1 2 f , hm8:2l hm9:2l fhmlOf : f2f , hmll 32, fhml2 1 : !2 hml31 : f2 fhml4 1 :hml5 : 2、hml6：2， !hml71:2,quartrmaintitm1 : * qtr 11 : 1 3 1 , 1 qtr2 * : T 3 1 , 1 qtr3 1 : 1 3 1 , qtr4 : 3 , 1qtr5 1 : T 3 *, 1qtr6 1 : 13 *, 1qtr71 : * 31, * qtr8 * : 131, 1 qtr91 : 1 31,qtrlO:3,* halfyearmaintitem, :hyl!1 41, hy21 : 1 4 1 , 1hy3!: 14 1, 1hy4:4, ，hy5 ： 4。，!hy6f : !4，y7 , : f4f ,，hy8 ： 4、: f 4 1 , !hyl0 1 : f4!)”季度维保需要传的值：T contenttype 1:1 2 1 , userinfo 1:* userid:* AA12 *, 1 timestamp *:* 2016-12-22 15:34:43, , nonce f:abedefSignature1:14330e2dcf44f131f258527ef002f5d0a85423f6c1z* content1:,maintnote1:* normalmainttime1:12016-06-101, 1mainttype1:* 1 *, 1mainttime *: 12016-10-26 15:34:431z 1maintstaff * :* 11 , ,maintstafftel*:* 1 , ,1notifytime *: 12016-10-26 15:34:43, arrivetime1:12016-10-26 15:34:43, 1 endtime *:12016-10-26 15:34:43, 1 servicetype 1:11f, 1otherservice1:* 11 , * faultdesc *:11 *, 1 resolveresult1:1 11, , partscode *: 11 * z * deliverynum1:11 * z 1 remark 1:11 , 1useorgopinion *:1 11, aintstaffid*:*1*, * useorgstaff * :1 11 , useorgname * : * 1 *, * maintorgname1:111, * status:1createdtime1:12016-06-10 * r ismakeup1:* 1T, 1 elevcode:11* elevtype 1:* 1 *, * makeuptime *:12016-0 6-101,1useorgeontime 1 :* 2016-06-10 , r , useorgstaffid!: 14545 ,maintorgeode *:14441z * useorgmanager *:* 444 *, 1useorgpone *:4 44,1elevlongit : 444 , elevlatitT:1 444 1 ),halfmonthmaintitem1:1hml:2hm21:121f 1hm31:121f hm41:121f 1 hm5 1 : 1 2 1 , hm6:2l f hm7 1 : 1 2 f z Thm8 1 : 1 2 S hm9:2l mlO1 : *2* , hmll : 2，fhinl2 1 : f2 hml3, : f2 hml4 ： 2，hml5 ： 21, hml6 ： 2 I hml71: 2, quartermaintitem * : * qtrl1 : 1 3 1 , 1 qtr2 1 : T 3 1 , 1 qtr3 1 : 1 3 1 , * qtr4 * : 1 3 * z1qtr51: 13 1, 1qtr6 1 : 131, * qtr7: 3* qtr81 : 1 3 1 , * qtr9 * : * 31,* qtrlO * : 1 31）n输出格式为JSON字符串，其中issuccess代表是否成功。如果成功将得到以下字符串。 1 issuccess * : * success 1 如果失败将得到类似以下包含具体原因的字符串。1、用户名userid错误， ! issuccess 1 :，该用户不存在，验证失败，请重新 验证！ 2、此次传递的加密后的字符串signatur与上次一样，L issuccess，： 验证不合法，请重新请求！ 3、通过传递的时间戳等信息加密得到的字符串与传递的signature不相等, issuccess验证失败，请重新验证！ 1 4、设备代码elvcod错误，L issuccss halfmonthmaintitem quarterm- aintitem halfyearmaintitem yearmaintitem分别为维保t己录数 据，半月、季度、半年、年度维保工程 数据，content根据维保类型盒维修类型确定内容中数据，例如：以上是最全 的数据，如果contenttype=3那么c- ontent 包含 maintnote halfmo- nthmaintitem quartermaintit- m、half ya rma intitm（维保记录、 半月、季度、半年的维保工程数据）。maintnote维保记录信息normaImainttimeString否正常维保时间（传值格式： yyyy-MM-dd）mainttypeString11否维保类别mainttimeString否本次维保时间（传值格式： yyyy-MM-dd）maintstaffString100否维保联系人姓名（多人用，间隔）maintstafftelString20否维保联系人 notifytimeString否通知时间（传值格式:yyyy-MM-dd）arrivetimeString否到达时间（传值格式:yyyy-MM-dd）endtimeString否结束时间（传值格式：yyyy-MM-dd）servicetypeString11否服务性质（L例行保养；2：维修；3： 其它）otherserviceString100否其它服务说明faultdescString200否故障现象resolveresultString500否处理过程partscodeString200否更换配件编号dlivrynumString100否送货单号remarkString500否备注useorgopinionString200否使用单位意见maintstaffidString20否维保人员身份证号useorgeontimeString否使用单位确认时间（传值格式： yyyy-MM-dd）useorgstaffidString20否使用单位确认人身份证号useorgstaffString45否使用单位确认人usorgnamString45否使用单位名称maintorgcodeString50否维保单位代码maintorgnameString100否维保单位名statusString11否维保单状态（1，未维保，0，待维保， 1，超期维保，2，维保完成，）createdtimeString否创立日期（传值格式：yyyy-MM-dd）i smakeupString11否维保过程状态（0：默认初始状态；1： 签到；2 ：结束；3 ：补单完成）elevcodeString50否电梯设备注册号1vtypString1否电梯类型：（1、曳引与强制驱动电梯， 2、液压驱动电梯，3、其它类型电梯， 4、自动扶梯与自动人行道）makeuptimeString否补录时间（传值格式：yyyy-MM-dd）useorgmanagerString50否使用单位平安管理人员useorgponeString20否使用单位平安管理人员 elevlongitString50否设备所在经度elevlatitString50否设备所在纬度halfmonthmaintitem半月维保工程信息（工程内容传值：1 正常、2异常、3需要调整、4未检查、 5需要更换、6已处理完）hmlString11是机房环境hm2String11是机房内手动泵操作装置hm3String11是油箱/电动机hm4String11是层门和轿门旁路装置hm5String11是阀、泵、消音器、油管、表、接口等部件hm6String11是编码器hm7String11是轿顶/轿顶检修开关、停止装置hm8String11是导靴上油杯/井道照明/限速器各销轴部 位hm9String11是轿厢检修开关、停止装置hmlOString11是轿厢照明、风扇、应急照明/轿内报警装 置、对讲系统/轿内显示、指令按钮hmllString11是轿门防撞击保护装置/轿门门锁触点hml2String11是轿门运行/轿厢平层准确度hml 3String11是层站召唤、层楼显示/层门地坎hml 4String11是层门自动关门装置/层门门锁自动复位hml 5String11是层门门锁电气触点/锁紧元件啮合长度hml 6String11是底坑/底坑停止装置hml 7String11是液压柱塞/井道内液压汕管、接口quartermaintitem季度维保工程信息（工程内容传值：1 正常、2异常、3需要调整、4未检查、 5需要更换、6已处理完）qtrlString11是平安溢流阀（在油泵与单向阀之间）qtr2String11是手动下降阀/手动泵qtr3String11是油温监控装置qtr4String11是限速器轮槽、限速器钢丝绳qtr5String11是验证轿门关闭的电气平安装置qtr 6String11是轿厢侧靴衬、滚轮/柱塞侧靴衬qtr7String11是层门、轿门系统中传动钢丝绳、链条、胶 带qtr8String11是层门门导靴qtr 9String11是消防开关qtrlOString11是耗能缓冲器qtrllString11是限速器张紧轮装置和电气平安装置halfyearmaintitem半年维保工程信息（工程内容传值：1正常、2异常、3需要调整、4未检查、5需要更换、6已处理完）hylString11是控制柜/控制柜内各接线口肝hy2String11是导向轮/悬挂钢丝绳及其绳头组合hy3String11是限速器钢丝绳hy4String11是柱塞限位装置hy5String11是上下极限开关hy6String11是柱塞、消音器放气操作yearmaintitem年度维保工程信息（工程内容传值：1 正常、2异常、3需要调整、4未检查、 5需要更换、6已处理完）yiString11是控制柜接触器、继电器触点y2String11是动力装置各安装螺栓y3String11是导电回路绝缘性能测试y4String11是限速器平安钳联动试验（限速器每2年一 校）V、String11是随行电缆y6String11是层门装置和地坎y7String11是轿顶、轿厢架、轿门及附件安装螺栓y8String11是轿厢称重装置v9String11是平安钳钳座ylOString11是轿厢及油缸导轨支架yiiString11是轿厢及油缸导轨yi2String11是轿底各安装螺栓yi3String11是缓冲器yl4String11是轿厢沉降试验以下是实例：年度维保需要传的值：1 contenttype *: 1 4 *,userinfo 1:* userid1:* AA12, 1 timestamp 1:1 2016-12-22 15:34:43, 1 nonce 1:abcdefSignature1:f 4330e2dcf44f131f258527ef002f5d0a85423f6c1, 1 content *:aintnote1:* normalmainttime1:* 2016-06-101r *mainttype1:1 1 *, ainttime1: * 2016-10-26 15 : 34:43 1 z 1maintstaff1:1 11, 1maintstafftel*:11 * ,notifytime *: 12016-10-26 15:34:43,arrivetime,:f2016-10-26 15:34:43, 1 endtime *:* 2016-10-26 15:34:431, 1 servicetype * :* 11, 1otherservice1:* 1 , * faultdesc ,:111, 1 resolveresult *:* 1 *, 1partscode *: 111, 1 deliverynum *:* 11r 1 remark:1, 1useorgopinion 1 : 111, 1maintstaffid *: 111, useorgstaff : 1, useorgname1 : * 1 , * maintorgname *: 111, status:1, 1createdtime1:* 2016-06-10 , A , ismakeup *:* 11, * elevcode: 1, elevtype 1:* 21, 1 makeuptime *: 12016-0 6-10 1,1useorgcontime1:1 2016-06-101, * useorgstaffid:145451, aintorgcode *:1444 1, 1useorgmanager :444useorgpone *:4 44, 1elevlongit : 444 I elevlatit:14441 ,* halfmonthmaintitem1 :1hml* : 12 *, hm2 1 : * 21, 1hm31 : * 2 *,* hm4 1 : 121,1 hm5 1 : f 2 hm6:2,，1 hm7 1 : 1 2 1 , 1 hm8 f : 1 2 hm9:2l nml032, hmll : 2，fhinl2 1 : f2 hml3, : f2 hml4 ： 2，hml5 ： 21, hml6 ： 2 I hml71 : f21,1quartermaintitemf:* qtrl1: 131, 1qtr2 1: 13 *, * qtr31: 131, * qtr4 * : 131, fqtr5 Y 3 , f qtr6 3 I fqtr7 1 : f 3 fqtr8，： 3 , fqtr9 3 I,qtrlO1 : 3 Jqtrll。: 3 ,halfyearmaintitem! :* hyl1: 141, * hy2 * : * 4 1 , * hy3 *: 14 *, 1hy4 : 4, fhy5f :, ，hy6,* yearmaintitem1 :* yl*: 151, * y21: f 51, 1y31 : 15 * A y4 : 5, * y51 : 1 51, 1yTYW fy8f : f5 lOYl1yl2 1 : 151 f yl3f : 5，fyl4 f : 5 )n半年维保需要传的值：1 contenttype 1:* 3 *, userinfo 1:* userid:* AA12 *, 1 timestamp *:* 2016-12-22 15:34:431, , nonce 1:1abcdef1,Signature1:14330e2dcf44f131f258527ef002f5d0a85423f6c1z1 content1:maintnote1:* normalmainttime1:12016-06-101, *mainttype1:* 1 *, , mainttime *: 12016-10-26 15:34:43, 1maintstaff1 :111 , ,maintstafftel*:* 1 ,1 notifytime *:12016-10-26 15:34:43, arrivetime1:12016-10-26 15:34:43, 1 endtime *:12016-10-26 15:34:43, 1 servicetype 1:* 1f, 1otherservice1:* 1 , 1faultdesc *:11 *, 1 resolveresult1:* 1 *, partscode *: 111z * deliverynum *:11 * z 1 remark 1:11f, 1useorgopinion *:* 11, 1maintstaffid1: * 11 , * useorgstaff * :1 11 , useorgname * : * 1 *, * maintorgname *: * 11, * status:1, createdtime1:12016-06-10 1, f ismakeup1:* 1, 1 elevcode 1:111, elevtype 1:* 21, * makeuptime *: 12016-0 6-101,1useorgcontime * :* 2016-06-10 , r , useorgstaffid: 145451, aintorgcode 1:1444 1 , 1useorgmanager : 444, useorgpone:4 44, 1elevlongit : 444 , elevlatit *:* 444 1 , halfmonthmaintitem * :* hml* : 121, * hm21 : * 2 *, * hm31 : * 21,* hm41 :121f1 hm5 1 f 2 1 , hm6:2,， hm7 : 2 I Thm8 r : f2 1 , hm9:2,，mlO1 : hmll : f2 * , fhml2 1 : 2，hml31 : f2 hml4 ： 2、hml5 ： 2， hml6 ： 2 1 !hml7 1 : 2,1 quartermaintitem * : 1 qtrl1 : * 3 * , 1 qtr2 1 : 1 3 1 , * qtr3 1 : * 3 1 , * qtr4 * : 1 3 * z fqtr5 : 3 , f qtr6 1 : 13 fqtr7 1 : f3 fqtr8 : 3 qtr 9 : 3 Iqtrl。，: 3 Jqtrll : 3,half yearma inti ternf : 1 hyl1 : 1 4 1 , hy2 T : * 4 * , * hy3 * : 1 4 * , 1 hy4 1 : 1 4 1 , fhy5f :Thy6f : 1 4 1)季度维保需要传的值：1 contenttype 1:12 , userinfo 1:* userid1:1AA12, * timestamp 1:1 2016-12-22 15:34:43, T nonce *:* abcdef,signature1:14330e2dcf44f131f258527ef002f5d0a85423f6c1, f content *:1maintnote1:* normalmainttime *:12016-06-101, *mainttype f:* 1 *, mainttime *: 12016-10-26 15:34:43, *maintstaff *:1 11, aintstafftel *:* 11z * notifytime *: 12016-10-26 15:34:43, 1arrivetime f:, 2016-10-26 15:34:43, , endtime *:* 2016-10-26 15:34:43, T servicetype!111, otherservice1:f1 *, * faultdesc *:11 *, f resolveresult *:f11, , partscode *: 11 * z * deliverynum *:11 , remark1:11 1, * useorgopinion *:111, *maintstaffid1:1, * useorgstaff1:1 11,1useorgname1:* 11z 1maintorgname *: 111, 1 status:1,createdtime1:12016-06-10 1, 1ismakeup1:* 11, * elevcode 1:!1 * z, elevtype f:* 2 f, * makeuptime *: 12016-06-10 1,1useorgcontime * :12016-06-10 1 , * useorgstaffid *:4545,1 maintorgeode 1:1444 f, * useorgmanager *:* 444 useorgpone:444, f elevlongit : 444 , elevlatit:14441 ,1halfmonthmaintitem1 :* hml*: 121, * hm21:* 21, * hm31:121,1hm4 1:* 21,f hm5 1 f 2 hm6:2,，f hm7 1 : 1 2 hm8:2，hm9:2l nml0:2， hmll: 12 *, !hml2 1 : f2 fhml3f :21, fhml41 : 2，hml5 : 121, hml6 ： 2 I hml7: 2,1quartermaintitem1 :* qtrl*: 131, 1qtr2 1: * 31, 1qtr3 1 : * 31z 1qtr41 : 13 * qtr5 *: * 3 *, 1qtr6 : 3, * qtr7 : 3 , * qtr8 : 3, * qtr91 : 1 31, ytrlCT : 31 , qtrll : 3)n输出格式为JSON字符串，其中issuccess代表是否成功。如果成功将得到以下字符串。issuccess 1 : 1 success 1 如果失败将得到类似以下包含具体原因的字符串。1、用户名userid错误，issuccess，:，该用户不存在，验证失败，请重新 验证！ 2、此次传递的加密后的字符串signatur与上次一样，L issuccess，： ,验证不合法，请重新请求！，3、通过传递的时间戳等信息加密得到的字符串与传递的signature不相等, ，issuccss，：，验证失败，请重新验证！ 1 4、设备代码1vcod错误， issuccss :失败，设备注册代码错误！，其它类型电梯该类别其内部字段具体含义如下:字段名类型长度必填/ 选填含义描述contenttypeString1否传值维保类型：1、半月2、季度、3 半年4、年度userinfo传递用户的验证信息useridString10否用户名timestampString否时间戳（传值格式：yyyy-MM-dd HH : mm:ss）nonceString0-20否随机字符串signatureString否使用平安哈希算法SHA1对排序后的 （之前约定的token,时间戳，随机字 符串）字符串进行加密content传递数据内容，其内部的maintnote、 halfmonthmaintitem quarterm- aintitem halfyearmaintitem yearmaintitem 分别为维保t己录数 据，半月、季度、半年、年度维保工程 数据，content根据维保类型盒维修类 型确定内容中数据，例如：以上是最全 的数据，如果contenttype=3那么c- ontent 包含 maintnote halfmo- nthmaintitem quartermaintit-emhalf yea rma inti tem（维保记录、 半月、季度、半年的维保工程数据）。maintnote维保记录信息normaImainttimeString否正常维保时间（传值格式： yyyy-MM-dd）mainttypeString11否维保类别mainttimeString否本次维保时间（传值格式： yyyy-MM-dd）maintstaffString100否维保联系人姓名（多人用，间隔）maintstafftelString20否维保联系人 notifytimeString否通知时间（传值格式：yyyy-MM-dd）arrivetimeString否到达时间（传值格式：yyyy-MM-dd）endtimeString否结束时间（传值格式：yyyy-MM-dd）servicetypeString11否服务性质（L例行保养；2：维修；3： 其它）otherserviceString100否其它服务说明faultdescString200否故障现象resolveresultString500否处理过程partscodeString200否更换配件编号deliverynumString100否送货单号remarkString500否备注useorgopinionString200否使用单位意见maintstaffidString20否维保人员身份证号useorgeontimeString否使用单位确认时间（传值格式： yyyy-MM-dd）useorgstaffidString20否使用单位确认人身份证号useorgstaffString45否使用单位确认人useorgnameString45否使用单位名称maintorgcodeString50否维保单位代码maintorgnameString100否维保单位名statusString11否维保单状态（-1，未维保，0，待维保， 1，超期维保，2，维保完成，）createdtimeString否创立日期（传值格式：yyyy-MM-dd）ismakeupString11否维保过程状态（0：默认初始状态；1： 签到；2：结束；3：补单完成）elevcodeString50否电梯设备注册号1vtypString1否电梯类型：（1、曳引与强制驱动电梯， 2、液压驱动电梯，3、其它类型电梯， 4、自动扶梯与自动人行道）makuptimeString否补录时间（传值格式：yyyy-MM-dd）useorgmanagerString50否使用单位平安管理人员us0rgponeString20否使用单位平安管理人员 elevlongitString50否设备所在经度elevlatitString50否设备所在纬度halfmonthmaintitem半月维保工程信息（工程内容传值：1 正常、2异常、3需要调整、4未检查、 5需要更换、6已处理完）hmlString11是机房、通道环境hm2String11是手动紧急操作装置/驱动主机hm3String11是制动器各销轴部位/制动器间隙hm4String11是限速器各销轴部位hm5String11是轿顶/轿顶停止装置hm6String11是导靴上油杯/井道照明hm7String11是对重块（平衡重块）及压板hm8String11是轿门门锁触点hm9String11是层站召唤、层楼显示/层门地坎hmlOString11是层门门锁自动复位/层门门锁电气触点hmllString11是层门锁紧元件啮合长度/层门门导靴hml2String11是底坑环境/底坑停止装置quartermaintitem季度维保工程信息（工程内容传值：1 正常、2异常、3需要调整、4未检查、 5需要更换、6已处理完）qtrlString11是减速机润滑油qtr2String11是制动衬qtr3String11是曳引轮槽、悬挂装置qtr4String11是限速器轮槽、限速器钢丝绳qtr5String11是靴衬qtr 6String11是层门、轿门系统中传动钢丝绳、链条、传 动带qtr7String11是层门门导靴qtr8String11是限速器张紧轮装置和电气平安装置halfyearmaintitem半年维保工程信息（工程内容传值：1 正常、2异常、3需要调整、4未检查、 5需要更换、6已处理完）hylString11是电动机与减速机联轴器hy2String11是驱动轮、导向轮轴承部hy3String11是制动器上检测开关hy4String11是控制柜内各接线端子/控制柜各仪表hy5String11是悬挂装置及其绳头组合/限速器钢丝绳hy6String11是对重缓冲距离/上、下极限开关yearmaintitem年度维保工程信息（工程内容传值：1 正常、2异常、3需要调整、4未检查、 5需要更换、6已处理完）yiString