HC小区接口文档

基础接口

登陆接口 接口签名 员工接口

资产接口

小区接口 物业接口 楼栋接口 单元接口 房屋接口 交房 退房 车位接口 车辆接口

业主接口

业主接口 家庭成员 查询房屋认证 认证审核 账户接口 撤销账户明细

费用接口

费用项接口 创建费 查询费用 缴费接口 结束费用 缴费记录 水电抄表

工单接口

报修接口 投诉接口

业主账户预存

查询账户
账户预存

1. 接口名称

业主账户预存（Owner Prestore Account）

2. 接口描述

该接口用于业主向个人账户预存金额，支持不同账户类型（如物业费账户、水电表账户等），并记录交易明细和收款单。

3. 接口路径

POST http://{ip}:{port}/app/account.ownerPrestoreAccount

4. 请求方法

POST

5. 请求头

参数名称 必填 类型 描述
Authorization 是 String 用户认证 Token（Base Token）
app-id 是 String 应用 ID（由系统分配）
transaction-id 是 String 请求流水号（格式：1000000000+YYYYMMDDhhmmss+6位序列）
sign 是 String 签名
req-time 是 String 请求时间（格式：YYYYMMDDhhmmss）

6. 请求参数（Body JSON）

参数名称 必填 类型 描述 示例
communityId 是 String 小区 ID "123456"
ownerId 是 String 业主 ID "1001"
amount 是 String 预存金额（单位：元） "500.00"
acctType 是 String 账户类型（propertyFee：物业费账户，meter：水电表账户） "propertyFee"
primeRate 是 String 支付方式（如 cash、wechat、alipay） "wechat"
roomId 条件必填 String 房屋 ID（当 acctType 为 propertyFee 或 meter 时必填） "R1001"
remark 否 String 备注信息 "业主预存物业费"

7. 返回值

参数名称 类型 描述
code String 返回码（0 成功，非 0 失败）
msg String 返回信息
data Object 返回数据（通常为空）

8. 示例请求

POST /account/ownerPrestoreAccount
Headers:
{
  "Authorization": "Bearer xxxxxx",
  "app-id": "app001",
  "transaction-id": "100000000020231201143000123456",
  "sign": "xxxxxx",
  "req-time": "20231201143000"
}
Body:
{
  "communityId": "123456",
  "ownerId": "1001",
  "amount": "500.00",
  "acctType": "propertyFee",
  "primeRate": "wechat",
  "roomId": "R1001",
  "remark": "业主预存物业费"
}

9. 示例响应

{
  "code": "0",
  "msg": "成功",
  "data": null
}

10. 业务逻辑说明

  1. 参数校验

    • 检查必填参数（communityId、ownerId、amount、acctType、primeRate）。
    • 若 acctType 为物业费或水电表账户，则 roomId 必填。

  2. 账户处理

    • 查询业主是否已有账户，若无则创建新账户。
    • 更新账户余额，并记录交易明细（AccountDetailPo）。

  3. 收款单记录

    • 生成收款单（AccountReceiptPo），记录支付方式、金额等信息。

  4. 返回结果

    • 成功返回 code=0，失败抛出异常并返回错误信息。

11. 数据库操作

  • 查询：
    • accountInnerServiceSMOImpl.queryAccounts（查询业主账户）
    • ownerInnerServiceSMOImpl.queryOwners（查询业主信息）
    • roomInnerServiceSMOImpl.queryRooms（查询房屋信息）
  • 插入：
    • accountInnerServiceSMOImpl.saveAccount（新增账户）
    • accountDetailInnerServiceSMOImpl.saveAccountDetails（记录交易明细）
    • accountReceiptV1InnerServiceSMOImpl.saveAccountReceipt（记录收款单）
  • 更新：
    • accountInnerServiceSMOImpl.prestoreAccount（更新账户余额）

12. 注意事项

  • 金额需为正数，且格式为字符串（避免浮点数精度问题）。
  • primeRate 需与系统支持的支付方式匹配。
  • 若业主或房屋不存在，接口会返回错误。

以上为完整 API 文档，符合 RESTful 规范，涵盖请求、响应、业务逻辑及数据库操作说明。