HC社区政务系统对接协议

本文档详细介绍了HC社区政务系统对接协议,包括楼栋、房屋、位置、人员开门记录、业主、车辆等信息的添加、修改上报流程。通过Kafka topic的方式进行实时数据交互,涉及的数据项包括楼栋ID、房屋信息、位置信息、人员记录等,旨在实现物业系统与政务系统的数据同步。
摘要由CSDN通过智能技术生成

HC社区政务对接协议

说明

首先依照政务所加的区域下的小区信息主键ID,将物业系统的小区管理里面的社区编码改为政务小区主键,完成关联。按照政务接口规范同步数据到政务系统。目前将小区密钥与楼栋类型,在物业系统映射管理中进行配置,后期需物业系统增加相关属性进行添加

1、楼栋上传

说明:物业系统添加楼栋时 实时将数据上报HC社区政务系统

请求方式: kafka topic

请求topic:hcGov

请求参数:

上一级 名称 类型 是否必填 示例值 描述
- header Object - -
header serviceCode String ADD_FLOOR 添加楼栋
header tranId String 12345677 交易流水
header reqTime String 20210831000000 请求时间 YYYYMMDDHHmmSS
header sign String dffdsdfsdfsdfsdf 签名
header extCommunityId String 123123123 外部小区ID
- body Object - -
body floorNum String 1 楼栋编号
body floorName String 花园楼 楼栋名称
body floorType String 66525455124451 建筑物类型(住宅)
body floorArea String 300 楼栋面积
body layerCount String 33 楼层数
body unitCount String 2 单元数
body floorUse String 小区住宅 建筑物用途
body personName String 凌乱 责任人
body personLink String 15236985632 联系电话

返回参数:

上一级 名称 类型 是否必填 示例值 描述
- header Object - -
header serviceCode String ADD_FLOOR 添加楼栋
header tranId String 12345677 交易流水
header extCommunityId String 123123123 外部小区ID
header resTime String 20210831000000 请求时间 YYYYMMDDHHmmSS
header sign String dffdsdfsdfsdfsdf 签名
header code int 0 状态 0 成功 其他失败
header msg String 0 状态说明

| - | body | Object | 是 | - | - |
| body | extFloorId | String | 是 | 96655232651212355 | 外部楼栋ID |

请求样例

{
   
    "header": {
   
        "serviceCode": "ADD_FLOOR",
        "extCommunityId": "123123123",
        "tranId": "678465161420210831444",
        "reqTime": "2020-12-31 18:06:40",
        "sign": "2020122471920846"
    },
    "body": {
   
        "floorNum": "1",
        "floorName": "花园楼",
        "floorType": "66525455124451",
        "floorArea": "300",
        "layerCount": "33",
        "unitCount": "2",
        "floorUse": "小区住宅",
        "personName": "凌乱",
        "personLink": "15236985632"
        
    }
}

返回样例

{
   
    "header": {
   
        "serviceCode": "ADD_FLOOR",
        "tranId": "678465161420210831444",
        "extCommunityId": "123123123",
        "resTime": "2020-12-31 18:06:40",
        "sign": "2020122471920846",
        "code": 0,
        "msg": "成功",

    },
    "body": {
   
        "extFloorId": "96655232651212355"

    }
}

2、修改楼栋上传

说明:物业系统修改楼栋时 实时将数据上报HC社区政务系统

请求方式: kafka topic

请求topic:hcGov

请求参数:

上一级 名称 类型 是否必填 示例值 描述
- header Object - -
header serviceCode String EDIT_FLOOR 添加楼栋
header tranId String 12345677 交易流水
header reqTime String 20210831000000 请求时间 YYYYMMDDHHmmSS
header sign String dffdsdfsdfsdfsdf 签名
header extCommunityId String 123123123 外部小区ID
- body Object - -
body extFloorId String 1 外部楼栋ID
body floorNum String 1 楼栋编号
body floorName String 花园楼 楼栋名称
body floorType String 66525455124451 建筑物类型(住宅)
body floorArea String 300 楼栋面积
body layerCount String 33 楼层数
body unitCount String 2 单元数
body floorUse String 小区住宅 建筑物用途
body personName String 凌乱 责任人
body personLink String 15236985632 联系电话

返回参数:

