xk-docs/docs/projects/xk-api/modules/finance.md

财务结算模块

概述

财务结算模块负责分账、提现、对账、资金流水、月结等财务管理功能。

---

分账结算

接口

方法	路径	说明
GET	settlement/list	结算列表
GET	settlement/detail	结算详情
POST	settlement/settle	执行结算
GET	settlement/export	导出结算单

关联类

类	文件	说明
SettlementController	app/Http/Controllers/admin/finance/SettlementController.php	控制器
SettlementService	app/Service/admin/finance/SettlementService.php	业务服务
LedgerService	app/Service/finance/LedgerService.php	分账服务

关联模型

模型	表名	说明
LedgerModel	yii_ledger	分账记录
LedgerLogModel	yii_ledger_log	分账变更日志
AccountAbleChangeLogModel	xk_account_able_change_log	可提现金额变更

分账规则

费用类型	值	说明
药品费用	1	产品订单药品费用
挂号费用	2	挂号订单费用
快递费用	3	快递费用
处方费	4	处方费用
加工费	5	代煎/加工费用
诊疗费	6	诊疗费用

分账流程

sequenceDiagram
    participant P as 支付回调
    participant J as ProductOrderPaidJob
    participant L as LedgerService
    participant DB as 数据库

    P->>J: 支付成功
    J->>L: createLedger(order)
    L->>L: calculateSplit(order)
    L->>DB: INSERT INTO yii_ledger (门店)
    L->>DB: INSERT INTO yii_ledger (平台)
    L->>DB: INSERT INTO xk_account_able_change_log

---

提现管理

接口

方法	路径	说明
GET	withdrawal-application/list	提现申请列表
GET	withdrawal-application/detail	申请详情
POST	withdrawal-application/audit	审核申请
POST	withdrawal-application/pay	打款

关联类

类	文件	说明
WithdrawalApplicationController	app/Http/Controllers/admin/finance/WithdrawalApplicationController.php	控制器
WithdrawalApplicationService	app/Service/admin/finance/WithdrawalApplicationService.php	业务服务

关联模型

模型	表名	说明
CashApplyModel	yii_cash_apply	提现申请
CashAccountModel	yii_cash_account	提现账户

提现审核流程

stateDiagram-v2
    [*] --> 审核中: 提交申请
    审核中 --> 已通过: 审核通过
    审核中 --> 已拒绝: 审核拒绝
    已通过 --> 打款中: 发起打款
    打款中 --> 已打款: 打款成功
    打款中 --> 打款失败: 打款失败
    已拒绝 --> 审核中: 重新申请

---

对账管理

接口

方法	路径	说明
GET	reconciliation/list	对账列表
GET	reconciliation/detail	对账详情
GET	reconciliation/export	导出对账单

关联类

类	文件	说明
ReconciliationController	app/Http/Controllers/admin/finance/ReconciliationController.php	控制器
ReconciliationService	app/Service/admin/finance/ReconciliationService.php	业务服务

关联模型

模型	表名	说明
ReconciliationModel	yii_reconciliation	对账记录

---

资金流水

接口

方法	路径	说明
GET	fund-water/list	流水列表
GET	fund-water/detail	流水详情

关联类

类	文件	说明
FundWaterController	app/Http/Controllers/admin/finance/FundWaterController.php	控制器
FundWaterService	app/Service/admin/finance/FundWaterService.php	业务服务

关联模型

模型	表名	说明
FundWaterModel	yii_fund_water	资金流水

---

月结管理

接口

方法	路径	说明
GET	monthly-payment/list	月结列表
GET	monthly-payment/detail	月结详情
POST	monthly-payment/settle	结算
POST	monthly-payment/cancel	取消

关联类

类	文件	说明
MonthlyPaymentController	app/Http/Controllers/admin/finance/MonthlyPaymentController.php	控制器
MonthlyPaymentService	app/Service/admin/finance/MonthlyPaymentService.php	业务服务

关联模型

模型	表名	说明
MonthlyPaymentModel	xk_monthly_payment	月结账单
MonthlyPaymentSettlementModel	xk_monthly_payment_settlement	月结结算记录

---

代理付款

接口

方法	路径	说明
GET	charge-cash-pay-record/list	付款记录列表
POST	charge-cash-pay-record/create	创建付款记录

关联类

类	文件	说明
ChargeCashPayRecordController	app/Http/Controllers/admin/finance/ChargeCashPayRecordController.php	控制器
ChargeCashPayRecordService	app/Service/admin/finance/ChargeCashPayRecordService.php	业务服务

关联模型

模型	表名	说明
ChargeCashPayRecordModel	yii_charge_cash_pay_record	代理付款记录

---

财务可视化

接口

方法	路径	说明
GET	visualization-chart/data	图表数据

关联类

类	文件	说明
VisualizationChartController	app/Http/Controllers/admin/finance/VisualizationChartController.php	控制器
VisualizationChartService	app/Service/admin/finance/VisualizationChartService.php	业务服务