API 接口文档：更新费用项配置
1. 接口名称
更新费用项配置
2. 接口描述
用于修改已有的费用项配置信息，包括费用类型、计费规则、单价等。如果费用项状态变更为 NA（不可用），则关联的费用将被标记为结束状态。
3. 接口路径
http://{ip}:{port}/app/feeConfig.updateFeeConfig（Java110Cmd 编码）
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. 请求参数（JSON Body）
| 参数名称 | 必填 | 类型 | 描述 | 示例 |
|---|---|---|---|---|
configId |
是 | String |
费用项 ID | 123456 |
feeTypeCd |
是 | String |
费用类型编码 | 1001 |
feeName |
是 | String |
收费项目名称 | 物业费 |
feeFlag |
是 | String |
费用标识 | Y（可收费） |
startTime |
是 | String |
计费起始时间（格式：YYYY-MM-DD） |
2023-01-01 |
endTime |
是 | String |
计费终止时间（格式：YYYY-MM-DD） |
2023-12-31 |
computingFormula |
是 | String |
计费公式 | 面积 * 单价 + 附加费 |
squarePrice |
是 | BigDecimal |
计费单价 | 2.50 |
additionalAmount |
是 | BigDecimal |
附加费用 | 100.00 |
communityId |
是 | String |
小区 ID | 10001 |
billType |
是 | String |
出账类型 | MONTHLY（按月） |
state |
否 | String |
状态（N-正常，NA-不可用） |
NA |
7. 返回值
| 参数名称 | 类型 | 描述 |
|---|---|---|
code |
String |
返回码（0 表示成功，其他失败） |
msg |
String |
返回信息 |
data |
Object |
返回数据（通常为空） |
8. 示例请求
POST /feeConfig.updateFeeConfig
Headers:
{
"Authorization": "Bearer xxxxxx",
"app-id": "micro-community",
"transaction-id": "100000000020231201143456123456",
"sign": "xxxxxx",
"req-time": "20231201143456"
}
Body:
{
"configId": "123456",
"feeTypeCd": "1001",
"feeName": "物业费",
"feeFlag": "Y",
"startTime": "2023-01-01",
"endTime": "2023-12-31",
"computingFormula": "面积 * 单价 + 附加费",
"squarePrice": 2.50,
"additionalAmount": 100.00,
"communityId": "10001",
"billType": "MONTHLY",
"state": "NA"
}
9. 示例响应
{
"code": "0",
"msg": "成功",
"data": null
}
10. 业务逻辑说明
- 参数校验：检查必填字段是否为空。
- 查询费用项：根据
configId和communityId查询费用项是否存在。 - 更新费用项：修改费用项信息，如果
state为NA，则更新关联费用状态为STATE_FINISH（结束）。 - 费用标识修改：如果
feeFlag变更且无账单规则关联，则更新费用标识。
11. 数据库操作
- 查询：
feeConfigInnerServiceSMOImpl.queryFeeConfigs - 更新：
payFeeConfigV1InnerServiceSMOImpl.updatePayFeeConfig - 费用状态更新：
payFeeV1InnerServiceSMOImpl.updatePayFee
12. 注意事项
- 如果费用项已关联账单规则（
poy_fee_rule），则不允许修改feeFlag。 state为NA时，会结束所有关联的费用记录。