注意:
所有接口需要传入 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
}