2. 欠费催缴API

API列表

HTTP协议：

HTTP,HTTPS

API调用

2.1:APP查询欠费催缴业主记录列表

APP获取欠费催缴业主记录列表

请求信息

URI：https://biz-running-uat.smartmideazy.com/charge/arrear-history/can-send/list

方法：POST

请求参数

请求Body描述(非Form表单数据)

{
            "communityId": "1003837",
            "userName": "lipl4",
            "keywords":"1401",
            "pageNo":1,
            "pageSize":20
}

返回信息

返回参数类型

JSON

返回参数

返回结果示例

{
    "code": 200,
    "data": {
        "total": 1,
        "pages": 1,
        "arrearHistoryInfos": [
            {
                "historyInfoId": 1,  
                "communityName": "美的翰诚嘉园",
                "communityId": 1003837,
                "houseName": "6栋1单元2102",
                "houseId": 537011,
                "buildName": null,
                "buildId": null,
                "unitName": null,
                "unitId": null,
                "userId": 32,
                "userName": "郑雲玲",
                "contactPhone": "18269242824",
                "acctAmount": 3434.22,
                "costCycle": "2020-01，2020-02，2020-03，2020-04，2020-05，2020-06，2020-07，2020-08，2020-09，2020-10，2020-11，2020-12",
                "costTotal": 12,
                "isDealWith": "N",
                "createTime": "2021-07-05T09:51:35.000+0000",
                "updateTime": "2021-07-07T06:27:17.000+0000",
                "createBy": null,
                "updateBy": null,
                "versionNum": 0,
                "deleteFlag": 0,
                "createTimeStr": "2021-07-05 17:51:35",
                "updateTimeStr": "2021-07-07 14:27:17",
                "managerId": null,
                "managerUserName": null,
                "managerContactPhone": null,
                "sendDate": "2021-07-07 14:27:44"
            }
        ],
        "pageNo": 1,
        "pageSize": 10
    },
    "message": "success"
}



{
    "code": 200,
    "data": {
        "total": 0,
        "pages": 0,
        "arrearHistoryInfos": [],
        "pageNo": 1,
        "pageSize": 10
    },
    "message": "success"
}

异常返回示例

{"code":401,"message":"Invalid Signature"}

2.2:APP发送欠费催缴短信

描述

请求信息

URI：https://biz-running-uat.smartmideazy.com/charge/arrear-history/can-send/send

方法：POST

请求参数

请求Body描述(非Form表单数据)

情况一：
{
            "communityId": "1003837",
            "userName": "lipl4",
            "isCheckAll":"Y",
            "mobile":"13600009603",
            "userId":1945728
}

情况二
{
            "communityId": "1003837",
            "userName": "lipl4",
            "isCheckAll":"N",
            "ids":"1,2,3,4,5,6",
            "mobile":"13600009603",
            "userId":1945728
}

返回信息

返回参数类型

JSON

返回参数

返回结果示例

注意：因为是利用MQ发送的，所以会直接返回成功，其实返回成功的时候，还没处理完
{
    "code": 200,
    "data": {},
    "message": "success"
}

异常返回示例

{"code":401,"message":"Invalid Signature"}

2.3:中台欠费催缴短信发送列表

描述

请求信息

URI：https://biz-running-uat.smartmideazy.com/charge/arrear-api/api/query/list

方法：POST

请求参数

请求Body描述(非Form表单数据)

{

}

返回信息

返回参数类型

JSON

返回参数

返回结果示例

{
    "code": 200,
    "data": {
        "arrearRemindMsg": [
            {
                "remindMsgId": 2,
                "communityName": "美的翰诚嘉园",
                "communityId": 1003837,
                "houseName": "6栋1单元2102",
                "houseId": 537011,
                "buildName": null,
                "unitName": null,
                "userId": 32,
                "userName": "郑雲玲",
                "contactPhone": "18269242824",
                "managerId": 1945728,
                "managerUserName": "lipl4",
                "managerContactPhone": "13600009603",
                "sendDate": "2021-07-07T06:27:44.000+0000",
                "sendStatus": "OK",
                "msgSubject": null,
                "msgContent": null,
                "createTime": "2021-07-07T06:27:44.000+0000",
                "updateTime": "2021-07-07T06:27:44.000+0000",
                "createBy": 1945728,
                "updateBy": 1945728,
                "versionNum": 0,
                "deleteFlag": 0,
                "createTimeStr": "2021-07-07 14:27:44",
                "updateTimeStr": "2021-07-07 14:27:44",
                "sendDateStr": "2021-07-07 14:27:44"
            }
        ],
        "total": 1,
        "pages": 1,
        "pageNo": 1,
        "pageSize": 5
    },
    "message": "success"
}

异常返回示例

{"code":401,"message":"Invalid Signature"}

2.4:APP新增欠费催缴白名单

描述

请求信息

URI：https://biz-running-uat.smartmideazy.com/charge/arrear-remind/white-list/create

方法：POST

请求参数

请求Body描述(非Form表单数据)

{
    "arWhitelist":{
        "whitelistType": "arrear_remind_msg",
        "businessType": "community_house_user",
        "communityId": 21441121,
        "houseId": "35651289",
        "userId": 14,
        "managerId": "1865616"
    }
}

返回信息

返回参数类型

JSON

返回参数

返回结果示例

{
    "code": 200,
    "data": {},
    "message": "success"
}

异常返回示例

{"code":401,"message":"Invalid Signature"}

2.5:导出缴费记录

描述

请求信息

HTTP协议：HTTP,HTTPS

uri：https://biz-running-uat.smartmideazy.com/biz/mob/report/csv/exportCsvArrearRemindMsg

方法：POST

请求参数

| 名称 | 位置 | 类型 | 必填 | 描述 | | 名称 | 位置 | 类型 | 必填 | 描述 | | ---------------- | ------------ | ------- | ---- | ------------------------------------------------------------ | | communityId | BODY | STRING | 否 | 项目ID | | communityName | BODY | STRING | 否 | 项目名称 | | mobile | BODY | STRING | 否 | 业主手机号或管家手机号模糊查询 | | fromTime | BODY | Date | 是 | 开始时间 | | toTime | BODY | Date | 是 | 结束时间 |

请求Body描述(非Form表单数据)

返回信息

返回参数类型

返回参数

返回结果示例

导出

异常返回示例

{"code":400,"message":"暂无信息","data":{}}