上一级 名称 类型 是否必填 示例值 描述
- header Object - -
header serviceCode String EDIT_FLOOR 添加楼栋
header tranId String 12345677 交易流水
header extCommunityId String 123123123 外部小区ID
header resTime String 20210831000000 请求时间 YYYYMMDDHHmmSS
header sign String dffdsdfsdfsdfsdf 签名
header code int 0 状态 0 成功 其他失败
header msg String 0 状态说明
- body Object - -
body extFloorId String 96655232651212355 外部楼栋ID

请求样例

{
   
    "header": {
   
        "serviceCode": "EDIT_FLOOR",
        "extCommunityId": "123123123",
        "tranId": "678465161420210831444",
        "reqTime": "2020-12-31 18:06:40",
        "sign": "2020122471920846"
    },
    "body": {
   
      "extFloorId": "768463413135",
        "floorNum": "1",
        "floorName": "花园楼",
        "floorType": "66525455124451",
        "floorArea": "300",
        "layerCount": "33",
        "unitCount": "2",
        "floorUse": "小区住宅",
        "personName": "凌乱",
        "personLink": "15236985632"
        
    }
}

返回样例

{
   
    "header": {
   
        "serviceCode": "EDIT_FLOOR",
        "tranId": "678465161420210831444",
        "extCommunityId": "123123123",
        "resTime": "2020-12-31 18:06:40",
        "sign": "2020122471920846",
        "code": 0,
        "msg": "成功"
    },
    "body": {
   
        "extFloorId": "96655232651212355"
    }
}

3、房屋上传

说明:物业系统添加房屋时 实时将数据上报HC社区政务系统

请求方式: kafka topic

请求topic:hcGov

请求参数:

上一级 名称 类型 是否必填 示例值 描述
- header Object - -
header serviceCode String ADD_ROOM 添加房屋
header tranId String 12345677 交易流水
header reqTime String 20210831000000 请求时间 YYYYMMDDHHmmSS
header sign String dffdsdfsdfsdfsdf 签名
header extCommunityId String 123123123 外部小区ID
- body Object - -
body roomNum String 1 房屋编号
body builtUpArea String 200 建筑面积
body layer String 24 房屋层数
body roomArea String 120 室内面积
body layerCount String 33 楼层数
body unitCount String 2 单元数
body roomRent String 1200 租金
body userId String 655412154 房主ID
body extFloorId String 65456414515 所属楼栋
body state String 出售 房屋状态 出售/闲置/待验房
body roomSubType String 住宅 房屋类型 住宅/办公/宿舍
body roomRight String 1001 房屋产权 1001 大产权 2002 小产权
body roomAddress String **** 房屋地址
body isConservati String Y 是否常住 Y 是 N不是
body isSettle String N 是否落户 Y 是 N不是

返回参数:

上一级 名称 类型 是否必填 示例值 描述
- header Object - -
header serviceCode String ADD_ROOM 添加房屋
header tranId String 12345677 交易流水
header extCommunityId String 123123123 外部小区ID
header resTime String 20210831000000 请求时间 YYYYMMDDHHmmSS
header sign String dffdsdfsdfsdfsdf 签名
header code int 0 状态 0 成功 其他失败
header msg String 0 状态说明
- body Object - -
body extRoomId String 96655232651212355 外部房屋ID

请求样例

{
   
    "header": {
   
        "serviceCode": "ADD_ROOM",
        "extCommunityId": "123123123",
        "tranId": "678465161420210831444",
        "reqTime": "2020-12-31 18:06:40",
        "sign": "2020122471920846"
    },
    "body": {
   
        "roomNum": "房屋编号",
        "builtUpArea": "建筑面积",
        "layer": "层数",
        "roomArea": "室内面积",
        "roomRent": "租金",
        "userId": "户主ID",
        "extFloorId": "所属楼栋",
        "layerCount": "楼层数",
        "unitCount": "单元数",
        "state": "房屋状态",
        "roomSubType": "房屋类型",
        "roomRight":"1001",
        "roomAddress":"****",
        "isConservati":"Y",
        "isSettle":"N"
        
    }
}

返回样例

{
   
    "header": {
   
        "serviceCode": "ADD_ROOM",
        "tranId": "678465161420210831444",
        "extCommunityId": "123123123",
        "resTime": "2020-12-31 18:06:40",
        "sign": "2020122471920846",
        "code": 0,
        "msg": "成功"
    },
    "body": {
   
        "extRoomId": "96655232651212355"
    }
}

4、修改房屋上传

说明:物业系统修改房屋时 实时将数据上报HC社区政务系统

请求方式: kafka topic

请求topic:hcGov

请求参数:

上一级 名称 类型 是否必填 示例值 描述
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值