开放平台 / 收费管理 / 3.3 收款

3.3 收款

注意:

    所有接口需要传入 Head信息,格式如下

 

    参数 说明 类型 是否必须

    appKey App Key String Y 开发者账号创建授权接入

    clientTime 访问时间毫秒数 Int Y在30分钟内有效

    version 客户端版本 String Y   固定值V1.0

    signature 签名串 String Y


     签名串生成规则见1.4.1签名算法




3.3.1 查询收款信息


(1) 方法:

路径:/api/receipt/list

类型:GET接口


(2) 接口参数

参数 说明 类型 是否必须

access_token string token

pid String 项目id

roomId String 房间id

phone String 客户手机号

beginDate 开始时间,格式2018-01-01

endDate 结束时间, 和开始时间小于等于1个月,格式2018-01-31


(3) 返回结果

{
  "code": 1,
  "data": {    
        [   
         {   

         receiveNumber 费用账单编码

         room String 房号

        feeType  string 费用项目名称

        amount string 金额

       createTime  String 收款时间  ‘2018-03-20’

       period  欠费期间  ‘2018-01’

        },

     ], 
  }
  "msg": "成功",  
  "result": "success", 
  "success": true 



3.3.2 查询在线缴款信息


(1) 方法:

路径:/api/receipt/payed_list

类型:GET接口


(2) 接口参数

参数 说明 类型 是否必须

access_token string token

pid String 项目id

phone String 客户手机号


(3) 返回结果

{
  "code": 1,
  "data": {    
       [   
         {   

        tradeNo交易编号

        feeType  string 费用说明

        amount string 金额

       createTime  String 收款时间

        },

     ], 
  }
  "msg": "成功",  
  "result": "success", 
  "success": true 
}



3.3.3 查询某房间的预收款项和余额

(1) 方法:

路径:api/receipt/preList

类型:GET接口


(2) 接口参数

参数 说明 类型 是否必须

access_token token String Y

pid 小区ID String Y

roomId 房间ID String Y


(3) 返回结果

{

“result”: “success”|“error”,

“data”: 

{

balance: 余额

unpaidBillMoneyDefineList:

[

{

moneyDefineId:款项ID

moneyDefineName:款项名称

balance: 余额

}

]

},

“msg”: “操作成功”|“错误信息”,

“code”: 1|0,

“success”: true|false

 



3.3.4 计算某房间的某款项应缴金额

(1) 方法:

路径:api/receipt/getCusOffsetMoney

类型:GET接口


(2) 接口参数

参数 说明 类型 是否必须

access_token token String Y

pid 小区ID String Y

roomId 房间ID String Y

moneyDefineId 款项ID String Y  来源于3.3.3


(3) 返回结果

{

“result”: “success”|“error”,

“data”: 

[

{

isView:"0"  是否显示

name:"一个月"   说明

type:"oneMonth"  分类

value:0  金额

}

],

“msg”: “操作成功”|“错误信息”,

“code”: 1|0,

“success”: true|false




3.3.5 保存预收款

 

(1) 方法:

路径:api/receipt/save


类型:POST接口


(2) 接口参数

参数 说明 类型 是否必须

fees json字符串(

    { 

     number 收款单编码

     room房号,      

     roomId房号,     

     moneyDefineId 费用类型 ID:  预收物业管理费

     transDate 费用发生日期    yyyy-MM-dd     

     amount 金额     

     remark 备注

    } String Y

access_token token String Y

pid 小区ID String Y

payTypeName 支付类型名称 String Y


(3) 返回结果

{


“result”: “success”|“error”,


“data”: true|false,


“msg”: “操作成功”|“错误信息”,


“code”: 1|0,


“success”: true|false


}




3.3.5 预收款/充值款明细

(1)方法:  

路径:/api/charge/getPreBillTransactionDetail  

类型:GET接口


(2)接口参数  

参数   类型  是否必须  说明  

access_token   String  是 token  

projectID   String  是  项目ID  

phone   String  是  用户电话号码  

roomId 房间ID String Y

moneyDefineId 款项ID String Y  来源于3.3.3

pageSize   int 否  页容量,默认为10  

pageNum int  否    当前页,默认为1


(3)返回结果

{

  "result": "success",

  "data": {

    "current": 1, 现在所在页

    "total": 5,  总记录数

    "pages": 5,  页数

    "rowCount": 1,  页容量

    "rows": [

      {

        "roomId": "d0b6cd87cfad4fc7ba01f362471af038", 房间ID

        "amount": "100.0000000000",  金额

        "type": 0,  typeName为recharge充值时会有0收 1 退 2 转 3 变更

        "createTime": "2018-12-26 00:00:00",    创建时间

        "projectId": "319c23c4c60e4def9959c776c32ca7f9", 项目id

        "projectName": null,

        "buildName": "H栋",   楼栋名称

        "buildUnitName": "一单元",   单元名称

        "floor": "1",    楼层名称

        "roomName": "HSF333",     房间名称

        "moneyDefineName": "合同变更预收",   交易项目名

        "typeName": "recharge",  类型名字,recharge充值 deduction:抵扣 

        "oppsite": 0

      }

    ]

  },

  "msg": "获取成功",

  "code": 0,

  "success": true

}


3.3.6 缴费抵扣明细接口

(1)方法:  

路径:/api/charge/getStoreMoneyTransactionDetail  

类型:GET接口


(2)接口参数  

参数   类型  是否必须  说明  

access_token   String  是 token  

projectID   String  是  项目ID  

phone   String  是  用户电话号码  

roomId 房间ID String Y

moneyDefineId 款项ID String Y  来源于3.3.3

pageSize   int 否  页容量,默认为10  

pageNum int  否    当前页,默认为1

 

(3)返回结果

{

  "result": "success",

  "data": {

    "current": 1,

    "total": 4,

    "pages": 4,

    "rowCount": 1,

    "rows": [

      {

        "roomId": "d0b6cd87cfad4fc7ba01f362471af038",  房间ID

        "amount": "10.000000",  金额

        "type": 0,  

        "createTime": "2018-12-27 21:53:57",     创建时间

        "projectId": "319c23c4c60e4def9959c776c32ca7f9",   项目id

        "projectName": null,

        "buildName": "H栋",  楼栋名称

        "buildUnitName": "一单元",  单元名称

        "floor": "1",  楼层名称

        "roomName": "HSF333",   房间名称

        "moneyDefineName": "junjun储值卡",   交易项目名

        "typeName": null,

        "oppsite": 1    出入账(-1减少,1增加)

      }

    ]

  },

  "msg": "获取成功",

  "code": 0,

  "success": true

}