4.6推送小区楼房信息接口


场景说明:物业费定制新增的接口,发起方是渠道方。每上线一个新项目(小区〉时,渠道方需要调这个接口,推送小区楼房信息给微信生活缴费,以便用户缴费时选择为哪个楼房缴费。

应用场景:

本接口为必选接口,因为前端查户号时,只有这两种模式:

  • 按『楼房信息』查户号模式
  • 按『楼房信息+手机号』查户号

请求参数:

参数

参数名称

取值

必填

最大长度

备注

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字段样例报文:

返回样例报文:


yinjr 2025年8月22日 14:10 收藏文档