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
请求参数:
上一级 | 名称 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|---|