场景说明:物业费定制新增的接口,发起方是渠道方。每上线一个新项目(小区〉时,渠道方需要调这个接口,推送小区楼房信息给微信生活缴费,以便用户缴费时选择为哪个楼房缴费。
应用场景:
本接口为必选接口,因为前端查户号时,只有这两种模式:
- 按『楼房信息』查户号模式
- 按『楼房信息+手机号』查户号
请求参数:
参数 |
参数名称 |
取值 |
必填 |
最大长度 |
备注 |
head |
|||||
cusid |
商户号 |
平台分配的商户号 |
是 |
15 |
|
trancode |
接口编号 |
pushpropertyaddress |
是 |
15 |
|
transeqnum |
请求流水 |
|
是 |
15 |
标记每一次请求的流水 |
version |
版本号 |
接口版本号 |
是 |
6 |
1.0.1 |
info |
|||||
op_type |
变更类型 |
枚举值可选:add、delete,分别代表新增、删除 |
是 |
6 |
|
company_id |
项目id |
例如:30221 |
是 |
10 |
|
data |
楼房信息 |
必这是一个数组类型,data结构见下说明,建议楼房信息分批传送.每次不超50条记录 |
是 |
object[] |
|
data数组说明 |
|||||
bill_key |
户号 |
物业公司为每套楼房定义的唯一编号 |
是 |
64 |
|
first_addr_name |
一级房屋地址名 |
例如:一期 |
是 |
50 |
|
first_addr_no |
一级房屋编号 |
例如:P101 |
是 |
30 |
|
first_addr_order_num |
一级房屋次序 |
例如:1 |
是 |
Int |
|
second_addr_name |
二级房屋地址名 |
例如:3号楼 |
否 |
50 |
|
second_addr_no |
二级房屋编号 |
例如:BO3 |
否 |
30 |
|
second_addr_order_num |
二级房屋次序 |
例如:3 |
否 |
Int |
|
third_addr_name |
三级房屋地址名 |
例如:10单元 |
否 |
50 |
|
third_addr_no |
三级房屋编号 |
例如:U10 |
否 |
30 |
|
third_addr_order_num |
三级房屋次序 |
例如:10 |
否 |
Int |
|
fourth_addr_name |
四级房屋地址名 |
例如:1088室 |
否 |
50 |
|
fourth_addr_no |
四级房屋编号 |
例如:R1088 |
否 |
30 |
|
fourth_addr_order_num |
四级房屋次序 |
例如:1088 |
否 |
Int |
|
删除说明:删除时,只传bill_key即可。如果要修改bill_key,删除后再新增。
返回参数:
参数 |
参数名称 |
取值 |
必填 |
最大长度 |
备注 |
||
head |
|||||||
cusid |
商户号 |
平台分配的商户号 |
是 |
15 |
|
||
trancode |
接口编号 |
pushpropertyaddress |
是 |
15 |
|
||
version |
版本号 |
接口版本号 |
是 |
6 |
1.0.1 |
||
transeqnum |
请求流水 |
|
是 |
15 |
标记每一次请求的流水 |
||
ret_code |
返回码 |
|
是 |
10 |
0-成功 其他错误码看错误提示 |
||
err_msg |
提示信息 |
|
是 |
20 |
|
||
info |
|||||||
succ_count |
处理成功记录数 |
|
是 |
num(16) |
|
||
fail_count |
处理失败记录数 |
|
是 |
Num(16) |
|
请求info字段样例报文:
返回样例报文: