开放平台 / 收费管理 / 3.1 欠款查缴

3.1 欠款查缴

注意:

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

 

    参数 说明 类型 是否必须

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

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

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

    signature 签名串 String Y


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




3.1.1 查询欠款信息


(1) 方法:

路径:/api/receive/list

类型:GET接口


(2) 接口参数

参数 说明 类型 是否必须

access_token string token

phone string N 客户手机号

roomId string N 房间ID, 手机号和房间ID必须具备1个

pid string 小区id  N


(3) 返回结果

{
  "code": 0,
  "data": {
      "total": 300,  总金额   
       "list": [   
         {   

        id  :账单ID

        projectName :小区名

        pid :  小区id

        roomName:房号        

        buildingName:楼栋

        customerName:客户名称

        property :  1 住宅 2商业

        period月份,如 2017-01

        moneydefineName:  费用名称 ,如物业管理费

        amount 金额   

        penalty :   违约金

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



3.1.2 缴款成功通知


(1) 方法:

路径:/api/receive/notify

类型:POST接口


特别注意:  账单ID多个必须属于1个客户。 不能是不同客户。 有客户迁入迁出,1个房间的费用计算到不同的客户,建议分两次调用接口。

本接口提交的账单必须是一个小区的


(2) 接口参数

参数 说明 类型 是否必须

pid string 小区id  Y   (3.1.1 接口有返回,每个账单都有pid 

access_token string token

id  string 账单ID,(多个账单英文,号分隔)

billno string 是  交易流水号  

transDate  否  交易日期 ,格式 ‘2018-01-01’

amount   缴费金额


(3) 返回结果

{
  "code": 0,
  "data": {

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