保存业主车辆信息接口文档

添加车辆
删除车辆
修改车辆
查询车辆

一、接口名称

保存业主车辆信息

二、接口描述

该接口用于为业主绑定车辆信息，包括车牌号、车辆类型、车位信息等，并支持设置车辆属性。

三、接口路径

http://ip:port/app/owner.saveOwnerCar

四、请求方法

POST

五、请求头

六、请求参数

6.1 请求体参数（JSON格式）

6.1.1 attrs 参数说明（可选）

七、返回值

7.1 返回值结构

八、示例请求

{
  "communityId": "123456789",
  "ownerId": "1001",
  "carNum": "京A12345",
  "carType": "PRIMARY",
  "psId": "PS001",
  "leaseType": "MONTH",
  "startTime": "2023-01-01",
  "endTime": "2023-12-31",
  "attrs": [
    {
      "specCd": "1001",
      "value": "白色"
    },
    {
      "specCd": "1002",
      "value": "SUV"
    }
  ]
}

九、示例响应

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

十、错误码

十一、业务逻辑说明

1. 参数校验

   • 检查必填参数（communityId、ownerId、carNum、carType、psId）是否为空。
   • 如果 leaseType=MONTH，检查 startTime 和 endTime 是否合法。
   • 检查车位是否空闲（状态为 F）。
   • 检查车牌号是否已绑定其他车辆（临时车除外）。
   • 如果车牌号是临时车，检查是否在场（未出场）。

2. 数据处理

   • 生成车辆ID（carId）。
   • 设置默认值（如 leaseType=MONTH，carTypeCd=PRIMARY）。
   • 保存车辆信息（OwnerCarPo）。
   • 更新车位状态为出租（H）。
   • 保存车辆属性（attrs）。

3. 数据库操作

   • 查询车位信息（ParkingSpaceDto）。
   • 插入车辆信息（OwnerCarPo）。
   • 更新车位状态（ParkingSpacePo）。
   • 插入车辆属性（OwnerCarAttrPo）。

十二、注意事项

1. 时间格式：startTime 和 endTime 必须为 yyyy-MM-dd 格式。
2. 车位状态：仅空闲车位（state=F）可绑定车辆。
3. 临时车处理：如果车牌号是临时车，需先出场才能绑定为月租车。
4. 车辆属性：attrs 可选，用于存储额外信息（如颜色、车型）。